X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhl.man1;h=9f84170026ba86791ca3aee7d2eae3bd6b4473f5;hp=de444489e9e96d95c0fc71b00de0c7398e4f9114;hb=943765e7ac5693ae177fd8d2b5a2440e53ce816e;hpb=e11983f44e59d8de236affa5b0d0d3067c192e24 diff --git a/man/mhl.man1 b/man/mhl.man1 index de44448..9f84170 100644 --- a/man/mhl.man1 +++ b/man/mhl.man1 @@ -8,7 +8,6 @@ mhl \- produce formatted listings of nmh messages .HP 5 .na .B mhl -.RB [ \-clear " | " \-noclear ] .RB [ \-folder .IR +folder ] .RB [ \-form @@ -34,32 +33,7 @@ messages. It is the default method of displaying text messages for (it is the default .IR showproc ). .PP -As with -.BR more , -each of the messages specified as arguments (or -the standard input) will be output. If more than one message file is -specified, the user will be prompted prior to each one, and a -or will begin the output, with clearing the screen (if -appropriate), and (usually CTRL\-D) suppressing the screen clear. -An (usually CTRL\-C) will abort the current message output, -prompting for the next message (if there is one), and a (usually -CTRL-\\) will terminate the program (without core dump). -.PP -The -.B \-clear -option tells -.B mhl -to clear the -screen at the end of each page (or output a formfeed after each message). -This switches (and its inverse counterpart) take effect only -if the profile entry -.I moreproc -is defined but empty, and -.B mhl -is outputting to a terminal. If the -.I moreproc -entry is defined and -non-empty, and +If .B mhl is outputting to a terminal, then .B mhl @@ -67,38 +41,14 @@ will cause the .I moreproc to be placed between the terminal and -.B mhl -and the switches are ignored. Furthermore, if the -.B \-clear -switch is -used and \fImhl's\fR output is directed to a terminal, then -.B mhl -will consult the -.B $TERM -and -.B $TERMCAP -environment variables -to determine the user's terminal type in order to find out how to clear -the screen. If the -.B \-clear -switch is used and -.BR mhl 's -output is -not directed to a terminal (e.g., a pipe or a file), then -.B mhl -will -send a formfeed after each message. +.BR mhl . .PP To override the default .I moreproc and the profile entry, use the .B \-moreproc .I program -switch. Note that -.B mhl -will never start a -.I moreproc -if invoked on a hardcopy terminal. +switch. .PP The .B \-length @@ -156,7 +106,7 @@ of the format is produced as a structured list. In phase 2, this list is walked for each message, outputting message information under the format constraints from the format file. .PP -The format file can contain information controlling screen clearing, +The format file can contain information controlling screen size, wrap\-around control, transparent text, component ordering, and component formatting. Also, a list of components to ignore may be specified, and a couple of \*(lqspecial\*(rq components are defined @@ -189,11 +139,11 @@ Remaining lines define the global environment. For example, the line: .PP .RS 5 -width=80,length=40,clearscreen,overflowtext="***",overflowoffset=5 +width=80,length=40,overflowtext="***",overflowoffset=5 .RE .PP defines the screen size to be 80 columns by 40 rows, specifies that the -screen should be cleared prior to each page, that the overflow indentation +overflow indentation is 5, and that overflow text should be flagged with \*(lq***\*(rq. .PP Following are all of the current variables and their arguments. If they @@ -201,11 +151,11 @@ follow a component, they apply only to that component, otherwise, their affect is global. Since the whole format is parsed before any output processing, the last global switch setting for a variable applies to the whole message if that variable is used in a global context (i.e., -clearscreen, width, length). +width, length). .PP .RS 5 .nf -.ta \w'noclearscreen 'u +\w'integer/G 'u +.ta \w'xxxxxxxxxxxxx 'u +\w'integer/G 'u .I variable type semantics width integer screen width or component width length integer screen length or component length @@ -218,8 +168,6 @@ compwidth integer positions to indent component text uppercase flag output text of this component in all upper case nouppercase flag don't uppercase -clearscreen flag/G clear the screen prior to each page -noclearscreen flag/G don't clearscreen component string/L name to use instead of \*(lqcomponent\*(rq for this component nocomponent flag don't output \*(lqcomponent: \*(rq for this @@ -333,7 +281,6 @@ show(1), ap(8), dp(8) .SH DEFAULTS .nf -.RB ` \-noclear ' .RB ` \-length 40 ' .RB ` \-width 80 ' .fi @@ -349,8 +296,5 @@ tool, the switch does only take file names, but no format strings with a prepended equal sign `='. .PP -There should be some way to pass `clear' information to the -front\-end. -.PP The \*(lqnonewline\*(rq option interacts badly with \*(lqcompress\*(rq and \*(lqsplit\*(rq.