plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

news.1 (1152B)


      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