CTAGS(CP)                XENIX System V                 CTAGS(CP)



     Name
          ctags - Creates a tags file.

     Syntax
          ctags [ -a ] [ -u ] [ -v ] [ -w ] [ -x ] name ...

     Description
          ctags makes a tags file for vi(C) from the specified C
          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, vi can quickly find these function definitions.

          If the -x flag 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. With the -x option no tags file is
          created.  This is a simple index which can be printed out as
          an off-line readable function index.

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

          Other options are:

          -w   Suppresses warning diagnostics.

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

          The tag main is treated specially in C programs.  The tag
          formed is created by prepending 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.

     Files
          tags      Output tags file











     Page 1                                           (printed 8/7/87)

     CTAGS(CP)                XENIX System V                 CTAGS(CP)



     See Also
          ex(C), vi(C)

     Credit
          This utility was developed at the University of California
          at
          Berkeley and is used with permission.
















































     Page 2                                           (printed 8/7/87)