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