README for XML::RSS::SimpleGen Time-stamp: "2004-01-17 21:16:50 AST" [Excerpted from the POD...] NAME XML::RSS::SimpleGen -- for writing RSS files SYNOPSIS # A complete example screen-scraper and RSS generator here: use strict; use XML::RSS::SimpleGen; my $url = q<http://www.exile.ru/>; rss_new( $url, "eXile", "Moscow-based Alternative Newspaper" ); rss_language( 'en' ); rss_webmaster( 'xxxxx@yourdomain.com' ); rss_twice_daily(); get_url( $url ); while( m{<h4>\s*<a href='/(.*?)'.*?>(.*?)</a>\s*</h4>\s*<p.*?>(.*?)<a href='/}sg ) { rss_item("$url$1", $2, $3); } die "No items in this content?! {{\n$_\n}}\nAborting" unless rss_item_count(); rss_save( 'exile.rss', 45 ); exit; DESCRIPTION This module is for writing RSS files, simply. It transparently handles all the unpleasant details of RSS, like proper XML escaping, and also has a good number of Do-What-I-Mean features, like not changing the modtime on a written-out RSS file if the file content hasn't changed, and like automatically removing any HTML tags from content you might pass in. This module isn't meant to have the full expressive power of RSS; instead, it provides functions that are most commonly needed by RSS-writing programs. [...end pod excerpt] PREREQUISITES This suite requires perl 5.004 or higher. INSTALLATION You install XML::RSS::SimpleGen et al, as you would install any Perl module library, by running these commands: perl Makefile.PL make make test make install If you want to install a private copy of XML::RSS::SimpleGen in your home directory, then you should try to produce the initial Makefile with something like this command: perl Makefile.PL PREFIX=~/perl See perldoc perlmodinstall for more information and advice. DOCUMENTATION POD-format documentation is included in XML/RSS/SimpleGen.pm. POD is readable with the 'perldoc' utility, like with "perldoc XML::RSS::SimpleGen" See ChangeLog for recent changes. MACPERL INSTALLATION NOTES Don't bother with the makefiles. Just make an RSS directory under your XML directory under your MacPerl site_lib or lib directory, and move SimpleGen.pm into it (the RSS directory, that is). SUPPORT Questions, bug reports, useful code bits, and suggestions for XML::RSS::SimpleGen should just be sent to me at sburke@cpan.org AVAILABILITY The latest version of this suite is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you.