CTAGS.1
上传用户:datang2001
上传日期:2007-02-01
资源大小:53269k
文件大小:4k
源码类别:

操作系统开发

开发平台:

C/C++

  1. CTAGS(1)                  Minix Programmer's Manual                   CTAGS(1)
  2. NAME
  3.      ctags - Generates "tags" and (optionally) "refs" files
  4. SYNOPSIS
  5.      ctags [-stvra] filesnames...
  6. DESCRIPTION
  7.      ctags generates the "tags" and "refs" files from  a  group  of  C  source
  8.      files.   The  "tags"  file  is  used  by Elvis' ":tag" command, control-]
  9.      command, and -t option.  The "refs" file is sometimes used by the  ref(1)
  10.      program.
  11.      Each C source file is scanned for #define statements and global  function
  12.      definitions.   The  name  of  the macro or function becomes the name of a
  13.      tag.  For each tag, a line is added to the "tags" file which contains:
  14.                  - the name of the tag
  15.                  - a tab character
  16.                  - the name of the file containing the tag
  17.                  - a tab character
  18.                  - a way to find the particular line within the file.
  19.      The filenames list will typically be the names of all C source  files  in
  20.      the current directory, like this:
  21.           $ ctags -stv *.[ch]
  22. OPTIONS
  23.      -t   Include typedefs.  A tag will be  generated  for  each  user-defined
  24.           type.  Also tags will be generated for struct and enum names.  Types
  25.           are considered to be global if they are defined in  a  header  file,
  26.           and static if they are defined in a C source file.
  27.      -v   Include variable declarations.  A tag will  be  generated  for  each
  28.           variable,  except  for  those that are declared inside the body of a
  29.           function.
  30.      -s   Include static tags.  Ctags will normally put  global  tags  in  the
  31.           "tags"  file, and silently ignore the static tags.  This flag causes
  32.           both global and static tags to be added.  The name of a  static  tag
  33.           is  generated  by  prefixing  the name of the declared item with the
  34.           name of the file where it is defined, with a colon in between.   For
  35.           example,  "static  foo(){}"  in  "bar.c"  results  in  a  tag  named
  36.           "bar.c:foo".
  37.      -r   This causes ctags to generate both "tags" and "refs".   Without  -r,
  38.           it would only generate "tags".
  39.      -a   Append to "tags", and  maybe  "refs".   Normally,  ctags  overwrites
  40.           these  files  each time it is invoked.  This flag is useful when you
  41.           have to many files in the current directory for you to list them  on
  42.                                                                              1
  43. CTAGS(1)                  Minix Programmer's Manual                   CTAGS(1)
  44.           a single command-line; it allows you to split  the  arguments  among
  45.           several invocations.
  46. FILES
  47.      tags A cross-reference that lists each tag name, the name of  the  source
  48.           file  that contains it, and a way to locate a particular line in the
  49.           source file.
  50.      refs The "refs" file contains the definitions for each tag in the  "tags"
  51.           file,  and  very little else.  This file can be useful, for example,
  52.           when licensing restrictions prevent you from making the source  code
  53.           to  the  standard  C  library  readable  by everybody, but you still
  54.           everybody to know what arguments the library functions need.
  55. BUGS
  56.      ctags is sensitive to indenting and line breaks.  Consequently, it  might
  57.      not  discover  all  of the tags in a file that is formatted in an unusual
  58.      way.
  59. SEE ALSO
  60.      elvis(1), refs(1)
  61. AUTHOR
  62.      Steve Kirkendall
  63.      kirkenda@cs.pdx.edu
  64.                                                                              2