X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex-split.1.in;h=27b5cea64d2dd2e0887abdafd8bbeac1aca66ed7;hb=549c613c4f8cfcf1f0e2fc55d83ee128a00a3be6;hp=270d4bb24151b618c446e93837a379056222da3e;hpb=4f9947253f6a08f4a922d3efe0880e3039b3eb5e;p=wimlib diff --git a/doc/imagex-split.1.in b/doc/imagex-split.1.in index 270d4bb2..27b5cea6 100644 --- a/doc/imagex-split.1.in +++ b/doc/imagex-split.1.in @@ -1,41 +1,37 @@ -.TH IMAGEX "1" "May 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands" +.TH WIMLIB-IMAGEX "1" "August 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME -imagex split \- Split a WIM into multiple parts - +@IMAGEX_PROGNAME@-split \- Split a WIM into multiple parts .SH SYNOPSIS -\fBimagex split\fR \fIWIMFILE\fR \fISPLIT_WIMFILE\fR \fIPART_SIZE\fR [\fIOPTION...\fR] - +\fB@IMAGEX_PROGNAME@ split\fR \fIWIMFILE\fR \fISPLIT_WIM_PART\fR \fIPART_SIZE\fR [\fIOPTION...\fR] .SH DESCRIPTION -.PP - -Splits \fIWIMFILE\fR into parts with size at most \fIPART_SIZE\fR megabytes, -with the first part having the name \fISPLIT_WIMFILE\fR and the other parts +Splits \fIWIMFILE\fR into parts with size at most \fIPART_SIZE\fR mebibytes, +with the first part having the name \fISPLIT_WIM_PART\fR and the other parts having names numbered in order of the parts. - +This command is also available as simply \fBwimsplit\fR if the appropriate +hard link or batch file has been installed. +.PP +\fB@IMAGEX_PROGNAME@ split\fR can split both non-pipable and pipable WIMs. .SH OPTIONS .TP 6 \fB--check\fR When reading \fIWIMFILE\fR, verify its integrity if the integrity table is -present; additionally, when writing each \fISPLIT_WIMFILE\fR, write an integrity -table. If this option is not specified, no integrity tables are included in the -split WIM files, even if there was one in the original WIM. - +present; additionally, when writing each \fISPLIT_WIM_PART\fR, write an integrity +table. If this option is not specified, integrity tables will be included in +the split WIMs if and only if one was present in \fIWIMFILE\fR. .SH EXAMPLES -.IP -imagex split windows.wim windows.swm 100 -.LP Splits the WIM 'windows.wim' into 'windows.swm', 'windows2.swm', 'windows3.swm', -etc. where each part is at most 100 MiB. - -.SH NOTE - +etc. where each part is at most 100 MiB: +.RS +.PP +@IMAGEX_PROGNAME@ split windows.wim windows.swm 100 +.RE +.SH LIMITATIONS It it possible for the size of the parts to exceed the \fIPART_SIZE\fR given. This is impossible to avoid and Microsoft's program has this problem as well because the WIM file format provides no way to divide a single file resource in the WIM among multiple split WIM parts. So if you, for example, have a file inside the WIM that is 100 MiB, then an uncompressed split WIM will have at -least one part that is 100 MiB in size to contain that file. If the WIM -resources are compressed then less space would be needed. - +least one part that is 100 MiB in size to contain that file. However, if the +WIM resources are compressed then less space would be needed. .SH SEE ALSO -.BR imagex (1) +.BR @IMAGEX_PROGNAME@ (1)