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