Explained result pager

Thomas Schmitt 15 years ago
parent e63ffdc805
commit d50079825e

@ -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 "December 5, 2007"
.TH XORRISO 1 "December 7, 2007"
.\" Please adjust this date whenever revising the manpage.
.\" Some roff macros, for reference:
@ -70,6 +70,8 @@ Libburn drives
Rock Ridge, POSIX, X/Open
Command processing
Result pager
.sp 1
Maybe you first want to have a look at section EXAMPLES near the end of
this text before reading the next few hundred lines of background information.
@ -179,7 +181,8 @@ Overwriteable media assume this state only in such read-only drives.
.B Creating, Growing, Modifying:
A new empty ISO image gets created if there is no input drive with a valid
A new empty ISO image gets \fBcreated\fR
if there is no input drive with a valid
ISO 9660 image plus Rock Ridge extensions when the first time an output drive
is defined. This is achieved by option -dev on blank media or by option -outdev
on media in any state.
@ -311,8 +314,28 @@ the program arguments as commands and parameters and finally it enters
dialog mode if command -dialog "on" was executed up to then.
The program ends either by command -end, or by the end of program arguments
if not command -dialog was encountered up to that moment, or by a problem
if not dialog was enabled up to that moment, or by a problem
event which triggers the threshold of command -abort_on.
.B Result pager:
Option -page activates a builtin result text pager which may be convenient in
dialog. After an action has put out the given number of terminal lines,
the pager prompts the user for a line of input.
An empty line lets xorriso resume work until the next page is put out.
The single character "@" disables paging for the current action.
"@@@", "x", "q", "X", or "Q" urge the current action to abort and suppress
further result output.
Any other line will be interpreted as new dialog line. The current action
is urged to abort. Afterwards, the input line is executed.
Some actions apply paging to their info output, too.
The urge to abort may or may not be obeyed by the current action. All actions
try to abort as soon as possible.
@ -732,7 +755,7 @@ are processed. In dialog mode input lines get prompted via
readline or from stdin.
\fB\-page\fR len width
Describe terminal to the text pager.
Describe terminal to the text pager. See above, paragraph Result pager.
\fB\-use_readline\fR "on"|"off"
If "on" then use readline for dialog. Else use plain stdin.