NEWS(C)                                    UNIX System V



     Name
          news - print news items


     Syntax
          news [ -a ] [ -n ] [ -s ] [ items ]


     Description
          news is used to keep the user informed  of  current  events.
          By  convention,  these  events are described by files in the
          directory /usr/news.

          When invoked without arguments, news prints the contents  of
          all current files in /usr/news, most recent first, with each
          preceded  by  an  appropriate  header.   news   stores   the
          ``currency''  time  as the modification date of a file named
          .newstime in the user's home  directory  (the  identity  of
          this directory is determined by the environment variable

          $HOME); only files more recent than this currency  time  are
          considered ``current.''

          The -a option causes news to print all items, regardless  of
          currency.  In this case, the stored time is not changed.

          The -n option causes news to report the names of the current
          items  without printing their contents, and without changing
          the stored time.

          The -s option causes news to report how many  current  items
          exist, without printing their names or contents, and without
          changing the stored time.

          All other arguments are assumed to be  specific  news  items
          that are to be printed.

          If the INTERRUPT key is struck during the printing of a news
          item,  printing stops and the next item is started.  Another
          INTERRUPT within one second of the first causes the  program
          to terminate.


     Files
          /usr/news/*
          $HOME/.news_time

     See Also
          profile(M), environ(M)


     Standards Conformance
          news is conformant with:

          AT&T SVID Issue 2, Select Code 307-127;
          and The X/Open Portability Guide II of January 1987.


     (printed 8/28/89)                                  NEWS(C)