ctags(1)                   DG/UX 4.30                    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.



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

     ctags(1)                   DG/UX 4.30                    ctags(1)



          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 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)         Page 2