blob: f3c2aa4d9c117989ccc632b86b024285ff4e1c5a [file] [log] [blame]
rsc058b0112005-01-03 06:40:20 +00001.TH NEWS 1
2.SH NAME
3news \- 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
16When invoked without options,
17this simple local news service
18prints files that have appeared in
19.BR /lib/news
20since last reading, most recent first,
21with each preceded by an appropriate header.
22The time of reading is recorded.
23The options are
24.TP
25.B -a
26Print all items, regardless of currency.
27The recorded time is not changed.
28.TP
29.B -n
30Report the names of the current items without
31printing their contents, and without changing
32the recorded time.
33.PP
34Other arguments
35select particular news items.
36.PP
37To post a news item, create a file in
rscc8b63422005-01-13 04:49:19 +000038.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.
rsc058b0112005-01-03 06:40:20 +000045.PP
46Empty news items, and news items named
47.B core
48or
49.B dead.letter
50are ignored.
51.SH FILES
rsc058b0112005-01-03 06:40:20 +000052.TP
rscc8b63422005-01-13 04:49:19 +000053.B \*9/news/*
rsc058b0112005-01-03 06:40:20 +000054articles
55.TP
56.B $HOME/lib/newstime
57modify time is time news was last read
rscc8b63422005-01-13 04:49:19 +000058.\" .TP
59.\" .B /sys/lib/subscribers
rsc058b0112005-01-03 06:40:20 +000060who gets news mailed to them
61.SH SOURCE
rscc3674de2005-01-11 17:37:33 +000062.B \*9/src/cmd/news.c