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.