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.