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  \*9/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 .TP
53 .B \*9/news/*
54 articles
55 .TP
56 .B $HOME/lib/newstime
57 modify time is time news was last read
58 .\" .TP
59 .\" .B /sys/lib/subscribers
60 who gets news mailed to them
61 .SH SOURCE
62 .B \*9/src/cmd/news.c