Clarified man page

This commit is contained in:
Thomas Schmitt 2007-11-11 11:22:39 +00:00
parent 40b5f82b95
commit b9d0801ee5

View File

@ -32,8 +32,8 @@ information of existing ISO images and it writes the session results to
optical media or to filesystem objects.
.PP
A special property of xorriso is that it needs neither an external ISO 9660
formatter program nor an external burn program but rather incorporates
the libraries of libburnia-project.org .
formatter program nor an external burn program for CD or DVD but rather
incorporates the libraries of libburnia-project.org .
.SS
.B Overview of features:
.br
@ -208,7 +208,7 @@ with a fixed list length.
is a property of some particular commands and not a general
feature. It gets controlled by command -iso_rr_pattern. Commands which
eventually use pattern expansion all have variable argument lists which
are marked in this man page by [***] rather than [...].
are marked in this man page by "[***]" rather than "[...]".
.br
Some other commands perform pattern matching unconditionally.
.PP
@ -297,11 +297,11 @@ commands which support this feature.
converts a list of pattern words into a list of existing file addresses.
Eventual unmatched pattern words appear themselves in that result list, though.
.br
Pattern matching supports the usual shell parser wildcards '*' '?' '[a-z]'
Pattern matching supports the usual shell parser wildcards '*' '?' '[xyz]'
and respects '/' as separator which may only be matched literally.
.br
Setting "off" disables this feature for all commands which are marked in this
man page by "iso_rr_path [***]" or "pattern [***].
man page by "iso_rr_path [***]" or "pattern [***]".
Setting "on" enables it for all those commands.
Setting "ls" enables it only for those which are marked by "pattern [***]".
.br
@ -594,7 +594,7 @@ readline or from stdin.
\fB\-page\fR len width
Describe terminal to the text pager.
.TP
? \fB\-use_readline\fR "on"|"off"
\fB\-use_readline\fR "on"|"off"
If "on" then use readline for dialog. Else use plain stdin.
.TP
\fB\-reassure\fR "on"|"tree"|"off"
@ -603,9 +603,16 @@ before deleting or overwriting any file in the ISO image.
With setting "tree" the reassuring prompt will appear for an eventual
directory only once and not for each file in its whole subtree.
Setting "off" silently kills any kind of image file object.
To really produce user prompts, option -dialog needs to be set to "on".
.br
Note that the prompt appears only in situations where file removal
is not forbidden by option -overwrite.
is not forbidden by option -overwrite. -reassure only imposes an additional
curb for removing existing file objects.
.br
Be aware that file objects get deleted from the ISO image immediately
after confirmation. They are gone even if the running command gets aborted
and its desired effect gets revoked. In case of severe mess-up, consider to
use -rollback to revoke the whole session.
.TP
.B Drive and media related inquiry actions:
.TP
@ -711,7 +718,7 @@ Filters begin with '-' and are compared literally against the
output lines of -status:long_history. A line is put out only
if its start matches the filter text. No wildcards.
.TP
? \fB\-status_history_max\fR number
\fB\-status_history_max\fR number
Set maximum number of history lines to be reported with -status "long_history".
.TP
\fB\-options_from_file\fR fileaddress
@ -800,6 +807,7 @@ to read and execute lines from the following files:
/etc/opt/xorriso/rc
/etc/xorriso/cdrskin.conf
$HOME/.xorrisorc
.br
The files are read in the sequence given above, but none of them is required
for xorriso to function properly.
.br