1GOZILLA(1)                  General Commands Manual                 GOZILLA(1)
2
3
4

NAME

6       gozilla - force mozilla to display specified source file.
7

SYNOPSIS

9       gozilla [-b browser][-p][+no] file
10       gozilla [-b browser][-p] -d name
11

DESCRIPTION

13       Gozilla  force mozilla to display specified source file as a hypertext.
14       Gozilla can be used with other browsers like firefox and epiphany.
15
16       In advance of  using  this  command,  you  must  execute  gtags(1)  and
17       htags(1)  at  the  root directory of the source tree to make tag files.
18       Then you can execute gozilla at anywhere in the source tree.
19
20       First form:
21       You can specify source file and the line number optionally.
22
23       Second form:
24       You can specify definition name directly. Definition name must exist in
25       ´GTAGS´ tag file.
26
27       Some browsers require you to load it before executing gozilla.  Whether
28       or not gozilla waits for exiting of browser depends on browser.
29

OPTIONS

31       The following options are available:
32
33       +no    line number. It must be a line on which function  definition  or
34              function  reference  is  exist.  If you execute htags(1) with -l
35              option, you can specify any line.
36
37       -b browser
38              browser to use. By default, it is assumed mozilla.
39
40       -d name
41              print function.
42
43       --help Show help.
44
45       -p     just print generated target URL.
46
47       file   path of source file or alias name.
48
49       -q, --quiet
50              Quiet mode.
51
52       -v, --verbose
53              Verbose mode.
54
55       --version
56              Show version number.
57

FILES

59       ´HTML/´
60              hypertext of source tree.
61
62       ´GTAGS/´
63              tags file for function definitions.
64
65       ´$HOME/.gozillarc´
66              alias file. Please read source code for the detail.
67

ENVIRONMENT

69       GTAGSROOT
70              The directory which is the root of source tree.
71
72       GTAGSDBPATH
73              The directory on which gtags  database  exist.   This  value  is
74              ignored when GTAGSROOT is not defined.
75
76       BROWSER
77              browser to use. By default, it is assumed mozilla.
78

EXAMPLES

80            $ gtags
81            $ htags
82            $ global -x main
83            main              82 ctags.c          main(argc, argv)
84            $ mozilla &
85            $ gozilla +82 ctags.c
86
87            $ firefox &
88            $ gozilla -b firefox +82 ctags.c
89
90            $ setenv BROWSER 'epiphany --new-tab'
91            $ epiphany &
92            $ gozilla +82 ctags.c
93

DIAGNOSTICS

95       Gozilla exits with a non 0 value if an error occurred, 0 otherwise.
96

SEE ALSO

98       global(1), gtags(1), htags(1), firefox(1), epiphany(1), mozilla(1).
99
100       GNU GLOBAL source code tag system
101       (http://www.gnu.org/software/global/).
102

NOTES

104       Gozilla means 'Global for mozilla'.
105

BUGS

107       Gozilla can treat not only source file but also normal file, directory,
108       HTML file and even URL, because it is omnivorous.
109

AUTHORS

111       Tama Communications Corporation.
112

HISTORY

114       The gozilla command appeared in FreeBSD 2.2.2 but did not installed  by
115       default.
116
117
118
119GNU Project                        July 2006                        GOZILLA(1)