MAN page from Mandrake Other mh-6.8.4-7.i386.rpm

SHOW

Section: User Commands (1)
Updated: MH.6.8
Index

NAME

show - show (list) messages

SYNOPSIS

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

DESCRIPTION

Show lists each of the specified messages to the standardoutput (typically, the terminal).Typically, the messages are listed exactlyas they are, with no reformatting.A program named by the showproc profile component isinvoked to do the listing, and any switches not recognized byshow are passed along to that program.The default program is known as more (1).To override the default and the showproc profile component,use the `-showproc program' switch.For example, `-show pr' will cause the pr (1) program to list themessages.The MH command mhl can be used as a showprocto show messages in a more uniform format.Normally, this program is specified as the showproc is the user's.mh_profile.See mhl (1) for the details.If the `-noshowproc' option is specified,`/bin/cat' is used instead of showproc.

If you have messages with multi-media contents,the profile entry mhnproc defines the name of a program tomanipulate multi-media messages.(The mhn (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 mhnproc will be run instead ofshowproc.The use of the mhnproc can also be disabled if theenvironment variable NOMHNPROC is set.Note that the mhnproc may be invoked even for textual contents,depending on the character set involved.The environment variable MM_CHARSET should be set to the terminal'scharacter set to avoid gratuitous invocations of the mhnproc.

The `-header' switch tells show to display a one-linedescription 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,more will prompt for a <RETURN> prior to listing each message.more will list each message, a page at a time.When the end ofpage is reached, more will ring the bell and wait for a <SPACE>or <RETURN>.If a <RETURN> is entered, more will print the next line,whereas <SPACE> will print the next screenful.To exit more, type ``q''.

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 ofseparation.

``show -draft'' will list the file <mh-dir>/draft if itexists.

If the profile entry ``Unseen-Sequence'' is present and non-empty,then show will remove each of the messages shown from eachsequence named by the profile entry.This is similar to the ``Previous-Sequence'' profile entry supportedby all MH commands which take `msgs' or `msg' arguments.^$HOME/.mh_profile~^The user profile^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 contentmhl(1), more(1), next(1), pick(1), prev(1), scan(1)`+folder' defaults to the current folder`msgs' defaults to cur`-header'If a folder is given, it will become the current folder.The last message shown will become the current message.The `-header' switch doesn't work when `msgs' expands to more thanone message.If the showproc is mhl,then is problem can be circumvented by referencingthe ``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 useractually seeing them.This is generally not a problem,unless the user relies on the ``unseen'' messages mechanism,and interrupts show while it is showing ``unseen'' messages.

If showproc is mhl,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 more (1) is your showproc (the default),then avoid running show in the backgroundwith 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 &

This document was created byman2html,using the manual pages.