gitaction(1)

💅 gitaction — the manual page, but make it cute

okay bestie, welcome to gitaction(1) from the General Commands Manual — GNU Interactive Tools' little per-file-type action script that just gets you 🫶

---

✨ NAME ✨

gitaction — GNU Interactive Tools — per file type action script 🌸

---

🌈 SYNTAX 🌈

gitaction directory file
.gitaction directory file

---

👑 DESCRIPTION 👑

gitaction is a script that runs a different action for each file type you specify. It's called by the gitfm program when you press F2 or ^Xa — and yeah, that's the gnuitrc.TERM configuration files from the gnuit manual, iykyk 📖✨

So here's the deal with the two args:

• the first parameter is the current directory name
• the second parameter is the file name that gets matched against the default patterns

The matching is done using the shell case statement. no cap 🐚

Now the fun part, the ~vibes~ 💅:

• press F2 or ^Xa on a *.html file → gitfm invokes a browser to view it 🌐
• press F2 or ^Xa on a *.tar.gz file → gitfm lists the tar archive contents 📦
• press those same keys on a *.gz file → gitfm displays its uncompressed contents on the screen 😌

...and etc, etc, the list goes on forever fr fr.

If you press F2 or ^Xa on a *.gif file or a *.jpg file and you have the zgv utility installed, you will be able to see it 🖼️✨ And if you wanna change the gif/jpeg viewer? literally all you gotta do is change its name in the gitaction script. that's it. iconic.

There are many more file types and viewers that gitaction knows about. main character energy honestly. In addition:

• if you're running under GNOME, gnome-open is used
• on MacOS, open(1) is used
• see(1) and metamail(1) are also used as fallbacks 🧚

If all else fails, the file is displayed using $GNUIT_PAGER. Feel free to change this 💖 And if you wanna find out what the default action for each file type is (or if you wanna modify it), just read/modify the gitaction script. It's giving open source, bestie.

The script can be easily enhanced. Just read it. 📚

---

🦋 the .gitaction local version 🦋

The .gitaction script is a local version of the gitaction script. Here's how it goes:

When started, gitaction tries to search a script called .gitaction in the current directory and, if it finds it, it starts it. Then — if .gitaction's exit code is 0 (meaning .gitaction couldn't find a matching pattern), gitaction starts its own case statement trying to match the current file name (the second parameter) against its default patterns 🔍

⚠️ The .gitaction script *must* be executable. Not optional. Periodt.

An example of .gitaction can be found in the directory gitfm is installed into (usually /usr/local/bin or /usr/bin). Debian users can find it in /usr/share/doc/gnuit/examples/ 🍓 You should copy the example to the current directory or your home directory and then modify it.

---

💀 BUGS 💀

Please send bug reports to:

gnuit-dev@gnu.org

(not me being emotionally devastated by a bug report 😭)

---

🔥 SEE ALSO 🔥

gitfm(1) gitps(1) gitview(1) gitmount(1) gitkeys(1) gitrgrep(1) gitunpack(1)

---

⭐ AUTHORS ⭐

• Tudor Hulubei <tudor@cs.unh.edu>
• Andrei Pitis <pink@pub.ro>
• Ian Beckwith <ianb@erislabs.net> (current maintainer). 👑

---

okay that's the whole page, you ate it 💅✨ this was gitaction(1) from the General Commands Manual — mwah, go press F2 on something and live your truth 🎀🦋