| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame^] | 1 | .TH NEWS 1 |
| 2 | .SH NAME |
| 3 | news \- print news items |
| 4 | .SH SYNOPSIS |
| 5 | .B news |
| 6 | [ |
| 7 | .B -a |
| 8 | ] |
| 9 | [ |
| 10 | .B -n |
| 11 | ] |
| 12 | [ |
| 13 | .I item ... |
| 14 | ] |
| 15 | .SH DESCRIPTION |
| 16 | When invoked without options, |
| 17 | this simple local news service |
| 18 | prints files that have appeared in |
| 19 | .BR /lib/news |
| 20 | since last reading, most recent first, |
| 21 | with each preceded by an appropriate header. |
| 22 | The time of reading is recorded. |
| 23 | The options are |
| 24 | .TP |
| 25 | .B -a |
| 26 | Print all items, regardless of currency. |
| 27 | The recorded time is not changed. |
| 28 | .TP |
| 29 | .B -n |
| 30 | Report the names of the current items without |
| 31 | printing their contents, and without changing |
| 32 | the recorded time. |
| 33 | .PP |
| 34 | Other arguments |
| 35 | select particular news items. |
| 36 | .PP |
| 37 | To post a news item, create a file in |
| 38 | .BR /lib/news . |
| 39 | .PP |
| 40 | You may arrange to receive news automatically by |
| 41 | registering your mail address in |
| 42 | .BR /sys/lib/subscribers . |
| 43 | A daemon mails recent news |
| 44 | to all addresses on the list. |
| 45 | .PP |
| 46 | Empty news items, and news items named |
| 47 | .B core |
| 48 | or |
| 49 | .B dead.letter |
| 50 | are ignored. |
| 51 | .SH FILES |
| 52 | .TF /sys/lib/subscribers |
| 53 | .TP |
| 54 | .B /lib/news/* |
| 55 | articles |
| 56 | .TP |
| 57 | .B $HOME/lib/newstime |
| 58 | modify time is time news was last read |
| 59 | .TP |
| 60 | .B /sys/lib/subscribers |
| 61 | who gets news mailed to them |
| 62 | .SH SOURCE |
| 63 | .B /usr/local/plan9/src/cmd/news.c |
