Eventual backslash output conversion outside quotes for more terminal-safety

This commit is contained in:
2008-11-10 12:38:01 +00:00
parent 31ccbfb4ad
commit 6ca36d3806
3 changed files with 36 additions and 21 deletions

View File

@ -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 "Nov 07, 2008"
.TH XORRISO 1 "Nov 11, 2008"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -2292,11 +2292,11 @@ Enable or disable the interpretation of symbolic representations of special
characters with quoted input, or with program arguments, or with program
text output. If enabled the following translations apply:
.br
\\a=bell(007) \\b=backspace(008) \\e=Escape(033) \\f=formfeed(014)
\\a=bell(007) \\b=backspace(010) \\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
\\v=vtab(013) \\\\=backslash(134) \\[0-7][0-7][0-7]=octal_code
.br
\\\\x[0-9a-f][0-9a-f]=hex_code \\cC=control-C
.br
@ -2313,9 +2313,12 @@ With the start program arguments there is mode:
"with_program_arguments" translates all program arguments.
.br
.br
Mode "encode_output" encodes output characters inside single or double
quotation marks. It combines "encode_results" with "encode_infos". Encoding
applies to ASCII characters 1 to 31 and 127 to 255.
Mode "encode_output" encodes output characters. It combines "encode_results"
with "encode_infos". Inside single or double quotation marks encoding applies
to ASCII characters octal 001 to 037 , 177 to 377 and to backslash(134).
Outside quotation marks some harmless control characters stay unencoded:
bell(007), backspace(010), tab(011), linefeed(012), formfeed(014),
carriage_return(015).
.br
Mode "off" is default and disables any translation.
Mode "on" is
@ -2595,12 +2598,13 @@ This example assumes that the existing ISO image was written with character
set ISO-8859-1 but that the readers expected UTF-8. Now a new session with
the same files gets added with converted file names.
In order to avoid any weaknesses of the local character set this command
pretends that it is already the final target set UTF-8.
Therefore strange file names may appear in eventual error messages.
pretends that it uses already the final target set UTF-8.
Therefore strange file names may appear in eventual error messages which
will be made terminal-safe by option -backslash_codes.
.br
\fB$\fR xorriso -in_charset ISO-8859-1 -local_charset UTF-8 \\
.br
-out_charset UTF-8 -dev /dev/sr0 \\
-out_charset UTF-8 -backslash_codes on -dev /dev/sr0 \\
.br
-alter_date m +0 / -- -commit -eject all
.SS