gozilla.1

代码检索工具GLOBAL源码。可用来浏览分析LINUX源码。

.\" This file is generated automatically by convert.pl from gozilla/manual.in.
.TH GOZILLA 1 "May 2004" "GNU Project"
.SH NAME
gozilla \- force mozilla to display specified source file.
.SH SYNOPSIS
\fBgozilla\fP [-b browser][-p][+no] file
.br
\fBgozilla\fP [-b browser][-p] -d name
.br
.SH DESCRIPTION
\fBGozilla\fP force mozilla to display specified source
file as a hypertext.
.PP
In advance of using this command, [1] you must execute \fBgtags\fP(1)
and \fBhtags\fP(1) at the root directory of the source tree
to make tag files, and [2] execute mozilla in you computer.
Then you can execute gozilla at anywhere in the source tree.
.PP
First form:
.br
You can specify source file and the line number optionally.
.PP
Second form:
.br
You can specify definition name directly. Definition name must exist 
in \'GTAGS\' tag file.
.SH OPTIONS
The following options are available:
.TP
\fB+no\fP
line number. It must be a line on which function definition or
function reference is exist.  If you execute \fBhtags\fP(1)
with \fB-l\fP option, you can specify any line.
.TP
\fB-b\fP \fIbrowser\fP
browser to use. By default, it is assumed mozilla.
If you specify another browser, \fBgozilla\fP waits for
exiting of the browser.
.TP
\fB-p\fP
just print generated target URL.
.TP
\fIfile\fP
path of source file or alias name.
.TP
\fB-d\fP \fIname\fP
print function.
.TP
\fB-q\fP, \fB--quiet\fP
Quiet mode.
.TP
\fB-v\fP, \fB--verbose\fP
Verbose mode.
.TP
\fB--version\fP
Show version number.
.TP
\fB--help\fP
Show help.
.SH FILES
.TP
\'HTML/\'
hypertext of source tree.
.TP
\'GTAGS/\'
tags file for function definitions.
.TP
\'$HOME/.gozillarc\'
alias file. Please read source code for the detail.
.SH ENVIRONMENT
.TP
\fBGTAGSROOT\fP
The directory which is the root of source tree.
.TP
\fBGTAGSDBPATH\fP
The directory on which gtags database exist.
This value is ignored when \fBGTAGSROOT\fP is not defined.
.TP
\fBBROWSER\fP
browser to use. By default, it is assumed mozilla.
.SH EXAMPLES
.nf
	$ gtags
	$ htags
	$ mozilla &
	$ global -x main
	main              82 ctags.c          main(argc, argv)
	$ gozilla +82 ctags.c
.fi
.SH DIAGNOSTICS
\fBGozilla\fP exits with a non 0 value if an error occurred, 0 otherwise.
.SH "SEE ALSO"
\fBglobal\fP(1),
\fBgtags\fP(1),
\fBhtags\fP(1),
\fBmozilla\fP(1).
.PP
GNU GLOBAL source code tag system
.br
(http://www.gnu.org/software/global/).
.SH NOTES
\fBGozilla\fP means 'Global for mozilla'.
.SH BUGS
\fBGozilla\fP can treat not only source file but also normal file,
directory, HTML file and even URL, because it is omnivorous.
.PP
I don't know whether or not \fBgozilla\fP works well in Windows32
environment.
.SH AUTHORS
Tama Communications Corporation.
.SH HISTORY
The \fBgozilla\fP command appeared in FreeBSD 2.2.2 but did not
installed by default.