Ruby RSS (Rich Site Summary)

CHANGES
-------
0.9.1 introduced a 15 item limit (as imposed by the RSS spec).  If you add
more than 15 items, Channel#add_item will raise an error.

DESCRIPTION
-----------
This library provides and object oriented interface for the RSS 
(http://http://my.netscape.com/publish/help/mnn20/quickstart.html) xml format.
It currently supports RSS 0.91.  Aside from RSS parsing and creation code,
classes are provided for downloading and caching existing RSS content via HTTP
and (very basically) providing a distributed Ruby interface to this content.

Have a look at the sample programs (in the samples/ directory) to see how to use
this.  It should be fairly simple.

WARNING
-------
There isn't much error handling at this point.  Please send context diffs
of additional error handling if you happen to add anything. 

PREREQUISITES (see http://www.ruby-lang.org RAA)
-------------
xmlparser (tested with 0.6.1)
druby >= 1.2.2
Ruby >= 1.6.2 

INSTALLATION
-----------
cp *rb /usr/local/lib/ruby/site_ruby/<ruby version>

CLASSES
-------
RSS::Channel
	class methods:
		from_xml - Returns a new Channel object from an xml string
				
	instance methods:
		to_xml - Returns an XML document representing the channel.
		
	attributes:
		image - (RSS::Image)
		title - (String)
		link - (String)
		url - (String)
		lang - (String) language
		rating - (String) PICS Rating
		copyright - (String)
		pubdata - (String)
		lastbuilddate - (String)
		docs - (String) link to channel information
		textinput - (RSS::TextInput)

RSS::Image - The image that will be displayed when the channel is rendered
	attributes:
		title - (String) Normally shown as alt text
		url - (String)  URL of image
		link - (String) Link to associated site
		width - (String) Image width (as String).  Defaults to "88"
		height - (String) Image height (as String).  Defaults to "31"

RSS::Item - An actual item in the Channel
	attributes: 
		title - (String) Article title
		link - (String) URL of link to full story
		
RSS::TextInput - Optional text input box for submitting queries/posts to site
	attributes:
		title - (String) 
		description - (String)
		name - (String) Form variable name for text box
		link - (String) URL for form to post to
RSS::Cache
	instance methods:
		get(host, path) - Returns an RSS::Channel representing RSS content available
				via HTTP at host/path. (e.g. "slashdot.org", "/slashdot.rdf")

Author(s)
-------
Chad Fowler (cfowler@chadfowler.com) - Original author
Aleksi Niemelä (zak@ale.cx) - Provided the interesting element_accessor hack

Additional thanks to Dave Thomas for suffering through standards compliance problems
late on a Saturday night.
