ctags(1)                                                 ctags(1)



     NAME
          ctags - maintain a tags file for a C program

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

     DESCRIPTION
          ctags makes a tags file for ex(1) and vi(1) from the speci-
          fied 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.

     FLAG OPTIONS
          -a   Causes the output to be appended to the tags file in-
               stead of rewriting it.

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

          -w   Suppresses warning diagnostics.

          -x   If the -x flag option is given, ctags 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.

          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
               ctags *.c *.h

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






     April, 1990                                                     1

     ctags(1)                                                 ctags(1)



     FILES
          /usr/bin/ctags
          tags           output tags file

     SEE ALSO
          ex(1), vi(1).

     BUGS
          Not all warning diagnostics are suppressed by -w.

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










































     2                                                     April, 1990