home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / 1_1_contri / usd / 08_mh / show_me < prev    next >
Encoding:
Text File  |  1986-04-15  |  4.0 KB  |  125 lines
  1. .\"    This file is automatically generated.  Do not edit!
  2. .SC SHOW 1
  3. .NA
  4. show \- show (list) messages
  5. .SY
  6. show
  7. \%[+folder] \%[msgs]
  8. \%[\-draft]
  9. \%[\-header] \%[\-noheader]
  10. \%[\-showproc\ program] \%[\-noshowproc]
  11. \%[switches\ for\ \fIshowproc\fR]
  12. \%[\-help]
  13. .DE
  14. \fIShow\fR lists each of the specified messages to the standard
  15. output (typically, the terminal).
  16. Typically, the messages are listed exactly
  17. as they are, with no reformatting.
  18. A program named by the \fIshowproc\fR profile component is
  19. invoked to do the listing, and any switches not recognized by
  20. \fIshow\fR are passed along to that program.
  21. The default program is known as \fImore\fR\0(1).
  22. To override the default and the \fIshowproc\fR profile component,
  23. use the `\-showproc\ program' switch.
  24. For example, `\-show\ pr' will cause the \fIpr\fR\0(1) program to list the
  25. messages.
  26. The \fIMH\fR command \fImhl\fR can be used as a \fIshowproc\fR
  27. to show messages in a more uniform format.
  28. Normally, this program is specified as the \fIshowproc\fR is the user's
  29. \&.mh\(ruprofile.
  30. See \fImhl\fR\0(1) for the details.
  31. If the `\-noshowproc' option is specified,
  32. `/bin/cat' is used instead of \fIshowproc\fR.
  33.  
  34. The `\-header' switch tells \fIshow\fR to display a one\-line
  35. description of the message being shown.
  36. This description includes the folder and the message number.
  37.  
  38. If no `msgs' are specified, the current message is used.
  39. If more than one message is specified,
  40. \fImore\fR will prompt for a <RETURN> prior to listing each message.
  41. \fImore\fR will list each message, a page at a time.
  42. When the end of
  43. page is reached, \fImore\fR will ring the bell and wait for a <SPACE>
  44. or <RETURN>.
  45. If a <RETURN> is entered, \fImore\fR will print the next line,
  46. whereas <SPACE> will print the next screenful.
  47. To exit \fImore\fR, type \*(lqq\*(rq.
  48.  
  49. If the standard output is not a terminal, no queries are made,
  50. and each file is listed with a one\-line header and two lines of
  51. separation.
  52.  
  53. \*(lqshow \-draft\*(rq will list the file <mh\-dir>/draft if it
  54. exists.
  55.  
  56. If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
  57. then \fIshow\fR will remove each of the messages shown from each
  58. sequence named by the profile entry.
  59. This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
  60. by all \fIMH\fR commands which take `msgs' or `msg' arguments.
  61. .Fi
  62. ^$HOME/\&.mh\(ruprofile~^The user profile
  63. .Pr
  64. ^Path:~^To determine the user's MH directory
  65. .Ps
  66. ^Current\-Folder:~^To find the default current folder
  67. .Ps
  68. ^Unseen\-Sequence:~^To name sequences denoting unseen messages
  69. .Ps
  70. ^showproc:~^Program to show messages
  71. .Sa
  72. mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
  73. .De
  74. `+folder' defaults to the current folder
  75. .Ds
  76. `msgs' defaults to cur
  77. .Ds
  78. `\-format'
  79. .Ds
  80. `\-header'
  81. .Co
  82. If a folder is given, it will become the current folder.
  83. The last message shown will become the current message.
  84. .Bu
  85. The `\-header' switch doesn't work when `msgs' expands to more than
  86. one message.
  87. If the \fIshowproc\fR is \fImhl\fR,
  88. then is problem can be circumvented by referencing
  89. the \*(lqmessagename\*(rq field in the \fImhl\fR format file.
  90.  
  91. \fIShow\fR updates the user's context before showing the message.
  92. Hence if \fIshow\fR will mark messages as seen prior to the user
  93. actually seeing them.
  94. This is generally not a problem,
  95. unless the user relies on the \*(lqunseen\*(rq messages mechanism,
  96. and interrupts \fIshow\fR while it is showing \*(lqunseen\*(rq messages.
  97.  
  98. If \fIshowproc\fR is \fImhl\fR,
  99. then \fIshow\fR uses a built\-in \fImhl\fR:
  100. it does not actually run the \fImhl\fR program.
  101. Hence, if you define your own \fIshowproc\fR,
  102. don't call it \fImhl\fR since \fIshow\fR won't run it.
  103.  
  104. If \fImore\fR\0(1) is your showproc (the default),
  105. then avoid running \fIshow\fR in the background
  106. with only its standard output piped to another process, as in
  107.  
  108. .ti +.5i
  109. show | imprint &
  110.  
  111. Due to a bug in \fImore\fR,
  112. show will go into a \*(lqtty input\*(rq state.
  113. To avoid this problem,
  114. re\-direct \fIshow\fR's diagnostic output as well.
  115. For users of \fIcsh\fR:
  116.  
  117. .ti +.5i
  118. show |& imprint &
  119.  
  120. For users of \fIsh\fR:
  121.  
  122. .ti +.5i
  123. show 2>&1 | imprint &
  124. .En
  125.