Gallimimus is a simple RSS feed database.  You create feeds, then add items
to feeds, all in the database, and then point people to the rssfeed.php
script and they get all the items in that feed.

There are essentially three components to Gallimimus:

Data sources -> Gallimimus DB -> rssfeed.php -> (other people's aggregators)

Although an RSS system can support multiple feeds / channels itself, you
can run multiple Gallimimus systems independently -- different locations,
databases, and list of channels.  See "Multiple Gallimimus Instances" below.

By default, the gallimimus system will store the database in
/var/lib/gallimus/gallimimus.db.  You can alias pretty much any URL you like
to /usr/share/gallimimus/rssfeed.php, then to produce an RSS file for a
particular feed, you just reference "rssfeed.php?feed=feedid", where
"feedid" is the name of the feed you used when you created it.

The 'gallimimus' command line program is used to manage the gallimimus DB. 
Use 'gallimimus help' for information on the available subcommands.


Multiple Gallimimus Instances
-------------------------------

Everything surrounding gallimimus relates to a particular database file. 
The default at installation time is /var/lib/gallimus/gallimimus.db.  If you
want to run out of other databases, you need to tell both the 'gallimimus'
command line program and rssfeed.php where to find the new database file.

For 'gallimimus', you can set the GALLIMIMUS_DB environment variable.  For
rssfeed.php it's a bit trickier.

The naive implementation is to make a copy of rssfeed.php and uncomment the
GALLIMIMUS_DB define and change the path, but this method doesn't scale real
well -- every upgrade of gallimimus will require doing this operation again.

Instead, you could create a short PHP file containing something like this:

<?php
define('GALLIMIMUS_DB', '/path/to/gallimimus.db');

(replacing /path/to/gallimimus.db with the appropriate path, of course)

And then using a .htaccess file or Apache configuration to set the PHP
variable auto_prepend_file any time rssfeed.php gets invoked.

Alternately, if you're feeling adventurous, you can use a gallimimus.db file
in the current directory to store all of the feed data.  If you do this, you
need to copy or symlink rssfeed.php into the directory where the database is
stored, and then always run 'gallimimus' from within this directory. 
Remember to configure apache not to serve gallimimus.db to clients unless
you want to allow people to download your entire RSS database.
