Explained result pager

This commit is contained in:
Thomas Schmitt 2007-12-08 17:16:41 +00:00
parent a26f7cd7c7
commit be48f2b8a7

View File

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" 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. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -70,6 +70,8 @@ Libburn drives
Rock Ridge, POSIX, X/Open Rock Ridge, POSIX, X/Open
.br .br
Command processing Command processing
.br
Result pager
.sp 1 .sp 1
Maybe you first want to have a look at section EXAMPLES near the end of 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. 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.
.SS .SS
.B Creating, Growing, Modifying: .B Creating, Growing, Modifying:
.br .br
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 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 is defined. This is achieved by option -dev on blank media or by option -outdev
on media in any state. 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. dialog mode if command -dialog "on" was executed up to then.
.PP .PP
The program ends either by command -end, or by the end of program arguments 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. event which triggers the threshold of command -abort_on.
.SS
.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.
.br
An empty line lets xorriso resume work until the next page is put out.
.br
The single character "@" disables paging for the current action.
.br
"@@@", "x", "q", "X", or "Q" urge the current action to abort and suppress
further result output.
.br
Any other line will be interpreted as new dialog line. The current action
is urged to abort. Afterwards, the input line is executed.
.PP
Some actions apply paging to their info output, too.
.br
The urge to abort may or may not be obeyed by the current action. All actions
try to abort as soon as possible.
.br .br
.SH OPTIONS .SH OPTIONS
.br .br
@ -732,7 +755,7 @@ are processed. In dialog mode input lines get prompted via
readline or from stdin. readline or from stdin.
.TP .TP
\fB\-page\fR len width \fB\-page\fR len width
Describe terminal to the text pager. Describe terminal to the text pager. See above, paragraph Result pager.
.TP .TP
\fB\-use_readline\fR "on"|"off" \fB\-use_readline\fR "on"|"off"
If "on" then use readline for dialog. Else use plain stdin. If "on" then use readline for dialog. Else use plain stdin.