README

= athena - Convert database files to various formats

== VERSION

This documentation refers to athena version 0.2.1


== DESCRIPTION

Athena is a library to convert "database" files between various formats.
It's accompanied by a corresponding executable that gives access to its
converting features from the command-line. See Athena::Formats for the
supported database formats and how you can add your own.

=== Plugins

Athena has a plugin system that allows you to implement additional database
formats and have them available easily. Just create a file +athena_plugin.rb+
(Athena::PLUGIN_FILENAME) in your Gem's +lib+ directory or any directory that's
placed in <tt>$LOAD_PATH</tt>. See Athena::Formats on how to define custom formats.


== LINKS

<b></b>
Documentation::     http://prometheus.rubyforge.org/athena
Source code::       http://github.com/blackwinter/athena
RubyForge project:: http://rubyforge.org/projects/prometheus


== AUTHORS

* Jens Wille <mailto:jens.wille@uni-koeln.de>


== LICENSE AND COPYRIGHT

Copyright (C) 2007-2011 University of Cologne,
Albertus-Magnus-Platz, 50923 Cologne, Germany

athena is free software: you can redistribute it and/or modify it under the
terms of the GNU Affero General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.

athena is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for
more details.

You should have received a copy of the GNU Affero General Public License
along with athena. If not, see <http://www.gnu.org/licenses/>.