NAME

       gtags-parser - print cross reference list for gtags.

SYNOPSIS

       gtags-parser [-bdenqrstvw] file ...

DESCRIPTION

       Gtags-parser  print  cross  reference  list  for  gtags(1) from the specified C, C++, yacc, java, PHP and
       Assembly source to standard output.  Each line of output contains the object name, the line number  which
       it  appears,  the file in which it is defined, and a line image separated by white-space.  It's same with
       the output of ctags(1) with -x option.

       Depending upon the options provided to gtags-parser, objects will consist of object  definitions,  object
       references and other symbols.

       Files  whose names end in ´.c´ or ´.h´ are assumed to be C source files.  Files whose names end in ´.c++´
       ´.cc´ ´.cpp´ ´.cxx´ ´.hxx´ ´.hpp´ ´.C´ ´.H´ are assumed to be C++ source files.  Files whose names end in
       ´.y´ are assumed to be YACC source files.  Files whose names end in ´.java´ are assumed to be Java source
       files.  Files whose names end in ´.php´ ´.php3´ ´.phtml´ are assumed to be PHP source files.  Files whose
       names end in ´.s´ or ´.S´ are assumed to be Assembly source files.  Other files are searched for C  style
       definitions.

       Yacc files each have a special tag. yyparse is the start of the second section of the yacc file.

       This command is the default parser of GLOBAL source code tag system.

OPTIONS

       The following options are available:

       -b, --begin-block
              Force level 1 block to begin when reach the left brace at the first column.  (C only)

       -e, --end-block
              Force level 1 block to end when reach the right brace at the first column.  (C only)

       -n, --no-tags
              Suppress output of tags. It is useful to use with -w option.

       -q, --quiet
              Quiet mode.

       -r, --reference
              Locate  object  references  instead  of  object  definitions.   ´GTAGS´  is  needed at the current
              directory.  (C, C++ and Java source only) By default, locate object definitions.

       -s, --symbol
              Collect symbols  other  than  object  definitions  and  references.   By  default,  locate  object
              definitions.

       -v, --verbose
              Verbose mode.

       -w, --warning
              Print warning message.

       --langmap=map
              Language mapping. Each comma-separated  map  consists of the language name, a colon, and a list of
              file      extensions.       Default      mapping      is      'c:.c.h,yacc:.y,asm:.s.S,java:.java,
              cpp:.c++.cc.cpp.cxx.hxx.hpp.C.H,php:.php.php3.phtml'.

       The -r and -s options override each other; the last one specified determines the method used.

ENVIRONMENT

       The following environment variables affect the execution of gtags-parser:

       GTAGSFORCECPP
              If this variable is set, each file whose suffix is 'h' is treated as a C++ source file.

DIAGNOSTICS

       Gtags-parser exits with a non 0 value if an error occurred,  0  otherwise.   Duplicate  objects  are  not
       considered errors.

SEE ALSO

       global(1), gtags(1), htags(1).

       GNU GLOBAL source code tag system
       (http://www.gnu.org/software/global/).

BUG

       Gtags-parser  relies  on  the input being well formed, and any syntactical errors will completely confuse
       it.

AUTHOR

       Tama Communications Corporation.

HISTORY

       The gtags-parser(gctags) command appeared in FreeBSD 2.2.2.

GNU Project                                        March 2008                                    GTAGS-PARSER(1)