news 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  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 /sys/src/cmd/news.c