ctags(1)                                                 ctags(1)



NAME
     ctags - maintains a tags file for a C program

SYNOPSIS
     ctags [-a] [-u] [-w] [-x] file...

ARGUMENTS
     -a   Causes the output to be appended to the tags file
          instead of rewriting it.

     file Specifies the C program file to be tagged.

     -u   Causes the specified files to be updated in tags; that
          is, all references to them are replaced by new values.
          (Beware:  this option is implemented in a way that is
          rather slow; it is usually faster to simply rebuild the
          tags file.)

     -w   Suppresses warning diagnostics.

     -x   Produces a list of function names, the line number and
          file name on which each is defined, as well as the text
          of that line and prints this on the standard output.

DESCRIPTION
     ctags makes a tags file for ex(1) and vi(1) from the
     specified C, Fortran, and Pascal sources.

     A tags file gives the locations of specified objects (in
     this case functions) in a group of files.  Each line of the
     tags file contains the function name, the file in which it
     is defined, and a scanning pattern used to find the function
     definition.  These are given in separate fields on the line,
     separated by blanks or tabs.  Using the tags file, ex can
     quickly find these function definitions.

     Files whose name ends in .c or .h are assumed to be C source
     files and are searched for C routine and macro definitions.

     The tag main is treated specially in C programs.  The tag
     formed is created by prefixing M to the name of the file,
     with a trailing .c removed, if any, and leading pathname
     components also removed.  This makes use of ctags practical
     in directories with more than one program.

EXAMPLES
     The command:

        ctags *.c *.h

     puts the tags from all the .c and .h files into the tagsfile
     tags.



January 1992                                                    1

ctags(1)                                                 ctags(1)



LIMITATIONS
     Not all warning diagnostics are suppressed by the -w option.

     If ctags(1) is interrupted while executing under the -u
     option, a temporary file named OTAGS is left in the current
     directory.

FILES
     /usr/bin/ctags
          Executable file
     tags Output tags file

SEE ALSO
     ex(1), vi(1)









































2                                                    January 1992