ctags(1)                       DG/UX 5.4R3.00                       ctags(1)


NAME
       ctags - create a tags file

SYNOPSIS
       ctags [ -BFatuwvx ] name ...

DESCRIPTION
       Ctags makes a tags file for ex(1) from the specified C, Pascal and
       Fortran sources.  A tags file gives the locations of specified
       objects (in this case functions and typedefs) in a group of files.
       Each line of the tags file contains the object name, the file in
       which it is defined, and an address specification for the object
       definition.  Functions are searched for with a pattern, typedefs with
       a line number.  Specifiers are given in separate fields on the line,
       separated by blanks or tabs.  Using the tags file, ex can quickly
       find these object definitions.

       If the -x flag is given, ctags produces a list of object names, the
       line number and file name on which each is defined, as well as the
       text of that line and prints this information on the standard output.
       This is a simple index which can be printed out.

       If the -v flag is given, an index of a different form is produced on
       the standard output.  This listing contains the function name, file
       name, and page number (assuming 64 line pages).

       Files whose names end in .c or .h are assumed to be C source files
       and are searched for C routine 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:

       -a   append to tags file.

       -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 which
            is rather slow; it is usually faster to simply rebuild the tags
            file.)

       -F   use forward searching patterns (/.../) (default).

       -B   use backward searching patterns (?...?).

       -t   create tags for typedefs.

       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



Licensed material--property of copyright holder(s)                         1

ctags(1)                       DG/UX 5.4R3.00                       ctags(1)


       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 very simpleminded way.  No attempt is made to
       deal with block structure; if you have two Pascal procedures in
       different blocks with the same name, the procedure will not work.

       Does not know about #ifdefs.

       Should know about Pascal types.  Relies on the input being well
       formed to detect typedefs.  Use of -tx shows only the last line of
       typedefs.






































Licensed material--property of copyright holder(s)                         2