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

                                                                                                    gitaction(1)