Update version number to 1.4.0; update NEWS
[wimlib] / doc / imagex-join.1.in
1 .TH IMAGEX "1" "May 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
2 .SH NAME
3 @IMAGEX_PROGNAME@-join \- Join split WIMs into a standalone one-part WIM
4
5 .SH SYNOPSIS
6 \fB@IMAGEX_PROGNAME@ join\fR [\fIOPTION\fR...] \fIOUT_WIMFILE\fR \fISPLIT_WIM\fR...
7
8 .SH DESCRIPTION
9 .PP
10 Joins the \fISPLIT_WIMs\fR into a standalone one-part WIM \fIOUT_WIMFILE\fR.
11
12 All parts of the split WIM  must be specified.  You probably want to do so using
13 a shell wildcard.
14
15 .SH OPTIONS
16 .TP 6
17 \fB--check\fR
18 When reading each \fISPLIT_WIM\fR, verify its integrity if the integrity table is
19 present; additionally, when writing \fIOUT_WIMFILE\fR,
20 write an integrity table.  If this option is not specified, no integrity table
21 is included in the new WIM file, even if there was one before.
22
23 .SH EXAMPLES
24 Join a split WIM, with the parts named `windows*.swm' where the * is anything
25 (usually the number of the part, except for the first part which may have no
26 number), and write the joined WIM to the file `windows.wim'.
27 .RS
28 .PP
29 @IMAGEX_PROGNAME@ join windows.wim windows*.swm
30 .RE
31
32 .SH NOTES
33 \fB@IMAGEX_PROGNAME@ join\fR is roughly equivalent to:
34 .RS
35 .PP
36 \fB@IMAGEX_PROGNAME@ export\fR \fISWM_PART_1\fR --ref="\fISWM_GLOB\fR" [--check] all \fIOUT_WIMFILE\fR
37 .RE
38 .PP
39
40
41 .SH SEE ALSO
42 .BR @IMAGEX_PROGNAME@ (1)
43 .BR @IMAGEX_PROGNAME@-export (1)