show.man

早期freebsd实现

SHOW(1)                BSD Reference Manual               SHOW(1)


NNAAMMEE
       show - show (list) messages

SSYYNNOOPPSSIISS
       show   [+folder]  [msgs]  [-draft]  [-header]  [-noheader]
            [-showproc program] [-noshowproc] [switches for _s_h_o_w_-
            _p_r_o_c] [-help]

DDEESSCCRRIIPPTTIIOONN
       _S_h_o_w  lists each of the specified messages to the standard
       output (typically, the terminal).  Typically, the messages
       are  listed  exactly as they are, with no reformatting.  A
       program named by the _s_h_o_w_p_r_o_c profile component is invoked
       to do the listing, and any switches not recognized by _s_h_o_w
       are passed along to that program.  The default program  is
       known  as _m_o_r_e (1).  To override the default and the _s_h_o_w_-
       _p_r_o_c  profile  component,  use   the   `-showproc program'
       switch.   For  example,  `-show pr'  will cause the _p_r (1)
       program to list the messages.  The _M_H command _m_h_l  can  be
       used as a _s_h_o_w_p_r_o_c to show messages in a more uniform for-
       mat.  Normally, this program is specified as the  _s_h_o_w_p_r_o_c
       is  the  user's .mh_profile.  See _m_h_l (1) for the details.
       If the `-noshowproc' option is  specified,  `/bin/cat'  is
       used instead of _s_h_o_w_p_r_o_c.

       If  you  have messages with multi-media contents, the pro-
       file entry _m_h_n_p_r_o_c defines the name of a program to manip-
       ulate  multi-media  messages.  (The _m_h_n (1) program, which
       is suitable for this purpose, is  the  default.)   If  the
       `-noshowproc'  option is NOT specified, and if one or more
       named messages has a multi-media content, then the program
       indicated by _m_h_n_p_r_o_c will be run instead of _s_h_o_w_p_r_o_c.  The
       use of the _m_h_n_p_r_o_c can also be disabled if the environment
       variable  $$NNOOMMHHNNPPRROOCC is set.  Note that the _m_h_n_p_r_o_c may be
       invoked even for textual contents, depending on the  char-
       acter  set involved.  The environment variable $MM_CHARSET
       should be set to the terminal's  character  set  to  avoid
       gratuitous invocations of the _m_h_n_p_r_o_c.

       The  `-header'  switch  tells  _s_h_o_w  to display a one-line
       description of the message being shown.  This  description
       includes the folder and the message number.

       If  no  `msgs' are specified, the current message is used.
       If more than one message is specified,  _m_o_r_e  will  prompt
       for  a  <RETURN> prior to listing each message.  _m_o_r_e will
       list each message, a page at a time.  When the end of page
       is reached, _m_o_r_e will ring the bell and wait for a <SPACE>
       or <RETURN>.  If a <RETURN> is entered,  _m_o_r_e  will  print
       the next line, whereas <SPACE> will print the next screen-
       ful.  To exit _m_o_r_e, type "q".



[mh.6]                        MH.6.8                            1








SHOW(1)                BSD Reference Manual               SHOW(1)


       If the standard output is not a terminal, no  queries  are
       made,  and  each file is listed with a one-line header and
       two lines of separation.

       "show -draft" will list  the  file  <mh-dir>/draft  if  it
       exists.

       If  the  profile  entry  "Unseen-Sequence"  is present and
       non-empty, then _s_h_o_w will  remove  each  of  the  messages
       shown from each sequence named by the profile entry.  This
       is similar to the "Previous-Sequence" profile  entry  sup-
       ported by all _M_H commands which take `msgs' or `msg' argu-
       ments.

FFIILLEESS
       $HOME/.mh_profile                         The user profile

PPRROOFFIILLEE CCOOMMPPOONNEENNTTSS
       Path:                To determine the user's MH directory
       Current-Folder:      To find the default current folder
       Unseen-Sequence:     To name sequences denoting unseen messages
       showproc:            Program to show messages
       mhnproc:             Program to show messages with multi-media content

SSEEEE AALLSSOO
       mhl(1), more(1), next(1), pick(1), prev(1), scan(1)

DDEEFFAAUULLTTSS
       `+folder' defaults to the current folder
       `msgs' defaults to cur
       `-header'

CCOONNTTEEXXTT
       If a folder is given, it will become the  current  folder.
       The last message shown will become the current message.

BBUUGGSS
       The  `-header'  switch doesn't work when `msgs' expands to
       more than one message.  If the _s_h_o_w_p_r_o_c is  _m_h_l,  then  is
       problem  can  be circumvented by referencing the "message-
       name" field in the _m_h_l format file.

       _S_h_o_w updates the user's context before  showing  the  mes-
       sage.   Hence _s_h_o_w will mark messages as seen prior to the
       user actually seeing them.  This is generally not a  prob-
       lem, unless the user relies on the "unseen" messages mech-
       anism, and interrupts _s_h_o_w while it  is  showing  "unseen"
       messages.

       If _s_h_o_w_p_r_o_c is _m_h_l, then _s_h_o_w uses a built-in _m_h_l: it does
       not actually run the _m_h_l program.  Hence,  if  you  define



[mh.6]                        MH.6.8                            2








SHOW(1)                BSD Reference Manual               SHOW(1)


       your  own _s_h_o_w_p_r_o_c, don't call it _m_h_l since _s_h_o_w won't run
       it.

       If _m_o_r_e (1) is your showproc  (the  default),  then  avoid
       running _s_h_o_w in the background with only its standard out-
       put piped to another process, as in

            show | imprint &

       Due to a bug in _m_o_r_e, show will  go  into  a  "tty  input"
       state.  To avoid this problem, re-direct _s_h_o_w's diagnostic
       output as well.  For users of _c_s_h:

            show |& imprint &

       For users of _s_h:

            show 2>&1 | imprint &




































[mh.6]                        MH.6.8                            3