Source Filters
 
                                  Version 1.28
 
                                  10th Jan 2002
 
      Copyright (c) 1995-2002 Paul Marquess. All rights reserved.
         This program is free software; you can redistribute it and/or
                modify it under the same terms as Perl itself.
 
 
 
DESCRIPTION
-----------
 
This distribution consists of a number of Source Filters.

For more details see the pod documentation embedded in the .pm files.

If you intend using the Filter::Call functionality, I would strongly
recommend that you check out Damian Conway's excellent Filter::Simple
module. This module provides a much cleaner interface than
Filter::Util::Call. Although it doesn't allow the fine control that
Filter::Util::Call does, it should be adequate for the majority of
applications. It's available at

   http://www.cpan.org/modules/by-author/Damian_Conway/Filter-Simple.tar.gz 
   http://www.csse.monash.edu.au/~damian/CPAN/Filter-Simple.tar.gz 

PREREQUISITES
-------------
 
Before you can build the Source Filters you need to have the following
installed on your system:

    * Perl 5.004 or better. 5.6.0 or better is recommended for Win32.

If your Perl is less than version 5.004_55, the "order" test harness
will be skipped.


BUILDING THE MODULES
--------------------
 
Assuming you have met all the prerequisites, building the modules
should be relatively straightforward.

The modules can now be built using this sequence of commands:
 
    perl Makefile.PL
    make
    make test
 
The filters have been successfully built and tested on the following
systems (at least):

	SunOS 4.1.3 (Sun C compiler & gcc 2.7.2.3)
	Solaris 2.3 (Sun C Compiler)
	irix 5.3	
	irix 6.x	
	Windows NT 4.0 (Visual C++ 5.0 and Borland C++ 5.02)

GNU tr and GNU cpp must be installed somewhere on the path for the
testsuite to pass successfully on Windows NT.

INSTALLATION
------------
 
    make install
 
UPDATES
-------
 
The most recent version of the Filters is always available at
 
    http://www.cpan.org/modules/by-module/Filter