README
1XML::Filter::DetectWS version 0.01
2==================================
3
4DESCRIPTION
5
6This a PerlSAX filter that detects which character data contains ignorable whitespace and optionally filters it.
7
8Note that this is just a first stab at the implementation and it may change completely in the near future. Please provide
9feedback whether you like it or not, so I know whether I should change it.
10
11The XML spec defines ignorable whitespace as the character data found in elements that were defined in an
12<!ELEMENT> declaration with a model of 'EMPTY' or 'Children' (Children is the rule that does not contain '#PCDATA'.)
13
14In addition, XML::Filter::DetectWS allows the user to define other whitespace to be ignorable. The ignorable whitespace
15is passed to the PerlSAX Handler with the ignorable_whitespace handler, provided that the Handler implements this
16method. (Otherwise it is passed to the characters handler.) If the SkipIgnorableWS is set, the ignorable whitespace is
17simply discarded.
18
19XML::Filter::DetectWS also takes xml:space attributes into account. See below for details.
20
21CDATA sections are passed in the standard PerlSAX way (i.e. with surrounding start_cdata and end_cdata events),
22unless the Handler does not implement these methods. In that case, the CDATA section is simply passed to the
23characters method.
24
25INSTALLATION
26
27To install this module type the following:
28
29 perl Makefile.PL
30 make
31 make test
32 make install
33
34COPYRIGHT AND LICENCE
35
36Copyright (c) 1999,2000 Enno Derksen
37All rights reserved.
38This program is free software; you can redistribute it and/or modify it
39under the same terms as Perl itself.
40