  The CCmviewCA program is a full-screen viewer, for viewing both files and menus.
  It can even be used as a mini-BBS, although from a security point of view
  its usefulness in this respect is limited - you'd be better off using the
  BBS program CCmbbsCA instead.

Message:

Subject: 4.1 MVIEW Invocation

  The general form for invocation of the viewer CCmviewCA is:

   mview [OPTIONS] FILE...

  Each FILE specified will be displayed in turn.

  The first few options determine the way that data is displayed.

  CC-mCA
  CC--menuCA    Each specified file is to be displayed as a menu, not as a normal
            file.

  CC-LCA
  CC--listedCA        Each specified file is a directory, to be displayed as a
                  menu showing all of the items in the directory.

  CC-lCA CCnCA
  CC--line=CCnCA
  CC+CCnCA        Start the file viewer with line n at the bottom of the screen.

            Note that CC-lCA and CC--lineCA apply to Ballb files specified on the
            command line, but CC+CCnCA only applies to those files specified after
            it.

            Also note that this option has no effect if the CC-mCA option is
            given.

  CC-zCA
  CC--bottomCA        Start at the bottom of each file. This does not affect menu
                  viewing.

  CC-TCA
  CC--topCA     Start at the top of each file (the default action if there is no
            LDB entry to use). Again, this does not affect menu viewing.

  CC-cCA
  CC--no-coloursCA
  CC--monochromeCA    Do not output any colour attributes - view everything in
                  black and white.

  The following options control the use of a database recording the files read
  and the last position they were read at. See section 2.4 Last Access.

  CC-dCA CCfileCA
  CC--ldb=CCfileCA      Use file as a last-access database containing records of
                  which files have been looked at in the past. If file does
                  not exist, it will be created. Note that old records are
                  never purged automatically; use the CC-pCA option for that.

                  This option overrides the CCMVIEW_LDBCA environment variable.

  CC-nCA
  CC--no-ldbCA        Don't use a last-access database, even if one is specified
                  in the CCMVIEW_LDBCA environment variable.

  CC-pCA
  CC--purge-ldbCA     Purge the last access database specified by CC-dCA or CCMVIEW_LDBCA
                  by removing from it any records pertaining to files that can
                  no longer be found, and then exit without viewing any files.

  CC-fCA CCfileCA
  CC--file=CCfileCA     Pretend, for last access database purposes, that file was
                  the file accessed instead of using the real file name. In
                  other words, record the last access details for the current
                  file under the name file.

  The new few options determine which restrictions are to be put in effect.

  CC-yCA
  CC--anonymousCA     Account names are stripped from CCaFrom:CA lines, leaving only
                  the namelines.

  CC-rCA
  CC--readonlyCA      The files cannot be modified.

  CC-eCA
  CC--no-editCA       Direct-editing is disallowed, though files can still be
                  added to.

  The last two options give information about the program.

  CC--helpCA    Print a usage message on standard output and exit successfully.

  CC-VCA
  CC--versionCA       Print version information on standard output and exit
                  successfully.

Message:

Subject: 4.2 File Viewer

  To view a file, do `mview file'. This will open file in the full-screen
  viewer, with all editing enabled (depending on file ownership and
  permissions).

  If file's name ends in `.gz', it is treated as a file compressed with GNU
  zip (CCgzipCA - see section `Gzip' in Gzip). This means that it is decompressed
  to a temporary file and this temporary file is viewed instead.

  Note that only regular (seekable) files may be viewed. FIFOs, pipes, and
  serial devices will cause problems.

  For information about the key presses available in the viewer, see the
  manual page (`man mview') or press [B?b] while viewing a file.

Message:

Subject: 4.3 Last Access Database

  Optionally, you can record your position in files by means of a last-access
  database (LDB). This is a file containing details of which files you have
  read, when you last read them, and where you left off, and thus acts as a
  kind of "bookmark".

  To use an LDB file, you can either give its name with the `-d file' option
  or you can set the CCMVIEW_LDBCA environment variable to point to the file you
  wish to use as an LDB.

  Note that LDB files have a specific format and should not be created by
  hand.

  LDB files also record which menus and files you are subscribed to - see the
  menu viewer section (see section 4.4 Menu Viewer) and the section on
  scanning (see section 4.5 Scanning) for more information about
  subscriptions.

  It is a good idea to purge your LDB now and again - that is, remove entries
  which refer to nonexistent files. This can be done with `mview -p'.

Message:

Subject: 4.4 Menu Viewer

  To view a menu, do `mview -m file'. This will open file in the full-screen
  menu viewer. Note that, unlike in the case of the file viewer, file must Bnotb
  be compressed.

  If you are using a last access database, you may mark entries in a menu as
  "uninteresting", so that when you do a scan (see section 4.5 Scanning) those
  entries are skipped. This is known as Bunsubscribingb, and is done with the [B=b]
  key.

  For information about the key presses available in the viewer, see the
  manual page (`man mview') or press [B?b] while viewing a menu.

  Information about menu code and writing menus is given elsewhere in this
  document. See section 10. Menu Code.

Message:

Subject: 4.5 Scanning

  Menus may be Bscannedb for new files. This is triggered by hitting [BSPACEb],
  and causes the viewer to search for the first unread file that has not been
  unsubscribed from.

  If all files in the current menu have been read up to date, submenus are
  scanned recursively until one is found, at which point the scan stops and
  the viewer displays the menu in which that file was found. Upon hitting
  [BSPACEb] again, the viewer will enter that file.

  If no files at all can be found, the viewer exits to the next highest menu,
  unless it was already at the top level, in which case nothing happens.

