[Contents]   [Back]   [Prev]   [Up]   [Next]   [Forward]  


5. Command References

5.1 global - print the locations of specified object.

NAME

global - print the locations of specified object.

SYNOPSIS

global [-aGilnqrstTvx][-e] pattern
global -c[qsv] prefix
global -f[anqrstvx] files
global -g[aGilnoqtvx][-e] pattern
global -I[ailnqtvx][-e] pattern
global -p[qrv]
global -P[aGilnoqtvx][-e] pattern
global -u[qv]

DESCRIPTION

Global find the locations of specified object in C, C++, Yacc, Java, PHP and Assembly source files. Global can treat a source tree, that is, a directory that has subdirectories and source files. You can get the relative path of objects from anywhere within the tree. Global can locate not only function definitions but also function references and other symbols. Duplicate entries are allowed.

In advance of using this command, you must execute gtags(1) at the root directory of the source tree to make tag files. Then you can execute at anywhere in the source tree.

COMMANDS

The following commands are available:

pattern
Print object which match to the pattern. Extended regular expressions which are the same as those accepted by egrep(1) are available.
`-c', `--completion' [prefix]
Print candidate function names which start with specified prefix. Prefix is not specified, print all function names.
`-f', `--file' files
Print all function definitions in the files. This option implies -x option.
`-g', `--grep'
Print all lines which match to the pattern.
`-I', `--idutils'
Print all lines which match to the pattern. This function use id-utils(1) as a search engine. To use this command, you need to install id-utils(1) in your system and you must execute gtags(1) with `-I' option.
`-p', `--print-dbpath'
Print the location of `GTAGS'.
`-P', `--path' [pattern]
Print the path which match to the pattern. If no pattern specified, print all.
`-u', `--update'
Locate tag files and update them incrementally.
`--version'
Show version number.
`--help'
Show help.

OPTIONS

The following options are available:

`-a', `--absolute'
Print absolute path name. By default, print relative path name.
`-e', `--regexp' pattern
Use pattern as the pattern; useful to protect patterns beginning with -.
`-G', `--basic-regexp'
Interpret pattern as a basic regular expression. The default is extended regular expression. This option is valid for the `-g' and `-P' command.
`-i', `--ignore-case'
ignore case distinctions in pattern.
`-l', `--local'
Print just objects which exist under the current directory.
`-n', `--nofilter'
Suppress sort filter and path conversion filter.
`-o', `--other'
Search pattern in not only source files but also other files like `README'. This option is valid only with `-g' or `-P' command.
`-q', `--quiet'
Quiet mode.
`-r', `--reference', `--rootdir'
Print the locations of object references. By default, print object definitions. With the `-p' option, print the root directory of source tree.
`--result' format
format may be 'path', `ctags', `ctags-x', `grep' or 'cscope'. The `--result=ctags' and `--result=ctags-x' are equivalent to the `-t' and `-x' respectively. The `-t' and `-x' are given to priority more than the `--result' option.
`-s', `--symbol'
Print the locations of specified symbol other than function names. You need `GSYMS' tags file. See gtags(1).
`-t', `--tags'
Print with standard ctags format.
`-T', `--through'
Go through all the tag files listed in GTAGSLIBPATH. By default, stop searching when tag is found. This option is ignored when either `-s', `-r' or `-l' option is specified.
`-v', `--verbose'
Verbose mode.
`-x', `--cxref'
In addition to the default output, produce the line number and the line contents.

