{ "content": [ { "type": "text", "text": "# show (man)\n\n## NAME\n\nshow - display nmh messages\n\n## SYNOPSIS\n\nshow [-help] [-version] [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc program]\n[-header | -noheader] [-checkmime | -nocheckmime] [-concat | -noconcat] [switches for\nshowproc or showmimeproc]\n\n## DESCRIPTION\n\nshow lists each of the specified messages to the standard output (typically, the terminal).\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **FILES**\n- **PROFILE COMPONENTS**\n- **SEE ALSO**\n- **DEFAULTS**\n- **CONTEXT**\n- **BUGS**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "show", "section": "", "mode": "man", "summary": "show - display nmh messages", "synopsis": "show [-help] [-version] [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc program]\n[-header | -noheader] [-checkmime | -nocheckmime] [-concat | -noconcat] [switches for\nshowproc or showmimeproc]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [ { "name": "mhl", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/mhl/1/json" }, { "name": "mhshow", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/mhshow/1/json" }, { "name": "next", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/next/1/json" }, { "name": "prev", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/prev/1/json" }, { "name": "scan", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/scan/1/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 4, "subsections": [] }, { "name": "DESCRIPTION", "lines": 56, "subsections": [] }, { "name": "FILES", "lines": 2, "subsections": [] }, { "name": "PROFILE COMPONENTS", "lines": 6, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "DEFAULTS", "lines": 6, "subsections": [] }, { "name": "CONTEXT", "lines": 3, "subsections": [] }, { "name": "BUGS", "lines": 28, "subsections": [] } ], "sections": { "NAME": { "content": "show - display nmh messages\n", "subsections": [] }, "SYNOPSIS": { "content": "show [-help] [-version] [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc program]\n[-header | -noheader] [-checkmime | -nocheckmime] [-concat | -noconcat] [switches for\nshowproc or showmimeproc]\n", "subsections": [] }, "DESCRIPTION": { "content": "show lists each of the specified messages to the standard output (typically, the terminal).\n\nBy default, text (non-MIME) messages are filtered and displayed by the nmh command mhl. This\ncommand will display text messages in a nice, uniform format. It also allows you to config‐\nure the format of the displayed messages and which headers fields are shown. See the mhl(1)\nmanual page for the details about this command. This default can be changed by defining the\nshowproc profile component. Any switches not recognized by show, as well as -header and -no‐\nheader, are passed along to that program. To override the default and the showproc profile\ncomponent, use the -showproc program switch. For example, -showproc more will cause the more\nprogram to list the messages with no reformatting. Normally, this program is specified as\nthe showproc in the user's .mhprofile, rather than using a command line switch.\n\nBy default, non-text messages (MIME messages with multi-media contents) are processed and\ndisplayed by the nmh command mhshow. See the mhshow(1) manual page for details about this\ncommand. This default can changed by defining the showmimeproc profile component. Any\nswitches not recognized by show are passed along to that program. To override this default\nand the showmimeproc profile component, use the -showmimeproc program switch.\n\nNote that in some cases, show may invoke the showmimeproc even for textual contents. This\nwill happen for text messages that specify a transfer encoding (such as MIME quoted-printable\nor base64) or specify a character set that show doesn't believe can be displayed natively.\nThe appropriate locale(1) environment variables should be set to the terminal's native char‐\nacter set to avoid gratuitous invocations of the showmimeproc. See locale(1) for details\nabout these environment variables.\n\nThe option -checkmime (set by default) instructs show to test if any of the messages to be\ndisplayed are non-text (MIME) messages. If any are non-text, they are displayed by the pro‐\ngram showmimeproc, else they are displayed by the program showproc. The option -nocheckmime\ndisables this test and instructs show to use showproc, regardless of whether any of the mes‐\nsages are non-text (MIME) messages.\n\nThe -noshowproc switch will disable any formatting or paging of messages. It is equivalent\nto -nocheckmime -showproc cat. It is still accepted, but should be considered (somewhat) ob‐\nsolete.\n\nThe -header switch tells show to display a one-line description of the message being shown.\nThis description includes the folder and the message number.\n\nBy default show will concatenate all content under one pager. If you want each part to dis‐\nplayed separately, you can override the default behavior with -noconcat.\n\nIf no `msgs' are specified, the current message is used. Although it depends on the specific\nshowproc or showmimeproc, in the default setup when more than one message is specified, you\nwill be prompted for a prior to listing each message. Each message will be listed a\npage at a time, and when the end of page is reached, the program will wait for a or\n. If a is entered, it will print the next line, whereas will print\nthe next screenful.\n\nIf the standard output is not a terminal, no queries are made, and each file is listed with a\none-line header and two lines of separation.\n\n“show -draft” will list the file /draft if it exists.\n\nIf the profile entry “Unseen-Sequence” is present and non-empty, then show will remove each\nof the messages shown from each sequence named by the profile entry.\n", "subsections": [] }, "FILES": { "content": "$HOME/.mhprofile The user profile\n", "subsections": [] }, "PROFILE COMPONENTS": { "content": "Path: To determine the user's nmh directory\nCurrent-Folder: To find the default current folder\nUnseen-Sequence: To name sequences denoting unseen messages\nshowproc: Program to show text (non-MIME) messages\nshowmimeproc: Program to show non-text (MIME) messages\n", "subsections": [] }, "SEE ALSO": { "content": "mhl(1), mhshow(1), next(1), prev(1), scan(1)\n", "subsections": [] }, "DEFAULTS": { "content": "`+folder' defaults to the current folder\n`msgs' defaults to cur\n`-checkmime'\n`-header'\n`-concat'\n", "subsections": [] }, "CONTEXT": { "content": "If a folder is given, it will become the current folder. The last message selected will be‐\ncome the current message.\n", "subsections": [] }, "BUGS": { "content": "The -header switch doesn't work when `msgs' expands to more than one message. If the show‐\nproc is mhl, then this problem can be circumvented by referencing the “messagename” field in\nthe mhl format file.\n\nshow updates the user's context before showing the message. Hence show will mark messages as\nseen prior to the user actually seeing them. This is generally not a problem, unless the\nuser relies on the “unseen” messages mechanism, and interrupts show while it is showing “un‐\nseen” messages.\n\nIf your showproc is mhl (the default), then show uses a built-in mhl: it does not actually\nrun the mhl program. Hence, if you define your own showproc, don't call it mhl since show\nwon't run it.\n\nIf your showproc is the pager more, then avoid running show in the background with only its\nstandard output piped to another process, as in\n\nshow | imprint &\n\nDue to a bug in more, show will go into a “tty input” state. To avoid this problem, re-di‐\nrect show's diagnostic output as well. For users of csh:\n\nshow |& imprint &\n\nFor users of sh:\n\nshow 2>&1 | imprint &\n\nnmh-1.8 2016-03-24 SHOW(1mh)", "subsections": [] } } } }