
				     MCatS



INTRODUCTION
MCatS is a catalog utility. MCatS stands for Modular Catalog System and works as most third pary layer. It talks one language internaly and uses modules to talk to other languages, kind of a translation.
	MCatS's main goal is to function as a converter tool, but will have the capability to work as a standalone catalogsystem aswell. It's at the moment developed mainly under Linux but should compile under most UNIX clones fearly smoothly.
	Since this is the initial release of MCatS, many of the wanted features didn't make this release. To contribute to the future feature list send an email to future@mcats.net with the suggestion, but please checkout the http://mcats.sourceforge.net/ so it's not already there first.


QUICK GUIDE
To compile and install mcats with standard configuration, follow the steps below.
./configure
make
make install (as root)


DOCUMENTATION
There are man pages for the MCatS core and every module in this release. mcats(1) contain basic information about the core, then all modules has there own man page accessed as mcats_<modulename>(1).
	Other usefull documentation can be found in the doc/ directory. If there is a README file for a specific module, there's where to find it.
	To get uptodate documentation and newer documentation that might not made this release can be found at http://mcats.sourceforge.net/.


MODULES
The default modules to be compiled and installed is cdinput, stdout and wii. To enable compilation and installation of wii or iodbc module pass --enable-wii or --enable-iodbc to ./configure.
	In this release the modules cdinput, stdout, wii, iodbc and gtktalog is ... .
	Cdinput module is for input from cdroms.
	Stdout module is for output to standard output.
	Wii module is for reading WhereIsIt? files.
	Iodbc module is for output to odbc source using libiodbc.
	gtktalog module is for input/output to/from gtktalog files. (Broken)


HELP
If there is a problem that can't be resolved by reading the documentation associated to this application please check the mailinglist archive at http://sourceforge.net/mailarchive/forum.php?forum_id=7589. In case the problem still can't be solved, feel free to mail mcats-beta@lists.sourceforge.net with the question and someone will try to answear it. Observe that this is a free software so there is no guarentee any question will be answeard, even though me and others will do our best to do so.


BUGS
For any bugs found, please send a complete bug report to bug@mcats.net. This should contain the commandline executed, a gdb trace and if nessasery any additionally files.
	Another approach is to use the mcats.bug script that's located at <srcroot>/misc. By running this script with the full mcats commandline executed when the bug occured, it will run gdb and put together a complete mail that is opened in vi. To send it to bug@mcats.net, save it, otherwise quit without saving.


LICENSE
This application lies under GPL version 2 or newer. For a complete license agreement please see the COPYING file that can be found in the source root.


AUTHOR
The main author of this application is Pehr Johansson <pehr@mcats.net>, for additional authors for seperate modules can be found in the AUTHORS file in the source root.


Copyright (C) 2002-2004  Pehr Johansson <pehr@mcats.net>
