AFP-PowerTools

AFP-PowerTools is the Perl implementation of afppowertools.
afppowertools is a library and a set of utilities for parsing AFP (Advanced
Function Presentation), a format used for high-volume printing.

The name afppowertools comes as a parallel to Unix tools like grep, cut, awk...
which parse a line, and then apply some user-defined actions on that line.
In AFP, the record is not a line, but a "Structured Field". With
afppowertools, the user has to register "rules": pairs of callbacks
("condition" + "action"), which will be called after parsing each
Structured Field. Some callbacks are already provided in the library, together
with scripts that use them.

The library relies on a YAML translation of the AFP specification.
The AFP specifications can be found at:	http://www.afpcinc.org
The yaml files included in the library are in the public domain.
They were originally written by Roland Rodrigus in 2010.


INSTALLATION

To install this module, run the following commands:

        perl Makefile.PL
        make
        make test
        make install


In addition to the perl package, the installation script copies the yaml grammar and templates to:
	/usr/share/afppowertools
If you want another location, you can edit Makefile.PL appropriately. You also need to edit
the path in AFP::PowerTools::Grammar.pm.

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc AFP::PowerTools


LICENSE AND COPYRIGHT

Copyright (C) 2010 Roland Rodrigus

   afppowertools is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.

   afppowertools 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.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with afppowertools.  If not, see <http://www.gnu.org/licenses/>.


