From 4f096964968b9671a2fd43d1054e77eda0630ac7 Mon Sep 17 00:00:00 2001 From: hsbt Date: Mon, 14 Dec 2015 05:33:42 +0000 Subject: [PATCH] * lib/xmlrpc.rb: added documentation for parser details. [ci skip][fix GH-1124] Patch by @jrafanie git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@53107 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 5 +++++ lib/xmlrpc.rb | 12 +++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index d654377adc..4f86996a91 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Mon Dec 14 14:33:35 2015 SHIBATA Hiroshi + + * lib/xmlrpc.rb: added documentation for parser details. + [ci skip][fix GH-1124] Patch by @jrafanie + Mon Dec 14 11:46:52 2015 SHIBATA Hiroshi * enum.c: fix a typo in documentation. diff --git a/lib/xmlrpc.rb b/lib/xmlrpc.rb index 511c57d269..8cad6a1099 100644 --- a/lib/xmlrpc.rb +++ b/lib/xmlrpc.rb @@ -53,9 +53,19 @@ # # * Parsers # * NQXML (XMLParser::NQXMLStreamParser, XMLParser::NQXMLTreeParser) +# * Not compiled (pure ruby) +# * Note: NQXML's website recommends rexml and isn't available on rubygems.org +# * See http://nqxml.sourceforge.net/ # * Expat (XMLParser::XMLStreamParser, XMLParser::XMLTreeParser) +# * Compiled +# * Fastest parser and also uses the least memory +# * See https://rubygems.org/gems/xmlparser # * REXML (XMLParser::REXMLStreamParser) +# * Not compiled (pure ruby) +# * See ruby standard library # * xml-scan (XMLParser::XMLScanStreamParser) +# * Not compiled (pure ruby) +# * See https://rubygems.org/gems/xmlscan # * Fastest parser is Expat's XMLParser::XMLStreamParser! # # * General @@ -292,7 +302,7 @@ # # ... # # -# Note that XMLParser::XMLStreamParser is incredible faster (and uses less memory) than any +# Note XMLParser::XMLStreamParser (xmlparser gem) is faster and uses less memory than any # other parser and scales well for large documents. For example for a 0.5 MB XML # document with many tags, XMLParser::XMLStreamParser is ~350 (!) times faster than # XMLParser::NQXMLTreeParser and still ~18 times as fast as XMLParser::XMLTreeParser.