libxml-ruby 0.8.3 → 0.9.0

data/CHANGES

@@ -1,5 +1,23 @@
 (See log/ChangeLog for more detailed changes derived directly from source control.)
 
+== 0.9.0 / 2008-11-18 Charlie Savage
+
+* Expose LibXML's encoding support via a new Encoding object.
+
+* Revamp error handling to be much easier to use.  Errors are now
+  wrapped by the new XML::Error class and are thrown as exceptions
+  when it is appropriate.
+
+* Fixed segementation fault caused by documents being freed
+  before xpath results that referenced the document.
+
+* Add Node#register_default_namespace to simplify default namespace handling.
+
+* Significantly improve documentation
+
+* A number of bug fixes and patches.
+
+
 == 0.8.3 / 2008-07-21 Charlie Savage
 
 * Missed several files in last release

data/RAKEFILE

@@ -3,7 +3,6 @@
 # Be sure to set ENV['RUBYFORGE_USERNAME'] to use publish.
 
 require 'rubygems'
-require 'date'
 require 'rake/gempackagetask'
 require 'rake/rdoctask'
 require 'rake/testtask'
@@ -20,6 +19,7 @@ FILES = FileList[
   'doc/**/*',
   'ext/libxml/*',
   'ext/mingw/Rakefile',
+  'ext/mingw/build.rake',
   'ext/vc/*.sln',
   'ext/vc/*.vcproj',
   'lib/**/*',
@@ -69,47 +69,26 @@ end
 Rake::GemPackageTask.new(default_spec) do |pkg|
   pkg.package_dir = 'admin/pkg'
   pkg.need_tar = true
-  pkg.need_zip = true
 end
 
 
-# ------- Windows Package ----------
-
-# Use *.dll* to get import libraries
-binaries = (FileList['ext/mingw/*.so',
-                     'ext/mingw/*.dll*'])
-
-# Windows specification
-win_spec = default_spec.clone
-win_spec.extensions = []
-win_spec.platform = Gem::Platform::CURRENT
-win_spec.files += binaries.map {|binaryname| "lib/#{File.basename(binaryname)}"}
+# ------- Windows GEM ----------
+if RUBY_PLATFORM.match(/win32/)
+  binaries = (FileList['ext/mingw/*.so',
+                       'ext/mingw/*.dll*'])
 
+  # Windows specification
+  win_spec = default_spec.clone
+  win_spec.extensions = ['ext/mingw/Rakefile']
+  win_spec.platform = Gem::Platform::CURRENT
+  win_spec.files += binaries.to_a
 
-desc "Create Windows Gem"
-task :create_win32_gem do
-  # Copy the win32 extension built by MingW - easier to install
-  # since there are no dependencies of msvcr80.dll
-  current_dir = File.expand_path(File.dirname(__FILE__))
-
-  binaries.each do |binaryname|
-    target = File.join(current_dir, 'lib', File.basename(binaryname))
-    cp(binaryname, target)
-  end
-  
-  # Create the gem, then move it to admin/pkg
-  Gem::Builder.new(win_spec).build
-  gem_file = "#{win_spec.name}-#{win_spec.version}-#{win_spec.platform}.gem"
-  mv(gem_file, "admin/pkg/#{gem_file}")
-
-  # Remove win extension from top level directory  
-  binaries.each do |binaryname|
-    target = File.join(current_dir, 'lib', File.basename(binaryname))
-    rm(target)
+  # Rake task to build the windows package
+  Rake::GemPackageTask.new(win_spec) do |pkg|
+    pkg.package_dir = 'admin/pkg'
   end
 end
 
-
 # ---------  RDoc Documentation ---------
 desc "Generate rdoc documentation"
 Rake::RDocTask.new("rdoc") do |rdoc|
@@ -128,9 +107,6 @@ Rake::RDocTask.new("rdoc") do |rdoc|
                           'VERSION')
 end
 
-task :default => :package
-task :package => :create_win32_gem
-
 Rake::TestTask.new do |t|
   t.libs << "test"
   t.libs << "lib"
@@ -141,6 +117,7 @@ if not RUBY_PLATFORM.match(/mswin32/i)
   Rake::Task[:test].prerequisites << :extensions
 end
 
+task :default => :package
 task :build => :extensions
 task :extension => :build
 
@@ -161,9 +138,8 @@ namespace :extensions do
 end
 
 file "ext/libxml/Makefile" => ["ext/libxml/extconf.rb"] do
