0
@@ -9,12 +9,27 @@ Parse nearly any RSS and Atom feeds in Ruby.  3000 unit tests.  Open source.
0
 
0
 == Installation
0
 
0
+For Debian-based systems:
0
+
0
+  $ sudo apt-get install libxml-ruby1.8 # or libxml-parser-ruby1.8
0
+
0
+TODO: dependency installation instructions for other platforms.
0
+
0
+And then:
0
+
0
   $ sudo gem install rfeedparser
0
 
0
 Or for the latest development version:
0
 
0
   $ git clone git://github.com/technomancy/rfeedparser.git
0
 
0
+Dependencies on other gems are handled by rubygems, but rfeedparser
0
+also relies on having bindings to a native XML parsing library. The
0
+recommended choice is libxml, which is installable with the
0
+libxml-ruby1.8 package in Debian-based systems. But it can also fall
0
+back to expat (the libxml-parser-ruby1.8 Debian package) if libxml is
0
+not installed.
0
+
0
 == Usage
0
 
0
    require 'rubygems' # may omit if installed manually

0
@@ -27,7 +27,7 @@ spec = Gem::Specification.new do |s|
0
   s.add_dependency('htmltools', '>= 1.10')
0
   s.add_dependency('htmlentities', '4.0.0')
0
   s.add_dependency('mongrel', '>=1.0.1')
0
-  s.requirements << "Yoshida Masato's Ruby bindings to the Expat XML parser"
0
+  s.requirements << "Yoshida Masato's Ruby bindings to the Expat XML parser or libxml"
0
 end
0
 
0
 

0
@@ -1,3 +1,12 @@
0
+# If you don't have libxml installed (or for some reason you would
0
+# rather use expat) you can fall back upon this for your parser. Be
0
+# advised that the bindings for expat are much older (from the days of
0
+# Ruby 1.6.7) and are unmaintained. If you want to force use of expat
0
+# even when libxml is installed, you can do this:
0
+#
0
+#   feed = FeedParser.parse("some-feed-stream-filepath-or-url",
0
+#                           :strict => FeedParser::Expat::StrictFeedParser)
0
+
0
 require 'xml/saxdriver'
0
 
0
 module FeedParser