news(1)                                                   news(1)



NAME
     news - displays local news items

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

ARGUMENTS
     -a   Displays all items, regardless of currency.  In this
          case, the stored time is not changed.

     -n   Reports the names of the current items without
          displaying their contents, and without changing the
          stored time.

     -s   Reports 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.

     items
          Specifies the news items that are to be displayed.

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.  The news program
     stores the ``currency'' time as the modification date of a
     file named .news_time in your 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.''

     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
     The command:

        news

     will display all files in /usr/news that have not been read
     previously by the account owner.






January 1992                                                    1

news(1)                                                   news(1)



FILES
     /bin/news
          Executable file
     /etc/profile
          Executable file
     /usr/news/*
          Files containing news items
     $HOME/.news_time
          Executable file

SEE ALSO
     profile(4), environ(5) in A/UX Programmer's Reference











































2                                                    January 1992