X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=doc%2Fimagex-capture.1.in;h=b4c66d15233c2d1a499ab38d40d1f3dd3027a4ef;hp=943f1f4d1626e087fcae7db286ceea37037c9838;hb=9e7ecc35cf675cd8a8bc5d6e30dd805c25aefb85;hpb=0857bf8cb1bb7092983236cb1edc29ff7595b039 diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in index 943f1f4d..b4c66d15 100644 --- a/doc/imagex-capture.1.in +++ b/doc/imagex-capture.1.in @@ -2,8 +2,8 @@ .SH NAME @IMAGEX_PROGNAME@-capture, @IMAGEX_PROGNAME@-append \- Create or append a WIM image .SH SYNOPSIS -\fB@IMAGEX_PROGNAME@ capture\fR \fISOURCE\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR] \ -[\fIIMAGE_DESCRIPTION\fR] [\fIOPTION\fR...] +\fB@IMAGEX_PROGNAME@ capture\fR \fISOURCE\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR \ +[\fIIMAGE_DESCRIPTION\fR]] [\fIOPTION\fR...] .br \fB@IMAGEX_PROGNAME@ append\fR \fISOURCE\fR \fIWIMFILE\fR [\fIIMAGE_NAME\fR \ [\fIIMAGE_DESCRIPTION\fR]] [\fIOPTION\fR...] @@ -245,10 +245,10 @@ absolute symbolic links that point outside the directory tree being captured will be ignored and not be captured at all. When disabled (\fB--norpfix\fR), absolute symbolic links will be captured exactly as is. .IP "" -The default behavior for \fBimagex capture\fR is equivalent to \fB--rpfix\fR. -The default behavior for \fBimagex append\fR will be \fB--rpfix\fR if reparse -point fixups have previously been done on \fIWIMFILE\fR, otherwise -\fB--norpfix\fR. +The default behavior for \fB@IMAGEX_PROGNAME@ capture\fR is equivalent to +\fB--rpfix\fR. The default behavior for \fB@IMAGEX_PROGNAME@ append\fR will be +\fB--rpfix\fR if reparse point fixups have previously been done on +\fIWIMFILE\fR, otherwise \fB--norpfix\fR. .IP "" In the case of a multi-source capture, (\fB--source-list\fR specified), passing \fB--norpfix\fR is recommended. Otherwise, reparse point fixups will be @@ -323,6 +323,14 @@ itself. However, additional symbolic links in subdirectories, or in additional source directories not destined for the WIM image root (with \fB--source-list\fR), are not dereferenced unless \fB--dereference\fR is specified. +.PP +With the UNIX version of \fB@IMAGEX_PROGNAME@\fR, it is possible to create a WIM +image containing files with names differing only in case, or files with names +containing the characters ':', '*', '?', '"', '<', '>', '|', or '\\', which are +valid on POSIX-compliant filesystems but not Windows. Be warned that such files +will not be extracted by default by the Windows version of +\fB@IMAGEX_PROGNAME@\fR, and Microsoft's ImageX might get confused by such +names. .SH EXAMPLES Create a new WIM 'mywim.wim' from the directory 'somedir', using LZX compression and including an integrity table: