From b9d0801ee568c8ee7a1c3cdade7b2887c22d83f5 Mon Sep 17 00:00:00 2001
From: Thomas Schmitt <scdbackup@gmx.net>
Date: Sun, 11 Nov 2007 11:22:39 +0000
Subject: [PATCH] Clarified man page

---
 libisoburn/trunk/test/xorriso.1 | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1
index 2c98b4fa..300a88cd 100644
--- a/libisoburn/trunk/test/xorriso.1
+++ b/libisoburn/trunk/test/xorriso.1
@@ -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