git.maemo.org Git - pkg-perl/blob - deb-src/libfilter-perl/libfilter-perl-1.34/README

   1                                  Source Filters
   2
   3                                   Version 1.33
   4
   5                                  1st March 2007
   6
   7         Copyright (c) 1995-2007 Paul Marquess. All rights reserved.
   8          This program is free software; you can redistribute it and/or
   9                  modify it under the same terms as Perl itself.
  10
  11
  12
  13 DESCRIPTION
  14 -----------
  15
  16 This distribution consists of a number of Source Filters.
  17
  18 For more details see the pod documentation embedded in the .pm files.
  19
  20 If you intend using the Filter::Call functionality, I would strongly
  21 recommend that you check out Damian Conway's excellent Filter::Simple
  22 module. Damian's module provides a much cleaner interface than
  23 Filter::Util::Call. Although it doesn't allow the fine control that
  24 Filter::Util::Call does, it should be adequate for the majority of
  25 applications. It's available at
  26
  27    http://www.cpan.org/modules/by-author/Damian_Conway/Filter-Simple.tar.gz
  28    http://www.csse.monash.edu.au/~damian/CPAN/Filter-Simple.tar.gz
  29
  30 PREREQUISITES
  31 -------------
  32
  33 Before you can build the Source Filters you need to have the following
  34 installed on your system:
  35
  36     * Perl 5.004 or better. 5.6.0 or better is recommended for Win32.
  37
  38 If your Perl is less than version 5.004_55, the "order" test harness
  39 will be skipped.
  40
  41
  42 BUILDING THE MODULES
  43 --------------------
  44
  45 Assuming you have met all the prerequisites, building the modules
  46 should be relatively straightforward.
  47
  48 The modules can now be built using this sequence of commands:
  49
  50     perl Makefile.PL
  51     make
  52     make test
  53
  54 The filters have been successfully built and tested on the following
  55 systems (at least):
  56
  57         SunOS 4.1.3 (Sun C compiler & gcc 2.7.2.3)
  58         Solaris 2.3 (Sun C Compiler)
  59         irix 5.3
  60         irix 6.x
  61         Windows NT 4.0 (Visual C++ 5.0 and Borland C++ 5.02)
  62
  63 GNU tr and GNU cpp must be installed somewhere on the path for the
  64 testsuite to pass successfully on Windows NT.
  65
  66 INSTALLATION
  67 ------------
  68
  69     make install
  70
  71 UPDATES
  72 -------
  73
  74 The most recent version of the Filters is always available at
  75
  76     http://www.cpan.org/modules/by-module/Filter