From b5f6b31620d3f2f76799ccf63ec9de316e656653 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sun, 22 Mar 2009 08:59:18 +0000 Subject: [PATCH] Clarification about -auto_charset pitfalls --- libisoburn/trunk/xorriso/xorriso.1 | 34 +++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 8 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index c10a42ee..2d74dce8 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/xorriso/xorriso.1 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH XORRISO 1 "Mar 20, 2009" +.TH XORRISO 1 "Mar 21, 2009" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -658,14 +658,15 @@ When loading the written image after -commit the setting of -out_charset will be copied to -in_charset. .TP \fB\-auto_charset\fR "on"|"off" -Enable or disable recording of the output character set name in an xattr -attribute of the image root directory. If enabled then use an eventual -recorded character set name as input character set when reading an image. +Enable or disable recording and interpretation of the output character +set name in an xattr attribute of the image root directory. If enabled then +an eventual recorded character set name gets used as input character set +when reading an image. .br Note that the default output charset is the local character set of the -terminal where xorriso runs. Before attributing this one to the produced -ISO image, it is necessary to check whether the terminal properly displays -all intended filenames. Check especially the exotic national characters. +terminal where xorriso runs. Before attributing this local character set +to the produced ISO image, check whether the terminal properly displays +all intended filenames, especially exotic national characters. .TP \fB\-acl\fR "on"|"off" Enable or disable processing of ACLs. @@ -1840,7 +1841,7 @@ missing. .PP File names are strings of non-zero bytes with 8 bit each. Unfortunately the same byte string may appear as different peculiar national characters -on differently nationalized computers. +on differently nationalized terminals. The meanings of byte codes are defined in \fBcharacter sets\fR which have names. Shell command iconv -l lists them. .br @@ -1861,6 +1862,23 @@ local character set. xorriso can inquire the same info as shell command "locale" with argument "charmap". This may be influenced by environment variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of the terminal. +.br +The default output charset is the local character set of the terminal where +xorriso runs. So by default no conversion happens between local filesystem +names and emerging names in the image. The situation stays ambigous and the +reader has to riddle what character set was used. +.br +By option -auto_charset it is possible to attribute the output charset name +to the image. This makes the situation unambigous. But if your terminal +character set does not match the character set of the local file names, +then this attribute can become plainly wrong and cause problems at read time. +To prevent this it is necessary to check whether the terminal properly +displays all intended filenames. Check especially the exotic national +characters. +.br +To enforce recording of a particular character set name without any conversion +at image generation time, set -charset and -local_charset to the desired name, +and enable -backslash_codes to avoid evil character display on your terminal. .TP \fB\-charset\fR character_set_name Set the character set from which to convert file names when loading an