X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex.1.in;h=44ae0480870c3697e4b019fb6b86157be89927b2;hb=6c22a824ca41822f106c1d5764526ff1dfd5e87b;hp=7f13df5eeb90f7aef1f9fba4af75887b0916ea02;hpb=1fc939b7bd0b37900d974b1cd5b11df128df71f5;p=wimlib diff --git a/doc/imagex.1.in b/doc/imagex.1.in index 7f13df5e..44ae0480 100644 --- a/doc/imagex.1.in +++ b/doc/imagex.1.in @@ -1,4 +1,4 @@ -.TH WIMLIB-IMAGEX 1 "December 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH WIMLIB-IMAGEX 1 "March 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@ \- Create, modify, extract, mount, or unmount a WIM (Windows Imaging Format) archive .SH SYNOPSIS @@ -170,10 +170,9 @@ mounting an image from a split WIM, but Microsoft's software does not. (Note: this functionality is not available in Windows builds of wimlib and \fB@IMAGEX_PROGNAME@\fR.) .SH LOCALES AND CHARACTER ENCODINGS -WIM files themselves store file and stream names using the UTF16-LE. On -Windows, wimlib works in UTF-16LE, so conversions are usually necessary and -there should be no problems with character encodings, except possibly in the XML -data. +WIM files themselves store file and stream names using UTF-16LE. On Windows, +wimlib works in UTF-16LE, so conversions are usually not necessary and there +should be no problems with character encodings. .PP On UNIX-like systems, wimlib works primarily in the locale-dependent multibyte encoding, which you are strongly recommended to set to UTF-8 to avoid any @@ -187,19 +186,19 @@ between UNIX-like systems and Windows. WIM images may (but usually do not) have multiple files with the same case-insensitive name. Internally, wimlib stores filenames as case-sensitive, but on Windows paths actually provided by the user for use in a WIM image (e.g. for extracting, -adding, renaming, or deleting files) will be treated as case-insensitive in -order to get the "expected" behavior. This differs from the default behavior on -UNIX-like systems, where such paths will be treated as case-sensitive. Note -that with case insensitively, a path component may in general be ambiguous due -to multiple files or directories having the same case-insensitive name. In such -cases, if there is a file or directory with an exactly matching name, it is -chosen; otherwise, one of the case-insensitively matching file or directories is -chosen arbitrarily. +adding, renaming, or deleting files) will by default be treated as +case-insensitive in order to get the "expected" behavior. This differs from the +default behavior on UNIX-like systems, where such paths will be treated as +case-sensitive. Note that with case insensitivity, a path component may in +general be ambiguous due to multiple files or directories having the same +case-insensitive name. In such cases, if there is a file or directory with an +exactly matching name, it is chosen; otherwise, one of the case-insensitively +matching file or directories is chosen arbitrarily. .PP -The default behavior can be overwritten by explicitly setting the environmental +The default behavior can be overridden by explicitly setting the environmental variable \fBWIMLIB_IMAGEX_IGNORE_CASE\fR to 1, in which case such paths will be treated case insensitively, or 0, in which such paths will be treated case -sensitsively. +sensitively. .PP Regardless of these settings, options and non-path arguments must be specified in lower case.