New option -local_charset

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 "Oct 25, 2008"
+.TH XORRISO 1 "Nov 07, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -1513,9 +1513,9 @@ The meanings of byte codes are defined in \fBcharacter sets\fR which have
 names. Shell command iconv -l lists them. 
 .br
 Character sets should not matter as long as only alphanumeric characters are
-used for file names or as long as the computer which runs xorriso uses the
-same character set as the computer which wrote the loaded image and those
-computers which shall read the newly emerging ISO image.
+used for file names or as long as the shell session which runs xorriso uses the
+same character set as the one which wrote the loaded image and the same
+character set as the computers which shall read the newly emerging ISO image.
 Outside these constraints it may be necessary to let xorriso convert byte
 codes.
 .br
@@ -1525,13 +1525,23 @@ character set to the output character set is performed when a new
 image tree gets written. The sets can be defined independently by options
 -in_charset and -out_charset. Normally one will have both identical, if ever.
 .br
-xorriso expects and uses the local character set for command arguments
-and file name output. Other character sets will only be in effect on media.
+If conversions are desired then it is necessary to know the name of the
+local character set. xorriso can inquire the same info as shell command
+"locale" with argument "charmap". This may or may not be the correct name.
+So one should check.
+.br
+A typical wrong answer would be "ANSI_X3.4-1968" if your shell session supports
+non-US-ASCII characters.
+It is outside the scope of xorriso how to find out the correct name in such
+a case. The author of this text uses -local_charset "ISO-8859-1".
 .TP
 \fB\-charset\fR character_set_name
 Set the character set from which to convert file names when loading an
 image and to which to convert when writing an image.
 .TP
+\fB\-local_charset\fR character_set_name
+Override the system assumption of the local character set name.
+.TP
 .B Exception processing:
 .PP
 Since the tasks of xorriso are manifold and prone to external influence, there