FTN-Database

Modules and associated scripts which can be used for Fidonet/FTN related processing
in an SQL database supported by a Perl DBD module, defaulting to SQLite, and which
includes FTN Nodelist processing.

Required, neccessary and/or useful modules, etc.:

DBD::SQLite	SQLite DBD Module is required by default, so should be installed.
		Any other database engines will be named similarly and should be
		installed if used.  May	already be installed on your system;  if
		not, one place they may be obtained is at cpan (www.cpan.org).

FTN::Log	Must be a least v0.02, for the 'logging' subroutine as used in 
		the nl2ftndb and ftndbadm scripts. If not already installed, one
		place it may be obtained is from the ftnpl project at Sourceforge.

Getopt::Std	May already be installed on your system;  if not, one place
		it may be obtained is at cpan (www.cpan.org).


INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install


SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this application with
the perldoc command.

    perldoc FTN::Database
    perldoc FTN::Database::Nodelist
    perldoc nl2ftndb
    perldoc ftndbadm
    perldoc net2file

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=FTN-Database

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/FTN-Database

    CPAN Ratings
        http://cpanratings.perl.org/d/FTN-Database

    Search CPAN
        http://search.cpan.org/dist/FTN-Database


The FTN-Database application is hosted at the 'Perl for FTN Systems' project
at SourceForge (ftnpl.sourceforge.net).  The ftnpl-user or ftnpl-develop mailing
lists are available from the project site; however, the FTN echos like PERL or
BBS_CARNIVAL can be used for discussions regarding it as well and are the
preferred avenues for support.

Note that the code history for FTN-Database is available in a git repository
at the Sourceforge project, as follows:

git clone git://ftnpl.git.sourceforge.net/gitroot/ftnpl/ftn-database.git (Read Only)
http://ftnpl.git.sourceforge.net/git/gitweb.cgi?p=ftnpl/ftn-database.git (Browse Online)

Note also that the standard distribution archives are created directly from the 
repository and that commit id can obtained like as follows:
    zcat FTN-Database-n.nn.tar.gz | git get-tar-commit-id 

COPYRIGHT AND LICENCE

Copyright (C) 2010 Robert James Clay

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

