WHAT IS THIS? ============= This is "PodFilter": a Perl5 module which provides a base class for parsing and selecting sections of pod documentation from an input stream. PLEASE NOTE THAT THIS IS AN INITIAL RELEASE FOR THE PURPOSE OF GATHERING COMMENTS AND SUGGESTIONS AND MAY CHANGE IN INCOMPATIBLE WAYS IN FUTURE RELEASES!!! AUTHORS/CONTRIBUTORS ==================== Brad Appleton (based off of Pod::Text by Tom Christiansen ) COPY/REUSE POLICY ================= Copyright (C) 1996 Tom Christiansen. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Please refer to the license agreement that came with your Perl distribution for more details. DISCLAIMER ========== This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. In no event will any copyright holder or distirbutor of the software be liable to you for any kind of damages. Please refer to the license agreement that came with your Perl distribution for more details. CONTENTS ======== README -- this file Makefile.PL -- Perl Makefile template Filter.pm -- The Pod::Filter module source podfilter.PL -- A script to print selected sections of pod docs in raw pod format REQUIREMENTS ============ * Perl version 5.002 or later * Getopt::Long version 2.13 or later (podfilter.PL only) * Pod::PlainText version 0.01 or later (podfilter.PL only) * Pod::Usage version 0.01 or later (podfilter.PL only) BUILDING & INSTALLING ===================== Please see the perl "ExtUtils::MakeMaker" manpage for how to build and install using the Makefile.PL template. In a nutshell, simply typing: perl Makefile.PL should build a Makefile with the usual targets like "all", "clean", "test", and "install". BUGS ==== Please send all bug reports to Brad Appleton . HISTORY ======= 07-Aug-1996 Brad Appleton ----------------------------------------------------------------------------- Initial release of version 0.01 to garner some feedback.