news(1)                                                   news(1)



     NAME
          news - display local news items

     SYNOPSIS
          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 displays 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
          .news_time 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 flag option causes news to display all items, regard-
          less 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 displaying their contents, and without chang-
          ing the stored time.

          The -s flag option causes news to report how many current
          items exist, without displaying their names or contents, and
          without changing the stored time.  It is useful to include
          such an invocation of news in one's .profile file, or in the
          system's /etc/profile.

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

          If the interrupt character (usually CONTROL-c) is pressed
          during the display of a news item, the display stops and the
          next item is started.  Another interrupt within one second
          of the first causes the program to terminate.

     EXAMPLES
               news

          will display all files in /usr/news that have not been read









     April, 1990                                                     1

     news(1)                                                   news(1)



          previously by the account owner.

     FILES
          /bin/news
          /etc/profile
          /usr/news/*
          $HOME/.news_time

     SEE ALSO
          profile(4), environ(5).













































     2                                                     April, 1990