Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

apropos(1)

col(1)

pg(1)

whatis(1)

environ(4)

term(4)



  man(1)                              CLIX                              man(1)



  NAME

    man, nman - Displays online reference manual entries

  SYNOPSIS

    man [flag ... ] [section] entry ...

    nman [flag ... ] [section] entry ...

  FLAGS

    -c       Displays output using col.  Note that col is used automatically
             by man unless term is 300, 300s, 450, 37, 4000a, 382, 4014, tek,
             1620, or X.

    -C       (nman only) Displays output using col -b.  This flag eliminates
             backspaces in the displayed output to allow pg pattern searches.

    -d       Searches the current directory for entries rather than the online
             reference manual directory (/usr/ip32/sysvdoc/catman); requires
             the full filename for the entry (such as cu.Z rather than cu).

    -Tterm   Displays the entry as appropriate for terminal type term.  For a
             list of recognized values of term, see term(4).

    -w       Displays only the pathnames of the entries relative to the online
             reference manual directory (/usr/ip32/sysvdoc/catman), or to the
             current directory when used with the -d flag.

  DESCRIPTION

    The man command searches the online reference manual directory
    (/usr/ip32/sysvdoc/catman) for an entry named entry, and displays the
    entry if found.  The entry name entry is entered in lowercase.  If
    multiple entries with names containing entry exist, all entries are
    displayed, one after the other.

    The nman command is nearly identical to the man command.  The nman command
    pipes its output through the pg command, and displays bolded and
    underlined characters not shown in the displayed output from man.  All pg
    perusal commands are available within nman; however, you must use the -C
    flag to enable pattern searches in the displayed output.

    The man command does not page its output; a displayed entry will scroll to
    the end of the file without stopping.  For more convenient viewing, you
    should pipe the output through the pg command.

    You can specify multiple entry names on the man or nman command line.  All
    entries containing the specified entry names are displayed, one after the
    other.



  2/94 - Intergraph Corporation                                              1






  man(1)                              CLIX                              man(1)



    You can narrow the search for an entry by specifying a section number
    section on the man or nman command line.  Currently, valid sections are 0
    through 8, inclusive; the section number may not have a letter suffix.

    The man and nman commands examine the environment variable TERM (see
    environ(4) ) and attempt to select options that adapt the output to the
    terminal being used.  The -Tterm flag overrides the value of TERM; in
    particular, you should use -Tlp when sending the output of man or nman to
    a printer.

    To produce printed reference manual entries, pipe the output of the man or
    nman command through lp (for line printer output) or qpr (for NQS printer
    output).

  EXAMPLES

    1.  The following displays this entry (man) and any other entries whose
        names contain man, and pipes the output through pg for more convenient
        viewing:

        $ man man | pg


    2.  The following displays a compressed online entry file named passwd.Z
        that resides in the current directory, and enables pg pattern
        searching of the displayed output:

        $ nman -C -d passwd.Z


    3.  The following displays the pathnames to the online entries for
        ansitape, relative to the online reference manual directory
        (/usr/ip32/sysvdoc/catman):

        $ man -w ansitape
        u_man/man1/ansitape.Z p_man/man4/ansitape.Z


    4.  The following pipes the ls(1) entry to a printer on the NQS queue
        laser:

        $ nman -Tlp ls | qpr -t text -q laser


    5.  The following pipes the ls(1) entry to a line printer named prt1:

        $ nman -Tlp ls | lp -dprt1


  FILES




  2                                              Intergraph Corporation - 2/94






  man(1)                              CLIX                              man(1)



    /usr/ip32/sysvdoc/catman/?_man/man[1-8]/*

  NOTES

    The word manpage is synonymous with reference manual entry.

    If you specify a section number section and multiple entry names, note
    that if any of the entries are not in the specified section, you will
    receive an error message that the missing entry was not found, and none of
    the entries will display.

    Other commands can help you find related reference manual entries, or
    determine what a specific entry documents.  See apropos(1) and whatis(1)
    for more information.

    The man and nman commands display reference manual entries that were
    formatted by nroff when the online reference manual product was built.
    Entries were formatted using terminal type lp, and are displayed using the
    correct terminal filters as derived from the -Tterm and TERM settings.

  DIAGNOSTICS

    Man pages not found: /usr/ip32/sysvdoc/catman
           The online reference manual product is not installed on the system.

  EXIT VALUES

    The man and nman commands exit with a value of 0 if successful, and with a
    value of 1 if there is a problem.

  RELATED INFORMATION

    Commands:  apropos(1), col(1), pg(1), whatis(1)

    Files:  environ(4), term(4)



















  2/94 - Intergraph Corporation                                              3




Typewritten Software • bear@typewritten.org • Edmonds, WA 98026