nokogiri 1.8.5 → 1.9.1

data/CONTRIBUTING.md

@@ -1,42 +0,0 @@
-# Issue and Pull Request Guidelines
-
-Thank you for getting involved in making Nokogiri better!
-
-
-## Code of Conduct
-
-For best results, be nice. Remember that Nokogiri maintainers are
-volunteers, and treat them with respect.
-
-Do not act entitled to service. Do not be rude. Do not use judgmental
-or foul language.
-
-The maintainers reserve the right to delete comments that are rude, or
-that contain foul language. The maintainers reserve the right to
-delete comments that they deem harassing or offensive.
-
-
-## Issues
-
-Please read the
-["Getting Help" tutorial](http://www.nokogiri.org/tutorials/getting_help.html)
-at the [nokogiri.org](http://nokogiri.org) site.
-
-If you're reporting an issue, it must contain:
-
-* Example code that reproduces the **observed** behavior.
-* An explanation of what the **expected** behavior is.
-
-That's it. If you don't provide that information, we'll ask you for
-it, tag the story "needs more information", and then after a time will
-close it if the information isn't provided.
-
-
-## Pull Requests
-
-Pull requests must always contain a test to prevent
-regressions. Preferably, the test should demonstrate the __intent__ of
-the code.
-
-We may ask you for clarification if we don't understand the intent of
-the change.

data/C_CODING_STYLE.rdoc

@@ -1,33 +0,0 @@
-= C/C++ mode style for Nokogiri
-
-Please don't propose commits that only change whitespace. However, if your
-commit touches a function or section that is not using MRI Ruby conventions,
-feel free to update whitespace in the surrounding code.
-
-
-= WHITESPACE:
-
-* indent level: 2
-* indent type: Always spaces
-* line Breaks: LF
-
-This style can be automatically applied by running:
-
-    astyle --indent=spaces=2 --style=1tbs --keep-one-line-blocks $(ack -f --type=cpp --type=cc ext/nokogiri)
-
-
-= FUNCTION DECLARATION:
-
-ANSI C style:
-
-    type name(args)
-    {
-      declarations
-    
-      code
-    }
-
-= SOURCES:
-
-* <3<3<3
-

data/Gemfile

@@ -1,23 +0,0 @@
-# -*- ruby -*-
-
-# DO NOT EDIT THIS FILE. Instead, edit Rakefile, and run `rake bundler:gemfile`.
-
-source "https://rubygems.org/"
-
-gem "mini_portile2", "~>2.3.0"
-
-gem "hoe-bundler", "~>1.2", :group => [:development, :test]
-gem "hoe-debugging", "~>1.4", :group => [:development, :test]
-gem "hoe-gemspec", "~>1.0", :group => [:development, :test]
-gem "hoe-git", "~>1.6", :group => [:development, :test]
-gem "minitest", "~>5.8.4", :group => [:development, :test]
-gem "rake", "~>12.0", :group => [:development, :test]
-gem "rake-compiler", "~>1.0.3", :group => [:development, :test]
-gem "rake-compiler-dock", "~>0.6.2", :group => [:development, :test]
-gem "racc", "~>1.4.14", :group => [:development, :test], :platform => [:ruby, :mingw, :x64_mingw]
-gem "rexical", "~>1.0.5", :group => [:development, :test], :platform => [:ruby, :mingw, :x64_mingw]
-gem "concourse", "~>0.15", :group => [:development, :test]
-gem "rdoc", "~>4.0", :group => [:development, :test]
-gem "hoe", "~>3.16", :group => [:development, :test]
-
-# vim: syntax=ruby

data/Gemfile-libxml-ruby

@@ -1,3 +0,0 @@
-ENV['TEST_NOKOGIRI_WITH_LIBXML_RUBY'] = "1"
-gem "libxml-ruby", :platform => :mri, :require => false
-eval_gemfile File.join(File.dirname(ENV['BUNDLE_GEMFILE']),"Gemfile")

data/Manifest.txt

@@ -1,370 +0,0 @@
-.autotest
-.cross_rubies
-.editorconfig
-.gemtest
-.travis.yml
-CHANGELOG.md
-CONTRIBUTING.md
-C_CODING_STYLE.rdoc
-Gemfile
-Gemfile-libxml-ruby
-LICENSE-DEPENDENCIES.md
-LICENSE.md
-Manifest.txt
-README.md
-ROADMAP.md
-Rakefile
-SECURITY.md
-STANDARD_RESPONSES.md
-Y_U_NO_GEMSPEC.md
-appveyor.yml
-bin/nokogiri
-build_all
-dependencies.yml
-ext/java/nokogiri/EncodingHandler.java
-ext/java/nokogiri/HtmlDocument.java
-ext/java/nokogiri/HtmlElementDescription.java
-ext/java/nokogiri/HtmlEntityLookup.java
-ext/java/nokogiri/HtmlSaxParserContext.java
-ext/java/nokogiri/HtmlSaxPushParser.java
-ext/java/nokogiri/NokogiriService.java
-ext/java/nokogiri/XmlAttr.java
-ext/java/nokogiri/XmlAttributeDecl.java
-ext/java/nokogiri/XmlCdata.java
-ext/java/nokogiri/XmlComment.java
-ext/java/nokogiri/XmlDocument.java
-ext/java/nokogiri/XmlDocumentFragment.java
-ext/java/nokogiri/XmlDtd.java
-ext/java/nokogiri/XmlElement.java
-ext/java/nokogiri/XmlElementContent.java
-ext/java/nokogiri/XmlElementDecl.java
-ext/java/nokogiri/XmlEntityDecl.java
-ext/java/nokogiri/XmlEntityReference.java
-ext/java/nokogiri/XmlNamespace.java
-ext/java/nokogiri/XmlNode.java
-ext/java/nokogiri/XmlNodeSet.java
-ext/java/nokogiri/XmlProcessingInstruction.java
-ext/java/nokogiri/XmlReader.java
-ext/java/nokogiri/XmlRelaxng.java
-ext/java/nokogiri/XmlSaxParserContext.java
-ext/java/nokogiri/XmlSaxPushParser.java
-ext/java/nokogiri/XmlSchema.java
-ext/java/nokogiri/XmlSyntaxError.java
-ext/java/nokogiri/XmlText.java
-ext/java/nokogiri/XmlXpathContext.java
-ext/java/nokogiri/XsltStylesheet.java
-ext/java/nokogiri/internals/ClosedStreamException.java
-ext/java/nokogiri/internals/HtmlDomParserContext.java
-ext/java/nokogiri/internals/IgnoreSchemaErrorsErrorHandler.java
-ext/java/nokogiri/internals/NokogiriBlockingQueueInputStream.java
-ext/java/nokogiri/internals/NokogiriDomParser.java
-ext/java/nokogiri/internals/NokogiriEncodingReaderWrapper.java
-ext/java/nokogiri/internals/NokogiriEntityResolver.java
-ext/java/nokogiri/internals/NokogiriErrorHandler.java
-ext/java/nokogiri/internals/NokogiriHandler.java
-ext/java/nokogiri/internals/NokogiriHelpers.java
-ext/java/nokogiri/internals/NokogiriNamespaceCache.java
-ext/java/nokogiri/internals/NokogiriNamespaceContext.java
-ext/java/nokogiri/internals/NokogiriNonStrictErrorHandler.java
-ext/java/nokogiri/internals/NokogiriNonStrictErrorHandler4NekoHtml.java
-ext/java/nokogiri/internals/NokogiriStrictErrorHandler.java
-ext/java/nokogiri/internals/NokogiriXPathFunction.java
-ext/java/nokogiri/internals/NokogiriXPathFunctionResolver.java
-ext/java/nokogiri/internals/NokogiriXPathVariableResolver.java
-ext/java/nokogiri/internals/NokogiriXsltErrorListener.java
-ext/java/nokogiri/internals/ParserContext.java
-ext/java/nokogiri/internals/ReaderNode.java
-ext/java/nokogiri/internals/SaveContextVisitor.java
-ext/java/nokogiri/internals/SchemaErrorHandler.java
-ext/java/nokogiri/internals/UncloseableInputStream.java
-ext/java/nokogiri/internals/XalanDTMManagerPatch.java
-ext/java/nokogiri/internals/XmlDeclHandler.java
-ext/java/nokogiri/internals/XmlDomParserContext.java
-ext/java/nokogiri/internals/XmlSaxParser.java
-ext/java/nokogiri/internals/c14n/AttrCompare.java
-ext/java/nokogiri/internals/c14n/C14nHelper.java
-ext/java/nokogiri/internals/c14n/CanonicalFilter.java
-ext/java/nokogiri/internals/c14n/CanonicalizationException.java
-ext/java/nokogiri/internals/c14n/Canonicalizer.java
-ext/java/nokogiri/internals/c14n/Canonicalizer11.java
-ext/java/nokogiri/internals/c14n/Canonicalizer11_OmitComments.java
-ext/java/nokogiri/internals/c14n/Canonicalizer11_WithComments.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315Excl.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315ExclOmitComments.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315ExclWithComments.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315OmitComments.java
-ext/java/nokogiri/internals/c14n/Canonicalizer20010315WithComments.java
-ext/java/nokogiri/internals/c14n/CanonicalizerBase.java
-ext/java/nokogiri/internals/c14n/CanonicalizerPhysical.java
-ext/java/nokogiri/internals/c14n/CanonicalizerSpi.java
-ext/java/nokogiri/internals/c14n/Constants.java
-ext/java/nokogiri/internals/c14n/ElementProxy.java
-ext/java/nokogiri/internals/c14n/HelperNodeList.java
-ext/java/nokogiri/internals/c14n/IgnoreAllErrorHandler.java
-ext/java/nokogiri/internals/c14n/InclusiveNamespaces.java
-ext/java/nokogiri/internals/c14n/InvalidCanonicalizerException.java
-ext/java/nokogiri/internals/c14n/NameSpaceSymbTable.java
-ext/java/nokogiri/internals/c14n/NodeFilter.java
-ext/java/nokogiri/internals/c14n/UtfHelpper.java
-ext/java/nokogiri/internals/c14n/XMLUtils.java
-ext/java/org/apache/xml/dtm/ref/dom2dtm/DOM2DTMExt.java
-ext/nokogiri/depend
-ext/nokogiri/extconf.rb
-ext/nokogiri/html_document.c
-ext/nokogiri/html_document.h
-ext/nokogiri/html_element_description.c
-ext/nokogiri/html_element_description.h
-ext/nokogiri/html_entity_lookup.c
-ext/nokogiri/html_entity_lookup.h
-ext/nokogiri/html_sax_parser_context.c
-ext/nokogiri/html_sax_parser_context.h
-ext/nokogiri/html_sax_push_parser.c
-ext/nokogiri/html_sax_push_parser.h
-ext/nokogiri/nokogiri.c
-ext/nokogiri/nokogiri.h
-ext/nokogiri/xml_attr.c
-ext/nokogiri/xml_attr.h
-ext/nokogiri/xml_attribute_decl.c
-ext/nokogiri/xml_attribute_decl.h
-ext/nokogiri/xml_cdata.c
-ext/nokogiri/xml_cdata.h
-ext/nokogiri/xml_comment.c
-ext/nokogiri/xml_comment.h
-ext/nokogiri/xml_document.c
-ext/nokogiri/xml_document.h
-ext/nokogiri/xml_document_fragment.c
-ext/nokogiri/xml_document_fragment.h
-ext/nokogiri/xml_dtd.c
-ext/nokogiri/xml_dtd.h
-ext/nokogiri/xml_element_content.c
-ext/nokogiri/xml_element_content.h
-ext/nokogiri/xml_element_decl.c
-ext/nokogiri/xml_element_decl.h
-ext/nokogiri/xml_encoding_handler.c
-ext/nokogiri/xml_encoding_handler.h
-ext/nokogiri/xml_entity_decl.c
-ext/nokogiri/xml_entity_decl.h
-ext/nokogiri/xml_entity_reference.c
-ext/nokogiri/xml_entity_reference.h
-ext/nokogiri/xml_io.c
-ext/nokogiri/xml_io.h
-ext/nokogiri/xml_libxml2_hacks.c
-ext/nokogiri/xml_libxml2_hacks.h
-ext/nokogiri/xml_namespace.c
-ext/nokogiri/xml_namespace.h
-ext/nokogiri/xml_node.c
-ext/nokogiri/xml_node.h
-ext/nokogiri/xml_node_set.c
-ext/nokogiri/xml_node_set.h
-ext/nokogiri/xml_processing_instruction.c
-ext/nokogiri/xml_processing_instruction.h
-ext/nokogiri/xml_reader.c
-ext/nokogiri/xml_reader.h
-ext/nokogiri/xml_relax_ng.c
-ext/nokogiri/xml_relax_ng.h
-ext/nokogiri/xml_sax_parser.c
-ext/nokogiri/xml_sax_parser.h
-ext/nokogiri/xml_sax_parser_context.c
-ext/nokogiri/xml_sax_parser_context.h
-ext/nokogiri/xml_sax_push_parser.c
-ext/nokogiri/xml_sax_push_parser.h
-ext/nokogiri/xml_schema.c
-ext/nokogiri/xml_schema.h
-ext/nokogiri/xml_syntax_error.c
-ext/nokogiri/xml_syntax_error.h
-ext/nokogiri/xml_text.c
-ext/nokogiri/xml_text.h
-ext/nokogiri/xml_xpath_context.c
-ext/nokogiri/xml_xpath_context.h
-ext/nokogiri/xslt_stylesheet.c
-ext/nokogiri/xslt_stylesheet.h
-lib/isorelax.jar
-lib/jing.jar
-lib/nekodtd.jar
-lib/nekohtml.jar
-lib/nokogiri.rb
-lib/nokogiri/css.rb
-lib/nokogiri/css/node.rb
-lib/nokogiri/css/parser.rb
-lib/nokogiri/css/parser.y
-lib/nokogiri/css/parser_extras.rb
-lib/nokogiri/css/syntax_error.rb
-lib/nokogiri/css/tokenizer.rb
-lib/nokogiri/css/tokenizer.rex
-lib/nokogiri/css/xpath_visitor.rb
-lib/nokogiri/decorators/slop.rb
-lib/nokogiri/html.rb
-lib/nokogiri/html/builder.rb
-lib/nokogiri/html/document.rb
-lib/nokogiri/html/document_fragment.rb
-lib/nokogiri/html/element_description.rb
-lib/nokogiri/html/element_description_defaults.rb
-lib/nokogiri/html/entity_lookup.rb
-lib/nokogiri/html/sax/parser.rb
-lib/nokogiri/html/sax/parser_context.rb
-lib/nokogiri/html/sax/push_parser.rb
-lib/nokogiri/syntax_error.rb
-lib/nokogiri/version.rb
-lib/nokogiri/xml.rb
-lib/nokogiri/xml/attr.rb
-lib/nokogiri/xml/attribute_decl.rb
-lib/nokogiri/xml/builder.rb
-lib/nokogiri/xml/cdata.rb
-lib/nokogiri/xml/character_data.rb
-lib/nokogiri/xml/document.rb
-lib/nokogiri/xml/document_fragment.rb
-lib/nokogiri/xml/dtd.rb
-lib/nokogiri/xml/element_content.rb
-lib/nokogiri/xml/element_decl.rb
-lib/nokogiri/xml/entity_decl.rb
-lib/nokogiri/xml/entity_reference.rb
-lib/nokogiri/xml/namespace.rb
-lib/nokogiri/xml/node.rb
-lib/nokogiri/xml/node/save_options.rb
-lib/nokogiri/xml/node_set.rb
-lib/nokogiri/xml/notation.rb
-lib/nokogiri/xml/parse_options.rb
-lib/nokogiri/xml/pp.rb
-lib/nokogiri/xml/pp/character_data.rb
-lib/nokogiri/xml/pp/node.rb
-lib/nokogiri/xml/processing_instruction.rb
-lib/nokogiri/xml/reader.rb
-lib/nokogiri/xml/relax_ng.rb
-lib/nokogiri/xml/sax.rb
-lib/nokogiri/xml/sax/document.rb
-lib/nokogiri/xml/sax/parser.rb
-lib/nokogiri/xml/sax/parser_context.rb
-lib/nokogiri/xml/sax/push_parser.rb
-lib/nokogiri/xml/schema.rb
-lib/nokogiri/xml/searchable.rb
-lib/nokogiri/xml/syntax_error.rb
-lib/nokogiri/xml/text.rb
-lib/nokogiri/xml/xpath.rb
-lib/nokogiri/xml/xpath/syntax_error.rb
-lib/nokogiri/xml/xpath_context.rb
-lib/nokogiri/xslt.rb
-lib/nokogiri/xslt/stylesheet.rb
-lib/serializer.jar
-lib/xalan.jar
-lib/xercesImpl.jar
-lib/xml-apis.jar
-lib/xsd/xmlparser/nokogiri.rb
-patches/libxml2/0001-Revert-Do-not-URI-escape-in-server-side-includes.patch
-patches/libxml2/0002-Fix-nullptr-deref-with-XPath-logic-ops.patch
-patches/libxml2/0003-Fix-infinite-loop-in-LZMA-decompression.patch
-patches/sort-patches-by-date
-suppressions/README.txt
-suppressions/nokogiri_ruby-2.supp
-tasks/test.rb
-test/css/test_nthiness.rb
-test/css/test_parser.rb
-test/css/test_tokenizer.rb
-test/css/test_xpath_visitor.rb
-test/decorators/test_slop.rb
-test/files/2ch.html
-test/files/GH_1042.html
-test/files/address_book.rlx
-test/files/address_book.xml
-test/files/atom.xml
-test/files/bar/bar.xsd
-test/files/bogus.xml
-test/files/dont_hurt_em_why.xml
-test/files/encoding.html
-test/files/encoding.xhtml
-test/files/exslt.xml
-test/files/exslt.xslt
-test/files/foo/foo.xsd
-test/files/metacharset.html
-test/files/namespace_pressure_test.xml
-test/files/noencoding.html
-test/files/po.xml
-test/files/po.xsd
-test/files/saml/saml20assertion_schema.xsd
-test/files/saml/saml20protocol_schema.xsd
-test/files/saml/xenc_schema.xsd
-test/files/saml/xmldsig_schema.xsd
-test/files/shift_jis.html
-test/files/shift_jis.xml
-test/files/shift_jis_no_charset.html
-test/files/slow-xpath.xml
-test/files/snuggles.xml
-test/files/staff.dtd
-test/files/staff.xml
-test/files/staff.xslt
-test/files/test_document_url/bar.xml
-test/files/test_document_url/document.dtd
-test/files/test_document_url/document.xml
-test/files/tlm.html
-test/files/to_be_xincluded.xml
-test/files/valid_bar.xml
-test/files/xinclude.xml
-test/helper.rb
-test/html/sax/test_parser.rb
-test/html/sax/test_parser_context.rb
-test/html/sax/test_parser_text.rb
-test/html/sax/test_push_parser.rb
-test/html/test_attributes.rb
-test/html/test_builder.rb
-test/html/test_document.rb
-test/html/test_document_encoding.rb
-test/html/test_document_fragment.rb
-test/html/test_element_description.rb
-test/html/test_named_characters.rb
-test/html/test_node.rb
-test/html/test_node_encoding.rb
-test/namespaces/test_additional_namespaces_in_builder_doc.rb
-test/namespaces/test_namespaces_aliased_default.rb
-test/namespaces/test_namespaces_in_builder_doc.rb
-test/namespaces/test_namespaces_in_cloned_doc.rb
-test/namespaces/test_namespaces_in_created_doc.rb
-test/namespaces/test_namespaces_in_parsed_doc.rb
-test/namespaces/test_namespaces_preservation.rb
-test/test_convert_xpath.rb
-test/test_css_cache.rb
-test/test_encoding_handler.rb
-test/test_memory_leak.rb
-test/test_nokogiri.rb
-test/test_soap4r_sax.rb
-test/test_xslt_transforms.rb
-test/xml/node/test_save_options.rb
-test/xml/node/test_subclass.rb
-test/xml/sax/test_parser.rb
-test/xml/sax/test_parser_context.rb
-test/xml/sax/test_parser_text.rb
-test/xml/sax/test_push_parser.rb
-test/xml/test_attr.rb
-test/xml/test_attribute_decl.rb
-test/xml/test_builder.rb
-test/xml/test_c14n.rb
-test/xml/test_cdata.rb
-test/xml/test_comment.rb
-test/xml/test_document.rb
-test/xml/test_document_encoding.rb
-test/xml/test_document_fragment.rb
-test/xml/test_dtd.rb
-test/xml/test_dtd_encoding.rb
-test/xml/test_element_content.rb
-test/xml/test_element_decl.rb
-test/xml/test_entity_decl.rb
-test/xml/test_entity_reference.rb
-test/xml/test_namespace.rb
-test/xml/test_node.rb
-test/xml/test_node_attributes.rb
-test/xml/test_node_encoding.rb
-test/xml/test_node_inheritance.rb
-test/xml/test_node_reparenting.rb
-test/xml/test_node_set.rb
-test/xml/test_parse_options.rb
-test/xml/test_processing_instruction.rb
-test/xml/test_reader.rb
-test/xml/test_reader_encoding.rb
-test/xml/test_relax_ng.rb
-test/xml/test_schema.rb
-test/xml/test_syntax_error.rb
-test/xml/test_text.rb
-test/xml/test_unparented_node.rb
-test/xml/test_xinclude.rb
-test/xml/test_xpath.rb
-test/xslt/test_custom_functions.rb
-test/xslt/test_exception_handling.rb

data/ROADMAP.md

@@ -1,111 +0,0 @@
-# Roadmap for API Changes
-
-## overhaul serialize/pretty printing API
-
-* https://github.com/sparklemotion/nokogiri/issues/530
-  XHTML formatting can't be turned off
-
-* https://github.com/sparklemotion/nokogiri/issues/415
-  XML formatting should be no formatting
-
-
-## overhaul and optimize the SAX parsing
-
-* see fairy wing throwdown - SAX parsing is wicked slow.
-
-
-## Node should not be Enumerable; and should have a better attributes API
-
-* https://github.com/sparklemotion/nokogiri/issues/679
-  Mixing in Enumerable has some unintended consequences; plus we want to improve the attributes API
-
-* Some ideas for a better attributes API?
-  * (closed) https://github.com/sparklemotion/nokogiri/issues/666
-  * https://github.com/sparklemotion/nokogiri/issues/765
-
-
-## improve CSS query parsing
-
-* https://github.com/sparklemotion/nokogiri/issues/528
-  support `:not()` with a nontrivial argument, like `:not(div p.c)`
-
-* https://github.com/sparklemotion/nokogiri/issues/451
-  chained :not pseudoselectors
-
-* better jQuery selector and CSS pseudo-selector support:
-  * https://github.com/sparklemotion/nokogiri/issues/621
-  * https://github.com/sparklemotion/nokogiri/issues/342
-  * https://github.com/sparklemotion/nokogiri/issues/628
-  * https://github.com/sparklemotion/nokogiri/issues/652
-  * https://github.com/sparklemotion/nokogiri/issues/688
-
-* https://github.com/sparklemotion/nokogiri/issues/394
-  nth-of-type is wrong, and possibly other selectors as well
-
-* https://github.com/sparklemotion/nokogiri/issues/309
-  incorrect query being executed
-
-* https://github.com/sparklemotion/nokogiri/issues/350
-  :has is wrong?
-
-
-## DocumentFragment
-
-* there are a few tickets about searches not working properly if you
-  use or do not use the context node as part of the search.
-  - https://github.com/sparklemotion/nokogiri/issues/213
-  - https://github.com/sparklemotion/nokogiri/issues/370
-  - https://github.com/sparklemotion/nokogiri/issues/454
-  - https://github.com/sparklemotion/nokogiri/issues/572
-  could we fix this by making DocumentFragment be a subclass of NodeSet?
-
-
-## Better Syntax for custom XPath function handler
-
-* https://github.com/sparklemotion/nokogiri/pull/464
-
-
-## Better Syntax around Node#xpath and NodeSet#xpath
-
-* look at those methods, and use of Node#extract_params in Node#{css,search}
-  * we should standardize on a hash of options for these and other calls
-* what should NodeSet#xpath return?
-  * https://github.com/sparklemotion/nokogiri/issues/656
-
-## Encoding
-
-We have a lot of issues open around encoding. How bad are things?
-Somebody who knows encoding well should head this up.
-
-* Extract EncodingReader as a real object that can be injected
-  https://groups.google.com/forum/#!msg/nokogiri-talk/arJeAtMqvkg/tGihB-iBRSAJ
-
-
-## Reader
-
-It's fundamentally broken, in that we can't stop people from crashing
-their application if they want to use object reference unsafely.
-
-
-## Class methods that require Document
-
-There are a few methods, like `Nokogiri::XML::Comment.new` that
-require a Document object.
-
-We should probably make Document instance methods to wrap this, since
-it's a non-obvious expectation and thus fails as a convention.
-
-So, instead, let's make alternative methods like
-`Nokogiri::XML::Document#new_comment`, and recommend those as the
-proper convention.
-
-
-## `collect_namespaces` is just broken
-
-`collect_namespaces` is returning a hash, which means it can't return
-namespaces with the same prefix. See this issue for background:
-
-> https://github.com/sparklemotion/nokogiri/issues/885
-
-Do we care? This seems like a useless method, but then again I hate
-XML, so what do I know?