-
   command = ["ruby"] + $:.map{|dir| "-I#{File.expand_path dir}"} + ["extconf.rb"]
-  Dir.chdir("ext/libxml") { sh *command }
+  Dir.chdir("ext/libxml") { sh(*command) }
 end
 
 # ---------  Publish Website to Rubyforge ---------

data/README

@@ -1,7 +1,6 @@
 = LibXML Ruby
 
 == Overview
-
 The libxml gem provides Ruby language bindings for GNOME's Libxml2
 XML toolkit. It is free software, released under the MIT License.
 
@@ -13,7 +12,6 @@ libxml-ruby provides several advantages over REXML:
 
 
 == Requirements
-
 libxml-ruby requires Ruby 1.8.4 or higher.  It is dependent on 
 the following libraries to function properly:
 
@@ -22,44 +20,41 @@ the following libraries to function properly:
 * libiconv
 * libxml2
 
-If you are running Linux or Unix you'll need a C compiler so the extension
-can be compiled when it is installed.  If you are running Windows, then install the Windows specific RubyGem which
+If you are running Linux or Unix you'll need a C compiler so the
+extension can be compiled when it is installed.  If you are running
+Windows, then install the Windows specific RubyGem which
 includes an already built extension.
 
-
 == INSTALLATION
-
 The easiest way to install libxml-ruby is via Ruby Gems.  To install:
 
 <tt>gem install libxml-ruby</tt>
 
-If you are running Windows, make sure to install the Win32 RubyGem which 
-includes an already built binary file.  The binary is built against
-libxml2 version 2.6.32 and iconv version 1.11.  Both of these are also 
-included as pre-built binaries, and should be put either in the 
-libxml/lib directory or on the Windows path.
+If you are running Windows, make sure to install the Win32 RubyGem
+which includes an already built binary file.  The binary is built
+against libxml2 version 2.6.32 and iconv version 1.11.  Both of these
+are also included as pre-built binaries, and should be put either in
+the libxml/lib directory or on the Windows path.
 
 The Windows binaries are built with MingW and include libxml-ruby, 
 libxml2 and iconv.  The gem also includes a Microsoft VC++ 2008
 solution.  If you wish to run a debug version of libxml-ruby on
 Windows, then it is highly recommended you use VC++.
 
-
 == Functionality
