README

XML-Entities

This module provides a mapping from the standard XML entities to their Unicode
characters. A function for decoding is provided. The mapping can be generated
from a DTD file with entity definitions.

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

The entity definitions are shipped with this package in the XML::Entities::Data
module. If you find them outdated, you can rebuild the module by running the
bin/download-entities.pl script.

To rebuild the entity definitions, run

    perl download-entities.pl > XML/Entities/Data.pm

SUPPORT AND DOCUMENTATION

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

    perldoc XML::Entities

Documentation for the download-entities.pl script can be found in the
POD format within itself.

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=XML-Entities

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/XML-Entities

    CPAN Ratings
        http://cpanratings.perl.org/d/XML-Entities

    Search CPAN
        http://search.cpan.org/dist/XML-Entities


COPYRIGHT AND LICENCE

Copyright (C) 2012 Jan Oldřich Krůza <sixtease@cpan.org>

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.