show(1) - phpMan

Command: man perldoc info search(apropos)  


SHOW(1mh)                                                                               SHOW(1mh)

NAME
       show - display nmh messages

SYNOPSIS
       show [-help] [-version] [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc pro-
            gram] [-header | -noheader] [-checkmime | -nocheckmime] [-concat | -noconcat]
            [switches for showproc or showmimeproc]

DESCRIPTION
       show  lists  each  of the specified messages to the standard output (typically, the termi-
       nal).

       By default, text (non-MIME) messages are filtered and displayed by the  nmh  command  mhl.
       This  command will display text messages in a nice, uniform format.  It also allows you to
       configure the format of the displayed messages and which headers fields  are  shown.   See
       the mhl(1) manual page for the details about this command.  This default can be changed by
       defining the showproc profile component.  Any switches not recognized by show, as well  as
       -header  and -noheader, are passed along to that program.  To override the default and the
       showproc profile component, use the -showproc program switch.  For example, -showproc more
       will  cause  the  more  program to list the messages with no reformatting.  Normally, this
       program is specified as the showproc in the user's .mh_profile, rather than using  a  com-
       mand line switch.

       By  default, non-text messages (MIME messages with multi-media contents) are processed and
       displayed by the nmh command mhshow.  See the mhshow(1) manual page for details about this
       command.   This  default  can changed by defining the showmimeproc profile component.  Any
       switches not recognized by show are passed along to that program.  To  override  this  de-
       fault and the showmimeproc profile component, use the -showmimeproc program switch.

       Note that in some cases, show may invoke the showmimeproc even for textual contents.  This
       will happen for text messages that specify a transfer encoding (such as MIME quoted-print-
       able  or base64) or specify a character set that show doesn't believe can be displayed na-
       tively.  The appropriate locale(1) environment variables should be set to  the  terminal's
       native  character  set  to  avoid gratuitous invocations of the showmimeproc.  See the lo-
       cale(1) man page for details about these environment variables.

       The option -checkmime (set by default) instructs show to test if any of the messages to be
       displayed  are  non-text  (MIME) messages.  If any are non-text, they are displayed by the
       program showmimeproc, else they  are  displayed  by  the  program  showproc.   The  option
       -nocheckmime  disables this test and instructs show to use showproc, regardless of whether
       any of the messages are non-text (MIME) messages.

       The -noshowproc switch will disable any formatting or paging of messages.  It  is  equiva-
       lent to -nocheckmime -showproc cat.  It is still accepted, but should be considered (some-
       what) obsolete.

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

       By  default  show  will concatenate all content under one pager.  If you want each part to
       displayed separately, you can override the default behavior with -noconcat.

       If no `msgs' are specified, the current message is used.  Although it depends on the  spe-
       cific  showproc or showmimeproc, in the default setup when more than one message is speci-
       fied, you will be prompted for a <RETURN> prior to listing  each  message.   Each  message
       will  be  listed  a  page at a time, and when the end of page is reached, the program will
       wait for a <SPACE> or <RETURN>.  If a <RETURN> is entered, it will print  the  next  line,
       whereas <SPACE> will print the next screenful.

       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  show  will  remove
       each of the messages shown from each sequence named by the profile entry.

FILES
       $HOME/.mh_profile          The user profile

PROFILE COMPONENTS
       Path:                To determine the user's nmh directory
       Current-Folder:      To find the default current folder
       Unseen-Sequence:     To name sequences denoting unseen messages
       showproc:            Program to show text (non-MIME) messages
       showmimeproc:        Program to show non-text (MIME) messages

SEE ALSO
       mhl(1), mhshow(1), next(1), prev(1), scan(1)

DEFAULTS
       `+folder' defaults to the current folder
       `msgs' defaults to cur
       `-checkmime'
       `-header'
       `-concat'

CONTEXT
       If  a  folder is given, it will become the current folder.  The last message selected will
       become the current message.

BUGS
       The -header switch doesn't work when `msgs' expands to more  than  one  message.   If  the
       showproc  is  mhl,  then this problem can be circumvented by referencing the "messagename"
       field in the mhl format file.

       show updates the user's context before showing the message.  Hence show will mark messages
       as  seen  prior to the user actually seeing them.  This is generally not a problem, unless
       the user relies on the "unseen" messages mechanism, and interrupts show while it is  show-
       ing "unseen" messages.

       If your showproc is mhl (the default), then show uses a built-in mhl: it does not actually
       run the mhl program.  Hence, if you define your own showproc, don't call it mhl since show
       won't run it.

       If  your  showproc  is the pager more, then avoid running show in the background with only
       its standard output piped to another process, as in

            show | imprint &

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

            show |& imprint &

       For users of sh:

            show 2>&1 | imprint &

nmh-1.7.1                                   2016-03-24                                  SHOW(1mh)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-10-04 22:44 @3.236.112.101 CrawledBy CCBot/2.0 (https://commoncrawl.org/faq/)
Valid XHTML 1.0!Valid CSS!