Return to show.me CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh

Annotation of 43BSDReno/share/doc/usd/08.mh/show.me, revision 1.1

1.1     ! root        1: .\"    This file is automatically generated.  Do not edit!
        !             2: .SC SHOW 1
        !             3: .NA
        !             4: show \- show (list) messages
        !             5: .SY
        !             6: show
        !             7: \%[+folder] \%[msgs]
        !             8: \%[\-draft]
        !             9: \%[\-header] \%[\-noheader]
        !            10: \%[\-showproc\ program] \%[\-noshowproc]
        !            11: \%[switches\ for\ \fIshowproc\fR]
        !            12: \%[\-help]
        !            13: .DE
        !            14: \fIShow\fR lists each of the specified messages to the standard
        !            15: output (typically, the terminal).
        !            16: Typically, the messages are listed exactly
        !            17: as they are, with no reformatting.
        !            18: A program named by the \fIshowproc\fR profile component is
        !            19: invoked to do the listing, and any switches not recognized by
        !            20: \fIshow\fR are passed along to that program.
        !            21: The default program is known as \fImore\fR\0(1).
        !            22: To override the default and the \fIshowproc\fR profile component,
        !            23: use the `\-showproc\ program' switch.
        !            24: For example, `\-show\ pr' will cause the \fIpr\fR\0(1) program to list the
        !            25: messages.
        !            26: The \fIMH\fR command \fImhl\fR can be used as a \fIshowproc\fR
        !            27: to show messages in a more uniform format.
        !            28: Normally, this program is specified as the \fIshowproc\fR is the user's
        !            29: \&.mh\(ruprofile.
        !            30: See \fImhl\fR\0(1) for the details.
        !            31: If the `\-noshowproc' option is specified,
        !            32: `/bin/cat' is used instead of \fIshowproc\fR.
        !            33: 
        !            34: The `\-header' switch tells \fIshow\fR to display a one\-line
        !            35: description of the message being shown.
        !            36: This description includes the folder and the message number.
        !            37: 
        !            38: If no `msgs' are specified, the current message is used.
        !            39: If more than one message is specified,
        !            40: \fImore\fR will prompt for a <RETURN> prior to listing each message.
        !            41: \fImore\fR will list each message, a page at a time.
        !            42: When the end of
        !            43: page is reached, \fImore\fR will ring the bell and wait for a <SPACE>
        !            44: or <RETURN>.
        !            45: If a <RETURN> is entered, \fImore\fR will print the next line,
        !            46: whereas <SPACE> will print the next screenful.
        !            47: To exit \fImore\fR, type \*(lqq\*(rq.
        !            48: 
        !            49: If the standard output is not a terminal, no queries are made,
        !            50: and each file is listed with a one\-line header and two lines of
        !            51: separation.
        !            52: 
        !            53: \*(lqshow \-draft\*(rq will list the file <mh\-dir>/draft if it
        !            54: exists.
        !            55: 
        !            56: If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
        !            57: then \fIshow\fR will remove each of the messages shown from each
        !            58: sequence named by the profile entry.
        !            59: This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
        !            60: by all \fIMH\fR commands which take `msgs' or `msg' arguments.
        !            61: .Fi
        !            62: ^$HOME/\&.mh\(ruprofile~^The user profile
        !            63: .Pr
        !            64: ^Path:~^To determine the user's MH directory
        !            65: .Ps
        !            66: ^Current\-Folder:~^To find the default current folder
        !            67: .Ps
        !            68: ^Unseen\-Sequence:~^To name sequences denoting unseen messages
        !            69: .Ps
        !            70: ^showproc:~^Program to show messages
        !            71: .Sa
        !            72: mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
        !            73: .De
        !            74: `+folder' defaults to the current folder
        !            75: .Ds
        !            76: `msgs' defaults to cur
        !            77: .Ds
        !            78: `\-format'
        !            79: .Ds
        !            80: `\-header'
        !            81: .Co
        !            82: If a folder is given, it will become the current folder.
        !            83: The last message shown will become the current message.
        !            84: .Bu
        !            85: The `\-header' switch doesn't work when `msgs' expands to more than
        !            86: one message.
        !            87: If the \fIshowproc\fR is \fImhl\fR,
        !            88: then is problem can be circumvented by referencing
        !            89: the \*(lqmessagename\*(rq field in the \fImhl\fR format file.
        !            90: 
        !            91: \fIShow\fR updates the user's context before showing the message.
        !            92: Hence if \fIshow\fR will mark messages as seen prior to the user
        !            93: actually seeing them.
        !            94: This is generally not a problem,
        !            95: unless the user relies on the \*(lqunseen\*(rq messages mechanism,
        !            96: and interrupts \fIshow\fR while it is showing \*(lqunseen\*(rq messages.
        !            97: 
        !            98: If \fIshowproc\fR is \fImhl\fR,
        !            99: then \fIshow\fR uses a built\-in \fImhl\fR:
        !           100: it does not actually run the \fImhl\fR program.
        !           101: Hence, if you define your own \fIshowproc\fR,
        !           102: don't call it \fImhl\fR since \fIshow\fR won't run it.
        !           103: 
        !           104: If \fImore\fR\0(1) is your showproc (the default),
        !           105: then avoid running \fIshow\fR in the background
        !           106: with only its standard output piped to another process, as in
        !           107: 
        !           108: .ti +.5i
        !           109: show | imprint &
        !           110: 
        !           111: Due to a bug in \fImore\fR,
        !           112: show will go into a \*(lqtty input\*(rq state.
        !           113: To avoid this problem,
        !           114: re\-direct \fIshow\fR's diagnostic output as well.
        !           115: For users of \fIcsh\fR:
        !           116: 
        !           117: .ti +.5i
        !           118: show |& imprint &
        !           119: 
        !           120: For users of \fIsh\fR:
        !           121: 
        !           122: .ti +.5i
        !           123: show 2>&1 | imprint &
        !           124: .En

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.