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.