INSTALL

bashlib 4

bashlib is a bash library: there is nothing to configure and nothing
to build, the checked-out file is the finished library (it calls no
external tools). To run the test suite:

  # make check

To install (the default prefix is /usr/local):

  # make install
  # make install PREFIX=/usr          # or wherever

Packagers can use the usual DESTDIR redirection:

  # make install DESTDIR=$RPM_BUILD_ROOT

Using bashlib in your CGI scripts is as simple as beginning your
scripts with:

#!/bin/bash
. /path/to/bashlib

# Other stuff

Sourcing bashlib should be the first thing you do in your script;
it reads the environment and pulls out the parameters and cookies.
To get at a named parameter, call:

p=`param p`

In this case, the value of the parameter "p" will end up in p, and
can be accessed normally, through $p.

Cookies work similarly:

session=`cookie session`

will retrieve the cookie named session.

HELPING OUT

Any help is, of course, welcomed. Email me, and we can discuss what
needs to be done. Patches and feature requests are accepted.

TODO

 * Better documentation, probably a man page
 * More functions
   * Functions to generate HTML
   * Functions to set cookies
   * Create URL's
 * Better documentation
 * Add support for multivalued parameters, either via bash2's arrays
   or some other hack
 * sed-based templating system (I've started this one, and it's scary!)

AUTHOR

darren chamberlain <dlc@sevenroot.org>