news(1)                             CLIX                             news(1)



  NAME

    news - Displays news items

  SYNOPSIS

    news [-a] [-n] [-s] [item ... ]

  FLAGS

    -a   Causes news to display all items, regardless of currency.  In this
         case, the stored time is not changed.

    -n   Using this flag causes news to report the names of the current items
         without displaying their contents, and without changing the stored
         time.

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

  DESCRIPTION

    The news command 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 command 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.''

    If <Delete> is pressed while displaying a news item, the display stops and
    the next item is started.  Pressing <Delete> again within one second
    terminates the command.

  FILES

    /etc/profile

    /usr/news/*

    $HOME/.news_time




  2/94 - Intergraph Corporation                                              1

  news(1)                             CLIX                             news(1)



  DIAGNOSTICS

    news: options are mutually exclusive
           You can only specify one option (flag).

    news: options are not allowed with file names
           You cannot specify options (flags) at the same time as filenames.

    cannot open /usr/news
    cannot chdir to /usr/news
           The /usr/news does not exist or has incorrect permissions.

    no storage
           The news command could not get enough memory to continue
           processing.

    cannot open /usr/news/filename
           A listed filename does not exist, or has incorrect permissions.

    cannot find HOME variable
           Your $HOME environment variable is not set to your home directory.

  EXIT VALUES

    The news command exits with a 0 if successful and a 1 if an error occurs.

  RELATED INFORMATION

    Files: profile(4)

























  2                                              Intergraph Corporation - 2/94