home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume7 / 2.11news / part02 < prev    next >
Text File  |  1986-11-30  |  62KB  |  2,471 lines
  1. Subject:  v07i042:  2.11 News Documentation and Conversion, Part02/08
  2. Newsgroups: mod.sources
  3. Approved: mirror!rs
  4.  
  5. Submitted by: seismo!rick (Rick Adams)
  6. Mod.sources: Volume 7, Issue 42
  7. Archive-name: 2.11news/Part02
  8.  
  9. # To extract, sh this file
  10. #
  11. #    This file contains the man pages for the 2.11 release of news.
  12. #
  13. if test ! -d man
  14. then
  15.     mkdir man
  16. fi
  17. echo x - man/Makefile 1>&2
  18. sed 's/.//' >man/Makefile <<'*-*-END-of-man/Makefile-*-*'
  19. -#
  20. -# Makefile for news manual pages
  21. -#
  22. -# If you install news documentation in an appropriately structured
  23. -#    man tree (e.g. /usr/local/man) then you can do this better
  24. -#
  25. -
  26. -DESTDIR =
  27. -MANDIR = /usr/man/mann
  28. -
  29. -MANFILES = checknews.1 expire.8 getdate.3 inews.8 news.5 newsrc.5 postnews.1 \
  30. -    readnews.1 recnews.8 sendbatch.8 sendnews.8 uurec.8 vnews.1
  31. -NMANFILES = checknews.n expire.n getdate.n inews.n news.n newsrc.n postnews.n \
  32. -    readnews.n recnews.n sendbatch.n sendnews.n uurec.n vnews.n
  33. -
  34. -.SUFFIXES: .n .1 .3 .5 .8
  35. -
  36. -.1.n .3.n .5.n .8.n:
  37. -    cp $< $@
  38. -
  39. -all: $(NMANFILES)
  40. -
  41. -install: $(NMANFILES)
  42. -    -for i in $(NMANFILES); do (install -c -m 0444 $$i $(DESTDIR)$(MANDIR)); done
  43. -
  44. -clean:
  45. -    rm -f $(NMANFILES)
  46. *-*-END-of-man/Makefile-*-*
  47. echo x - man/checknews.1 1>&2
  48. sed 's/.//' >man/checknews.1 <<'*-*-END-of-man/checknews.1-*-*'
  49. -.if n .ds La '
  50. -.if n .ds Ra '
  51. -.if t .ds La `
  52. -.if t .ds Ra '
  53. -.if n .ds Lq "
  54. -.if n .ds Rq "
  55. -.if t .ds Lq ``
  56. -.if t .ds Rq ''
  57. -.de Ch
  58. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  59. -..
  60. -.TH CHECKNEWS 1 "October 19, 1986"
  61. -.ds ]W  Version B 2.11
  62. -.SH NAME
  63. -checknews \- check to see if user has news
  64. -.SH SYNOPSIS
  65. -.BR checknews " [ " -ynqevvN " ]  ["
  66. -.IR "newsgroup list" " ]  ["
  67. -.IR "readnews options" " ]"
  68. -.SH DESCRIPTION
  69. -.I Checknews
  70. -reports whether or not the user has news.
  71. -.TP 10
  72. -.B \-y
  73. -reports \*(LqThere is news\*(Rq if the user has news to read.
  74. -If the
  75. -.B \-N
  76. -flag is given,
  77. -then the newsgroups requested are also printed.
  78. -.TP 10
  79. -.B \-n
  80. -reports \*(RqNo news\*(Rq if there isn't any news to read.
  81. -.TP 10
  82. -.B \-q
  83. -causes
  84. -.I checknews
  85. -to be quiet.
  86. -Instead of printing a message, the exit status indicates news.
  87. -A status of 0 means no news, 1 means there is news.
  88. -.TP 10
  89. -.B \-v
  90. -alters the
  91. -.B \-y
  92. -message to show the name of the first newsgroup containing unread news.
  93. -Doubling
  94. -.B v
  95. -(e.g.
  96. -.BR \-vv )
  97. -will cause an explanation of
  98. -.I any
  99. -claim of new news,
  100. -and is useful if
  101. -.I checknews
  102. -and
  103. -.IR readnews (1)
  104. -disagree on whether there is news.
  105. -.TP 10
  106. -.B \-e
  107. -executes
  108. -.I readnews
  109. -if there is news.
  110. -.TP 10
  111. -.B \-N
  112. -causes the next argument to be read and interpreted as
  113. -a comma-separated list of newsgroups to be checked.
  114. -.PP
  115. -If there are no options,
  116. -.B \-y
  117. -is the default.
  118. -.SH FILES
  119. -.PD 0
  120. -.TP 40
  121. -~/.newsrc
  122. -Active newsgroups
  123. -.TP 40
  124. -/usr/lib/news/active
  125. -Options and list of previously read articles
  126. -.SH SEE ALSO
  127. -inews(8),
  128. -postnews(1),
  129. -readnews(1),
  130. -vnews(1),
  131. -news(5),
  132. -newsrc(5),
  133. -expire(8),
  134. -recnews(8),
  135. -sendnews(8),
  136. -uurec(8)
  137. -.SH BUGS
  138. -.LP
  139. -The
  140. -.B \-N
  141. -flag should really be named
  142. -.B \-n
  143. -to be consistent with other news programs,
  144. -but
  145. -.B \-n
  146. -was already used.
  147. -If the
  148. -.B \-v
  149. -flag is used with the
  150. -.B \-N
  151. -flag, the first newsgroup in the list
  152. -where there is news should be printed instead of the entire list.
  153. -If the
  154. -.B \-N
  155. -flag is used and
  156. -.I readnews
  157. -is invoked (with
  158. -.BR \-e )
  159. -it does not restrict
  160. -news reading to those groups checked, but reads all newsgroups where there
  161. -is new news.
  162. *-*-END-of-man/checknews.1-*-*
  163. echo x - man/expire.8 1>&2
  164. sed 's/.//' >man/expire.8 <<'*-*-END-of-man/expire.8-*-*'
  165. -.if n .ds La '
  166. -.if n .ds Ra '
  167. -.if t .ds La `
  168. -.if t .ds Ra '
  169. -.if n .ds Lq "
  170. -.if n .ds Rq "
  171. -.if t .ds Lq ``
  172. -.if t .ds Rq ''
  173. -.de Ch
  174. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  175. -..
  176. -.TH EXPIRE 8 "October 14, 1986"
  177. -.ds ]W  Version B 2.11
  178. -.SH NAME
  179. -expire \- remove outdated news articles
  180. -.SH SYNOPSIS
  181. -.BR expire " [ " \-n
  182. -.IR newsgroups " ] ["
  183. -.BR \-i " ] [ " \-I " ] ["
  184. -.BR \-a " ] ["
  185. -.BI \-v " level"
  186. -] [
  187. -.B \-p
  188. -]
  189. -.br
  190. -            [
  191. -.B \-h
  192. -] [
  193. -.B \-r
  194. -] [
  195. -.BI \-e " days"
  196. -] [
  197. -.BI \-E " days"
  198. -]
  199. -.br
  200. -.B expire
  201. -.BI \-f " user@site.DOMAIN"
  202. -.br
  203. -.B expire
  204. -.B \-u
  205. -.SH DESCRIPTION
  206. -.PP
  207. -.I Expire
  208. -is the program that removes out-of-date news articles from your system.
  209. -You need to use a special program to do this, instead of just using
  210. -.I find(1)
  211. -or
  212. -.I rm(1),
  213. -because of the history file. If you just delete messages, then the history
  214. -file will become incorrect because it will show that they are still there.
  215. -.PP
  216. -The normal use of
  217. -.I expire
  218. -is to run it at regular intervals with no options.
  219. -It will remove all articles whose expiration date have passed.
  220. -If you have a lot of disk space, you can run it once a week. If disk space is
  221. -tight, you might want to run it every night. The time that it takes
  222. -to run depends, of course, on many factors; on a VAX 11/750 with a 15-day
  223. -expiration period and the volume of news that is typical in 1986 (about 5000
  224. -articles per week),
  225. -.I expire
  226. -will take roughly an hour to run.
  227. -.PP
  228. -.I Expire
  229. -has the following options:
  230. -.TP
  231. -.B \-n
  232. -Specify certain newsgroups whose articles will be expired. The other
  233. -newsgroups will be left alone. The notation that you use with the \-n option
  234. -is quite similar to that used in the sys file. To expire only the articles in
  235. -talk.origins, leaving everything else alone, type this:
  236. -.nf
  237. -    expire \-n talk.origins
  238. -.fi
  239. -To expire only the articles in comp.os, but leave comp.os.eunice and
  240. -comp.os.cpm alone, type this:
  241. -.nf
  242. -    expire \-n comp.os !comp.os.eunice !comp.os.cpm
  243. -.fi
  244. -For compatibility with the syntax of the sys file, you can also type the
  245. -command this way, with commas instead of spaces between the fields.
  246. -.nf
  247. -    expire \-n comp.os,!comp.os.eunice,!comp.os.cpm
  248. -.fi
  249. -If you have certain groups that you use as archives, which should never have
  250. -their articles expired, you must construct an
  251. -.I expire
  252. -command that mentions all groups except your archive groups. When doing this,
  253. -be sure not to forget the groups
  254. -.Ch junk ,
  255. -.Ch control ,
  256. -and
  257. -.Ch general .
  258. -A likely command would be:
  259. -.nf
  260. -    expire \-n all,!local.source,!all.sources
  261. -.fi
  262. -.TP
  263. -.B \-e
  264. -Specify an expiration period. Normally
  265. -.I expire
  266. -removes articles that are older than 15 days. If you would like it to remove
  267. -articles that are older than 5 days, you can type
  268. -.nf
  269. -    expire \-e 5
  270. -.fi
  271. -If you would like it to remove articles from talk.religion.misc and
  272. -talk.politics.misc that are older than
  273. -23 days, and leave everything else alone, you can type
  274. -.nf
  275. -    expire \-e 23 \-n talk.religion.misc talk.politics.misc
  276. -.fi
  277. -You can specify the \-e option as \-e15 instead of as \-e\ 15 if you want;
  278. -this is for compatibility with old versions and old habits.
  279. -.TP
  280. -\-E
  281. -Normally
  282. -.I expire
  283. -removes the record of an article from the history file at the same time it
  284. -removes the article. One of the purposes of the history file is to prevent
  285. -articles from being duplicated if a second copy arrives a while later,
  286. -perhaps over some other path. If your site is extremely short on disk space,
  287. -forcing you to specify a short expiration period in the \-e option, you can
  288. -use the \-E option to ask that the information in the history file be kept
  289. -round a bit longer, until the danger of duplicate arrival has passed. The
  290. -command
  291. -.nf
  292. -    expire \-e 7 \-E 21
  293. -.fi
  294. -Causes articles that are 7 or more days old to be removed, and history
  295. -information that is 21 or more days old to be removed. If you use the \-E
  296. -option, make sure that the value it specifies is always larger than the \-e
  297. -option value, else you will end up with articles that are not in the history
  298. -file; this can cause problems.
  299. -.TP
  300. -.B \-a
  301. -Asks that articles be archived (usually in /usr/spool/oldnews) instead of being deleted.
  302. -An example of its use would be
  303. -.nf
  304. -    expire \-a all.sources,!comp.sources.bugs
  305. -.fi
  306. -.B \-a 
  307. -may be used with 
  308. -.BR \-n .
  309. -If no pattern is given for 
  310. -.BR \-a ,
  311. -all newsgroups specified by 
  312. -.B \-n
  313. -will be archived.
  314. -.TP
  315. -.B \-I
  316. -instructs
  317. -.I expire
  318. -to ignore expiration dates stored in articles, and to look at the number of
  319. -days that have passed since the article was received. Not very many articles
  320. -have expiration dates in them.
  321. -.TP
  322. -.B \-i
  323. -is like \-I, but it will look at the number of days that have passed and also
  324. -at the explicit expiration date, and it will remove the article if either of
  325. -those has passed.
  326. -.TP
  327. -\-v
  328. -sets the verbosity mode. If you have specified a complex collection of
  329. -options and they are not having the effect that you would like, then set \-v2
  330. -or \-v3 to find out what is going on. Values from 0 to 6 are meaningful, and
  331. -\-v1 is the default. \-v0 will turn off messages, and \-v6 will cause
  332. -.I expire
  333. -to print every possible message.
  334. -.TP
  335. -\-p
  336. -causes
  337. -.I expire
  338. -to use the date the article was posted, rather than the date it arrived at
  339. -your machine, as the basis for expiration. Every now and then there is a
  340. -.Ch "time warp"
  341. -that causes a batch of very very old news to be dumped onto the
  342. -network; judicious use of the \-p option can eradicate it.
  343. -.TP
  344. -\-f
  345. -asks
  346. -.I expire
  347. -to remove messages sent by a particular user, regardless of the newsgroup
  348. -that they are in, and regardless of how old they are.
  349. -This option is intended not so much to selectively censor
  350. -voluminous posters (though it has certainly been used for that) but to
  351. -recover when a
  352. -.I notesfiles
  353. -site (running different news software) accidentally releases a duplicate
  354. -batch of old news. An example of its use is
  355. -.nf
  356. -    expire \-f rlr@pyuxd.UUCP
  357. -.fi
  358. -Any article whose From: field exactly matches the argument to the \-f option
  359. -will be removed.
  360. -.TP
  361. -\-h
  362. -causes
  363. -.I expire
  364. -to ignore the history file, and do its expiration by looking at every article
  365. -file in the spool directory. This is phenomenally slow\(emit can take 5 or 6
  366. -hours on an otherwise idle VAX 11/750\(embut if your history file is damaged and
  367. -you cannot use
  368. -.I find(1)
  369. -because you are relying on expiration dates stored inside articles, then you
  370. -have no other choice.
  371. -.TP
  372. -\-r
  373. -causes
  374. -.I expire
  375. -to rebuild the history file in addition to doing expiration.  The \-r option
  376. -implies the \-h option; it scans every article in the spool directory and
  377. -builds a new set of history and
  378. -.I dbm(3X)
  379. -files. It also performs expiration, so if you want to rebuild the history
  380. -file while preserving all articles (as you might want to do on an archival
  381. -file computer), you must specify
  382. -.nf
  383. -    expire \-r \-I \-e 999999 \-E 999999
  384. -.fi
  385. -to prevent expiration from taking place.
  386. -If you do not rely on expiration dates stored inside articles, it is a good
  387. -tonic to run the following sequence of commands once every now and then:
  388. -.nf
  389. -    find /usr/spool/news \-size 0 \-o \-mtime +90 \-exec rm \-f {} \;
  390. -    /usr/lib/news/expire \-r
  391. -.fi
  392. -This will remove junk files that have somehow managed to find their way into
  393. -the spooling directory, and then it will rebuild the history file.
  394. -.TP
  395. -\-u
  396. -causes the minimum article-number field in the active file to be updated.
  397. -This is used when converting from 2.10.1 news to later versions.
  398. -.SH SEE ALSO
  399. -inews(8),
  400. -postnews(1),
  401. -getdate(3),
  402. -news(5),
  403. -recnews(8),
  404. -sendnews(8),
  405. -uurec(8)
  406. -.SH BUGS
  407. -.PP
  408. -The newsgroup pattern argument to the \-n option is limited to 1024
  409. -characters, which is about 8 lines of text.
  410. *-*-END-of-man/expire.8-*-*
  411. echo x - man/getdate.3 1>&2
  412. sed 's/.//' >man/getdate.3 <<'*-*-END-of-man/getdate.3-*-*'
  413. -.if n .ds La '
  414. -.if n .ds Ra '
  415. -.if t .ds La `
  416. -.if t .ds Ra '
  417. -.if n .ds Lq "
  418. -.if n .ds Rq "
  419. -.if t .ds Lq ``
  420. -.if t .ds Rq ''
  421. -.de Ch
  422. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  423. -..
  424. -.TH GETDATE 3 "May 26, 1986"
  425. -.ds ]W  Version B 2.11
  426. -.SH NAME
  427. -getdate \- convert time and date from \s-2ASCII\s0
  428. -.SH SYNOPSIS
  429. -.B #include <sys/types.h>
  430. -.br
  431. -.B #include <sys/timeb.h>
  432. -.PP
  433. -.B time_t getdate(buf, now)
  434. -.br
  435. -.B char *buf;
  436. -.br
  437. -struct timeb *now;
  438. -.SH DESCRIPTION
  439. -.I Getdate
  440. -is a routine that converts most common time specifications to standard UNIX
  441. -format.  The first argument is the character string containing the
  442. -time and date; the second is the assumed current time (used for relative
  443. -specifications); if
  444. -.B NULL
  445. -is passed,
  446. -.IR ftime (3C)
  447. -is used to obtain the current time and timezone.
  448. -.PP
  449. -The character string consists of 0 or more specifications of the following
  450. -form:
  451. -.TP .75i
  452. -tod
  453. -A
  454. -.I tod
  455. -is a time of day, which is of the form
  456. -.IR hh [: mm [: ss ]]
  457. -(or
  458. -.IR hhmm )
  459. -.RI [ meridian ]
  460. -.RI [ zone ].
  461. -If no meridian \-
  462. -.B am
  463. -or
  464. -.B pm
  465. -\- is specified, a 24-hour clock is used.  A
  466. -.I tod
  467. -may be specified as just
  468. -.I hh
  469. -followed by a
  470. -.IR meridian \&.
  471. -.TP .75i
  472. -date
  473. -A
  474. -.I date
  475. -is a specific month and day, and possibly a year.  Acceptable formats are
  476. -.IR mm/dd [ /yy ]
  477. -and
  478. -.IR "monthname dd" "[, " yy ]
  479. -If omitted, the year defaults to the
  480. -current year; if a year is specified
  481. -as a number less than 100, 1900 is added.
  482. -If a number not followed by a day or relative time unit occurs, it will
  483. -be interpreted as a year if a
  484. -.IR tod ,
  485. -.IR monthname ,
  486. -and
  487. -.I dd
  488. -have already been specified; otherwise, it will be treated as a
  489. -.IR tod .
  490. -This rule allows the output from
  491. -.IR date (1)
  492. -or
  493. -.IR ctime (3)
  494. -to be passed as input to
  495. -.IR getdate .
  496. -.TP .75i
  497. -day
  498. -A
  499. -.I day
  500. -of the week may be specified; the current day will be used if appropriate.
  501. -A
  502. -.I day
  503. -may be preceded by a
  504. -.IR number,
  505. -indicating which instance of that day is desired; the default is
  506. -.BR 1 .
  507. -Negative
  508. -.I numbers
  509. -indicate times past.  Some symbolic
  510. -.I numbers
  511. -are accepted:
  512. -.BR last ,
  513. -.BR next ,
  514. -and the ordinals
  515. -.B first
  516. -through
  517. -.B twelfth
  518. -.RB ( second
  519. -is ambiguous, and is not accepted as an ordinal number).
  520. -The symbolic number
  521. -.B next
  522. -is equivalent to
  523. -.BR 2 ;
  524. -thus,
  525. -.B "next monday"
  526. -refers not to the immediately coming Monday, but to the one a week later.
  527. -.TP .75i
  528. -relative time
  529. -Specifications relative to the current time are also accepted.  
  530. -The format is
  531. -.RI [ number "] " unit ;
  532. -acceptable units are
  533. -.BR year ,
  534. -.BR month ,
  535. -.BR fortnight ,
  536. -.BR week ,
  537. -.BR day ,
  538. -.BR hour ,
  539. -.BR minute ,
  540. -and
  541. -.BR second .
  542. -.PP
  543. -The actual date is formed as follows:  first, any absolute date and/or time
  544. -is processed and converted.  Using that time as the base, day-of-week
  545. -specifications are added; last, relative specifications are used.  If a
  546. -date or day is specified, and no absolute or relative time is given, midnight
  547. -is used.
  548. -Finally, a correction is applied so that the correct hour of the day is
  549. -produced after allowing for daylight savings time differences.
  550. -.PP
  551. -.I Getdate
  552. -accepts most common abbreviations for days, months, etc.; in particular,
  553. -it will recognize them with upper or lower case first letter, and will
  554. -recognize three-letter abbreviations for any of them, with or without
  555. -a trailing period.  Units, such as
  556. -.BR week s,
  557. -may be specified in the singular or plural.  Timezone and meridian
  558. -values may be in upper or lower case, and with or without periods.
  559. -.SH "SEE ALSO"
  560. -ctime(3), time(2)
  561. -.SH AUTHOR
  562. -Steven M. Bellovin (unc!smb)
  563. -.br
  564. -Dept. of Computer Science
  565. -.br
  566. -University of North Carolina at Chapel Hill
  567. -.SH BUGS
  568. -Because
  569. -.IR yacc (1)
  570. -is used to parse the date,
  571. -.I getdate
  572. -cannot be used a subroutine to any program that also needs
  573. -.IR yacc .
  574. -.br
  575. -The grammar and scanner are rather primitive; certain desirable and
  576. -unambiguous constructions are not accepted.  Worse yet, the meaning of
  577. -some legal phrases is not what is expected;
  578. -.B next week
  579. -is identical to
  580. -.BR "2 weeks" .
  581. -.br
  582. -The daylight savings time correction is not perfect, and can get confused
  583. -if handed times between midnight and 2:00 am on the days that the
  584. -reckoning changes.
  585. -.br
  586. -Because
  587. -.IR localtime (2)
  588. -accepts an old-style time format without zone information, attempting
  589. -to pass
  590. -.I getdate
  591. -a current time containing a different zone will probably fail.
  592. *-*-END-of-man/getdate.3-*-*
  593. echo x - man/inews.8 1>&2
  594. sed 's/.//' >man/inews.8 <<'*-*-END-of-man/inews.8-*-*'
  595. -.if n .ds La '
  596. -.if n .ds Ra '
  597. -.if t .ds La `
  598. -.if t .ds Ra '
  599. -.if n .ds Lq "
  600. -.if n .ds Rq "
  601. -.if t .ds Lq ``
  602. -.if t .ds Rq ''
  603. -.de Ch
  604. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  605. -..
  606. -.TH INEWS 8 "October 14, 1986"
  607. -.ds ]W  Version B 2.11
  608. -.SH NAME
  609. -inews \- submit news articles
  610. -.SH SYNOPSIS
  611. -.BR inews " [ " \-h " ]"
  612. -.BI \-t " title " \-n " newsgroups"
  613. -[
  614. -.BI \-e " expiration date"
  615. -] [
  616. -.BI \-f " sender name"
  617. -] [
  618. -.BI \-d " distribution"
  619. -] [
  620. -.BI \-F " references"
  621. -] [
  622. -.BI \-o " organization"
  623. -] [
  624. -.BI \-M
  625. -] [
  626. -.BI \-S
  627. -] [
  628. -.BI \-a " approvedby"
  629. -] [
  630. -.BI \-r " replyto"
  631. -] [
  632. -.BI \-x " dontsentto"
  633. -] [
  634. -.BI \-c " control-message"
  635. -]
  636. -.PP
  637. -.BI "inews \-p " filename
  638. -.PP
  639. -.BI "inews \-C " newsgroup
  640. -.PP
  641. -.BI "rnews \-U"
  642. -.SH DESCRIPTION
  643. -.I Inews
  644. -submits news articles to the USENET news network.
  645. -It is a raw interface called by news-posting programs.
  646. -You should not use
  647. -.I inews
  648. -directly. Most people use
  649. -.IR postnews (1)
  650. -to post news articles. Ultimately, of course,
  651. -.IR postnews (1)
  652. -and other news-posting programs call inews to do the actual submission.
  653. -.PP
  654. -The first form (no
  655. -.BI \-p
  656. -or
  657. -.BI \-C
  658. -options) is for submitting ordinary articles.
  659. -The body of the article will be read from the standard input.  A
  660. -.I title
  661. -(
  662. -.Ch Subject:
  663. -field)
  664. -must be specified (there is no default).
  665. -.PP
  666. -If
  667. -.IR expire (8)
  668. -is currently running or if 
  669. -.B SPOOLBATCH
  670. -was specified at compilation time, the articles may be spooled to
  671. -.I /usr/spool/news/.rnews
  672. -for later processing. Running 
  673. -.I "rnews \-U"
  674. -will unspool this articles.
  675. -.I "Rnews \-U"
  676. -is run automatically by expire when it is finished.
  677. -.PP
  678. -Each article is posted to one or more newsgroups. If the
  679. -.B \-n
  680. -flag is omitted, the list
  681. -will default to something like
  682. -.BR general .
  683. -If you wish to submit an article to multiple newsgroups, the
  684. -.I newsgroups
  685. -must be separated by commas and/or spaces.
  686. -.PP
  687. -The
  688. -.B \-e
  689. -flag is used to override the default expiration date. This is seldom
  690. -used.
  691. -.PP
  692. -The
  693. -.B \-f
  694. -flag specifies the article's sender.  Without this flag, the sender
  695. -defaults to the user's name.
  696. -If
  697. -.B \-f
  698. -is specified, the real sender's name will be included as a ``Sender:'' line
  699. -to prevent forged articles.
  700. -.PP
  701. -The
  702. -.B \-d
  703. -flag allows you to specify the maximum geographic distribution of your
  704. -article; for example, a distribution of
  705. -.Ch aus
  706. -limits distribution to Australia, and a distribution of
  707. -.Ch nj
  708. -limits distribution to New Jersey. There is no way to send a message from
  709. -California for distribution only in New Jersey\(emyour machine must be in the
  710. -distribution that you ask for.
  711. -.PP
  712. -The
  713. -.B \-r
  714. -flag allows you to specify the ``Reply-To:'' line in the article header.
  715. -.PP
  716. -The
  717. -.B \-x
  718. -flag says not to forward this article to the specified site despite
  719. -what the
  720. -.I /usr/lib/news/sys
  721. -file says.
  722. -.PP
  723. -The
  724. -.B \-F
  725. -flag is used to attach a list of related articles that this
  726. -message references; it creates the
  727. -.Ch References:
  728. -field of the posted article.
  729. -.PP
  730. -The
  731. -.B \-o
  732. -is used to override the default organization name.
  733. -.PP
  734. -The
  735. -.B \-M
  736. -and
  737. -.B \-a
  738. -flags are to be used only by the moderator of a moderated newsgroup. The
  739. -.B \-M
  740. -flag causes the
  741. -.Ch From:
  742. -and
  743. -.Ch Path:
  744. -fields of the article to be set to correct values for a moderated newsgroup.
  745. -The
  746. -.B \-a
  747. -flag is used to add an
  748. -.Ch Approved:
  749. -line to the header. Note that if the
  750. -.B \-M
  751. -flag is used in conjuction with the
  752. -.B \-h
  753. -flag (see below), the article headers must not have a
  754. -.Ch Path:
  755. -field in them already.
  756. -.PP
  757. -The
  758. -.B \-h
  759. -flag specifies that headers are present at the beginning of the
  760. -article, and these headers should be included with the article
  761. -header instead of as text. Everything before the first blank line in the
  762. -article is taken as a header field, and everything after that blank line is
  763. -taken to be part of the body of the message.
  764. -(This mechanism can be used to edit headers and supply additional
  765. -nondefault headers, but not to specify certain information,
  766. -such as the sender and article ID, that
  767. -.I inews
  768. -itself generates.)
  769. -.I Inews
  770. -will ignore nonstandard and misspelled header fields entered with the \-h
  771. -option.
  772. -.PP
  773. -The
  774. -.I \-c
  775. -flag is used to send a control message.
  776. -.PP
  777. -The
  778. -.I \-S
  779. -flag is used to override the automatic spooling option (if enabled).
  780. -It shold never be specified directly.  (It is normally used by
  781. -.IR "rnews \-U" .
  782. -.LP
  783. -When posting an article
  784. -.I inews
  785. -checks the environment for certain information about the sender. If
  786. -an environment variable
  787. -.B NAME
  788. -is defined,
  789. -.I inews
  790. -uses its value as the full name of the poster. If
  791. -.B NAME
  792. -is not defined,
  793. -\kx\f2$HOME\fP\h'|\nxu+2u'\f2$HOME/.name\fP
  794. -is checked and if it exists, its contents are used as the full name.
  795. -Otherwise, the system value (often in
  796. -.IR /etc/passwd )
  797. -is used.
  798. -This is useful if the system value cannot be set, or when
  799. -more than one person uses the same login.
  800. -If the environment variable
  801. -.B ORGANIZATION
  802. -is defined, then
  803. -.I inews
  804. -uses its value instead of the system
  805. -default organization name. If its value begins with a
  806. -.Ch / ,
  807. -then it is taken to be a file name, and
  808. -.I inews
  809. -takes the name of the organization from the contents of the file.
  810. -This is useful when a person uses a guest login and is
  811. -not primarily associated with the organization that owns the machine.
  812. -.LP
  813. -The second form (
  814. -.BI "inews \-p"
  815. -) is used for receiving articles from other machines. If
  816. -.I filename
  817. -is given, the article will be read from the file of that name; otherwise
  818. -the article will be read from the standard input.  An expiration date
  819. -need not be present and a reception date, if present, will be ignored.
  820. -.LP
  821. -When
  822. -.I inews
  823. -receives an article this way, it will check the history file to make sure
  824. -that the article is not already present, and it will make certain consistency
  825. -checks to make sure that the newsgroup names are legal and that the sys file
  826. -permits the article to be installed on the local machine. Once the article
  827. -passes those checks, it is installed in the appropriate directory on the
  828. -local machine. If the article fails those checks, it is installed in
  829. -newsgroup
  830. -.Ch junk
  831. -on the local machine. In any event,
  832. -.I inews
  833. -will then transmit the article to all systems that match in the sys file
  834. -and are not mentioned in the
  835. -.Ch Path:
  836. -field of the just-posted message. The details of this transmission are
  837. -determined by the contents of the sys file.
  838. -.LP
  839. -The third form (
  840. -.IB "inews \-C"
  841. -) is for creating new newsgroups. The use of this feature is
  842. -limited to certain users such as the super-user or news administrator.
  843. -.SH FILES
  844. -.PD 0
  845. -.TP 25
  846. -/usr/spool/news/.sys.nnn
  847. -temporary articles
  848. -.TP 25
  849. -/usr/spool/news/.rnews
  850. -spooled articles not yet processed by rnews \-U
  851. -.TP 25
  852. -.RI /usr/spool/news/ newsgroups / article_no.
  853. -Articles
  854. -.TP 25
  855. -/usr/lib/news/active
  856. -List of known newsgroups and highest local article numbers in each.
  857. -.TP 25
  858. -/usr/lib/news/seq
  859. -Sequence number of last article
  860. -.TP 25
  861. -/usr/lib/news/history
  862. -List of all articles currently stored on this machine.
  863. -.TP 25
  864. -/usr/lib/news/sys
  865. -System subscription list
  866. -.TP 25
  867. -/usr/lib/news/distributions
  868. -Suggested distribution code names
  869. -.PD
  870. -.SH "SEE ALSO"
  871. -Mail(1),
  872. -binmail(1),
  873. -mailx(1),
  874. -checknews(1),
  875. -msgs(1),
  876. -postnews(1),
  877. -readnews(1),
  878. -vnews(1),
  879. -getdate(3),
  880. -news(5),
  881. -newsrc(5),
  882. -expire(8),
  883. -recnews(8),
  884. -sendnews(8),
  885. -uurec(8)
  886. -.SH AUTHORS
  887. -Matt Glickman
  888. -.br
  889. -Mark Horton
  890. -.br
  891. -Stephen Daniel
  892. -.br
  893. -Tom Truscott
  894. -.br
  895. -Rick Adams
  896. *-*-END-of-man/inews.8-*-*
  897. echo x - man/news.5 1>&2
  898. sed 's/.//' >man/news.5 <<'*-*-END-of-man/news.5-*-*'
  899. -.if n .ds La '
  900. -.if n .ds Ra '
  901. -.if t .ds La `
  902. -.if t .ds Ra '
  903. -.if n .ds Lq "
  904. -.if n .ds Rq "
  905. -.if t .ds Lq ``
  906. -.if t .ds Rq ''
  907. -.de Ch
  908. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  909. -..
  910. -.TH NEWS 5 "July 5, 1986"
  911. -.ds ]W  Version B 2.11
  912. -.SH NAME
  913. -news \- USENET network news article, utility files
  914. -.SH DESCRIPTION
  915. -.PP
  916. -There are two formats of news articles:
  917. -.BR A " and " B.
  918. -.B A
  919. -format is the only format that version 1 netnews systems can read or write.
  920. -Systems running the version 2 netnews can read either format and there
  921. -are provisions for the version 2 netnews to write in
  922. -.BR A " format.  " A " format"
  923. -looks like this:
  924. -.LP
  925. -.BI A article-ID
  926. -.br
  927. -.I newsgroups
  928. -.br
  929. -.I path
  930. -.br
  931. -.I date
  932. -.br
  933. -.I title
  934. -.br
  935. -.I Body of article
  936. -.br
  937. -.LP
  938. -Only version 2 netnews systems can read and write
  939. -.BR B " format.  " B " format"
  940. -contains two extra pieces of information:  receipt date and expiration
  941. -date.  The basic structure of a
  942. -.B B
  943. -format file consists of a series of headers and then the body.  A header
  944. -field is defined as a line with a capital letter in the first column and
  945. -a colon somewhere on the line.  Unrecognized header fields are ignored.
  946. -News is stored in the same format transmitted, see
  947. -.I "Standard for the Interchange of USENET Messages"
  948. -for a full description.
  949. -The following fields are among those recognized:
  950. -.LP
  951. -.B From:
  952. -.IB user @ "host.domain[.domain ...]" " ("
  953. -.IB "Full Name" )
  954. -.br
  955. -.B Newsgroups:
  956. -.I Newsgroups
  957. -.br
  958. -.B Message-ID:
  959. -.BI < "Unique Identifier" >
  960. -.br
  961. -.B Subject:
  962. -.I descriptive title
  963. -.br
  964. -.B Date:
  965. -.I Date Posted
  966. -.br
  967. -.B Expires:
  968. -.I Expiration Date
  969. -.br
  970. -.B Reply-To:
  971. -.I Address for mail replies
  972. -.br
  973. -.B References:
  974. -.IR "Article ID of article this is a follow-up to" .
  975. -.br
  976. -.B Control:
  977. -.I Text of a control message
  978. -.LP
  979. -Here is an example of an article:
  980. -.LP
  981. -.in +10n
  982. -.nf
  983. -Path: cbosgd!mhuxj!mhuxt!eagle!jerry
  984. -From: jerry@eagle.uucp (Jerry Schwarz)
  985. -Newsgroups: net.general
  986. -Subject: Usenet Etiquette -- Please Read
  987. -Message-ID: <642@eagle.UUCP>
  988. -Date: Friday, 19 Nov 82 16:14:55 EST
  989. -Followup-To: net.news
  990. -Expires: Saturday, 1 Jan 83 00:00:00 EST
  991. -Organization: Bell Labs, Murray Hill
  992. -Lines: 42
  993. -
  994. -The body of the article comes here, after a blank line.
  995. -.fi
  996. -.in
  997. -.LP
  998. -The
  999. -.I sys
  1000. -file line has four fields, each separated by colons:
  1001. -.LP
  1002. -.IB system-name : subscriptions :\c
  1003. -.IB flags : "transmission command"
  1004. -.PP
  1005. -Of these fields, only the
  1006. -.IR system-name " and " subscriptions " need"
  1007. -to be present.
  1008. -.PP
  1009. -The
  1010. -.I system name
  1011. -is the name of the system being sent to.  The
  1012. -.I subscriptions
  1013. -is the list of newsgroups to be transmitted to the system.  The
  1014. -.I flags
  1015. -are a set of letters describing how the article should be transmitted.
  1016. -The default is
  1017. -.BR B \&.
  1018. -Valid flags include
  1019. -.B A
  1020. -(send in
  1021. -.B A
  1022. -format),
  1023. -.B B
  1024. -(send in
  1025. -.B B
  1026. -format),
  1027. -.B N
  1028. -(use \*(Lqihave/sendme\*(Rq protocol),
  1029. -.B U
  1030. -(use \*(Lquux \-c\*(Rq and the name of the stored article in a \*(Lq%s\*(Rq
  1031. -string).
  1032. -.LP
  1033. -The
  1034. -.I transmission command
  1035. -is executed by the shell with the article to be transmitted as the standard
  1036. -input.
  1037. -The default is
  1038. -.RI "\*(Lquux \- \-z \-r " sysname !rnews\*(Rq.
  1039. -Some examples:
  1040. -.LP
  1041. -.if n \{.in -2
  1042. -.    ll +3\}
  1043. -.B "xyz:net"
  1044. -.br
  1045. -.B "oldsys:net,mod,to.oldsys:A"
  1046. -.br
  1047. -.B "berksys:net,ucb::/usr/lib/news/sendnews \-b berksys\\:rnews"
  1048. -.br
  1049. -.B "arpasys:net,arpa::/usr/lib/news/sendnews \-a rnews@arpasys"
  1050. -.br
  1051. -.B "old2:net,mod:A:/usr/lib/sendnews \-o old2\\:rnews"
  1052. -.br
  1053. -.B "user:net.sf-lovers::mail user"
  1054. -.LP
  1055. -Somewhere in the
  1056. -.I sys
  1057. -file, there must be a line for the host system.  This line has no
  1058. -.IR flags " or " commands .
  1059. -A
  1060. -.Ch #
  1061. -as the first character in a line denotes a comment.
  1062. -A logical line may be continued to the next physical line by
  1063. -putting a \\ at end of the line.
  1064. -.LP
  1065. -The
  1066. -.IR history ,
  1067. -.IR active ,
  1068. -and
  1069. -.I ngfile
  1070. -files have one line per item.
  1071. -.SH SEE ALSO
  1072. -checknews(1),
  1073. -inews(8),
  1074. -postnews(1),
  1075. -readnews(1),
  1076. -vnews(1),
  1077. -getdate(3),
  1078. -expire(8),
  1079. -recnews(8),
  1080. -sendnews(8),
  1081. -uurec(8)
  1082. *-*-END-of-man/news.5-*-*
  1083. echo x - man/newsrc.5 1>&2
  1084. sed 's/.//' >man/newsrc.5 <<'*-*-END-of-man/newsrc.5-*-*'
  1085. -.if n .ds La '
  1086. -.if n .ds Ra '
  1087. -.if t .ds La `
  1088. -.if t .ds Ra '
  1089. -.if n .ds Lq "
  1090. -.if n .ds Rq "
  1091. -.if t .ds Lq ``
  1092. -.if t .ds Rq ''
  1093. -.de Ch
  1094. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1095. -..
  1096. -.TH NEWSRC 5 "October 19, 1986"
  1097. -.ds ]W  Version B 2.11
  1098. -.SH NAME
  1099. -newsrc \- information file for readnews(1) and checknews(1)
  1100. -.SH DESCRIPTION
  1101. -The
  1102. -.I .newsrc
  1103. -file contains the list of previously read articles and an optional
  1104. -options line for
  1105. -.IR readnews "(1) and " checknews (1).
  1106. -Each newsgroup that articles
  1107. -have been read from has a line of the form:
  1108. -.LP
  1109. -.IB newsgroup : " range"
  1110. -.LP
  1111. -The
  1112. -.I range
  1113. -is a list of the articles read.  It is basically a list of numbers
  1114. -separated by commas with sequential numbers collapsed with hyphens.
  1115. -For instance:
  1116. -.LP
  1117. -.B general: 1-78,80,85-90
  1118. -.br
  1119. -.B comp.laser-printers: 1-7
  1120. -.br
  1121. -.B news.misc: 1
  1122. -.br
  1123. -.B comp.ai! 1-5
  1124. -.br
  1125. -.LP
  1126. -If the
  1127. -.Ch :
  1128. -is replaced with an
  1129. -.Ch !
  1130. -(as in
  1131. -.B comp.ai
  1132. -above) the newsgroup
  1133. -is not subscribed to and will not be shown to the user.
  1134. -.LP
  1135. -An options line starts with the word
  1136. -.B options
  1137. -(left-justified).  Then there are the list of options just as they
  1138. -would be on the 
  1139. -.I readnews
  1140. -command line.  For instance:
  1141. -.LP
  1142. -.B "options \-n all !net.sf-lovers !mod.human-nets \-r"
  1143. -.br
  1144. -.B "options \-c \-r"
  1145. -.LP
  1146. -A string of lines beginning with a space or tab after the initial options
  1147. -line will be considered continuation lines.
  1148. -.SH FILES
  1149. -.TP 25
  1150. -~/.newsrc
  1151. -options and list of previously read articles
  1152. -.SH SEE ALSO
  1153. -checknews(1),
  1154. -readnews(1),
  1155. -vnews(1)
  1156. *-*-END-of-man/newsrc.5-*-*
  1157. echo x - man/postnews.1 1>&2
  1158. sed 's/.//' >man/postnews.1 <<'*-*-END-of-man/postnews.1-*-*'
  1159. -.if n .ds La '
  1160. -.if n .ds Ra '
  1161. -.if t .ds La `
  1162. -.if t .ds Ra '
  1163. -.if n .ds Lq "
  1164. -.if n .ds Rq "
  1165. -.if t .ds Lq ``
  1166. -.if t .ds Rq ''
  1167. -.de Ch
  1168. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1169. -..
  1170. -.TH POSTNEWS 1 "October 22, 1986"
  1171. -.ds ]W  Version B 2.11
  1172. -.SH NAME
  1173. -postnews \- submit news articles
  1174. -.SH SYNOPSIS
  1175. -.BR postnews " [ "
  1176. -.IR article " ]"
  1177. -.SH DESCRIPTION
  1178. -.I Postnews
  1179. -is a program that calls
  1180. -.IR inews (8)
  1181. -to submit news articles to USENET.
  1182. -The commands should be self-explanatory, however you may type
  1183. -.Ch ?
  1184. -to most prompts to get a list of the possible options (except
  1185. -for the \*(LqKeywords\*(Rq of the article, etc).
  1186. -It will prompt the user for the title of the article
  1187. -(which should be a phrase suggesting the subject,
  1188. -so that persons reading the news can tell if they
  1189. -are interested in the article), for the newsgroup,
  1190. -and for the distribution.
  1191. -.PP
  1192. -The distribution is typically a geographic region or corporate region.
  1193. -Typing
  1194. -.Ch ?
  1195. -will get you a list of the possible distributions. You should
  1196. -use the minimum distribution that will serve your purpose for
  1197. -posting the article. For example, if you are selling your car in New
  1198. -Jersey, it is doubtful that someone in California (or Europe) would
  1199. -be willing to buy it. If you don't restrict the distribution to your
  1200. -local area, you will cause this article to be transmitted unnecessarily
  1201. -around the world.  Currently, with a distribution of
  1202. -.BR world ,
  1203. -the article
  1204. -will be seen in the United States, Canada, Europe, Japan, Korea and
  1205. -other places.
  1206. -A distribution header will, if given, be included in the headers
  1207. -of the article, affecting where the article is distributed.
  1208. -.PP
  1209. -After entering the title, newsgroup, and distribution,
  1210. -the user will be placed in an editor.
  1211. -If
  1212. -.B EDITOR
  1213. -is set in the environment, that editor will be used.
  1214. -Otherwise,
  1215. -.I postnews
  1216. -defaults to
  1217. -.IR vi (1).
  1218. -.PP
  1219. -An initial set of headers containing the subject and newsgroups
  1220. -will be placed in the editor, followed by a blank line.
  1221. -The article should be appended to the buffer, after the blank line.
  1222. -The initial headers can be changed, or additional headers added,
  1223. -while in the editor, if desired.
  1224. -.PP
  1225. -After you have finished typing in your article, you have the
  1226. -option of sending it, listing it, quitting without sending it,
  1227. -editing the file again, or
  1228. -saving it in a file without sending it.
  1229. -.PP
  1230. -For posting news from a program, see
  1231. -.IR inews (8).
  1232. -.LP
  1233. -If the file
  1234. -.I /usr/lib/news/recording
  1235. -is present, it is taken as a list of
  1236. -\&\*(Lqrecordings\*(Rq to be shown to users posting news.
  1237. -(This is named after the recording you hear when you dial
  1238. -.Ch information
  1239. -in some parts of the U.S., asking you to stop and think if you really want do
  1240. -do this, but not actually preventing you.)
  1241. -The recording file contains lines of the form:
  1242. -.PP
  1243. -    newsgroup-specifier \fB\s-2TAB\s0\fP filename
  1244. -.PP
  1245. -for example:
  1246. -.PP
  1247. -    comp.all    comp.recording
  1248. -.br
  1249. -    local.all,!local.test local.recording
  1250. -.PP
  1251. -Any user posting an article to a newsgroup matching the pattern on
  1252. -the left will be shown the contents of the file on the right.
  1253. -The file is found in the
  1254. -.B LIBDIR
  1255. -directory (often
  1256. -.IR /usr/lib/news ).
  1257. -The user is then told to hit \s-2DEL\s0 to abort or \s-2RETURN\s0 to proceed.
  1258. -The intent of this feature is to help companies keep proprietary
  1259. -information from accidently leaking out.
  1260. -.SH FILES
  1261. -.PD 0
  1262. -.TP 25
  1263. -/usr/lib/news/active
  1264. -List of known newsgroups and highest local article numbers in each.
  1265. -.TP 25
  1266. -/usr/lib/news/distributions
  1267. -Suggested distribution code names
  1268. -.TP 25
  1269. -/usr/lib/news/newsgroups
  1270. -Descriptons of newsgroups
  1271. -.SH "SEE ALSO"
  1272. -inews(8),
  1273. -readnews(1),
  1274. -vi(1),
  1275. -news(5),
  1276. -expire(8)
  1277. *-*-END-of-man/postnews.1-*-*
  1278. echo x - man/readnews.1 1>&2
  1279. sed 's/.//' >man/readnews.1 <<'*-*-END-of-man/readnews.1-*-*'
  1280. -.if n .ds La '
  1281. -.if n .ds Ra '
  1282. -.if t .ds La `
  1283. -.if t .ds Ra '
  1284. -.if n .ds Lq "
  1285. -.if n .ds Rq "
  1286. -.if t .ds Lq ``
  1287. -.if t .ds Rq ''
  1288. -.de Ch
  1289. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1290. -..
  1291. -.TH READNEWS 1 "October 22, 1986"
  1292. -.ds ]W  Version B 2.11
  1293. -.SH NAME
  1294. -readnews \- read news articles
  1295. -.SH SYNOPSIS
  1296. -.BR readnews " ["
  1297. -.BI \-a " date"
  1298. -] [
  1299. -.BI \-n " newsgroups"
  1300. -] [
  1301. -.BI \-t " titles"
  1302. -] [
  1303. -.BR \-leprxhfuM " ] ["
  1304. -.BR \-c " ["
  1305. -.IR mailer " ] ]"
  1306. -.PP
  1307. -.B "readnews \-s"
  1308. -.PP
  1309. -.B "readnews \-K"
  1310. -.SH DESCRIPTION
  1311. -.I Readnews
  1312. -without argument prints unread articles.
  1313. -There are several interfaces available other than the default:
  1314. -.TP 10
  1315. -Flag
  1316. -Interface
  1317. -.TP 10
  1318. -.B \-M
  1319. -An interface to
  1320. -.IR mailx (1)
  1321. -or
  1322. -.IR Mail(1).
  1323. -.TP 10
  1324. -.B \-c
  1325. -A
  1326. -.IR binmail (1)\-like
  1327. -interface.
  1328. -.TP 10
  1329. -.BI "\-c " ``mailer''
  1330. -All selected articles written to a temporary file.  Then the mailer is
  1331. -invoked.  The name of the temporary file is referenced with a
  1332. -.Ch % .
  1333. -Thus, ``mail \-f %'' will invoke mail on a temporary file consisting of all
  1334. -selected messages.
  1335. -.TP 10
  1336. -.B \-p
  1337. -All selected articles are sent to the standard output.  No questions asked.
  1338. -.TP 10
  1339. -.B \-l
  1340. -Only the titles output.  The
  1341. -.I .newsrc
  1342. -file will not be updated.
  1343. -.TP 10
  1344. -.B \-e
  1345. -Like
  1346. -.B \-l
  1347. -but also updates the
  1348. -.I .newsrc
  1349. -file.
  1350. -.LP
  1351. -The
  1352. -.B \-r
  1353. -flag causes the articles to be printed in reverse order.  The
  1354. -.B \-f
  1355. -flag prevents any followup articles from being printed.  The
  1356. -.B \-h
  1357. -flag causes articles to be printed in a less verbose format,
  1358. -and is intended for terminals running at 300 baud.
  1359. -The
  1360. -.B \-u
  1361. -flag causes the
  1362. -.I .newsrc
  1363. -file to be updated every 5 minutes,
  1364. -in case of an unreliable system.
  1365. -(Note that if the
  1366. -.I .newsrc
  1367. -file is updated,
  1368. -the
  1369. -.B x
  1370. -command will not restore it to its original contents.)
  1371. -.PP
  1372. -The following flags determine the selection of articles.
  1373. -.TP 10
  1374. -.BI "\-n " newsgroups
  1375. -Select all articles that belong to
  1376. -.I newsgroups.
  1377. -.TP 10
  1378. -.BI "\-t " titles
  1379. -Select all articles whose titles contain one of the strings specified by
  1380. -.IR titles \&.
  1381. -.TP 10
  1382. -.BI "\-a " "\fR[\fP date \fR]\fP"
  1383. -Select all articles that were posted past the given
  1384. -.I date
  1385. -(in
  1386. -.IR getdate (3)
  1387. -format).
  1388. -.TP 10
  1389. -.B \-x
  1390. -Ignore
  1391. -.I .newsrc
  1392. -file.  That is, select articles that have already been read as well as new ones.
  1393. -.PP
  1394. -.I Readnews
  1395. -maintains a
  1396. -.I .newsrc
  1397. -file in the user's home directory that specifies all news articles
  1398. -already read.  It is updated at the end of each reading session in
  1399. -which the
  1400. -.BR \-x " or " \-l
  1401. -options weren't specified.
  1402. -If the environment variable
  1403. -.B NEWSRC
  1404. -is present, it should be the path
  1405. -name of a file to be used in place of
  1406. -.IR .newsrc \&.
  1407. -.PP
  1408. -If the user wishes, an options line may be placed in the
  1409. -.I .newsrc
  1410. -file.
  1411. -This line starts with the word
  1412. -.B options
  1413. -(left justified) followed by the list of standard options just as
  1414. -they would be typed on the command line.  Such a list may include:
  1415. -the
  1416. -.B \-n
  1417. -flag along with a newsgroup list; a favorite interface; and/or
  1418. -the
  1419. -.B \-r
  1420. -or
  1421. -.B \-t
  1422. -flag.  Continuation lines are specified by following lines
  1423. -beginning with a space or tab character.
  1424. -Similarly, options can be specified in the
  1425. -.B NEWSOPTS
  1426. -environment parameter.  Where conflicts exist, option on the command
  1427. -line take precedence, followed by the
  1428. -.I .newsrc
  1429. -.B options
  1430. -line, and lastly the
  1431. -.B NEWSOPTS
  1432. -parameter.
  1433. -.PP
  1434. -You can use the
  1435. -.B \-s
  1436. -flag to print the newsgroup subscription list.
  1437. -.PP
  1438. -If you haven't read news in a while (or if you have never read news!)
  1439. -you can do
  1440. -.I "readnews \-K"
  1441. -to Kill (mark as read) all of the articles in the groups to which
  1442. -you are subscribed.
  1443. -.PP
  1444. -When the user uses the reply command of the default or
  1445. -.IR binmail (1)
  1446. -interfaces, the environment parameter
  1447. -.B MAILER
  1448. -will be used to determine
  1449. -which mailer to use.  The default is
  1450. -.IR mail (1).
  1451. -.PP
  1452. -The user may specify a particular paging progam
  1453. -for articles.  The environment parameter
  1454. -.B PAGER
  1455. -should be set to
  1456. -the paging program.  The name of the article is referenced with
  1457. -a
  1458. -.Ch % ,
  1459. -as in the
  1460. -.B \-c
  1461. -option.  If no
  1462. -.Ch %
  1463. -is present, the article will be piped to the program.
  1464. -Paging may be disabled by setting
  1465. -.B PAGER
  1466. -to a null value.  By default, the pager is
  1467. -.IR cat (1).
  1468. -.SH "COMMANDS"
  1469. -.PP
  1470. -This section lists the commands you can type to the default and
  1471. -.I binmail
  1472. -interface prompts.
  1473. -The default interface will suggest some common commands in brackets.
  1474. -Just hitting return is the same as typing the first command.
  1475. -For example, \*(Lq[ynq]\*(Rq means that the commands
  1476. -.Ch y
  1477. -(yes),
  1478. -.Ch n
  1479. -(no),
  1480. -and
  1481. -.Ch q
  1482. -(quit) are common responses, and that
  1483. -.Ch y
  1484. -is the default.
  1485. -.sp
  1486. -.ta 2.5i
  1487. -Command        Meaning
  1488. -.IP \fB\-\fP
  1489. -Go back to last article.
  1490. -This is a toggle, typing it twice returns you to the original article.
  1491. -.IP \fB#\fP
  1492. -Report the name and size of the newsgroup.
  1493. -.IP \fB!\fP
  1494. -Shell escape.
  1495. -.IP "\fB<\fP\fImessage ID\fP\fB>\fP"
  1496. -Look for a particular article.
  1497. -(See
  1498. -.I
  1499. -Standard for Interchange of Usenet Messages
  1500. -for a description of message ID's).
  1501. -.IP \fBb\fP
  1502. -Back.  Back up one article.
  1503. -.IP \fBc\fP
  1504. -Cancel the article.  Only the author or the super user can do this.
  1505. -.IP \fBd\fP
  1506. -Read a digest.  Breaks up a digest into separate articles
  1507. -and permits you to read and reply to each piece.
  1508. -.IP \fBD\fP [\fInumber\fP]
  1509. -Decrypt.  Invokes a Caesar decoding program on the body of the message.
  1510. -This is used to decrypt rotated jokes posted to
  1511. -.BR rec.humor .
  1512. -Such jokes are usually obscene or otherwise offensive to some
  1513. -groups of people, and so are rotated to avoid accidental
  1514. -decryption by people who would be offended.
  1515. -The title of the joke should indicate the nature of the problem,
  1516. -enabling people to decide whether to decrypt it or not.
  1517. -.IP
  1518. -An explicit
  1519. -.I number
  1520. -rotation (usually 13) may be given to force a particular shift.
  1521. -.IP \fBe\fP
  1522. -Erase.  Forget that this article was read.
  1523. -.IP "\fBf\fP [\fItitle\fP]"
  1524. -Submit a follow up article.
  1525. -Normally you should leave off the title, since the system will generate
  1526. -one for you.
  1527. -You will be placed in your
  1528. -.B EDITOR
  1529. -to compose the text of the followup.
  1530. -.IP "\fBfd\fP"
  1531. -Followup directly, without edited headers.  This is like
  1532. -.BR f ,
  1533. -but the headers of the article are not included in the editor buffer.
  1534. -.IP \fBh\fP
  1535. -Header.  Print a more verbose header.
  1536. -.IP \fBH\fP
  1537. -Print a very verbose header, containing all known information
  1538. -about the article.
  1539. -.IP \fBK\fP
  1540. -Kill.  Mark all remaining articles in this newsgroup as read
  1541. -and skip to the next newsgroup.
  1542. -.IP \fBn\fP
  1543. -No.  Goes on to next article without printing current one.
  1544. -In the
  1545. -.I binmail
  1546. -interface, this means \*(Lqgo on to the next article\*(Rq,
  1547. -which will have the same effect as
  1548. -.B y
  1549. -or just hitting return.
  1550. -.IP "\fBN\fP [\fInewsgroup\fP]"
  1551. -Next Newsgroup.
  1552. -Go to the next newsgroup or named newsgroup.
  1553. -.IP \fBp\fP
  1554. -Print.  Reprint previous article.
  1555. -.IP \fBP\fP
  1556. -Previous Newsgroup.  Go back to previous newsgroup.
  1557. -.IP \fBq\fP
  1558. -Quit.  The
  1559. -.I .newsrc
  1560. -file will be updated if
  1561. -.B \-l
  1562. -or
  1563. -.B \-x
  1564. -were not on the command line.
  1565. -.IP r
  1566. -Reply.  Reply to article's author via
  1567. -.IR mail \&.
  1568. -You are placed in your
  1569. -.B EDITOR
  1570. -(by default
  1571. -.IR vi (1))
  1572. -with a header specifying
  1573. -\&\*(LqTo\*(Rq, \*(LqSubject\*(Rq, and \*(LqReferences\*(Rq
  1574. -lines taken from the message.
  1575. -You may change or add headers, as appropriate.
  1576. -You add the text of the reply after the blank line, and then exit
  1577. -the editor.  The resulting message is mailed to the author of the article.
  1578. -.IP \fBrd\fP
  1579. -Reply directly.
  1580. -You are placed in 
  1581. -.B MAILER
  1582. -.RI ( mail
  1583. -by default) in reply to the author.
  1584. -Type the text of the reply and then control-D.
  1585. -.IP "\fBs\fP [\fIfile\fP]"
  1586. -Save.  The article is appended to the named file.
  1587. -The default is
  1588. -.IR Articles \&.
  1589. -If the first character of the file name is
  1590. -.Ch | ,
  1591. -the rest of the file name is taken as the name of a program,
  1592. -which is executed with the text of the article as standard input.
  1593. -If the first character of the file name is
  1594. -.Ch / ,
  1595. -it is
  1596. -taken as a full path name of a file.
  1597. -If
  1598. -.B NEWSBOX
  1599. -(in the environment) is set to a full path name,
  1600. -and the file contains no
  1601. -.Ch / ,
  1602. -the file is saved in
  1603. -.BR NEWSBOX .
  1604. -Otherwise, it is saved relative to
  1605. -.BR HOME .
  1606. -.IP \fBU\fP
  1607. -Unsubscribe from this newsgroup. Also goes on to the next newsgroup.
  1608. -.IP \fBv\fP
  1609. -Print the current version of the news software.
  1610. -.IP \fBw\fP
  1611. -Same as
  1612. -.BR s .
  1613. -.IP \fBx\fP
  1614. -Exit.  Like quit except that
  1615. -.I .newsrc
  1616. -is not updated.
  1617. -.IP "\fBX\fP \fIsystem\fP"
  1618. -Transmit article to the named system.
  1619. -.IP \fBy\fP
  1620. -Yes.  Prints current article and goes on to next.
  1621. -.IP \fInumber\fP
  1622. -Go to \fInumber\fP.
  1623. -.IP \fB+\fP[\fIn\fP]
  1624. -Skip
  1625. -.I n
  1626. -articles.
  1627. -The articles skipped are recorded as ``unread'' and will be
  1628. -offered to you again the next time you read news.
  1629. -.PP
  1630. -The commands
  1631. -.BR c ,
  1632. -.BR f ,
  1633. -.BR fd ,
  1634. -.BR r ,
  1635. -.BR rd ,
  1636. -.BR e ,
  1637. -.BR h ,
  1638. -.BR H ,
  1639. -and
  1640. -.B s
  1641. -can be followed by
  1642. -.BR \- 's
  1643. -to refer to the previous article.
  1644. -Thus, when replying to an article using the default interface,
  1645. -you should normally type
  1646. -.B r\-
  1647. -(or
  1648. -.BR re- )
  1649. -since by the time you enter
  1650. -a command, you are being offered the next article.
  1651. -.SH EXAMPLES
  1652. -.TP 10
  1653. -.B readnews
  1654. -Read all unread articles using the default interface.  The
  1655. -.I .newsrc
  1656. -file is updated at the end of the session.
  1657. -.TP 10
  1658. -.B readnews \-c ``ed %'' \-l
  1659. -Invoke the
  1660. -.IR ed (1)
  1661. -text editor on a file containing the titles of all unread articles.  The
  1662. -.I .newsrc
  1663. -file is
  1664. -.B not
  1665. -updated at the end of the session.
  1666. -.TP 10
  1667. -.B readnews \-n all !talk \-M \-r
  1668. -Read all unread articles except articles whose newsgroups begin with
  1669. -.B talk.
  1670. -via
  1671. -.I mailx
  1672. -in reverse order.  The
  1673. -.I .newsrc
  1674. -file is updated at the end of the session.
  1675. -.TP 10
  1676. -.B "readnews \-p \-n all \-a last thursday"
  1677. -Print every unread article since last Thursday.  The
  1678. -.I .newsrc
  1679. -file is
  1680. -updated at the end of the session.
  1681. -.TP 10
  1682. -.B "readnews \-K"
  1683. -Discard all unread news.
  1684. -This is useful after returning from a long trip.
  1685. -.SH "ENVIRONMENT VARIABLES"
  1686. -.IP \fBEDITOR\fP
  1687. -Editor invoked by
  1688. -.B f
  1689. -command.  (Default is
  1690. -.IR /usr/ucb/vi .)
  1691. -.IP \fBMAILER\fP
  1692. -Mailing program invoked by the
  1693. -.B r
  1694. -command.  (Default is
  1695. -.IR /bin/mail .)
  1696. -.IP \fBNAME\fP
  1697. -Your full name used in header of articles posted by you.  (Default is
  1698. -the comments field of your id in
  1699. -.IR /etc/passwd .)
  1700. -.IP \fBNEWSBOX\fP
  1701. -File or directory where articles saved with the
  1702. -.B s
  1703. -command are stored.
  1704. -(Default is same as
  1705. -.BR HOME .)
  1706. -.IP \fBNEWSOPTS\fP
  1707. -Options for \fIreadnews\fR.
  1708. -.IP \fBORGANIZATION\fP
  1709. -Full name of this site used header of articles posted by you.
  1710. -.IP \fBPAGER\fP
  1711. -Paging program invoked by articles with more than 16 lines.  (Default
  1712. -is
  1713. -.IR /usr/ucb/more .)
  1714. -.IP \fBSHELL\fP
  1715. -The shell invoked by the
  1716. -.B !
  1717. -command.  (Default is
  1718. -.IR /bin/sh .)
  1719. -.SH FILES
  1720. -.PD 0
  1721. -.TP 25
  1722. -.RI /usr/spool/news/ newsgroup / number
  1723. -News articles
  1724. -.TP 25
  1725. -/usr/lib/news/active
  1726. -Active newsgroups and numbers of articles
  1727. -.TP 25
  1728. -/usr/lib/news/help
  1729. -Help file for default interface
  1730. -.TP 25
  1731. -~/.newsrc
  1732. -Options and list of previously read articles
  1733. -.PD
  1734. -.SH SEE ALSO
  1735. -binmail(1),
  1736. -checknews(1),
  1737. -inews(8),
  1738. -mail(1),
  1739. -mailx(1),
  1740. -news(5),
  1741. -newsrc(5)
  1742. -postnews(1),
  1743. -vnews(1),
  1744. -getdate(3),
  1745. -news(5),
  1746. -newsrc(5),
  1747. -expire(8),
  1748. -recnews(8),
  1749. -sendnews(8),
  1750. -uurec(8)
  1751. -.br
  1752. -.I
  1753. -How to Read the Network News
  1754. -by Mark Horton.
  1755. -.br
  1756. -.I
  1757. -Standard for Interchange of Usenet Messages
  1758. -by Mark Horton.
  1759. -.SH AUTHORS
  1760. -Matt Glickman
  1761. -.br
  1762. -Mark Horton
  1763. -.br
  1764. -Stephen Daniel
  1765. -.br
  1766. -Tom R. Truscott
  1767. -
  1768. *-*-END-of-man/readnews.1-*-*
  1769. echo x - man/recnews.8 1>&2
  1770. sed 's/.//' >man/recnews.8 <<'*-*-END-of-man/recnews.8-*-*'
  1771. -.if n .ds La '
  1772. -.if n .ds Ra '
  1773. -.if t .ds La `
  1774. -.if t .ds Ra '
  1775. -.if n .ds Lq "
  1776. -.if n .ds Rq "
  1777. -.if t .ds Lq ``
  1778. -.if t .ds Rq ''
  1779. -.de Ch
  1780. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1781. -..
  1782. -.TH RECNEWS 8 "May 26, 1986"
  1783. -.ds ]W  Version B 2.11
  1784. -.SH NAME
  1785. -recnews \- receive unprocessed articles via mail
  1786. -.SH SYNOPSIS
  1787. -.BR /usr/lib/news/recnews " [ "
  1788. -.IR newsgroup " [ " sender " ] ] "
  1789. -.SH DESCRIPTION
  1790. -.I Recnews
  1791. -reads a letter from the standard input; determines the article title,
  1792. -sender, and newsgroup; and gives the body to inews with the right
  1793. -arguments for insertion.
  1794. -.PP
  1795. -If
  1796. -.I newsgroup
  1797. -is omitted, the \*(LqTo:\*(Rq line of the letter will be used.  If
  1798. -.I sender
  1799. -is omitted, the sender will be determined from the \*(LqFrom\*(Rq line of the letter.
  1800. -The title is determined from the \*(LqSubject\*(Rq line.
  1801. -.SH SEE ALSO
  1802. -checknews(1),
  1803. -inews(8),
  1804. -postnews(1),
  1805. -readnews(1),
  1806. -vnews(1),
  1807. -news(5),
  1808. -sendnews(8),
  1809. -uurec(8)
  1810. *-*-END-of-man/recnews.8-*-*
  1811. echo x - man/sendbatch.8 1>&2
  1812. sed 's/.//' >man/sendbatch.8 <<'*-*-END-of-man/sendbatch.8-*-*'
  1813. -.if n .ds La '
  1814. -.if n .ds Ra '
  1815. -.if t .ds La `
  1816. -.if t .ds Ra '
  1817. -.if n .ds Lq "
  1818. -.if n .ds Rq "
  1819. -.if t .ds Lq ``
  1820. -.if t .ds Rq ''
  1821. -.TH SENDBATCH 8 "October 13, 1986"
  1822. -.ds ]W  Version B 2.11
  1823. -.SH NAME
  1824. -sendbatch \- send news articles in batches
  1825. -.SH SYNOPSIS
  1826. -.BR sendbatch " ["
  1827. -.BI \-s "size "
  1828. -] [
  1829. -.BI \-i " sitename"
  1830. -] [
  1831. -.BR \-c " ] ["
  1832. -.BR \-c7 " ] ["
  1833. -.I \-obBC 
  1834. -.RI "] " site
  1835. -.SH DESCRIPTION
  1836. -.I sendbatch
  1837. -prepares and transmits a batch of news for unbatching by another machine.
  1838. -.PP
  1839. -If
  1840. -.I sendbatch
  1841. -is called with no flags, it will submit the batched news (from
  1842. -.IR /usr/spool/news/site )
  1843. -queued up for 
  1844. -.B site
  1845. -to 
  1846. -.I uux
  1847. -for transmission and exectution on the remote machine.
  1848. -.PP
  1849. -Several flags are available to modify sendbatch's behavior.
  1850. -.PP
  1851. -The
  1852. -.B \-c
  1853. -flag says to use compression to reduce the site of the transmitted file.
  1854. -.PP
  1855. -The
  1856. -.B \-c7
  1857. -flag is normally used for sending articles over X.25 links.
  1858. -It will cause the batch of news to be compressed, then piped through
  1859. -.I encode
  1860. -to reduce the 8-bit data into 7-bit characters.
  1861. -.PP
  1862. -The
  1863. -.B \-s
  1864. -flag is used to modify the size of the batches. By default, the
  1865. -batch size is 50,000 bytes.
  1866. -.PP
  1867. -The 
  1868. -.B \-i
  1869. -flag says to send a batch of Message-IDs with the 
  1870. -.I ihave
  1871. -protocol.
  1872. -.PP
  1873. -The
  1874. -.B \-o
  1875. -flag is used with the 
  1876. -.B \-c
  1877. -flag to produce and old style compress batch suitable for systems
  1878. -with version 2.10.2 news.
  1879. -.PP
  1880. -The
  1881. -.B \-bBC
  1882. -flags are passed directly to compress and may be used to change
  1883. -its compression algorithms if necessary.
  1884. -.SH EXAMPLES
  1885. -.PP
  1886. -To send to a PDP 11/70 running 2.10.2 compressed batching:
  1887. -.ti 1i
  1888. -sendbatch  \-c \-C \-b12 -o sitename
  1889. -.PP
  1890. -To send to a VAX running 2.11 compressed batching:
  1891. -.ti 1i
  1892. -sendbatch \-c sitename
  1893. -.PP
  1894. -To send to a VAX over an X.25 network using batches of 30,000 bytes:
  1895. -.ti 1i
  1896. -sendbatch \-c7 \-s30000 sitename
  1897. -.PP
  1898. -To send to a Sun running 2.11 compressed batching with 
  1899. -.I ihave/sendme
  1900. -:
  1901. -.ti 1i
  1902. -sendbatch \-c \-i sitename
  1903. -.SH SEE ALSO
  1904. -compress(1)
  1905. *-*-END-of-man/sendbatch.8-*-*
  1906. echo x - man/sendnews.8 1>&2
  1907. sed 's/.//' >man/sendnews.8 <<'*-*-END-of-man/sendnews.8-*-*'
  1908. -.if n .ds La '
  1909. -.if n .ds Ra '
  1910. -.if t .ds La `
  1911. -.if t .ds Ra '
  1912. -.if n .ds Lq "
  1913. -.if n .ds Rq "
  1914. -.if t .ds Lq ``
  1915. -.if t .ds Rq ''
  1916. -.de Ch
  1917. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1918. -..
  1919. -.TH SENDNEWS 8 "May 26, 1986"
  1920. -.ds ]W  Version B 2.11
  1921. -.SH NAME
  1922. -sendnews \- send news articles via mail
  1923. -.SH SYNOPSIS
  1924. -.BR sendnews " ["
  1925. -.BR \-o " ] ["
  1926. -.BR \-a " ] ["
  1927. -.BR \-b " ] ["
  1928. -.BI \-n " newsgroups"
  1929. -.RI "] " destination
  1930. -.SH DESCRIPTION
  1931. -.I Sendnews
  1932. -reads an article from its standard input, performs a set of changes
  1933. -to it, and gives it to the mail program to mail it to
  1934. -.IR destination .
  1935. -.PP
  1936. -An
  1937. -.Ch N
  1938. -is prepended to each line for decoding by
  1939. -.IR uurec (1).
  1940. -.PP
  1941. -The
  1942. -.B \-o
  1943. -flag handles old format articles.
  1944. -.PP
  1945. -The
  1946. -.B \-a
  1947. -flag is used for sending articles via the ARPANET.
  1948. -It maps the article's path from
  1949. -.IB uucphost ! xxx
  1950. -to
  1951. -.IB xxx @ arpahost\fR.\fP
  1952. -.PP
  1953. -The
  1954. -.B \-b
  1955. -flag is used for sending articles via the Berknet.
  1956. -It maps the article's path from
  1957. -.IB uucphost ! xxx
  1958. -to
  1959. -.IB berkhost : xxx\fR.\fP
  1960. -.PP
  1961. -The
  1962. -.B \-n
  1963. -flag changes the article's newsgroup to the specified
  1964. -.IR newsgroup .
  1965. -.SH SEE ALSO
  1966. -checknews(1),
  1967. -inews(8),
  1968. -postnews(1),
  1969. -readnews(1),
  1970. -vnews(1),
  1971. -news(5),
  1972. -recnews(8),
  1973. -uurec(8)
  1974. *-*-END-of-man/sendnews.8-*-*
  1975. echo x - man/uurec.8 1>&2
  1976. sed 's/.//' >man/uurec.8 <<'*-*-END-of-man/uurec.8-*-*'
  1977. -.if n .ds La '
  1978. -.if n .ds Ra '
  1979. -.if t .ds La `
  1980. -.if t .ds Ra '
  1981. -.if n .ds Lq "
  1982. -.if n .ds Rq "
  1983. -.if t .ds Lq ``
  1984. -.if t .ds Rq ''
  1985. -.de Ch
  1986. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  1987. -..
  1988. -.TH UUREC 8 "May 26, 1986"
  1989. -.ds ]W  Version B 2.11
  1990. -.SH NAME
  1991. -uurec \- receive processed news articles via mail
  1992. -.SH SYNOPSIS
  1993. -.B uurec
  1994. -.SH DESCRIPTION
  1995. -.I Uurec
  1996. -reads news articles on the standard input sent by
  1997. -.IR sendnews (8),
  1998. -decodes them, and gives them to
  1999. -.IR inews (8)
  2000. -for insertion.
  2001. -.SH SEE ALSO
  2002. -inews(8),
  2003. -postnews(1),
  2004. -readnews(1),
  2005. -vnews(1),
  2006. -news(5),
  2007. -recnews(8),
  2008. -sendnews(8)
  2009. *-*-END-of-man/uurec.8-*-*
  2010. echo x - man/vnews.1 1>&2
  2011. sed 's/.//' >man/vnews.1 <<'*-*-END-of-man/vnews.1-*-*'
  2012. -.if n .ds La '
  2013. -.if n .ds Ra '
  2014. -.if t .ds La `
  2015. -.if t .ds Ra '
  2016. -.if n .ds Lq "
  2017. -.if n .ds Rq "
  2018. -.if t .ds Lq ``
  2019. -.if t .ds Rq ''
  2020. -.de Ch
  2021. -\\$3\\*(Lq\\$1\\*(Rq\\$2
  2022. -..
  2023. -.TH VNEWS 1 "September 19, 1986"
  2024. -.ds ]W  Version B 2.11
  2025. -.SH NAME
  2026. -vnews \- read news articles
  2027. -.SH SYNOPSIS
  2028. -.BR vnews " [ " \-a
  2029. -.IR date " ] [ "
  2030. -.B \-n
  2031. -.IR newsgroups " ] [ "
  2032. -.B \-t
  2033. -.IR titles " ] [ "
  2034. -.BR \-rxuc " ] "
  2035. -.PP
  2036. -.B "vnews \-s"
  2037. -.PP
  2038. -.B "vnews \-K"
  2039. -.SH DESCRIPTION
  2040. -.I Vnews 
  2041. -is a program for reading USENET news. It is based
  2042. -on
  2043. -.IR readnews (1)
  2044. -but has a CRT oriented interface.
  2045. -The list of available commands is quite
  2046. -similar, although since
  2047. -.I vnews
  2048. -is a \*(Lqvisual\*(Rq
  2049. -interface, most
  2050. -.I vnews
  2051. -commands do not have to be terminated
  2052. -by a newline.
  2053. -.LP
  2054. -.I Vnews
  2055. -uses all but the last two lines of the screen to display
  2056. -the current article. The next-to-last line is the secondary prompt line,
  2057. -and is used to input string arguments to commands.  The last line
  2058. -contains several fields.  The first field is the prompt
  2059. -field. If
  2060. -.I vnews
  2061. -is at the end of an article, the prompt is
  2062. -\&\*(Lqnext?\*(Rq; otherwise the prompt is \*(Lqmore?\*(Rq. The second field
  2063. -is the newsgroup field, which displays the current newsgroup,
  2064. -the number of the current article, and the number of
  2065. -the last article in the newsgroup. The third field contains
  2066. -the current time, and the last field contains the word
  2067. -\&\*(Lqmail\*(Rq if you have mail. When you receive new mail, the bell
  2068. -on the terminal is rung and the word \*(LqMAIL\*(Rq appears in capital
  2069. -letters for 30 seconds.
  2070. -.PP
  2071. -.I Vnews 
  2072. -without any arguments prints unread articles.
  2073. -.PP
  2074. -The following flags determine the selection of articles.
  2075. -.TP 10
  2076. -.BI "\-a " "\fR[\fP date \fR]\fP"
  2077. -Select articles posted after the given
  2078. -.I date
  2079. -(in
  2080. -.IR getdate (3)
  2081. -format).
  2082. -.TP 10
  2083. -.BI "\-n " newsgroups
  2084. -Select articles belonging to
  2085. -.I newsgroups.
  2086. -.TP 10
  2087. -.BI "\-t " titles
  2088. -Select articles whose titles contain one of the strings specified by
  2089. -.I titles.
  2090. -.TP 10
  2091. -.B \-r
  2092. -Print the articles in reverse order.
  2093. -.TP 10
  2094. -.B \-x
  2095. -Ignore
  2096. -.I .newsrc
  2097. -file.  That is, select articles that have already been read as well as new ones.
  2098. -.TP 10
  2099. -.B \-u
  2100. -Update the 
  2101. -.I .newsrc
  2102. -file every 5 minutes, as in the case of an unreliable system.
  2103. -(Note that if the
  2104. -.I .newsrc
  2105. -file is updated, the
  2106. -.B x
  2107. -command will not restore it to its original contents.)
  2108. -.PP
  2109. -If the
  2110. -.B \-c
  2111. -flag is specified,
  2112. -.I vnews
  2113. -will print the first
  2114. -page of the article, instead of just the header.
  2115. -.PP
  2116. -You can use the
  2117. -.B \-s
  2118. -flag to print the newsgroup subscription list.
  2119. -.PP
  2120. -If you haven't read news in a while (or if you have never read news!)
  2121. -you can do
  2122. -.I "vnews \-K"
  2123. -to Kill (mark as read) all of the articles in the groups to which
  2124. -you are subscribed.
  2125. -.PP
  2126. -.I Vnews
  2127. -maintains a
  2128. -.I .newsrc
  2129. -file in the your home directory that specifies all news articles
  2130. -already read.  It is updated at the end of each reading session
  2131. -unless the
  2132. -.BR \-x
  2133. -option was specified.
  2134. -If the environment variable
  2135. -.B NEWSRC
  2136. -is present, it should be the path
  2137. -name of a file to be used in place of
  2138. -.IR .newsrc \&.
  2139. -.PP
  2140. -If you wish, an options line may be placed in your
  2141. -.I .newsrc
  2142. -file.
  2143. -This line starts with the word
  2144. -.B options
  2145. -(left justified) followed by the list of standard options just as
  2146. -they would be typed on the command line.  Such a list may include:
  2147. -the
  2148. -.B \-n
  2149. -flag along with a newsgroup list and/or
  2150. -the
  2151. -.B \-r
  2152. -or
  2153. -.B \-t
  2154. -flag.  
  2155. -Continuation lines begin with a space or tab character.
  2156. -.SH ENVIRONMENT
  2157. -Options can be specified in the
  2158. -.B NEWSOPTS
  2159. -environment parameter.  Where conflicts exist, options on the command
  2160. -line take precedence, followed by the
  2161. -.I .newsrc
  2162. -.B options
  2163. -line, and lastly the
  2164. -.B NEWSOPTS
  2165. -parameter.
  2166. -.PP
  2167. -When the user uses the direct reply command,
  2168. -the environment parameter
  2169. -.B MAILER
  2170. -will be used to determine which mailer to use. The default is usually
  2171. -.IR /bin/mail .
  2172. -.PP
  2173. -If
  2174. -.B EDITOR
  2175. -is set, it will be used in place of the default editor on your system to
  2176. -edit replies and follow-ups.
  2177. -.PP
  2178. -If
  2179. -.B NAME
  2180. -is set, it will be used as your full name when posting news or
  2181. -submitting a follow-up. If it is not set, the name will be taken
  2182. -from the file
  2183. -.I .name
  2184. -in your home directory. If this file is not present, the name will
  2185. -be taken from
  2186. -.IR /etc/passwd .
  2187. -.PP
  2188. -If
  2189. -.B NEWSARCHIVE
  2190. -is set, a copy of any articles you post or follow-up to, will be saved
  2191. -in the specified file. If it is the null string, they will be
  2192. -copied in 
  2193. -.I author_copy
  2194. -in your home directory.
  2195. -.PP
  2196. -If
  2197. -.B NEWSBOX
  2198. -is set, the filename you specify when you save or write a file
  2199. -will be prepended with
  2200. -.B NEWSBOX
  2201. -unless the filename is an absolute pathname.
  2202. -.PP
  2203. -If
  2204. -.B NEWSRC
  2205. -is set, it will be used in place of the
  2206. -.I .newsrc
  2207. -file in your home directory.
  2208. -.PP
  2209. -If
  2210. -.B ORGANIZATION
  2211. -is set, it will be used as the name of your organization whenever you
  2212. -post an article. The default is compiled in and is usually correct.
  2213. -Typically, you would only use this if you were reading news at a
  2214. -site other than normal. (Or if you are trying to be cute.)
  2215. -.SH "COMMANDS"
  2216. -.PP
  2217. -Each
  2218. -.I vnews
  2219. -command may be preceded by a count.  Some
  2220. -commands use the count; others ignore it. If count is omitted,
  2221. -it defaults to one. Some commands prompt for an argument
  2222. -on the second line from the bottom of the screen.  Standard UNIX erase
  2223. -and kill processing is done on this argument.  The argument is
  2224. -terminated by a return. An interrupt
  2225. -(\s-2DEL\s0 or \s-2BREAK\s0) gets you out of any partially entered command. 
  2226. -.sp
  2227. -In the following table, ^B is used as a shorthand for Control-B.
  2228. -.sp
  2229. -.ta 2.5i
  2230. -Command        Meaning
  2231. -.IP \fB\s-2CR\s0\fP
  2232. -A carriage return prints more of the current article,
  2233. -or goes on to the next article if you are at the end of
  2234. -the current article. A \fB\s-2SPACE\s0\fP is equivalent to \fB\s-2CR\s0\fP.
  2235. -.IP \fB^B\fP
  2236. -Go backwards
  2237. -.I count
  2238. -pages.
  2239. -.IP \fB^F\fP
  2240. -Go forward
  2241. -.I count
  2242. -pages.
  2243. -.IP \fB^D\fP
  2244. -Go forwards half a page.
  2245. -.IP \fB^U\fP
  2246. -Go backwards half a page.
  2247. -.IP \fB^Z\fP
  2248. -Go forwards
  2249. -.I count
  2250. -lines.
  2251. -.IP \fB^E\fP
  2252. -Go backwards
  2253. -.I count
  2254. -lines.
  2255. -.IP \fB^L\fP
  2256. -Redraw the screen. \fB^L\fP may be typed at any time.
  2257. -.IP \fBb\fP
  2258. -Back up one article in the current group.
  2259. -.IP \fBc\fP
  2260. -Cancel the article.  Only the author of the article or the super user
  2261. -can do this.
  2262. -.IP \fBe\fP
  2263. -Erase.  Forget that this article was read.
  2264. -.IP \fBf\fP
  2265. -Submit a follow-up article.
  2266. -You will be placed in your
  2267. -.B EDITOR
  2268. -to compose the text of the follow-up.
  2269. -.IP \fBh\fP
  2270. -Go back to the top of the article and display only the
  2271. -header.
  2272. -.IP \fBl\fP
  2273. -Redisplay the article after you have sent a follow-up or reply.
  2274. -.IP \fBm\fP
  2275. -Move on to the next item in a digest.
  2276. -.IP \fBn\fP
  2277. -No.  Go on to the next article without printing current one. 
  2278. -.B \&.
  2279. -is equivalent to
  2280. -.BR n .
  2281. -This is convenient if your terminal
  2282. -has a keypad.
  2283. -.IP \fBp\fP
  2284. -Show the parent article (the article that the
  2285. -current article is a follow-up to). This doesn't work
  2286. -if the current article was posted by A-news or notesfiles.  To
  2287. -switch between the current and parent articles, use the
  2288. -.B \-
  2289. -command. Unfortunately, if you use several
  2290. -.B p
  2291. -commands
  2292. -to trace the discussion back further, there is no command to return
  2293. -to the original level.
  2294. -.IP \fBq\fP
  2295. -Quit.  The
  2296. -.I .newsrc
  2297. -file will be updated unless
  2298. -.B \-x
  2299. -was on the command line.
  2300. -.IP \fBr\fP
  2301. -Reply.  Reply to article's author via mail.
  2302. -You are placed in your
  2303. -.B EDITOR
  2304. -with a header specifying
  2305. -\&\*(LqTo\*(Rq, \*(LqSubject\*(Rq, and \*(LqReferences\*(Rq
  2306. -lines taken from the message.
  2307. -You may change or add headers, as appropriate.
  2308. -Add the text of the reply after the blank line, and then exit
  2309. -the editor.  The resulting message is mailed to the author of the article.
  2310. -.IP \fBR\fP
  2311. -This is the same as \fBr\fP except the body of the article is included
  2312. -in your mail message for you.
  2313. -.IP \fBESC-r\fP
  2314. -Reply directly.  You are placed in your
  2315. -.B MAILER
  2316. -as if you had run it specifying
  2317. -the author of the article as the recipient of a letter.
  2318. -.IP "\fBs\fP [\fIfile\fP]"
  2319. -Save.  The article is appended to the named file.
  2320. -The default is
  2321. -.IR Articles .
  2322. -If the first character of the file name is
  2323. -.Ch | ,
  2324. -the rest of the file name is taken as the name of a program,
  2325. -which is executed with the text of the article as standard input.
  2326. -If the first character of the file name is
  2327. -.Ch / ,
  2328. -it is
  2329. -taken as the full pathname of a file.
  2330. -If
  2331. -.B NEWSBOX
  2332. -(in the environment) is set to a full pathname,
  2333. -and the file contains no
  2334. -.Ch / ,
  2335. -the file is saved in
  2336. -.BR NEWSBOX .
  2337. -Otherwise, it is saved relative to
  2338. -.BR HOME .
  2339. -.IP \fBug\fP
  2340. -Unsubscribe to the current group. This is a two character
  2341. -command to ensure that it is not typed accidentally
  2342. -and to leave room for other types of unsubscribes (e.g. 
  2343. -unsubscribe to discussion).
  2344. -.IP \fBv\fP
  2345. -Print the current version of the news software.
  2346. -.IP \fBw\fP
  2347. -Write. Like save
  2348. -.BR s ,
  2349. -except that the headers are not written out.
  2350. -.IP \fBx\fP
  2351. -Exit.  Like quit except that
  2352. -.I .newsrc
  2353. -is not updated.
  2354. -.IP \fBy\fP
  2355. -Yes.  Print the current article and go to the next.
  2356. -.IP [\fIn\fP]\fBA\fP
  2357. -Go to article number \fIn\fP in the current newsgroup.
  2358. -.IP \fBD\fP
  2359. -Decrypts a joke. It only handles rot 13 jokes.   The
  2360. -.B D
  2361. -command is a toggle; typing another
  2362. -.B D
  2363. -re-encrypts the
  2364. -joke.
  2365. -.IP \fBH\fP
  2366. -Print a very verbose header, containing all known information
  2367. -about the article.
  2368. -.IP \fBK\fP
  2369. -Kill (mark as read) the rest of the articles in the current group. 
  2370. -This is useful if you can't keep up with the volume in the newsgroup,
  2371. -but don't want to unsubscribe.
  2372. -.IP "\fBN\fP [\fInewsgroup\fP]"
  2373. -Go to the next newsgroup or named newsgroup.
  2374. -.IP [\fIn\fP]\fB+\fP
  2375. -Skip
  2376. -.I n
  2377. -articles.
  2378. -The articles skipped are recorded as ``unread'' and will be
  2379. -offered to you again the next time you read news.
  2380. -.IP \fB\-\fP
  2381. -Go back to last article.
  2382. -This is a toggle; typing it twice returns you to the original article.
  2383. -.IP \fB<\fP
  2384. -Prompt for an article ID or the rest of a message ID.
  2385. -It will display the article if it exists.
  2386. -.IP \fB#\fP
  2387. -Report the name and size of the newsgroup.
  2388. -.IP \fB?\fP
  2389. -Print a short help message.
  2390. -.IP \fB!\fP
  2391. -Passes the rest of the command line to the shell.  The
  2392. -environment variable
  2393. -.B A
  2394. -is set to the name of the file
  2395. -containing the current article.  If the last character
  2396. -of the command is a
  2397. -.BR & ,
  2398. -then the
  2399. -.B &
  2400. -is deleted and
  2401. -the command is run in the background with stdin, stdout
  2402. -and stderr redirected to
  2403. -.IR /dev/null .
  2404. -If the command is
  2405. -missing, the shell is invoked. Use the
  2406. -.B l
  2407. -command (or
  2408. -essentially any other command) to turn on the display
  2409. -after the program terminates.
  2410. -.SH EXAMPLES
  2411. -.TP 10
  2412. -.B vnews
  2413. -Read all unread articles using the
  2414. -.IR visual
  2415. -interface.  The
  2416. -.I .newsrc
  2417. -file is updated at the end of the session.
  2418. -.TP 10
  2419. -.B vnews \-n all !mod \-r
  2420. -Read all unread articles except articles whose newsgroups begin with
  2421. -.B mod.
  2422. -in reverse order.  The
  2423. -.I .newsrc
  2424. -file is updated at the end of the session.
  2425. -.TP 10
  2426. -.B "vnews \-n all \-a last thursday"
  2427. -Print every unread article since last Thursday.  The
  2428. -.I .newsrc
  2429. -file is
  2430. -updated at the end of the session.
  2431. -.TP 10
  2432. -.B "vnews \-K"
  2433. -Discard all unread news.
  2434. -This is useful after returning from a long trip.
  2435. -.SH FILES
  2436. -.PD 0
  2437. -.TP 40
  2438. -.RI /usr/spool/news/ newsgroup / number
  2439. -News articles
  2440. -.TP 40
  2441. -/usr/lib/news/active
  2442. -Active newsgroups
  2443. -.TP 40
  2444. -/usr/lib/news/vnews.help
  2445. -Help file for
  2446. -.IR visual
  2447. -interface
  2448. -.TP 40
  2449. -~/.newsrc
  2450. -Options and list of previously read articles
  2451. -.PD
  2452. -.SH SEE ALSO
  2453. -checknews(1),
  2454. -inews(8),
  2455. -postnews(1),
  2456. -readnews(1),
  2457. -vnews(1),
  2458. -getdate(3),
  2459. -news(5),
  2460. -newsrc(5),
  2461. -expire(8),
  2462. -recnews(8),
  2463. -sendnews(8),
  2464. -uurec(8)
  2465. *-*-END-of-man/vnews.1-*-*
  2466. sed 's/.//' >man/patchlevel.man <<'*-*-END-of-man/patchlevel.man-*-*'
  2467. 0
  2468. *-*-END-of-man/patchlevel.man-*-*
  2469. exit
  2470.  
  2471.