#$Id: README 1218 2008-02-10 00:11:59Z jimk $
Data::Presenter - Reformat database reports

This document refers to version 1.03 of Data::Presenter.  This version was
released February 10, 2008.  If you used versions of Data::Presenter prior to
version 1.00, please read the "Notice of Change of Interface" in the
documentation, as interfaces to several methods have changed and changes need
to be made in the Data::Presenter subclasses from which new() is called.

To install this module on your system, place the tarball archive file in a 
temporary directory and call the following:

% gunzip Data-Presenter-1.03.tar.gz
% tar xf Data-Presenter-1.03.tar
% cd Data-Presenter-1.03
% perl Makefile.PL
% make
% make test
% make install

To better understand the tests as they are run, you may substitute the 
following for the next-to-last-line in the sequence of commands above:

% make test TEST_VERBOSE=1

If you are installing this module over any earlier version, you may 
substitute the following for the last line in the sequence of commands 
above:

% make install UNINST=1

If you are installing this module on a Win32 system with 'nmake', 
substitute 'nmake' for 'make' in the sequence of commands above.

The author has found that trying to install this distribution with 
(a) older (pre-6.16) versions of ExtUtils::MakeMaker, (b) on older 
versions of Perl (e.g., 5.6.0), and (c) on older Linux distributions 
(e.g., RedHat Linux 7.3) can result in a situation where the module's 
Plain Old Documentation, when transformed into manual pages, is not 
automatically placed in the optimal location for reading thru 'man' 
and 'info' (even though it reads perfectly through 'perldoc').  If you 
experience this problem, issue the following at the command line 
(adapted from a suggestion by Michael Schwern on the module-authors 
mailing list):

% perl Makefile.PL INSTALLSITEMAN3DIR=/usr/share/man/man3

Data::Presenter uses the Carp module which is part of the standard Perl 
distribution.  Data::Presenter also uses the List::Compare module by 
the same author.  This module is available from CPAN; versions 0.15 
and later should be used.  Data::Presenter's test suite uses CPAN modules
IO::Capture and IO::Capture::Extended.  These modules are pure Perl and should
install easily with the cpan utility.

For testing purposes, this distribution comes with four sample 
Data::Presenter subclass modules (now located under the t/ directory) 
which illustrate what is required for such a subclass.  In 
addition, the distribution comes with four configuration files, one for 
each sample subclass, which are required to construct a new 
Data::Presenter subclass object.  The distribution comes with four 
sourcefiles, one per subclass.  These sample subclasses are fully 
installed when you install Data::Presenter.  Once you master the 
principles of creating a Data::Presenter invocant subclass you may 
delete these sample files.

Author:  James E. Keenan (jkeenan@cpan.org).
Creation date:  October 25, 2001.  
Last modification date:  February 10, 2008.  
Copyright (c) 2001-2005 James E. Keenan.  United States.  All rights 
reserved.  This is free software and may be distributed under the 
same terms as Perl itself.