gozilla - Man Page
force firefox to display specified part of a source file
Synopsis
gozilla [-b browser][-p][+no] file
gozilla [-b browser][-p] -d name
Description
Gozilla forces firefox to display specified part of a source file. Gozilla can be used with other browsers like chrome.
In advance of using this command, you must execute gtags(1) and htags(1) at the root directory of the project to make tag files. Then you can execute this command anywhere in the project.
First form:
You can specify a source file and optional line number. This syntax is similar to vi(1) and emacs(1).
Second form:
You can specify a definition name directly. The definition name should exist in ´GTAGS´. This option requires ´HTML/MAP´ generated by htags(1).
Some browsers require you to load it before executing gozilla.
Options
The following options are available:
- +no
Line number.
- -b browser
Browser to use. By default, it is assumed firefox.
- -d name
Print definitions.
- --help
Show help.
- -p
Just print a generated URL instead of displaying it.
- file
File name or alias name.
- -q, --quiet
Quiet mode.
- -v, --verbose
Verbose mode.
- --version
Show version number.
Files
- ´GTAGS´
Tag file for definitions.
- ´HTML/´
Hypertext of source code.
- ´HTML/MAP´
Mapping file for converting tag name into the path of tag list.
- ´gtags.conf´, ´$HOME/.globalrc´
Configuration data for GNU GLOBAL. See gtags.conf(5).
Environment
- BROWSER
Browser to use. By default, it is assumed firefox. If you want to load the default browser in OSX, you may set this variable to osx-default.
- GTAGSDBPATH
The directory in which the tag files exist. This value is ignored when GTAGSROOT is not defined.
- GTAGSROOT
The root directory of the project.
Examples
$ gtags $ htags $ global -x main main 82 ctags.c main(argc, argv) $ gozilla +82 ctags.c $ gozilla -d main $ gozilla -b lynx +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), epiphany(1), firefox(1), gtags.conf(5).
GNU GLOBAL source code tag system
(http://www.gnu.org/software/global/).
Authors
Shigio YAMAGUCHI.
History
The gozilla command appeared in FreeBSD 2.2.2 but was not installed by default.