diplodocus.org Git - nmh/blob - docs/historical/mh-jun-1982/man/show.1

   1 .TH SHOW 1 RAND
   2 .SH NAME
   3 show \- show (list) messages
   4 .SH SYNOPSIS
   5 show \%[+folder] \%[msgs] \%[\-format] \%[\-noformat] \%[\-pr] \%[\-nopr] \%[\-draft] \%[\-help]
   6 \%[\fIc\fR\ or\ \fIpr\fR\ switches]
   7 .SH DESCRIPTION
   8 \fIShow\fR lists each of the specified messages to the standard
   9 output (typically, the terminal).
  10 The messages are listed exactly
  11 as they are, with no reformatting.
  12 A program named by the \fBshowproc\fR profile component is
  13 invoked to do the listing, and any switches not recognized by
  14 \fIshow\fR are passed along to that program.  The default
  15 program is known as \fIc\fR (also known as \fIl\fR).
  16 The mh command \fBmhl\fR can be used as a \fBshowproc\fR
  17 to show messages in a more uniform format.  See mhl(1).
  18 If the `-noformat' option is specified, `/bin/cat' is used
  19 instead of \fBshowproc\fR.
  20 The opposite of this is `-format', which is the default.
  21
  22 If no ``msgs'' are specified, the current message is used.
  23 If
  24 more than one message is specified, \fIc\fR will prompt for a
  25 <return> prior to listing each message.
  26
  27 \fIc\fR will list each message, a page at a time.
  28 When the end of
  29 page is reached, \fIc\fR will ring the bell and wait for a <RETURN>
  30 or <CTRL-D>.
  31 If a <return> is entered, \fIc\fR will clear the
  32 screen before listing the next page, whereas <CTRL-D> will not.
  33 The switches to \fIc\fR are
  34 `\-p#' to indicate the page length in lines, and `\-w#' to
  35 indicate the width of the page in characters.
  36
  37 If the standard output is not a terminal, no queries are made,
  38 and each file is listed with a one-line header and two lines of
  39 separation.
  40
  41 If `\-pr' is specified, then \fIpr\fR(I) will be invoked rather than
  42 \fIc\fR, and the switches (other than `\-draft') will be passed
  43 along.
  44 ``Show \-draft'' will list the file <mh-dir>/draft if it
  45 exists.
  46 .SH FILES
  47 .ta 2.4i
  48 $HOME/\*.mh\(ruprofile  The user profile
  49 .br
  50 /usr/ucb/c      Screen-at-a-time list program
  51 .br
  52 /bin/pr \fIpr\fR(I)
  53 .SH PROFILE COMPONENTS
  54 Path:   To determine the user's MH directory
  55 .br
  56 Current-Folder: To find the default current folder
  57 .br
  58 showproc:       Program to show message
  59 .br
  60 prproc:         Program to use for ``pr''
  61 .SH SEE ALSO
  62 next(1), prev(1), c(1), mhl(1)
  63 .SH DEFAULTS
  64 `+folder' defaults to current
  65 .br
  66 `msgs' defaults to cur
  67 .br
  68 `\-format'
  69 .br
  70 `\-nopr'
  71 .SH CONTEXT
  72 If a folder is given, it will become the current message.
  73 The last message
  74 listed will become the current message.