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. Damian's 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