newpage(1)                          CLIX                          newpage(1)



  NAME

    newpage - Adds online reference manual entries to vman information files

  SYNOPSIS

    newpage filepath

  DESCRIPTION

    The newpage utility adds an application's or user's online reference
    manual entries, in the specified filepath, to the
    /usr/ip32/sysvdoc/amanlist file.  The utility then creates a sorted file,
    /usr/ip32/sysvdoc/smanlist, combining reference manual entries in the
    online reference manual directory with the application's or user's
    reference manual entries.  The smanlist file is used by the vman command
    for searches.

    An entry already listed in the manlist file is not listed again.
    Duplication is determined by the entire path of the entry file.  Thus,
    entries located in different directories may have the same name.

  EXAMPLES

    1.  The following adds all of the files in the
        /usr/ip32/xcontrib/doc/games directory that end in .txt to the
        amanlist and smanlist files:

        newpage /usr/ip32/xcontrib/doc/games/*.txt


    2.  The following adds all of the files in the /usr/ip32/elm/doc/catman
        directory to the amanlist and smanlist files:

        newpage /usr/ip32/elm/doc/catman/*


    3.  The following adds a single entry to the amanlist and smanlist files:

        newpage /usr/john/my_app/ma.1


  FILES

    /usr/ip32/sysvdoc/manlist
    /usr/ip32/sysvdoc/amanlist  Files used by newpage to create
                                /usr/ip32/sysvdoc/smanlist

    /usr/ip32/sysvdoc/smanlist  File used by vman to find reference manual
                                entries.




  2/94 - Intergraph Corporation                                              1

  newpage(1)                          CLIX                          newpage(1)



  NOTES

    Only the superuser can change the /usr/ip32/sysvdoc/manlist,
    /usr/ip32/sysvdoc/smanlist, or /usr/ip32/sysvdoc/amanlist files.

    Do not add a directory full of entries one at a time.  The newpage command
    is most efficient when a group of entries is listed on the same command
    line.

  CAUTIONS

    If the format of an application's or user's reference manual entry does
    not match the format of the online reference manual entries delivered in
    the SYSVDOC product, that entry cannot be used by vman.

    Do not manually add entries to the /usr/ip32/sysvdoc/manlist,
    /usr/ip32/sysvdoc/amanlist, or /usr/ip32/sysvdoc/smanlist files.

  EXIT VALUES

    If the filepath is a directory, newpage exits with a value of 1.
    Otherwise, newpage exits with a value of 0.

  RELATED INFORMATION

    Commands:  vman(1)

    Files:  manlist(4)


























  2                                              Intergraph Corporation - 2/94