/usr/share/doc/libxml-rsslite-perl/README is in libxml-rsslite-perl 0.15+dfsg-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | THIS VERSION BREAKS BACKWARDS COMPATIBILITY
It is very similar and should require only minor changes,
but it is not a drop-in upgrade.
parseXML is now parseRSS
Okay, apparently a few people actually use this, so I should probably release
a new version. I've actually had this done for almost a year now but I wanted
to write a real test suite for it, maybe next time. Instead, all I can say is
I've been *using* it for the last year without a problem. Please provide me
with a copy of any document wish it chokes on when making a bug report.
=============================================================================
XML::RSSLite is a meant as a relaxed parser+,* and lightweight+,++
replacement for XML::RSS. In fact, it contains a generic lightweight
XML pseudo-parser** that can be used for other content.
For RSS/RDF/weblog/Scripting News content parseRSS does the following:
o Remove html tags to leave plain text
o Remove characters other than 0-9~!@#$%^&*()-+=a-zA-Z[];',.:"<>?\s
o Use <url> tags when <link> is empty
o Use misplaced urls in <title> when <link> is empty
o Exract links from <a href=...> if required
o Limit links to ftp and http
o Join relative urls to the site base
If you can make a convincing argument against any of these behaviors they
may be relaxed. Otherwise, you might use parseXML.
+ Under certain circumstances; not valid during leap years, full
moons, high tides, vernal equinoxes, or Wednesdays. YMMV.
* We hope, the new parser may be too strict, please provide samples
of content which you believe should parse but does not.
++ The new found "correctness" comes at a performance cost, it is
slower than prior versions, but still faster than XML::RSS.
** Not fully compliant with the W3C specifications.
|