diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1 index a5678440..31a0ddf8 100644 --- a/libisoburn/trunk/test/xorriso.1 +++ b/libisoburn/trunk/test/xorriso.1 @@ -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 .br Command processing +.br +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. .SS .B Creating, Growing, Modifying: .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 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. .PP 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. +.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 .SH OPTIONS .br @@ -732,7 +755,7 @@ are processed. In dialog mode input lines get prompted via readline or from stdin. .TP \fB\-page\fR len width -Describe terminal to the text pager. +Describe terminal to the text pager. See above, paragraph Result pager. .TP \fB\-use_readline\fR "on"|"off" If "on" then use readline for dialog. Else use plain stdin.