-libxml is a highly conformant XML parser, passing all 1800+ tests 
-from the OASIS XML Tests Suite.  In addition, it includes rich
-functionality such as: 
-
-* SAX
-* DOM
-* HTML Parsing
-* XMLReader
-* XPath
-* XPointer
-* DTDs 
-* RelaxNG Schemas
-* XML Schema
-* XSLT (split into the libxslt-ruby bindings) 
+LibXML is a highly conformant XML parser, passing all 1800+ tests 
+from the OASIS XML Tests Suite.  It includes rich functionality such as:
+
+* DOM (LibXML::XML::Parser)
+* SAX (LibXML::XML::SaxParser)
+* HTML Parsing (LibXML::XML::HTMLParser)
+* Reader (LibXML::XML::Reader)
+* XPath (LibXML::XML::XPath)
+* XPointer (LibXML::XML::XPointer)
+* DTDs (LibXML::XML::Dtd)
+* RelaxNG Schemas (LibXML::XML::RelaxNG)
+* XML Schema (LibXML::XML::Schema)
+* XSLT (http://rubyforge.org/projects/libxsl/)
 
 libxml-ruby provides impressive coverage of libxml's functionality 
 through an easy-to-use C api.  
@@ -89,29 +84,40 @@ From https://svn.concord.org/svn/projects/trunk/common/ruby/xml_benchmarks/
 For in-depth information about using libxml-ruby please refer
 to its online Rdoc documentation.  
 
-All libxml classes are in the LibXML::XML module. The simplest
-way to use libxml is to require 'xml'.  This will mixin the 
-LibXML module into the global namespace, allowing you to 
+All libxml classes are in the LibXML::XML module. The most
+expedient way to use libxml is to require 'xml'.  This will mixin
+the LibXML module into the global namespace, allowing you to 
 write code like this: 
 
-require 'xml'
-document = XML::Document.new
+  require 'xml'
+  document = XML::Document.new
+
+However, when creating an application or library you plan to 
+redistribute, it is best to not add the LibXML module to the global
+namespace, in which case you can either write your code like this:
+
+  require 'libxml'
+  document = LibXML::XML::Document.new
 
-If you prefer not to add the LibXML module to the global namepace, then
-write your code like this:
+or, more conveniently, utilize a proper namespace for you own work
+and include LibXML into it. For example:
 
-require 'libxml'
+  require 'libxml'
 
-class MyClass
-  def some_method
-    document = LibXML::XML::Document.new
+  mdoule MyApplication
+    include LibXML
+
+    class MyClass
+      def some_method
+        document = XML::Document.new
+      end
+    end
   end
-end
 
-Some simple examples are shown below.
+For simplicity's sake we will use require 'xml in the basic examples
+shown below.
 
 === READING
-
 There are several ways to read xml documents.
 
   require 'xml'
@@ -127,7 +133,7 @@ There are several ways to read xml documents.
     puts "Node path: #{node.path} \t Contents: #{node.content}"
   end
 
-And your terminal should look like:
+And your terminal should look like this:
 
   Root element name: root_node
   Elem3: baz
@@ -142,9 +148,7 @@ And your terminal should look like:
   Node path: /root_node/foo/bar[9]         Contents: 9
   Node path: /root_node/foo/bar[10]        Contents: 10
 
-
 === WRITING
-
 To write a simple document:
 
   require 'xml'
@@ -200,17 +204,14 @@ The file output.xml contains:
   </root_node>
 
 == DOCUMENTATION
-
 RDoc comments are included - run 'rake doc' to generate documentation.
 You can find the latest documentation at:
 
 * http://libxml.rubyforge.org/rdoc/
 
 == License
-
 See LICENSE for license information.
 
 == MORE INFORMATION
-
 For more information please refer to the documentation.  If you have any
-questions, please send email to libxml-devel@rubyforge.org.
+questions, please send email to libxml-devel@rubyforge.org.

data/ext/libxml/libxml.c

@@ -1,4 +1,4 @@
-/* $Id: libxml.c 489 2008-07-21 22:41:11Z cfis $ */
+/* $Id: libxml.c 585 2008-11-18 17:40:45Z cfis $ */
 
 /* Please see the LICENSE file for copyright and distribution information */
 
@@ -6,55 +6,880 @@
 
 VALUE mLibXML;
 VALUE mXML;
-VALUE eXMLError;
 
 
-#if defined(_WIN32)
-__declspec(dllexport) 
+/*
+ * call-seq:
+ * 		XML.catalog_dump -> true
+ * 
+ * Dump all the global catalog content stdout.
+ */
+VALUE
+ruby_xml_catalog_dump(VALUE self) {
+  xmlCatalogDump(stdout);
+  return(Qtrue);
+}
+
+
+/*
+ * call-seq:
+ * 		XML.catalog_remove(catalog) -> true
+ * 
+ * Remove the specified resource catalog.
+ */
+VALUE
+ruby_xml_catalog_remove(VALUE self, VALUE cat) {
+  Check_Type(cat, T_STRING);
+  xmlCatalogRemove((xmlChar *)StringValuePtr(cat));
+  return(Qtrue);
+}
+
+
+/*
+ * call-seq:
+ * 		XML.check_lib_versions -> true							
+ * 
+ * Check LIBXML version matches version the bindings
+ * were compiled to. Throws an exception if not.
+ */
+VALUE
+ruby_xml_check_lib_versions(VALUE class) {
+  xmlCheckVersion(LIBXML_VERSION);
+  return(Qtrue);
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_automata? -> (true|false)
+ * 
+ * Determine whether libxml regexp automata support is enabled.
+ */
+VALUE
+ruby_xml_enabled_automata_q(VALUE class) {
+#ifdef LIBXML_AUTOMATA_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
 #endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_c14n? -> (true|false)
+ * 
+ * Determine whether libxml 'canonical XML' support is enabled.
+ * See "Canonical XML" (http://www.w3.org/TR/xml-c14n)
+ */
+VALUE
+ruby_xml_enabled_c14n_q(VALUE class) {
+#ifdef LIBXML_C14N_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_catalog? -> (true|false)                                         
+ * 
+ * Determine whether libxml resource catalog support is enabled.
+ */
+VALUE
+ruby_xml_enabled_catalog_q(VALUE class) {
+#ifdef LIBXML_CATALOG_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_debug? -> (true|false)  
+ * 
+ * Determine whether libxml debugging support is enabled.
+ */
+VALUE
+ruby_xml_enabled_debug_q(VALUE class) {
+#ifdef LIBXML_DEBUG_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_docbook? -> (true|false)  
+ * 
+ * Determine whether libxml docbook support is enabled.
+ */
+VALUE
+ruby_xml_enabled_docbook_q(VALUE class) {
+#ifdef LIBXML_DOCB_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_ftp? -> (true|false)  
+ * 
+ * Determine whether libxml ftp client support is enabled.
+ */
+VALUE
+ruby_xml_enabled_ftp_q(VALUE class) {
+#ifdef LIBXML_FTP_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_http? -> (true|false)  
+ * 
+ * Determine whether libxml http client support is enabled.
+ */
+VALUE
+ruby_xml_enabled_http_q(VALUE class) {
+#ifdef LIBXML_HTTP_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_html? -> (true|false)  
+ * 
+ * Determine whether libxml html support is enabled.
+ */
+VALUE
+ruby_xml_enabled_html_q(VALUE class) {
+#ifdef LIBXML_HTML_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_iconv? -> (true|false)  
+ * 
+ * Determine whether libxml iconv support is enabled.
+ */
+VALUE
+ruby_xml_enabled_iconv_q(VALUE class) {
+#ifdef LIBXML_ICONV_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_memory_debug? -> (true|false)  
+ * 
+ * Determine whether libxml memory location debugging support
+ * is enabled.
+ */
+VALUE
+ruby_xml_enabled_memory_debug_location_q(VALUE class) {
+#ifdef DEBUG_MEMORY_LOCATION
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_regexp? -> (true|false)  
+ * 
+ * Determine whether libxml regular expression support is enabled.
+ */
+VALUE
+ruby_xml_enabled_regexp_q(VALUE class) {
+#ifdef LIBXML_REGEXP_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_schemas? -> (true|false)  
+ * 
+ * Determine whether libxml schema support is enabled.
+ */
+VALUE
+ruby_xml_enabled_schemas_q(VALUE class) {
+#ifdef LIBXML_SCHEMAS_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_thread? -> (true|false)  
+ * 
+ * Determine whether libxml thread-safe semantics support 
+ * is enabled (I think?).
+ */
+VALUE
+ruby_xml_enabled_thread_q(VALUE class) {
+#ifdef LIBXML_THREAD_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_unicode? -> (true|false)  
+ * 
+ * Determine whether libxml unicode support is enabled.
+ */
+VALUE
+ruby_xml_enabled_unicode_q(VALUE class) {
+#ifdef LIBXML_UNICODE_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_xinclude? -> (true|false)  
+ * 
+ * Determine whether libxml xinclude support is enabled.
+ */
+VALUE
+ruby_xml_enabled_xinclude_q(VALUE class) {
+#ifdef LIBXML_XINCLUDE_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_xpath? -> (true|false)  
+ * 
+ * Determine whether libxml xpath support is enabled.
+ */
+VALUE
+ruby_xml_enabled_xpath_q(VALUE class) {
+#ifdef LIBXML_XPATH_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_xpointer? -> (true|false)  
+ * 
+ * Determine whether libxml xpointer support is enabled.
+ */
+VALUE
+ruby_xml_enabled_xpointer_q(VALUE class) {
+#ifdef LIBXML_XPTR_ENABLED
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ * 		XML.enabled_zlib? -> (true|false)  
+ * 
+ * Determine whether libxml zlib support is enabled.
+ */
+VALUE
+ruby_xml_enabled_zlib_q(VALUE class) {
+#ifdef HAVE_ZLIB_H
+  return(Qtrue);
+#else
+ return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ *    XML.debug_entities -> (true|false)
+ * 
+ * Determine whether included-entity debugging is enabled.
+ * (Requires Libxml to be compiled with debugging support)
+ */
+VALUE
+ruby_xml_debug_entities_get(VALUE class) {
+#ifdef LIBXML_DEBUG_ENABLED
+  if (xmlParserDebugEntities)
+    return(Qtrue);
+  else
+    return(Qfalse);
+#else
+  rb_warn("libxml was compiled with debugging turned off");
+  return(Qfalse);
+#endif
+}
 
-void
-Init_libxml_ruby(void) {
-  /* Some libxml memory goo that should be done before anything else */
-#ifdef NONE
-  xmlMemGet((xmlFreeFunc *) & freeFunc,
-            (xmlMallocFunc *) & mallocFunc,
-            (xmlReallocFunc *) & reallocFunc,
-            (xmlStrdupFunc *) & strdupFunc);
 
-  if (xmlMemSetup((xmlFreeFunc)RubyMemFree, (xmlMallocFunc)RubyMemMalloc,
-                  (xmlReallocFunc)RubyMemRealloc, (xmlStrdupFunc)RubyMemStrdup) != 0)
-    rb_fatal("could not install the memory handlers for libxml");
+/*
+ * call-seq:
+ *    XML.debug_entities = true|false
+ * 
+ * Enable or disable included-entity debugging.
+ * (Requires Libxml to be compiled with debugging support)
+ */
+VALUE
+ruby_xml_debug_entities_set(VALUE class, VALUE bool) {
+#ifdef LIBXML_DEBUG_ENABLED
+  if (TYPE(bool) == T_FALSE) {
+    xmlParserDebugEntities = 0;
+    return(Qfalse);
+  } else {
+    xmlParserDebugEntities = 1;
+    return(Qtrue);
+  }
+#else
+  rb_warn("libxml was compiled with debugging turned off");
 #endif
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_keep_blanks -> (true|false)
+ * 
+ * Determine whether parsers retain whitespace by default.
+ */
+VALUE
+ruby_xml_default_keep_blanks_get(VALUE class) {
+  if (xmlKeepBlanksDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_keep_blanks = true|false
+ * 
+ * Controls whether parsers retain whitespace by default.
+ */
+VALUE
+ruby_xml_default_keep_blanks_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlKeepBlanksDefaultValue = 0;
+    return(Qfalse);
+  } else if (TYPE(bool) == T_TRUE) {
+    xmlKeepBlanksDefaultValue = 1;
+    return(Qtrue);
+  } else {
+    rb_raise(rb_eArgError, "Invalid argument, must be a boolean");
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_load_external_dtd -> (true|false)
+ * 
+ * Determine whether parsers load external DTDs by default.
+ */
+VALUE
+ruby_xml_default_load_external_dtd_get(VALUE class) {
+  if (xmlLoadExtDtdDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_load_external_dtd = true|false
+ * 
+ * Controls whether parsers load external DTDs by default.
+ */
+VALUE
+ruby_xml_default_load_external_dtd_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlLoadExtDtdDefaultValue = 0;
+    return(Qfalse);
+  } else {
+    xmlLoadExtDtdDefaultValue = 1;
+    return(Qtrue);
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_line_numbers -> (true|false)
+ * 
+ * Determine whether parsers retain line-numbers by default.
+ */
+VALUE
+ruby_xml_default_line_numbers_get(VALUE class) {
+  if (xmlLineNumbersDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_line_numbers = true|false
+ * 
+ * Controls whether parsers retain line-numbers by default.
+ */
+VALUE
+ruby_xml_default_line_numbers_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlLineNumbersDefault(0);
+    return(Qfalse);
+  } else {
+    xmlLineNumbersDefault(1);
+    return(Qtrue);
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_pedantic_parser -> (true|false)
+ * 
+ * Determine whether parsers are pedantic by default.
+ */
+VALUE
+ruby_xml_default_pedantic_parser_get(VALUE class) {
+  if (xmlPedanticParserDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_pedantic_parser = true|false
+ * 
+ * Controls whether parsers are pedantic by default.
+ */
+VALUE
+ruby_xml_default_pedantic_parser_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlPedanticParserDefault(0);
+    return(Qfalse);
+  } else {
+    xmlPedanticParserDefault(1);
+    return(Qtrue);
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_substitute_entities -> (true|false)
+ * 
+ * Determine whether parsers perform inline entity substitution
+ * (for external entities) by default.
+ */
+VALUE
+ruby_xml_default_substitute_entities_get(VALUE class) {
+  if (xmlSubstituteEntitiesDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_substitute_entities = true|false
+ * 
+ * Controls whether parsers perform inline entity substitution
+ * (for external entities) by default.
+ */
+VALUE
+ruby_xml_default_substitute_entities_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlSubstituteEntitiesDefault(0);
+    return(Qfalse);
+  } else {
+    xmlSubstituteEntitiesDefault(1);
+    return(Qtrue);
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_tree_indent_string -> "string"
+ * 
+ * Obtain the default string used by parsers to indent the XML tree
+ * for output.
+ */
+VALUE
+ruby_xml_default_tree_indent_string_get(VALUE class) {
+  if (xmlTreeIndentString == NULL)
+    return(Qnil);
+  else
+    return(rb_str_new2(xmlTreeIndentString));
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_tree_indent_string = "string"
+ * 
+ * Set the default string used by parsers to indent the XML tree
+ * for output.
+ */
+VALUE
+ruby_xml_default_tree_indent_string_set(VALUE class, VALUE string) {
+  Check_Type(string, T_STRING);
+  xmlTreeIndentString = xmlStrdup(StringValuePtr(string));
+  return(string);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_validity_checking -> (true|false)
+ * 
+ * Determine whether parsers perform XML validation by default.
+ */
+VALUE
+ruby_xml_default_validity_checking_get(VALUE class) {
+  if (xmlDoValidityCheckingDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_validity_checking = true|false
+ * 
+ * Controls whether parsers perform XML validation by default.
+ */
+VALUE
+ruby_xml_default_validity_checking_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlDoValidityCheckingDefaultValue = 0;
+    return(Qfalse);
+  } else {
+    xmlDoValidityCheckingDefaultValue = 1;
+    return(Qtrue);
+  }
+}
 
+
+/*
+ * call-seq:
+ *    XML.default_warnings -> (true|false)
+ * 
+ * Determine whether parsers output warnings by default.
+ */
+VALUE
+ruby_xml_default_warnings_get(VALUE class) {
+  if (xmlGetWarningsDefaultValue)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_warnings = true|false
+ * 
+ * Controls whether parsers output warnings by default.
+ */
+VALUE
+ruby_xml_default_warnings_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_FALSE) {
+    xmlGetWarningsDefaultValue = 0;
+    return(Qfalse);
+  } else {
+    xmlGetWarningsDefaultValue = 1;
+    return(Qtrue);
+  }
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_compression -> (true|false)
+ * 
+ * Determine whether parsers use Zlib compression by default
+ * (requires libxml to be compiled with Zlib support).
+ */
+VALUE
+ruby_xml_default_compression_get(VALUE class) {
+#ifdef HAVE_ZLIB_H
+  return(INT2FIX(xmlGetCompressMode()));
+#else
+  rb_warn("libxml was compiled without zlib support");
+  return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ *    XML.default_compression = true|false
+ * 
+ * Controls whether parsers use Zlib compression by default
+ * (requires libxml to be compiled with Zlib support).
+ */
+VALUE
+ruby_xml_default_compression_set(VALUE class, VALUE num) {
+#ifdef HAVE_ZLIB_H
+  Check_Type(num, T_FIXNUM);
+  xmlSetCompressMode(FIX2INT(num));
+  return(num);
+#else
+  rb_warn("libxml was compiled without zlib support");
+  return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ *    XML.features -> ["feature", ..., "feature"]
+ * 
+ * Obtains an array of strings representing features supported 
+ * (and enabled) by the installed libxml.
+ */
+VALUE
+ruby_xml_features(VALUE class) {
+  VALUE arr, str;
+  int i, len = MAX_LIBXML_FEATURES_LEN;
+  char **list = NULL;
+
+  list = ALLOC_N(char *,MAX_LIBXML_FEATURES_LEN);
+  MEMZERO(list, char *, MAX_LIBXML_FEATURES_LEN);
+
+  arr = rb_ary_new();
+  if (xmlGetFeaturesList(&len, (const char **)list) == -1)
+    return Qnil;
+
+  for (i = 0; i < len; i++) {
+    str = rb_str_new2((const char *)list[i]);
+    rb_gc_unregister_address(&str);
+    rb_ary_push(arr, str);
+  }
+
+  if (len == MAX_LIBXML_FEATURES_LEN)
+    rb_warn("Please contact libxml-devel@rubyforge.org and ask to have the \"MAX_LIBXML_FEATURES_LEN increased\" because you could possibly be seeing an incomplete list");
+
+  ruby_xfree(list);
+  return(arr);
+}
+
+
+/*
+ * call-seq:
+ *    XML.indent_tree_output -> (true|false)
+ * 
+ * Determines whether XML output will be indented 
+ * (using the string supplied to +default_indent_tree_string+)
+ */
+VALUE
+ruby_xml_indent_tree_output_get(VALUE class) {
+  if (xmlIndentTreeOutput)
+    return(Qtrue);
+  else
+    return(Qfalse);
+}
+
+
+/*
+ * call-seq:
+ *    XML.indent_tree_output = true|false
+ * 
+ * Controls whether XML output will be indented 
+ * (using the string supplied to +default_indent_tree_string+)
+ */
+VALUE
+ruby_xml_indent_tree_output_set(VALUE class, VALUE bool) {
+  if (TYPE(bool) == T_TRUE) {
+    xmlIndentTreeOutput = 1;
+    return(Qtrue);
+  } else if (TYPE(bool) == T_FALSE) {
+    xmlIndentTreeOutput = 0;
+    return(Qfalse);
+  } else {
+    rb_raise(rb_eArgError, "Invalid argument, must be boolean");
+  }
+}
+
+/*
+ * call-seq:
+ *    XML.memory_dump -> (true|false)
+ * 
+ * Perform a parser memory dump (requires memory debugging 
+ * support in libxml).
+ */
+VALUE
+ruby_xml_memory_dump(VALUE self) {
+#ifdef DEBUG_MEMORY_LOCATION
+  xmlMemoryDump();
+  return(Qtrue);
+#else
+  rb_warn("libxml was compiled without memory debugging support");
+  return(Qfalse);
+#endif
+}
+
+
+/*
+ * call-seq:
+ *    XML.memory_used -> num_bytes
+ * 
+ * Perform a parser memory dump (requires memory debugging 
+ * support in libxml).
+ */
+VALUE
+ruby_xml_memory_used(VALUE self) {
+#ifdef DEBUG_MEMORY_LOCATION
+  return(INT2NUM(xmlMemUsed()));
+#else
+  rb_warn("libxml was compiled without memory debugging support");
+  return(Qfalse);
+#endif
+}
+
+#if defined(_WIN32)
+__declspec(dllexport) 
+#endif
+void
+Init_libxml_ruby(void) {
   mLibXML = rb_define_module("LibXML");
   mXML = rb_define_module_under(mLibXML, "XML");
-  eXMLError = rb_define_class_under(mXML, "Error", rb_eRuntimeError);
 
+  /* Constants */
+  rb_define_const(mXML, "LIBXML_VERSION", rb_str_new2(LIBXML_DOTTED_VERSION));
+  rb_define_const(mXML, "VERSION", rb_str_new2(RUBY_LIBXML_VERSION));
+  rb_define_const(mXML, "VERNUM", INT2NUM(RUBY_LIBXML_VERNUM));
   rb_define_const(mXML, "XML_NAMESPACE", rb_str_new2((const char*)XML_XML_NAMESPACE));
 
+  rb_define_module_function(mXML, "enabled_automata?", ruby_xml_enabled_automata_q, 0);
+  rb_define_module_function(mXML, "enabled_c14n?", ruby_xml_enabled_c14n_q, 0);
+  rb_define_module_function(mXML, "enabled_catalog?", ruby_xml_enabled_catalog_q, 0);
+  rb_define_module_function(mXML, "enabled_debug?", ruby_xml_enabled_debug_q, 0);
+  rb_define_module_function(mXML, "enabled_docbook?", ruby_xml_enabled_docbook_q, 0);
+  rb_define_module_function(mXML, "enabled_ftp?", ruby_xml_enabled_ftp_q, 0);
+  rb_define_module_function(mXML, "enabled_http?", ruby_xml_enabled_http_q, 0);
+  rb_define_module_function(mXML, "enabled_html?", ruby_xml_enabled_html_q, 0);
+  rb_define_module_function(mXML, "enabled_iconv?", ruby_xml_enabled_iconv_q, 0);
+  rb_define_module_function(mXML, "enabled_memory_debug?", ruby_xml_enabled_memory_debug_location_q, 0);
+  rb_define_module_function(mXML, "enabled_regexp?", ruby_xml_enabled_regexp_q, 0);
+  rb_define_module_function(mXML, "enabled_schemas?", ruby_xml_enabled_schemas_q, 0);
+  rb_define_module_function(mXML, "enabled_thread?", ruby_xml_enabled_thread_q, 0);
+  rb_define_module_function(mXML, "enabled_unicode?", ruby_xml_enabled_unicode_q, 0);
+  rb_define_module_function(mXML, "enabled_xinclude?", ruby_xml_enabled_xinclude_q, 0);
+  rb_define_module_function(mXML, "enabled_xpath?", ruby_xml_enabled_xpath_q, 0);
+  rb_define_module_function(mXML, "enabled_xpointer?", ruby_xml_enabled_xpointer_q, 0);
+  rb_define_module_function(mXML, "enabled_zlib?", ruby_xml_enabled_zlib_q, 0);
+  
+  rb_define_module_function(mXML, "catalog_dump", ruby_xml_catalog_dump, 0);
+  rb_define_module_function(mXML, "catalog_remove", ruby_xml_catalog_remove, 1);
+  rb_define_module_function(mXML, "check_lib_versions", ruby_xml_check_lib_versions, 0);
+  rb_define_module_function(mXML, "debug_entities", ruby_xml_debug_entities_get, 0);
+  rb_define_module_function(mXML, "debug_entities=", ruby_xml_debug_entities_set, 1);
+  rb_define_module_function(mXML, "default_compression", ruby_xml_default_compression_get, 0);
+  rb_define_module_function(mXML, "default_compression=", ruby_xml_default_compression_set, 1);
+  rb_define_module_function(mXML, "default_keep_blanks", ruby_xml_default_keep_blanks_get, 0);
+  rb_define_module_function(mXML, "default_keep_blanks=", ruby_xml_default_keep_blanks_set, 1);
+  rb_define_module_function(mXML, "default_load_external_dtd", ruby_xml_default_load_external_dtd_get, 0);
+  rb_define_module_function(mXML, "default_load_external_dtd=", ruby_xml_default_load_external_dtd_set, 1);
+  rb_define_module_function(mXML, "default_line_numbers", ruby_xml_default_line_numbers_get, 0);
+  rb_define_module_function(mXML, "default_line_numbers=", ruby_xml_default_line_numbers_set, 1);
+  rb_define_module_function(mXML, "default_pedantic_parser", ruby_xml_default_pedantic_parser_get, 0);
+  rb_define_module_function(mXML, "default_pedantic_parser=", ruby_xml_default_pedantic_parser_set, 1);
+  rb_define_module_function(mXML, "default_substitute_entities", ruby_xml_default_substitute_entities_get, 0);
+  rb_define_module_function(mXML, "default_substitute_entities=", ruby_xml_default_substitute_entities_set, 1);
+  rb_define_module_function(mXML, "default_tree_indent_string", ruby_xml_default_tree_indent_string_get, 0);
+  rb_define_module_function(mXML, "default_tree_indent_string=", ruby_xml_default_tree_indent_string_set, 1);
+  rb_define_module_function(mXML, "default_validity_checking", ruby_xml_default_validity_checking_get, 0);
+  rb_define_module_function(mXML, "default_validity_checking=", ruby_xml_default_validity_checking_set, 1);
+  rb_define_module_function(mXML, "default_warnings", ruby_xml_default_warnings_get, 0);
+  rb_define_module_function(mXML, "default_warnings=", ruby_xml_default_warnings_set, 1);
+	rb_define_module_function(mXML, "features", ruby_xml_features, 0);
+  rb_define_module_function(mXML, "indent_tree_output", ruby_xml_indent_tree_output_get, 0);
+  rb_define_module_function(mXML, "indent_tree_output=", ruby_xml_indent_tree_output_set, 1);
+  rb_define_module_function(mXML, "memory_dump", ruby_xml_memory_dump, 0);
+  rb_define_module_function(mXML, "memory_used", ruby_xml_memory_used, 0);
+
+  /* Now initialize all the other modules */
+  ruby_init_xml_encoding();      
+  ruby_init_xml_error();
+  ruby_init_xml_input();
   ruby_init_state();
   ruby_init_parser();  
   ruby_init_xml_parser_context();
+  ruby_init_xml_node();
   ruby_init_xml_attributes();
   ruby_init_xml_attr();
   ruby_init_xml_document();
-  ruby_init_xml_node();
-  ruby_init_xml_node_set();
   ruby_init_xml_ns();
   ruby_init_xml_sax_parser();
   ruby_init_xml_xinclude();
   ruby_init_xml_xpath();
   ruby_init_xml_xpath_context();
   ruby_init_xml_xpointer();
-  ruby_init_xml_xpointer_context();
   ruby_init_html_parser();
   ruby_init_input_callbacks(); 
   ruby_init_xml_dtd();         
   ruby_init_xml_schema();      
   ruby_init_xml_relaxng();      
-  ruby_init_xml_reader();      
+  ruby_init_xml_reader();
 
-  ruby_xml_parser_default_substitute_entities_set(cXMLParser, Qtrue);
-  ruby_xml_parser_default_load_external_dtd_set(cXMLParser, Qtrue);
+  ruby_xml_default_substitute_entities_set(mXML, Qtrue);
+  ruby_xml_default_load_external_dtd_set(mXML, Qtrue);
 }