SECTION(1MAN)           COMMAND REFERENCE           SECTION(1MAN)



NAME
     section - print sections of manual entries

SYNOPSIS
     man [ -h ] [ -n ] [ -{qv} ] [ -{rt} ] [ -s section-list ] [
     section ] title ...

DESCRIPTION
     Like help(1man), section executes man(1man) with the given
     section and title arguments in order to obtain the names of
     the files containing the manual entries.  The data generated
     by buildif(1man) must be present in the manual page entry
     for section to be used on that entry.

     The section-list is a list of abbreviations for sections
     separated by commas, tabs, and spaces.  The following table
     shows the known abbreviations and the manual page sections
     they correspond to.  The abbreviations are listed in the
     order that section with no -s option uses.


          na     NAME
          sy     SYNOPSIS
          de     DESCRIPTION
          op     OPTIONS
          ex     EXAMPLES
          fi     FILES
          di     DIAGNOSTICS
          va     VARIABLES
          rv     RETURN VALUE
          ca     CAVEATS
          se     SEE ALSO
          re     REFERENCES
          no     The contents of the notes file in $HOME/.helpnotes

     See the manual page for help(1man) for a description of
     manual page notes.

     There are three output formats produced by section : raw,
     squeezed, and full.  The raw format is used when the -r
     option is given, or when no formatting options are given and
     the standard output is not a terminal.  With raw formatting,
     the text is printed on the standard output exactly as it
     appears in the manual page file.  The squeezed format is
     used whenever the -t option is given.  This format causes
     all sequences containing backspaces to be squeezed into just
     the text that would be seen, and all multiple blank lines to
     be squeezed into a single blank line.  When no formatting
     options are given and the standard output is a terminal,
     full formatting is used.  Full formatting acts like squeezed
     formatting, except that bold and underlined terminal
     sequences are printed so that the text looks like it has



Printed 10/17/86                                                1

SECTION(1MAN)           COMMAND REFERENCE           SECTION(1MAN)



     been piped through more(1) or ul(1).

     Unless the -h option is given, the title and section of the
     manual page is printed on a line before any text.  For
     example, the command ``section csh'' would print the header
     ``csh(1csh):'' before the text.

OPTIONS
     -h  Do not print header line.

     -n  Do not print the first line of the text.  This first
         line contains the section header, such as SYNOPSIS.

     -q  Print only urgent error messages.  This option can not
         be used with -v.

     -r  Raw format.  No processing of backspaces or multiple
         blank lines is done.

     -s section-list
         Use the given section list as the ordering for printing
         the sections.  The list is as described above.

     -t  Squeeze format.  Multiple blank lines are squeezed into
         single blank lines, and backspace sequences are turned
         into the characters to be printed.

     -v  Verbose.  Print error messages when a manual entry does
         not contain the requested section.

EXAMPLES
     The following example shows a csh(1csh) alias which will
     print the SYNOPSIS and OPTIONS sections for the given
     arguments.  Note that no header or section name is printed,
     and only urgent messages are printed.



          alias ops 'section -qnh -s sy,op \!$'


     The following is the same example done as a sh(1sh)
     function.



          ops()
          {
          section -qnh -s sy,op "$@"
          }





Printed 10/17/86                                                2

SECTION(1MAN)           COMMAND REFERENCE           SECTION(1MAN)



FILES
     $HOME/.helpnotes         Directory in which to search for
                              the notes on the manual entry when
                              the ``no'' section is requested.

VARIABLES
     HOME           The user's home directory.

     TERM           The user's terminal type.

     TERMCAP        The name of the terminal capability database
                    or the terminal entry itself.

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

CAVEATS
     The bold terminal sequence is determined by looking in the
     termcap entry for ``md'' and ``me''.  If those do not exist,
     ``so'' and ``se'' are used.  If those do not exist, nothing
     is printed for bold mode.

     The underlining terminal sequence is determined by looking
     in the termcap entry for ``uc''.  If that does not exist,
     ``us'' and ``ue'' are used.  If those do not exist, ``so''
     and ``se'' are used.  If those do not exist, nothing is
     printed for underline mode.

SEE ALSO
     apropos(1man), buildif(1man), help(1man), makewhatis(1man),
     manintro(1man), more(1), ul(1), whatis(1man), man(5man),
     manindex(5man), termcap(5t), whatis(5man), catman(8man).







Printed 10/17/86                                                3

%%index%%
na:72,78;
sy:150,308;
de:458,2330;2932,299;
op:3231,945;
ex:4176,517;
fi:4837,256;
va:5093,275;
rv:5368,729;
ca:6097,563;
se:6660,488;
%%index%%000000000168