GOZILLA(1)

💅 GOZILLA(1) — the General Commands Manual ✨

okay bestie, welcome to gozilla, a whole General Commands Manual entry, and no it is not a monster movie, it is a tiny little command that makes your browser jump straight to the exact line of source code you asked for 🦋

---

🌸 NAME 🌸

gozilla — force firefox to display specified part of a source file 💖

---

✨ SYNOPSIS ✨

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

---

🫶 DESCRIPTION 🫶

so basically gozilla forces firefox to display a specified part of a source file. like, it does not ask nicely, it just does it. and before you ask — yes, gozilla can be used with other browsers too, like chrome 👑

before you run this command, you gotta run gtags(1) and htags(1) at the root directory of the project to make tag files. that's the whole prerequisite, no cap. once that's done you can run this command anywhere in the project 🌈

First form: you can specify a source file and an optional line number. this syntax is similar to vi(1) and emacs(1) — so if those are your girls, you already get it 💅

Second form: you can specify a definition name directly. that definition name needs to exist in ´GTAGS´. and heads up, this option requires ´HTML/MAP´ generated by htags(1) — no map, no service 🙈

also, some browsers require you to load it before executing gozilla. so like, open the browser first, bestie. don't be weird about it.

---

🎀 OPTIONS 🎀

here's the whole lineup, the following options are available:

• +no — line number. that's it, that's the vibe.
• -b browser — the browser to use. by default, it is assumed firefox.
• -d name — print definitions.
• --help — show help. (iconic, everyone's favorite)
• -p — just print a generated URL instead of displaying it. lowkey so useful for scripting.
• file — file name or alias name.
• -q, --quiet — quiet mode. shhh 🤫
• -v, --verbose — verbose mode. tell me EVERYTHING.
• --version — show version number.

---

💜 FILES 💜

the files it cares about, besties:

• ´GTAGS´ — tag file for definitions.
• ´HTML/´ — hypertext of source code.
• ´HTML/MAP´ — mapping file for converting tag name into the path of tag list.
• ´gtags.conf´, ´$HOME/.globalrc´ — configuration data for GNU Global. see gtags.conf(5) for the deets.

---

🧚 ENVIRONMENT 🧚

env vars, the way that they control everything:

• BROWSER — browser to use. by default, it is assumed firefox. and if you want to load the default browser in OSX, you may set this variable to osx-default. very demure, very mindful 🍓
• GTAGSDBPATH — the directory in which the tag files exist. heads up though: this value is ignored when GTAGSROOT is not defined. 👀
• GTAGSROOT — the root directory of the project.

---

🔥 EXAMPLES 🔥

a whole little group chat of examples, watch:

$ gtags
$ htags
$ global -x main
main              82 ctags.c          main(argc, argv)
$ gozilla +82 ctags.c
$ gozilla -d main

$ gozilla -b lynx +82 ctags.c

see? gtags, then htags, then global to find the thing, then gozilla to yeet yourself right to it. and look at that last one — swapping the browser with -b lynx?? main character energy fr fr 😭

---

💀 DIAGNOSTICS 💀

Gozilla exits with a non-0 value if an error occurred, 0 otherwise. so 0 = we ate, non-0 = something's wrong bestie, check the vibes.

---

⭐ SEE ALSO ⭐

global(1), gtags(1), htags(1), epiphany(1), firefox(1), gtags.conf(5).

GNU Global source code tag system (http://www.gnu.org/software/global/).

---

👑 AUTHORS 👑

Shigio YAMAGUCHI. we stan. 💖

---

🌈 HISTORY 🌈

The gozilla command appeared in FreeBSD 2.2.2 but was not installed by default. so it was there, just lurking. mysterious. iconic. periodt ✨

---

okay that's the whole page, and just so you have the receipts: this was the GNU Project's version, dated March 2010, from the GOZILLA(1) manual. go forth and jump to line numbers, bestie 💅🦋🎀