= Universal Feed Parser
  http://rfeedparser.rubyforge.org
  Original Python code Copyright (c) 2002-5 by Mark Pilgrim
  Ruby port by Jeff Hodges.
 
== Description
 
Parse nearly any RSS and Atom feeds in Ruby.  3000 unit tests.  Open source.
 
== Installation
 
For Debian-based systems:
 
  $ sudo apt-get install libxml-ruby1.8 # or libxml-parser-ruby1.8
 
And then:
 
  $ sudo gem install rfeedparser
 
Or for the latest development version:
 
  $ git clone git://github.com/jmhodges/rfeedparser.git
  $ cd rfeedparser
  $ sudo rake setup
  $ rake gem
  $ sudo gem install pkg/rfeedparser-$VERSION.gem
 
Dependencies on other gems are handled by rubygems, but rfeedparser
works better if it has bindings to a native XML parsing library. The
recommended choice is libxml, which is installable with the
libxml-ruby1.8 package in Debian-based systems. But it can also use
expat (the libxml-parser-ruby1.8 Debian package). In general libxml is
more robust and up-to-date, so you should use it unless you have a
specific reason to use expat.
 
== Usage
 
   require 'rubygems' # may omit if installed manually
   require 'rfeedparser'
 
   feed = FeedParser.parse("some-feed-stream-filepath-or-url")
 
   feed.entries.each do |e|
     puts e.title
     puts e.content
     puts e.published
     puts '----'
   end
 
== Contributing
 
Clone the git repository at git://github.com/jmhodges/rfeedparser.git and
which has a webpage at http://github.com/jmhodges/rfeedparser/tree/master.
 
== Todo
 
- Dependency installation instructions for other platforms.
- Use hoe.
- Publish RDoc; unify README and rubyforge home page.