gitaction (1)

Leading comments

+----------
|
|			      GITACTION man page
|
|	      Copyright 1993-1999, 2006-2007 Free Software Foundation, Inc.
|
|	This file is part of GNUIT (GNU Interactive Tools)
|
|	GNUIT is free software; you can redistribute it and/or modify it under
| the terms of the GNU General Public License as published by the Free
| Software Foundation; either version 3, or (at your option) any later
| version.
|
| GNUIT is distributed in the hope that it will be useful, but WITHOUT ANY
| WARRANTY; without ev...

(The comments found at the beginning of the groff file "man1/gitaction.1".)

NAME

gitaction - GNU Interactive Tools - per file type action script

SYNTAX

gitaction directory file
.gitaction directory file

DESCRIPTION

gitaction is a script that executes a different action for each file type specified. It is called by the gitfm program when pressing F2 or ^Xa (see the gnuitrc.TERM configuration files in the gnuit manual). The first parameter is the current directory name and the second one is the file name to be matched against the default patterns. The matching is done using the shell 'case' statement. If you press F2 or ^Xa on a *.html file, gitfm will invoke a browser to view it, if you press F2 or ^Xa on a *.tar.gz file, gitfm will list the tar archive contents, if you press the same keys on a *.gz file, gitfm will display its uncompressed contents on the screen, etc ...
If you press F2 or ^Xa on a *.gif file or *.jpg file and you have the zgv utility installed, you will be able to see it. If you want to change the gif/jpeg viewer, all you need to do is to change its name in the gitaction script.
There are many more file types and viewers that gitaction knows about. In addition, if you are running under GNOME, gnome-open is used, and 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. If you want to find out what the default action for each file type is (or if you want to modify it), just read/modify the gitaction script.
The script can be easily enhanced. Just read it.
The .gitaction script is a local version of the gitaction script. When started, gitaction tries to search a script called .gitaction in the current directory and, if it finds it, it starts it. If .gitaction's exit code is 0 ( .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. 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

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).