EXAMPLES

	$ ls -F
	Makefile      src/    lib/
	$ gtags
	$ global main
	src/main.c
	$ global -x main
	main              10 src/main.c  main (argc, argv) {
	$ global -x '^[sg]et'
	set_num           20 lib/util.c  set_num(values)
	get_num           30 lib/util.c  get_num() {
	$ global -rx '^[sg]et'
	set_num          113 src/op.c            set_num(32);
	set_num          225 src/opop.c               if (set_num(0) > 0) {
	get_num           90 src/op.c            while (get_num() > 0) {
	$ cd lib
	$ global -rx '^[sg]et'
	set_num          113 ../src/op.c            set_num(32);
	set_num          225 ../src/opop.c               if (set_num(0) > 0) {
	get_num           90 ../src/op.c            while (get_num() > 0) {
	$ global strlen
	$ (cd /usr/src/sys; gtags)
	$ export GTAGSLIBPATH=/usr/src/sys
	$ global strlen
	../../../usr/src/sys/libkern/strlen.c
	$ (cd /usr/src/lib; gtags)
	$ GTAGSLIBPATH=/usr/src/lib:/usr/src/sys
	$ global strlen
	../../../usr/src/lib/libc/string/strlen.c

FILES

`GTAGS'
Tag file for function definitions.
`GRTAGS'
Tag file for function references.
`GSYMS'
Tag file for other symbols.
`GPATH'
Tag file for path of source files.
`GTAGSROOT'
If environment variable GTAGSROOT is not set and `GTAGSROOT' exist in the same directory with `GTAGS' then use the value as GTAGSROOT.
`/etc/gtags.conf', `$HOME/.globalrc'
Configuration file.

ENVIRONMENT

The following environment variables affect the execution of global:

GTAGSROOT
The directory which is the root of source tree.
GTAGSDBPATH
The directory on which gtags database exist. This value is ignored when GTAGSROOT is not defined.
GTAGSLIBPATH
If this variable is set, it is used as the path to search for library functions. If the specified function is not found in a source tree, global also search in these paths.
GTAGSLABEL
If this variable is set, its value is used as the label of configuration file. The default is default.

CONFIGURATION

The following configuration variables affect the execution of global:

icase_path(boolean)
Ignore case distinctions in the pattern.

DIAGNOSTICS

Global exits with a non 0 value if an error occurred, 0 otherwise.

SEE ALSO

gtags-parser(1), gtags(1), htags(1), less(1).

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

AUTHOR

Tama Communications Corporation.

HISTORY

The global command appeared in FreeBSD 2.2.2.

5.2 gtags - create tag files for global.

NAME

gtags - create tag files for global.

SYNOPSIS

gtags [-iIqvw][-f file][-n number][dbpath]

DESCRIPTION

Gtags recursively collect the source files under the current directory, pickup symbols and write the cross-reference data into tag files (`GTAGS', `GRTAGS', `GSYMS' and `GPATH'). You should execute this command at the root of the source tree.

C, C++, yacc, java, PHP and Assembly source files are supported. Files whose names end in `.c' or `.h' are assumed to be C source files and are searched for C style routine and macro definitions. 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 Assembler source files. Other files are searched for C style definitions.

OPTIONS

The following options are available:

`--config' name
Show the value of config variable name. If name is not specified then show whole of config entry.
`-f', `--file' file
Read from file a list of file names which should be considered as the candidate of source files. By default, all files under the current directory are considered as the candidate. If file is `-', read from standard input. File names must be separated by newline.
`--gtagsconf' file
Load user's configuration from file.
`--gtagslabel' label
label is used as the label of configuration file. The default is default.
`-i', `--incremental'
Update tag files incrementally. You had better use global(1) with the -u option.
`-I', `--idutils'
Make index files for id-utils(1).
`-n', `--max-args' number
Maximum number of arguments for gtags-parser(1). By default, gtags invokes the parser with arguments as a lot as possible to decrease the frequency of invoking.
`-q', `--quiet'
Quiet mode.
`-v', `--verbose'
Verbose mode.
`-w', `--warning'
Print warning messages.
dbpath
The directory in which tag files are generated. The default is the current directory. It is useful when your source directory is on a read only device like CDROM.

EXAMPLES

	$ ls -F
	Makefile      src/    lib/
	$ gtags -v
	$ global -x main
	main              10 src/main.c  main (argc, argv) {

FILES

`GTAGS'
Tag file for function definitions.
`GRTAGS'
Tag file for function references.
`GSYMS'
Tag file for other symbols.
`GPATH'
Tag file for path of source files.
`/etc/gtags.conf', `$HOME/.globalrc'
Configuration file.

ENVIRONMENT

The following environment variables affect the execution of gtags:

GTAGSCONF
If this variable is set, its value is used as the configuration file. The default is `$HOME/.globalrc'.
GTAGSLABEL
If this variable is set, its value is used as the label of configuration file. The default is default.
GTAGSCACHE
If this variable is set, its value is used as the size of btree cache. The default is 500000 (bytes).

CONFIGURATION

The following configuration variables affect the execution of gtags. You can see the default value for each variable with the `--config' option.

GTAGS(string)
If this variable is set, its value is used as the command line of parser for GTAGS. The default is `gtags-parser -dt %s'.
GRTAGS(string)
If this variable is set, its value is used as the command line of parser for GRTAGS. The default is `gtags-parser -dtr %s'.
GSYMS(string)
If this variable is set, its value is used as the command line of parser for GSYMS. The default is `gtags-parser -dts %s'.
skip(comma separated list)
Gtags skips files which listed in this list. As a special exception, gtags collect values from multiple skip variables. If the value ends with '/', it assumed as a directory and gtags skips all files under it. If the value start with '/', it assumed relative path from the root of source directory.
suffixes(comma separated list)
Suffixes of target source file. As a special exception, gtags collect values from multiple suffixes variables. This variable is obsoleted. If the langmap variable is defined gtags no longer refers this.
icase_path(boolean)
Ignore case distinctions in the path. Suffixes check are affected by this capability.
langmap(comma separated list)
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'.

DIAGNOSTICS

Gtags exits with a non 0 value if an error occurred, 0 otherwise.

MESSAGE FORMAT

Verbose message has important level. The most important level is 0, the second is 1 and so on. All the message has level numbers leading blanks.

SEE ALSO

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

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

BUG

`GTAGS', `GRTAGS' and `GSYMS' are very large. In advance of using this command, check the space of your disk.

Assembler support is far from complete. It extracts only ENTRY() and ALTENTRY() from source file. Probably valid only for FreeBSD and Linux kernel source.

There is no concurrency control about tag files.

Symbols in Assembly source files are not extracted for `GSYMS'.

AUTHOR

Tama Communications Corporation.

HISTORY

The gtags command appeared in FreeBSD 2.2.2.

5.3 htags - generate hypertext from source code.

NAME

htags - generate hypertext from source code.

SYNOPSIS

htags [-acDfFghInosTvwx][-d dbpath][-m name][-S cgidir][-t title][dir]

DESCRIPTION

Htags makes hypertext of C, C++, Yacc, Java, PHP and Assembly source code.

In advance of using this command, you must execute gtags(1) from the root directory of the source tree. Then you can execute htags from the same place. Htags makes an directory named `HTML' and generates hypertext in it. You can start browsing from `HTML/index.html'.

Since htags generates static hypertext as long as the `-D' or `-f' option is not specified, you can move it anywhere and browse it with any browser without web server.

You must use same parser for both gtags(1) and htags. If you use the default parser, it is not necessary to consider for it.

OPTIONS

The following options are available:

`-a', `--alphabet'
Make an alphabetical function index which is suitable for a large project.
`--caution'
Include caution message to prohibit downloading.
`-c', `--compact'
Compress html files by gzip(1). You need to set up a web server so that gzip(1) is invoked for each compressed file. See `HTML/.htaccess' that is generated by htags.
`--cvsweb' url
Include cvsweb URL. url is used as base of URL.
`--cvsweb-cvsroot' cvsroot
Specifies cvsroot in cvsweb URL.
`-D', `--dynamic'
Generate object lists dynamically using CGI program. By default, object lists are generated statically. Though this option decrease both the size and the generation time of the hypertext, you need to set up a web server, and you cannot move the hypertext from the source directroy.
`-d', `--dbpath' dbpath
Specifies the directory in which `GTAGS' and `GRTAGS' exist. The default is the current directory.
`-f', `--form'
Support search form using CGI program. You need to set up a web server, and you cannot move the hypertext from the source directroy.
`-F', `--frame'
Use frame for each part of the contents.
`-g', `--gtags'
Execute gtags(1) before creating hypertext. The `-v', `-w' and dbpath are passed to gtags.
`-h', `--func-header'
Insert function header for each function. By default, htags doesn't generates it.
`-I', `--icon'
Use icons instead of text for some links.
`--gtagsconf' file
Load user's configuration from file.
`--gtagslabel' label
label is used for the label of configuration file. The default is default.
`--insert-header' file
Insert custom header derived from file after <body> tag.
`--insert-footer' file
Insert custom footer derived from file before </body> tag.
`-m', `--main-func' name
Specify the main function name. The default is main.
`-n', `--line-number'
Print line numbers. By default, doesn't print them.
`--no-map-file'
Doesn't generate `MAP' and `FILEMAP' file. By default, htags generates them.
`-o', `--other'
Pick up not only source files but also other files except for binary files.
`--statistics'
Print statistics information.
`-s', `--symbol'
Make anchors not only for functions but also other symbols. `GSYMS' tag file needed.
`-S', `--secure-cgi' cgidir
Write CGI programs into the cgidir to realize a centralised CGI program. Script alias is `/cgi-bin' by default. You can overwrite this value using config variable script_alias in `gtags.conf'.
`-t', `--title' title
The title of this hypertext. The default is the last component of the current directory.
`-T', `--table-flist' [fields]
Generate file list using <table> tag. The fields is used for field number in a line. The default is 5.
`-v', `--verbose'
Verbose mode.
`-w', `--warning'
Print warning messages.
`-x', `--xhtml'
Generate XHTML hypertext instead of HTML. If the `--frame' option is specified then generate XHTML-1.0 Frameset for index.html and generate XHTML-1.0 Transitional for other files, else if config variable xhtml_version is set to 1.1 then generate XHTML-1.1 else XHTML 1.0 Transitional.
dir
The directory in which hypertext is generated. The default is the current directory.

EXAMPLES

	$ gtags -v
	$ htags -sanohITvt 'Welcom to XXX source tour!'
	$ firefox HTML/index.html

FILES

`GTAGS'
Tag file for function definitions.
`GRTAGS'
Tag file for function references.
`GSYMS'
Tag file for other symbols.
`GPATH'
Tag file for path of source files.
`/etc/gtags.conf', `$HOME/.globalrc'
Configuration file.
`HTML/index.html'
Index file for hypertext.
`HTML/MAP'
Mapping file for converting tag into path of hypertext. External system utilize this file.
`HTML/FILEMAP'
Mapping file for converting file name into path of hypertext. External system utilize this file.
`HTML/style.css'
Style sheet file. This file is generated when the `--xhtml' option is specified.

ENVIRONMENT

The following environment variables affect the execution of htags:

TMPDIR
If this variable is set, its value is used as the directory to make temporary files. The default is `/tmp'.
GTAGSCONF
If this variable is set, its value is used as the configuration file. The default is `$HOME/.globalrc'.
GTAGSLABEL
If this variable is set, its value is used as the label of configuration file. The default is default.
GTAGSCACHE
If this variable is set, its value is used as the size of btree cache. The default is 500000 (bytes).

CONFIGURATION

The following configuration variables affect the execution of htags: If the `--xhtml' option is specified then all definitions of HTML tag are ignored. Instead, you can customize the appearance using style sheet file (`style.css').

datadir(string)
Shared data directory. The default is '/usr/local/share' but you can change the value using configure script. Htags lookup templete files in the 'gtags' directory in this data directory.
htags_options(string)
Default options for htags. This value is inserted into the head of arguments.
xhtml_version(1.0|1.1)
XHTML version. 1.0 and 1.1 are acceptable. The default is 1.0.
body_begin(string)
Begin tag for body. The default is '<body text=#191970 bgcolor=#f5f5dc vlink=gray>'.
body_end(string)
End tag for body. The default is '</body>'.
table_begin(string)
Begin tag for table. The default is '<table>'.
table_end(string)
End tag for table. The default is '</table>'.
title_begin(string)
Begin tag for Title. The default is '<h1><font color=#cc0000>'.
title_end(string)
End tag for Title. The default is '</font></h1>'.
comment_begin(string)
Begin tag for comments. The default is '<i><font color=green>'.
comment_end(string)
End tag for comments. The default is '</font></i>'.
dynamic(bool)
Generate object list dynamically.
sharp_begin(string)
Begin tag for 'define'. The default is '<font color=darkred>'.
sharp_end(string)
End tag for 'define'. The default is '</font>'.
brace_begin(string)
Begin tag for brace. The default is '<font color=red>'.
brace_end(string)
End tag for brace. The default is '</font>'.
reserved_begin(string)
Begin tag for reserved word. The default is '<b>'.
reserved_end(string)
End tag for reserved word. The default is '</b>'.
position_begin(string)
Begin tag for posiotion mark. The default is '<font color=gray>'.
position_end(string)
End tag for posiotion mark. The default is '</font>'.
colorize_warned_line(boolean)
Colorize warned line using warned_line_begin and warned_line_end. The default is false.
warned_line_begin(string)
Begin tag for line which htags warned. The default is '<span style="background-color:yellow">'.
warned_line_end(string)
End tag for line which htags warned. The default is '</span>'.
hr(string)
Horizontal rules. The default is '<hr>'.
ncol(number)
Columns of line number. The default is 4.
tabs(number)
Tab stop. The default is 8.
flist_fields(number)
Field number of file index. The default is 5.
full_path(boolean)
List file names with full path in file index. By default, list just the last component of a path.
table_list(boolean)
List tags using <table> tag. The default is false.
table_flist(boolean)
Use <table> tag for file index. The default is false.
normal_suffix(string)
Suffix for normal html file. The default is 'html'.
no_map_file(boolean)
Doesn't generate `MAP' file. The default is false.
gzipped_suffix(string)
Suffix for compressed html file. The default is 'ghtml'.
script_alias(string)
Script alias for safe cgi script (`-S').
show_position(boolean)
Show position per function definition. The default is false.
definition_header(no|before|right|after)
Position of function header. The default is 'no'.
other_files(boolean)
File index includes not only source files but also other files. The default is false.
disable_grep(boolean)
Disable grep in search form(-f,--form). The default is false.
enable_idutils(boolean)
Enable id-utils in search form(-f,--form). The default is false.
include_file_suffixes(comma separated list)
Suffixes of include file. The default is 'h,hxx,hpp,H,inc.php'.
langmap(comma separated list)
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'.
copy_files(boolean)
Copy files instead of linking. When the `-f' option is used, htags make links of tag files in `cgi-bin' directory by default.

DIAGNOSTICS

Htags exits with a non 0 value if an error occurred, 0 otherwise.

MESSAGE FORMAT

Verbose message has important level. The most important level is 0, the second it 1 and so on. All the message has level numbers leading blanks.

SEE ALSO

gtags-parser(1), global(1), gtags(1).

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

BUG

Generated hypertext is VERY LARGE. In advance, check the space of your disk.

PHP supprt is far from complete.

AUTHOR

Tama Communications Corporation.

HISTORY

The htags command appeared in FreeBSD 2.2.2.

5.4 gtags-parser - print cross reference list for gtags.

NAME

gtags-parser - print cross reference list for gtags.

SYNOPSIS

gtags-parser [-bdenrstvw] 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 function definitions, function references and other symbols.

Files whose names end in `.c' or `.h' are assumed to be C source files and are searched for C style routine and macro definitions. 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 Assembler 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 a left brace at the first column. (C only)
`-d', `--define'
Pick up not only function but also macro without argument as a definition.
`-e', `--end-block'
Force level 1 block to end when reach a right brace at the first column. (C only)
`-n', `--no-tags'
Suppress output of tags. It is useful to use with `-w' option.
`-r', `--reference'
Locate function references instead of function definitions. `GTAGS' is needed at the current directory. (C, C++ and Java source only) By default, locate function definitions.
`-s', `--symbol'
Collect symbols other than functions. By default, locate function definitions.
`-t', `--typedef'
Pick up not only function but also typedef name and enum member as a definition.
`-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.

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.

Assembler support is far from complete. Probably valid only for FreeBSD and Linux kernel source.

AUTHOR

Tama Communications Corporation.

HISTORY

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

5.5 gozilla - force mozilla to display specified source file.

NAME

gozilla - force mozilla to display specified source file.

SYNOPSIS

gozilla [-b browser][-p][+no] file
gozilla [-b browser][-p] -d name

DESCRIPTION

Gozilla force mozilla to display specified source file as a hypertext. Gozilla can be used with other browsers like firefox and epiphany.

In advance of using this command, you must execute gtags(1) and htags(1) at the root directory of the source tree to make tag files. Then you can execute gozilla at anywhere in the source tree.

First form:
You can specify source file and the line number optionally.

Second form:
You can specify definition name directly. Definition name must exist in `GTAGS' tag file.

Some browsers require you to load it before executing gozilla. Whether or not gozilla waits for exiting of browser depends on browser.

OPTIONS

The following options are available:

`+no'
line number. It must be a line on which function definition or function reference is exist. If you execute htags(1) with `-l' option, you can specify any line.
`-b' browser
browser to use. By default, it is assumed mozilla.
`-p'
just print generated target URL.
file
path of source file or alias name.
`-d' name
print function.
`-q', `--quiet'
Quiet mode.
`-v', `--verbose'
Verbose mode.
`--version'
Show version number.
`--help'
Show help.

FILES

`HTML/'
hypertext of source tree.
`GTAGS/'
tags file for function definitions.
`$HOME/.gozillarc'
alias file. Please read source code for the detail.

ENVIRONMENT

GTAGSROOT
The directory which is the root of source tree.
GTAGSDBPATH
The directory on which gtags database exist. This value is ignored when GTAGSROOT is not defined.
BROWSER
browser to use. By default, it is assumed mozilla.

EXAMPLES

	$ gtags
	$ htags
	$ global -x main
	main              82 ctags.c          main(argc, argv)
	$ mozilla &
	$ gozilla +82 ctags.c

	$ firefox &
	$ gozilla -b firefox +82 ctags.c

	$ setenv BROWSER 'epiphany --new-tab'
	$ epiphany &
	$ gozilla +82 ctags.c

DIAGNOSTICS

Gozilla exits with a non 0 value if an error occurred, 0 otherwise.

SEE ALSO

global(1), gtags(1), htags(1), firefox(1), epiphany(1), mozilla(1).

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

NOTES

Gozilla means 'Global for mozilla'.

BUGS

Gozilla can treat not only source file but also normal file, directory, HTML file and even URL, because it is omnivorous.

AUTHORS

Tama Communications Corporation.

HISTORY

The gozilla command appeared in FreeBSD 2.2.2 but did not installed by default.

5.6 gtags-cscope - pseudo cscope which implements the line-oriented interface

NAME

gtags-cscope - pseudo cscope which implements the line-oriented interface

SYNOPSIS

gtags-cscope [-Cqv]

DESCRIPTION

Gtags-cscope is a pseudo cscope which implements the line-oriented interface. You can use this command for various clients instead of true cscope.

Since gtags-cscope is intended to make GLOBAL available through cscope interface, the output is not necessarily the same as cscope.

OPTIONS

The following options are available:

`-C', `--ignore-case'
Ignore letter case when searching.
`-q', `--quiet'
Quiet mode.
`-v', `--verbose'
Verbose mode.

EXAMPLES

	$ gtags-cscope
	>> help
	0<arg>: Find this C symbol
	1<arg>: Find this definition
	2<arg>: Find functions called by this function
		(Not implemented yet.)
	3<arg>: Find functions calling this function
	4<arg>: Find this text string
	6<arg>: Find this egrep pattern
	7<arg>: Find this file
	8<arg>: Find files #including this file
	c: Toggle ignore/use letter case
	r: Rebuild the database
	q: Quit the session
	h: Show help
	>> 1main
	cscope: 9 lines
	global/global.c main 158 main(int argc, char **argv)
	gozilla/gozilla.c main 155 main(int argc, char **argv)
	gtags-parser/gctags.c main 158 main(int argc, char **argv)
	gtags-cscope/gtags-cscope.c main 115 main(int argc, char **argv)
	gtags/gtags.c main 150 main(int argc, char **argv)
	htags-refkit/htags_path2url.c main 281 main(int argc, char **argv)
	htags/htags.c main 1400 main(int argc, char **argv)
	libglibc/getopt.c main 704 main (argc, argv)
	libglibc/getopt1.c main 93 main (argc, argv)
	>> q
	$ _

DIAGNOSTICS

Gtags-cscope exits with a non 0 value if an error occurred, 0 otherwise.

SEE ALSO

cscope(1), gtags-parser(1), gtags(1), global(1), htags(1).

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

BUG

The second field of the output is almost <unknown> since GLOBAL doesn't recognize it. Command 2 (Find functions called by this function) is not implemented.

AUTHOR

Tama Communications Corporation.

HISTORY

The gtags-cscope command appeared in 2006.


[Contents]   [Back]   [Prev]   [Up]   [Next]   [Forward]