


      CTAGS(1)                    (bsd 4.2)                    CTAGS(1)



      NAME
           ctags - create a tags file

      SYNTAX
           ctags [-u] [-w] [-x] name...

      DESCRIPTION
           Ctags makes a tags file for the ex(1) editor from the
           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.

           -x causes ctags to produce a list of function names, the
           line number and file name on which each is defined, and
           print the text of that line on the standard output. This is
           a simple index which can be printed out as an off-line
           readable function index.

           Files whose names end in .c or .h are assumed to be C source
           files and are searched for C routines and macro definitions.
           Others are first examined to see if they contain any Pascal
           or FORTRAN routine definitions; if not, they are processed
           again, looking for C definitions.

           Other options are:
           -w   suppressing warning diagnostics

           -u   causing 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 that 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

      SEE ALSO
           ex(1), vi(1)

      BUGS
           Recognition of functions, subroutines, and procedures for
           FORTRAN and Pascal is done in a simpleminded way.  No



      Page 1                                          (73 A2 02MT REV1)






      CTAGS(1)                    (bsd 4.2)                    CTAGS(1)



           attempt is made to deal with block structure; if you have
           two Pascal procedures in different blocks with the same
           name, ctags doesn't see it.




















































      Page 2                                          (73 A2 02MT REV1)



