New option -backslash_codes for expressing weird file names

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 15, 2008"
+.TH XORRISO 1 "Oct 16, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -2198,6 +2198,34 @@ quotation marks.
 .br
 For brevity the list delimiter is referred as "--" throughout this text.
 .TP
+\fB\-backslash_codes\fR "on"|"off"|mode[:mode]
+Enable or disable the interpretation of symbolic representations of special
+characters with quoted input or with program arguments. If enabled the
+following translations apply:
+.br
+ \\a=bell(007) \\b=backspace(008) \\e=Escape(033) \\f=formfeed(014)
+.br
+ \\n=linefeed(012) \\r=carriage_return(015) \\t=tab(011)
+.br
+ \\v=vtab(013) \\\\=backslash(134) \\[0-9][0-9][0-9]=octal_code
+.br
+ \\\\x[0-9a-f][0-9a-f]=hex_code \\cC=control-C
+.br
+Translations can occur with quoted input in 3 modes:
+.br
+ "in_double_quotes" translates only inside " quotation.
+.br
+ "outside_single_quotes" translates not inside ' quotation.
+.br
+ "with_quoted_input" translates all input text.
+.br
+With the start program arguments there is mode:
+.br
+ "with_program_arguments" translates all program arguments.
+.br
+Mode "off" is default and disables any translation.
+Mode "on" is the same as "with_quoted_input:with_program_arguments".
+.TP
 \fB\-temp_mem_limit\fR number["k"|"m"]
 Set the maximum size of temporary memory to be used for image dependent
 buffering. Currently this applies to pattern expansion only.