.\" This file is generated automatically by convert.pl from gozilla/manual.in.
.TH GOZILLA 1 "March 2010" "GNU Project"
.SH NAME
gozilla \- force firefox to display specified part of a source file
.SH SYNOPSIS
\fBgozilla\fP [-b browser][-p][+no] file
.br
\fBgozilla\fP [-b browser][-p] -d name
.br
.SH DESCRIPTION
\fBGozilla\fP forces firefox to display specified part of a source file.
\fBGozilla\fP can be used with other browsers like chrome.
.PP
In advance of using this command, you must execute \fBgtags\fP(1)
and \fBhtags\fP(1) at the root directory of the project to make tag files.
Then you can execute this command anywhere in the project.
.PP
First form:
.br
You can specify a source file and optional line number.
This syntax is similar to \fBvi\fP(1) and \fBemacs\fP(1).
.PP
Second form:
.br
You can specify a definition name directly. The definition name should
exist in \'GTAGS\'. This option requires \'HTML/MAP\' generated
by \fBhtags\fP(1).
.PP
Some browsers require you to load it before executing \fBgozilla\fP.
.SH OPTIONS
The following options are available:
.TP
\fB+no\fP
Line number.
.TP
\fB-b\fP \fIbrowser\fP
Browser to use. By default, it is assumed \fBfirefox\fP.
.TP
\fB-d\fP \fIname\fP
Print definitions.
.TP
\fB--help\fP
Show help.
.TP
\fB-p\fP
Just print a generated URL instead of displaying it.
.TP
\fIfile\fP
File name or alias name.
.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.
.SH FILES
.TP
\'GTAGS\'
Tag file for definitions.
.TP
\'HTML/\'
Hypertext of source code.
.TP
\'HTML/MAP\'
Mapping file for converting tag name into the path of tag list.
.TP
\'gtags.conf\', \'$HOME/.globalrc\'
Configuration data for GNU GLOBAL.
See \fBgtags.conf\fP(5).
.SH ENVIRONMENT
.TP
\fBBROWSER\fP
Browser to use. By default, it is assumed \fBfirefox\fP.
If you want to load the default browser in OSX, you may set this variable
to \fBosx-default\fP.
.TP
\fBGTAGSDBPATH\fP
The directory in which the tag files exist.
This value is ignored when \fBGTAGSROOT\fP is not defined.
.TP
\fBGTAGSROOT\fP
The root directory of the project.
.SH EXAMPLES
.nf
$ gtags
$ htags
$ global -x main
main              82 ctags.c          main(argc, argv)
$ gozilla +82 ctags.c
$ gozilla -d main
.PP
$ gozilla -b lynx +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),
\fBepiphany\fP(1),
\fBfirefox\fP(1),
\fBgtags.conf\fP(5).
.PP
GNU GLOBAL source code tag system
.br
(http://www.gnu.org/software/global/).
.SH AUTHORS
Shigio YAMAGUCHI.
.SH HISTORY
The \fBgozilla\fP command appeared in FreeBSD 2.2.2 but was not
installed by default.