home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / compsrcs / unix / volume01 / readnews.1 < prev    next >
Encoding:
Internet Message Format  |  1988-09-11  |  11.4 KB
  1. Date: Mon, 11 Feb 85 08:22:03 pst
  2. From: decvax!ihnp4!uw-beaver!entropy!dataio!bossert (John Bossert)
  3. Subject: Manual page for 2.10.2 readnews(1)
  4. Newsgroups: mod.sources
  5.  
  6. Some sites apparently didn't get this.  Hope it helps
  7.  
  8. #    This is a shell archive.
  9. #    Remove everything above and including the cut line.
  10. #    Then run the rest of the file through sh.
  11. -----cut here-----cut here-----cut here-----cut here-----
  12. #!/bin/sh
  13. # shar:    Shell Archiver
  14. #    Run the following text with /bin/sh to create:
  15. #    readnews.1
  16. # This archive created: Mon Feb 11 08:18:50 1985
  17. # By:    John Bossert (Data I/O Corporation, Redmond WA)
  18. sed 's/^X//' << \SHAR_EOF > readnews.1
  19. X.TH READNEWS 1 "15 January 1985"
  20. X.UC 4
  21. X.SH NAME
  22. X\fBreadnews\fR \- read news articles
  23. X.SH SYNOPSIS
  24. X\fBreadnews\fR
  25. X[\fB\-a\fR \fR[\fIdate\fR]]
  26. X[\fB\-n\fR \fInewsgroups\fR]
  27. X[\fB\-t\fR \fItitles\fR]
  28. X[\fB\-fhlMprux\fR]
  29. X[\fB\-c\fR \fR[\fImailer\fR]]
  30. X.br
  31. X
  32. X\fBreadnews\fR
  33. X\fB\-s\fR
  34. X.SH DESCRIPTION
  35. X.B Readnews 
  36. Xis a program for reading USENET news. 
  37. XIt permits the use of several interfaces,
  38. Xwith the \fImsgs\fR(1) interface as the default.
  39. X.PP
  40. X.B Readnews 
  41. Xwithout any arguments prints unread articles in the default subscription list.
  42. X.PP
  43. XThe following flags determine the selection of articles.
  44. X.TP 10
  45. X\fB\-a\fR \fR[\fIdate\fR]\fP
  46. XSelect articles posted after the given \fIdate\fR.
  47. XThe strict format for \fIdate\fR is of the form:
  48. X.nf
  49. X.ta 15m 20m
  50. X
  51. XDay Month Day-of-Month HH:MM:SS Year
  52. XSun Sep 16 12:00:00 1984
  53. X
  54. X.fi
  55. XHowever, some coloquialisms are buried in the source.
  56. XThe default value is sometime in 1970.
  57. X.RE
  58. X.TP 10
  59. X\fB\-c\fR \fR[\fImailer\fR]\fP
  60. XWrite all selected articles to a temporary file then invoke \fImailer\fR.
  61. XThe name of the temporary file is referenced as ``%''.
  62. XThus ``mail -f %'' will invoke "mail" on the temporary file 
  63. Xcontaining copies of the selected articles.
  64. XThe environment variable MAILER, 
  65. X(usually /bin/mail) defines the default mailer.
  66. X.TP 10
  67. X\fB\-f\fR 
  68. XDon't print followup articles.
  69. X.TP 10
  70. X\fB\-h\fR 
  71. XPrint articles in a less verbose format.
  72. XThis option is intended for use on terminals running at 300 baud.
  73. X.TP 10
  74. X\fB\-l\fR 
  75. XList only the titles of the selected articles.
  76. XThe \fI.newsrc\fR file is not updated.
  77. X.TP 10
  78. X\fB\-M\fR 
  79. XUse a \fIMail\fR(1)-like interface.
  80. X.TP 10
  81. X\fB\-n\fR \fInewsgroups\fR
  82. XSelect articles belonging to \fInewsgroups\fR.
  83. X.TP 10
  84. X\fB\-p\fR 
  85. XSend all selected articles to the standard output.
  86. X.TP 10
  87. X\fB\-r\fR
  88. XPrint the articles in reverse order.
  89. X.TP 10
  90. X\fB\-s\fR 
  91. XPrint the newsgroup subscription list.
  92. X.TP 10
  93. X\fB\-t\fR \fItitles\fR
  94. XSelect articles whose titles contain one of the strings specified by 
  95. X\fItitles\fR.
  96. X.TP 10
  97. X\fB\-u\fR
  98. XUpdate the 
  99. X.B .newsrc
  100. Xfile every 5 minutes,
  101. Xas in the case of an unreliable system.
  102. X(Note that if the .newsrc file is updated, the
  103. X.B x
  104. Xcommand will not restore it to its original contents.)
  105. X.TP 10
  106. X\fB\-x\fR
  107. XIgnore \fI.newsrc\fR file.
  108. XThat is, select articles that have already been read as well as new ones.
  109. X.B Readnews
  110. Xmaintains a \fI.newsrc\fR file in the your home directory that 
  111. Xspecifies all news articles already read.  
  112. XIt is updated at the end of each reading session unless the \fB\-x\fR
  113. Xoption was specified.
  114. XIf the environment variable NEWSRC is present,
  115. Xit should be the path name of a file to be used in place of .newsrc.
  116. X.PP
  117. XIf you wish, an options line may be placed in your \fI.newsrc\fR file.
  118. XThis line starts with the word
  119. X.B options
  120. X(left justified) followed by the list of standard options just as
  121. Xthey would be typed on the command line.
  122. XSuch a list may include:
  123. Xthe
  124. X\fB\-n\fR 
  125. Xflag along with a newsgroup list and/or
  126. Xthe
  127. X\fB\-r\fR
  128. Xor
  129. X\fB\-t\fR
  130. Xflag.  
  131. XContinuation lines begin with a space or tab character.
  132. X.SH ENVIRONMENT
  133. XOptions can be specified in the
  134. X.B NEWSOPTS
  135. Xenvironment parameter.  
  136. XWhere conflicts exist, options on the command line take precedence, 
  137. Xfollowed by the \fI.newsrc\fR,
  138. X.B options
  139. Xline, and lastly the
  140. X.B NEWSOPTS
  141. Xparameter.
  142. X.PP
  143. XIf
  144. X.B EDITOR
  145. Xis set, it will be used in place of the default editor on your system to
  146. Xedit replies and follow-ups.
  147. X.PP
  148. XWhen the user uses the reply command,
  149. Xthe environment parameter
  150. X.B MAILER
  151. Xwill be used to determine which mailer to use. 
  152. XThe default is usually /bin/mail.
  153. X.PP
  154. XIf
  155. X.B NAME
  156. Xis set, it will be used as your full name when posting news or
  157. Xsubmitting a follow-up. 
  158. XIf it is not set, the name will be taken from the file
  159. X.B .name
  160. Xin your home directory. 
  161. XIf this file is not present, the name will be taken from /etc/passwd.
  162. X.PP
  163. XIf
  164. X.B NEWSARCHIVE
  165. Xis set, a copy of any articles you post or follow-up to, 
  166. Xwill be saved in the specified file. 
  167. XIf it is the null string, they will be copied in 
  168. X.I author_copy
  169. Xin your home directory.
  170. X.PP
  171. XIf
  172. X.B NEWSBOX
  173. Xis present and equal to "directory", a request to save an article as
  174. X"filename" will cause the article to be saved as "directory/filename".
  175. XIf 
  176. X.B NEWSBOX
  177. Xis set to "directory/%s", a request to save an article in newsgroup
  178. X"newsgroup" as "filename" will save it in the pathname
  179. X"directory/newsgroup/filename".
  180. XThe portion of the pathname defined as $NEWSBOX must already exist.
  181. XThe subdirectories corresponding to news groups will be created as necessary.
  182. X.PP
  183. XIf
  184. X.B NEWSRC
  185. Xis set, it will be used in place of the .newsrc file in your home directory.
  186. X.PP
  187. XIf
  188. X.B ORGANIZATION
  189. Xis set, it will be used as the name of your organization whenever you
  190. Xpost an article. 
  191. XThe default is compiled in and is usually correct.
  192. XTypically, you would only use this if you were reading news at a
  193. Xsite other than normal. 
  194. X(Or if you are trying to be cute.)
  195. X.PP
  196. XIf the user so desires, he may specify a specific paging program for articles.
  197. XThe environment parameter
  198. X.B PAGER
  199. Xshould be set to the paging program.  
  200. XThe name of the article is referenced with a `%', as in the
  201. X\fB\-c\fR
  202. Xoption.  
  203. XIf no `%' is present, the article will be piped to the program.
  204. XPaging may be disabled by setting
  205. X.B PAGER
  206. Xto a null value.
  207. X.SH COMMANDS
  208. X.PP
  209. XThis section lists the commands you can type to the msgs and /bin/mail
  210. Xinterface prompts.
  211. XThe msgs interface will suggest some common commands in brackets.
  212. XTyping a carriage return is the same as typing the first command.
  213. XFor example, ``[ynq]'' means that the commands ``y'' (yes), ``n'' (no),
  214. Xand ``q'' (quit) are common responses, and that ``y'' is the default.
  215. X.sp
  216. X.ta 2.5i
  217. XCommand        Meaning
  218. X.IP y
  219. XYes.  Print current article.
  220. X.IP n
  221. XNo.  Skip this article.
  222. X.IP q
  223. XQuit.  The .newsrc file will be updated if 
  224. X\fB\-l\fR or \fB\-x\fR were not on the command line.
  225. X.IP c
  226. XCancel the article.  Only the author or the super user can do this.
  227. X.IP r
  228. XReply.  
  229. XReply to article's author via mail.
  230. XYou are placed in your EDITOR with a header specifying the
  231. XTo, Subject, and References lines derived from the original message.
  232. XYou may change or add headers, as appropriate.
  233. XEnter the text of the reply after the blank line, 
  234. Xand then exit the editor.  
  235. XThe resulting message is mailed to the author of the article.
  236. X.IP rd
  237. XReply directly.
  238. XYou are placed in MAILER (``mail'' by default) in reply to the author.
  239. XEnter the text of the reply and then control-D.
  240. X.IP f [\fItitle\fP]
  241. XSubmit a follow up article.
  242. XNormally you should leave off the title, 
  243. Xsince the system will generate one for you.
  244. XYou will be placed in your EDITOR to compose the text of the followup.
  245. X.IP fd
  246. XFollowup directly, without edited headers.  
  247. XThis is like \fBf\fR,
  248. Xbut the headers of the article are not included in the editor buffer.
  249. X.IP N [\fInewsgroup\fP]
  250. XGo to the next newsgroup or named newsgroup.
  251. X.IP s [\fIfile\fP]
  252. XSave.  
  253. XThe article is appended to the named file.
  254. XThe default is ``Articles''.
  255. XIf the first character of the file name is `|',
  256. Xthe rest of the file name is taken as the name of a program,
  257. Xwhich is executed with the text of the article as standard input.
  258. XIf the first character of the file name is `/', it is
  259. Xtaken as a full path name of a file.
  260. XIf $NEWSBOX (in the environment) is set to a full path name,
  261. Xand the file contains no `/', the file is saved in $NEWSBOX.
  262. XOtherwise, it is saved relative to $HOME.
  263. X.IP #
  264. XReport the name and size of the newsgroup.
  265. X.IP e
  266. XErase.  
  267. XForget that this article was read.
  268. X.IP h
  269. XPrint a more verbose header.
  270. X.IP H
  271. XPrint a very verbose header, 
  272. Xcontaining all known information about the article.
  273. X.IP U
  274. XUnsubscribe from this newsgroup and go on to the next newsgroup.
  275. X.IP d
  276. XRead a digest.  
  277. XBreaks up a digest into separate articles
  278. Xand permits you to read and reply to each piece.
  279. X.IP D [\fInumber\fP]
  280. XDecrypt.  
  281. XInvokes a Caesar decoding program on the body of the message.
  282. XThis is used to decrypt rotated jokes posted to net.jokes.
  283. XSuch jokes are usually obscene or otherwise offensive to some groups of people,
  284. Xand so are rotated to avoid accidental decryption by 
  285. Xpeople who would be offended.
  286. XThe title of the joke should indicate the nature of the problem,
  287. Xenabling people to decide whether to decrypt it or not.
  288. X.PP
  289. XNormally the Caesar program does a character frequency count on
  290. Xeach line of the article separately, 
  291. Xso that lines which are not rotated will be shown in plain text.
  292. XThis works well unless the line is short, 
  293. Xin which case it sometimes gets the wrong rotation.
  294. XAn explicit /fInumber/fR rotation (usually 13) may be 
  295. Xgiven to force a particular shift.
  296. X.IP v
  297. XPrint the current version of the news software.
  298. X.IP !
  299. XShell escape.
  300. X.IP \fInumber\fP
  301. XGo to \fInumber\fP.
  302. X.IP +[\fIn\fP]
  303. XSkip \fIn\fR articles.
  304. XThe articles skipped are recorded as ``unread'' and will be
  305. Xoffered to you again the next time you read news.
  306. X.IP \-
  307. XGo back to last article.
  308. XThis is a toggle, typing it twice returns you to the original article.
  309. X.IP x
  310. XExit.  
  311. XLike quit except that .newsrc is not updated.
  312. X.IP X \fIsystem\fP
  313. XTransmit article to the named system.
  314. X.PP
  315. XThe commands
  316. Xc, f, fd, r, rd, e, h, H, and s
  317. Xcan be followed by \-'s to refer to the previous article.
  318. XThus, when replying to an article using the msgs interface,
  319. Xyou should normally type ``r\-'' (or ``re-'') since by the time you enter
  320. Xa command, you are being offerred the next article.
  321. X.SH EXAMPLES
  322. X.TP 10
  323. X.B readnews
  324. XRead all unread articles using the
  325. X.IR msgs (1)
  326. Xinterface.  The
  327. X.I .newsrc
  328. Xfile is updated at the end of the session.
  329. X.TP 10
  330. X.B readnews \-c ``ed %'' \-l
  331. XInvoke the
  332. X.IR ed (1)
  333. Xtext editor on a file containing the titles of all unread articles.  The
  334. X.I .newsrc
  335. Xfile is
  336. X.B not
  337. Xupdated at the end of the session.
  338. X.TP 10
  339. X.B readnews \-n all !fa.all \-M \-r
  340. XRead all unread articles except articles whose newsgroups begin with
  341. X"fa." via
  342. X.IR Mail (1)
  343. Xin reverse order.  The
  344. X.I .newsrc
  345. Xfile is updated at the end of the session.
  346. X.TP 10
  347. X.B "readnews \-p \-n all \-a last thursday"
  348. XPrint every unread article since last Thursday.  The
  349. X.I .newsrc
  350. Xfile is
  351. Xupdated at the end of the session.
  352. X.TP 10
  353. X.B "readnews \-p > /dev/null &"
  354. XDiscard all unread news.
  355. XThis is useful after returning from a long trip.
  356. X.SH FILES
  357. X.PD 0
  358. X.TP 40
  359. X.RI /usr/spool/news/ newsgroup / number
  360. XNews articles
  361. X.TP 40
  362. X/usr/lib/news/active
  363. XActive newsgroups
  364. X.TP 40
  365. X/usr/lib/news/help
  366. XHelp file
  367. X.TP 40
  368. X~/.newsrc
  369. XOptions and list of previously read articles
  370. X.PD
  371. X.SH SEE ALSO
  372. X.BR checknews (1),
  373. X.BR inews (1),
  374. X.BR mail (1),
  375. X.BR news (5),
  376. X.BR newsrc (5),
  377. X.BR postnews (1),
  378. X.BR recnews (8),
  379. X.BR sendnews (8),
  380. X.BR uurec (8)
  381. X.SH AUTHORS
  382. XMatt Glickman
  383. X.br
  384. XMark Horton
  385. X.br
  386. XStephen Daniel
  387. X.br
  388. XTom R. Truscott
  389. SHAR_EOF
  390. #    End of shell archive
  391. exit 0
  392.  
  393.  
  394.