Cleanup imagex-apply man page
authorEric Biggers <ebiggers3@gmail.com>
Fri, 23 Nov 2012 23:46:06 +0000 (17:46 -0600)
committerEric Biggers <ebiggers3@gmail.com>
Fri, 23 Nov 2012 23:46:06 +0000 (17:46 -0600)
doc/imagex-apply.1.in

index db1af8c..ef517a3 100644 (file)
@@ -42,7 +42,7 @@ the WIM image(s):
 .IP \[bu] 4
 The default (unnamed) data stream of each file
 .IP \[bu]
-Hard links, if supported by the underlying filesystem
+Hard links
 .IP \[bu]
 File and directory creation, access, and modification timestamps to the nearest
 microsecond, if supported by the underlying filesystem
@@ -71,9 +71,8 @@ Short (DOS) names for files
 A special extraction mode is entered when \fITARGET\fR is a regular file or
 block device.  If this is the case, \fITARGET\fR is interpreted as an NTFS
 volume and opened using libntfs-3g.  If successful, the WIM image is extracted
-to the root of the NTFS volume in a special mode that preserves all, or almost
-all, information contained in the WIM.  \fIIMAGE\fR may not be "all" for this
-action.
+to the root of the NTFS volume in a special mode that preserves all information
+contained in the WIM image.  \fIIMAGE\fR may not be "all" for this action.
 
 The NTFS volume does not need to be empty, although it's expected that it be
 empty for the intended use cases.  A new NTFS filesystem can be created using
@@ -113,14 +112,15 @@ same directory are made to be names in the POSIX namespace.
 
 .PP
 
-In the NTFS extraction mode, we restore enough information from the WIM that it
-is possible, in most cases, to restore or install an image of an actual Windows
-installation. In the examples at the end of this manual page, we show an example
-of applying an image from the "install.wim" file contained in the installation
-media for Windows Vista, Windows 7, and Windows 8 in the "sources" directory.
+Since all information from the WIM image is should be restored in the NTFS
+extraction mode, it is possible to restore an image of an actual Windows
+installation. In the examples at the end of this manual page, there is an
+example of applying an image from the "install.wim" file contained in the
+installation media for Windows Vista, Windows 7, and Windows 8 in the "sources"
+directory.
 
-In order to actually boot Windows from an applied image, you must understand the
-boot process of Windows versions Vista and later.  Basically, it is the
+But in order to actually boot Windows from an applied image, you must understand
+the boot process of Windows versions Vista and later.  Basically, it is the
 following:
 
 .nr step 1 1
@@ -183,7 +183,7 @@ mywim4.swm
 mywim5.swm
 .RE
 
-To apply the first image of this split WIM to the directory "dir", we would do:
+To apply the first image of this split WIM to the directory "dir", run:
 .PP
 .RS
 imagex apply mywim.swm 1 dir --ref="mywim*.swm"
@@ -223,10 +223,10 @@ extracts and verifies that it is the same as the SHA1 message digest provided in
 the WIM file.  It is an error if the message digests don't match.  It's also
 considered to be an error if any WIM resources cannot be found in the stream
 lookup table.  So you can be fairly certain that the file streams are extracted
-correctly, even though we don't provide a \fB/verify\fR option like Microsoft's
-version of imagex does.  Please note that this is separate from the integrity
-table of the WIM, which provides SHA1 message digests over raw chunks of the
-entire WIM file and is checked separately if the \fB--check\fR option is
+correctly, even though \fBimagex apply\fR don't have a \fB/verify\fR option like
+Microsoft's version of imagex does.  Please note that this is separate from the
+integrity table of the WIM, which provides SHA1 message digests over raw chunks
+of the entire WIM file and is checked separately if the \fB--check\fR option is
 specified.
 
 .SH EXAMPLES
@@ -246,10 +246,10 @@ image apply /media/windows8/sources/boot.wim all boot --hardlink
 .RE
 .PP
 .SS NTFS extraction mode
-Verbosely apply a WIM image to a NTFS filesystem image:
+Apply a WIM image to a NTFS filesystem image:
 .RS
 .PP
-imagex apply mywim.wim 1 fsimage.ntfs --verbose
+imagex apply mywim.wim 1 fsimage.ntfs
 .RE
 .PP
 Create a new NTFS filesystem on the partition /dev/sda2 and apply the first