debian man page for gozilla

GOZILLA(1)						      General Commands Manual							GOZILLA(1)

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.

GNU Project							     July 2006								GOZILLA(1)