home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / 1_1_contri / usd / 08_mh / news_me < prev    next >
Encoding:
Text File  |  1986-04-15  |  2.6 KB  |  101 lines
  1. .\"    This file is automatically generated.  Do not edit!
  2. .NC NEWS
  3. .NA
  4. news \- show news
  5. .SY
  6. news
  7. \%[topic\ ...]
  8. \%[\-check]
  9. \%[\-display]
  10. \%[\-update]
  11. \%[\-review\ [topic]]
  12. \%[\-send\ topic]
  13. \%[\-topics]
  14. \%[\-help]
  15. .SH DESCRIPTION
  16. \fINews\fR is an \fIMH\fR program which checks, displays, reviews, 
  17. or sends news.
  18. A pseudo-user called `news' acts as an automated
  19. custodian for news items on various topics.
  20. These topics are managed as \fIMH\fR folders in the home directory of news.
  21. Mail sent to `news.everyone', for instance, will get
  22. filed in the `everyone' news folder.
  23.  
  24. You can explicitly select the group of news topics you want
  25. to check or display by specifying them as arguments to the
  26. \fInews\fR command.
  27. If you don't explicitly select topics in this way,
  28. the topic `everyone' is selected by default.
  29. Additional default topics can be selected by listing them on a
  30. \&``News\-Topics:'' line in your MH profile.
  31. The profile line
  32. must contain a blank-separated list of topics.
  33. As a special case, the profile line:
  34.  
  35.     \&``News\-Topics:\ *''
  36.  
  37. means you want to keep track of all news.
  38.  
  39. \&``\fINews \fB\-topics\fR''
  40. will show you what topics exist and
  41. the number of messages in each.
  42. Topics selected are marked with asterisks.
  43. \&``\fINews \fB\-help\fR''
  44. is like
  45. \&``\fInews \fB\-topics\fR''
  46. except that it also displays the syntax of the
  47. .I news
  48. command.
  49.  
  50. \&``\fINews \fB\-check\fR''
  51. will report the existence of unread news in the selected topics.
  52. .I News
  53. without any option arguments
  54. will display all unread news items from
  55. all selected topics.
  56. \&``\fINews \fB\-display\fR''
  57. is identical to
  58. .I news
  59. without an argument, but it suppresses the
  60. no news message (useful in login scripts).
  61. \&``\fINews \fB\-review\fR [#] [topic]''
  62. will redisplay the last # (default all) items
  63. in the selected topics.
  64.  
  65. News stores in your MH profile the message number of the most recent news
  66. item it has shown you in each topic.
  67. \&``\fINews \fB\-update\fR''
  68. will update your MH profile to indicate no
  69. outstanding news items to be read.
  70.  
  71. \&``\fINews \fB\-send\fR topic''
  72. is identical to
  73. \&``mail news.topic''.
  74. The mail sent to news.topic is
  75. automatically filed in a folder with
  76. name topic.
  77.  
  78. Any unrecognized switches to
  79. .I news
  80. are sent along to
  81. .IR l (1)
  82. for displaying items, or to
  83. .IR mail (1)
  84. for sending a news item.
  85. .Fi
  86. ^$HOME/\&.mh\(ruprofile~^The user profile
  87. ^/usr/news/<topics>~^The news folders
  88. ^/usr/news/.<topics>~^The number of items in <topics>
  89. .Pr
  90. ^News-topics:~^Topics the user is interested in
  91. .Ps
  92. ^News-<topic>:~^Current message in news topics
  93. .Sa
  94. mh-mail(5), mh(1)
  95. .De
  96. `topic' defaults to \*(lqeveryone\*(rq
  97. .Co
  98. The current message in each news folder is maintained in the
  99. user's mh\(ruprofile.
  100. .En
  101.