BUILDIF(1MAN)           COMMAND REFERENCE           BUILDIF(1MAN)



NAME
     buildif - build index format data

SYNOPSIS
     /usr/lib/buildif [ -f ] filename ...

DESCRIPTION
     Buildif reads each of the named files, which are expected to
     be formatted manual pages, locates the sections NAME,
     SYNOPSIS, DESCRIPTION, OPTIONS, EXAMPLES, FILES,
     DIAGNOSTICS, VARIABLES, RETURN VALUE, CAVEATS, SEE ALSO, and
     REFERENCES, and places a table as described in
     manindex(5man) at the end of the file.  The NAME section is
     required, and all others are optional.  This table is used
     by the commands help(1man) and section(1man) to display
     sections of the manual entry.

     This command may be executed automatically by catman(8man).
     See that manual entry to find out how this is done.

     Unless the -f option is given, a manual entry that already
     has an index format table will not be processed.

OPTIONS
     -f Force. If the file already has an index format table,
        remove the table and build a new one.

EXAMPLES
     The following example will add a new index format table to
     the file /usr/man/man1/buildif.1man, even if it already has
     one.

          /usr/lib/buildif -f /usr/man/man1/buildif.1man

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

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

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

CAVEATS
     When a file already has an index format table and the -f
     option is given, the old table is removed before the new
     index is built.  If the new index format table can not be
     built for some reason, the old index will have been removed



Printed 4/6/89                                                  1

BUILDIF(1MAN)           COMMAND REFERENCE           BUILDIF(1MAN)



     anyway.

SEE ALSO
     apropos(1man), help(1man), makewhatis(1man), man(1man),
     section(1man), whatis(1man), man(5man), manindex(5man),
     whatis(5man), and catman(8man).

















































Printed 4/6/89                                                  2

%%index%%
na:384,85;
sy:469,328;
de:797,1059;
op:1856,207;
ex:2063,329;
rv:2392,555;
ca:2947,350;3753,14;
se:3767,484;
%%index%%000000000142