mkalbum is copyright (c) 2002 Pallav Nawani.


VERSION:
---------
The current version is 1.0

INSTALLATION:
--------------
To install, just run install.bash. If does not run and quits saying:
Bash: install.bash not found
Put the path for your bash shell instead of /bin/bash at the top of the
script( install.bash). You will need to be root to install this. But if
you know shell scripting, you can put it anywhere by looking at what
install.bash does. However be warned that the directory
/usr/share/mkalbum is hard coded into the script, so change it at your
own peril.

Install program can take one optional parameter, a prefix for installation.
You can specify it likewise:
install.bash prefix

Specifying the prefix parameter will install mkalbum into the directory:
prefix/bin

Similar thing can be said about the man pages. Note that you don't need
any --prefix or such stuff. That is, don't precede the prefix with a
minus (-) sign.


REQUIREMENTS:
--------------
This is a perl script, so requires perl to be installed on your
linux box. It also requires the program convert. Most linux boxes have
all these preinstalled, but if not, get perl at
http://www.cpan.org

Convert is part of the image magick package, and available from most major
linux distributions.

FILES:
-------
This package should contain the following files:

1 mkalbum.pl:
   This is the actual album generator.
2 mkalbum,cfg:
   This a configuration file for mkalbum. You need to have this in the current
   directory while running the program.
3 adddes.pl:
  A script to easily add description to the album pages you have generated.
  read the man page for more details.
4 mkalbum.1
  The man page for mkalbum.
5 readme.txt:
  This file.
6 install.bash
  A bash script to install this package.

  A perl script to help create you descriptions for use is adddes.pl.
  Run it in the folder where you want to add descriptions, but before that,
  there should br a file names descriptions.txt in the directory. Note that
  this works for descriptive albums only. For more info, see the man page.
  
  Now you can edit descriptions.txt and add descriptions to it. Then you run
  adddes.pl, in the same directory, and lo! your descriptions are in!
  
LICENSE:
---------
This programe is released under the gnu GPL license. You can find the license
at http://www.gnu.org. The upshot of it is that you can (almost)freely modify
and disribute it, but you need to keep the copyright notice intact, and tell
people where to find the source, if they ask for it.

CREDITS:
---------
My brother, Gaurav Nawani, for doing beta testing of this script.
