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.

       -d name
              print function.

       --help Show help.

       -p     just print generated target URL.

       file   path of source file or alias name.

       -q, --quiet
              Quiet mode.

       -v, --verbose
              Verbose mode.

       --version
              Show version number.

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.