libxml-ruby 0.8.1 → 0.8.2

data/CHANGES

@@ -1,5 +1,26 @@
 (See log/ChangeLog for more detailed changes derived directly from source control.)
 
+== 0.8.2 / 2008-07-21 Charlie Savage
+
+* To use LibXML you can either require 'xml' or require 'libxml'. 
+  The differences is that require 'xml' mixes the LibXML module into
+  the global namespace, thereby allowing you to write code such
+  as document = XML::Document.new.  Note that this is different 
+  from 0.8.0 and 0.8.1 and may require updating your code.
+
+* Support RelaxNG validation (thanks to Morus Walter)
+
+* Support passing IO objects to XmlReaders (thanks to Tom Hughes)
+
+* Fix segmentation fault caused by adding an attribute to a CDATA node
+
+* Moved node checking functions from C to Ruby
+
+* Improved Windows support - libxml-ruby should now work out of the box.
+
+* Improved Windows support - turned on libxml's zlib and iconv support.
+
+
 == 0.8.1 / 2008-07-09 Charlie Savage
 
 * Reimplmented Node#each_attr for backwards compatability

data/RAKEFILE

@@ -0,0 +1,213 @@
+#!/usr/bin/env ruby
+
+# Be sure to set ENV['RUBYFORGE_USERNAME'] to use publish.
+
+require 'rubygems'
+require 'date'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'date'
+
+
+# ------- Default Package ----------
+FILES = FileList[
+  'RAKEFILE',
+  'README',
+  'LICENSE',
+  'CHANGES',
+  'setup.rb',
+  'doc/**/*',
+  'ext/libxml/*',
+  'ext/mingw/Rakefile',
+  'vc/*.sln',
+  'vc/*.vcproj',
+  'lib/**/*',
+  'benchmark/**/*',
+  'test/**/*'
+]
+
+# Default GEM Specification
+default_spec = Gem::Specification.new do |spec|
+  spec.name = "libxml-ruby"
+  
+  spec.homepage = "http://libxml.rubyforge.org/"
+  spec.summary = "Ruby libxml bindings"
+  spec.description = <<-EOF
+    The Libxml-Ruby project provides Ruby language bindings for the GNOME
+    Libxml2 XML toolkit. It is free software, released under the MIT License.
+    Libxml-ruby's primary advantage over REXML is performance - if speed 
+    is your need, these are good libraries to consider, as demonstrated
+    by the informal benchmark below.
+  EOF
+
+  # Determine the current version of the software
+  spec.version = 
+    if File.read('ext/libxml/version.h') =~ /\s*RUBY_LIBXML_VERSION\s*['"](\d.+)['"]/
+      CURRENT_VERSION = $1
+    else
+      CURRENT_VERSION = "0.0.0"
+    end
+  
+  spec.author = "Charlie Savage"
+  spec.email = "libxml-devel@rubyforge.org"
+  spec.platform = Gem::Platform::RUBY
+  spec.require_paths = ["lib", "ext/libxml"]
+  spec.bindir = "bin"
+  spec.extensions = ["ext/libxml/extconf.rb"]
+  spec.files = FILES.to_a
+  spec.test_files = Dir.glob("test/tc_*.rb")
+  
+  spec.required_ruby_version = '>= 1.8.4'
+  spec.date = DateTime.now
+  spec.rubyforge_project = 'libxml'
+  
+  spec.has_rdoc = true
+end
+
+# Rake task to build the default package
+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)}"}
+
+
+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)
+  end
+end
+
+
+# ---------  RDoc Documentation ---------
+desc "Generate rdoc documentation"
+Rake::RDocTask.new("rdoc") do |rdoc|
+  rdoc.rdoc_dir = 'doc/rdoc'
+  rdoc.title    = "LibXML"
+  # Show source inline with line numbers
+  rdoc.options << "--inline-source" << "--line-numbers"
+  # Make the readme file the start page for the generated html
+  rdoc.options << '--main' << 'README'
+  rdoc.rdoc_files.include('doc/*.rdoc',
+                          'ext/**/*.c',
+                          'lib/**/*.rb',
+                          'CHANGES',
+                          'README',
+                          'LICENSE',
+                          'VERSION')
+end
+
+task :default => :package
+task :package => :create_win32_gem
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.libs << "ext/libxml"
+end
+
+if not RUBY_PLATFORM.match(/mswin32/i)
+  Rake::Task[:test].prerequisites << :extensions
+end
+
+task :build => :extensions
+task :extension => :build
+
+ext = Config::CONFIG["DLEXT"]
+task :extensions => ["ext/libxml/libxml_ruby.#{ext}"]
+file "ext/libxml/libxml_ruby.#{ext}" =>
+  ["ext/libxml/Makefile"] + FileList["ext/libxml/*.{c,h}"].to_a do |t|
+  Dir.chdir("ext/libxml") { sh "make" }
+end
+
+namespace :extensions do
+  task :clean do
+    Dir.chdir("ext/libxml") do
+      sh "rm -f Makefile"
+      sh "rm -f *.{o,so,bundle,log}"
+    end
+  end
+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 }
+end
+
+# ---------  Publish Website to Rubyforge ---------
+desc "publish website (uses rsync)"
+task :publish => [:publish_website, :publish_rdoc]
+
+task :publish_website do
+  unixname = 'libxml'
+  username = ENV['RUBYFORGE_USERNAME']
+
+  dir = 'admin/web'
+  url = "#{username}@rubyforge.org:/var/www/gforge-projects/#{unixname}"
+
+  dir = dir.chomp('/') + '/'
+
+  # Using commandline filter options didn't seem to work, so
+  # I opted for creating an .rsync_filter file for all cases.
+
+  protect = %w{usage statcvs statsvn robot.txt wiki}
+  exclude = %w{.svn}
+
+  rsync_file = File.join(dir,'.rsync-filter')
+  unless File.file?(rsync_file)
+    File.open(rsync_file, 'w') do |f|
+      exclude.each{|e| f << "- #{e}\n"}
+      protect.each{|e| f << "P #{e}\n"}
+    end
+  end
+
+  # maybe -p ?
+  cmd = "rsync -rLvz --delete-after --filter='dir-merge #{rsync_file}' #{dir} #{url}"
+  sh cmd
+end
+
+task :publish_rdoc do
+  unixname = 'libxml'
+  username = ENV['RUBYFORGE_USERNAME']
+
+  dir = 'doc/rdoc'
+  url = "#{username}@rubyforge.org:/var/www/gforge-projects/#{unixname}/rdoc"
+
+  dir = dir.chomp('/') + '/'
+
+  # maybe -p ?
+  cmd = "rsync -rLvz --delete-after #{dir} #{url}"
+  sh cmd
+end

data/README

@@ -35,14 +35,14 @@ The easiest way to install libxml-ruby is via Ruby Gems.  To install:
 
 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.12.  Both of these are also 
+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 biult with MingW.  The gem also includes 
-a Microsoft VC++ 2005 solution.  If you wish to run a debug version
-of libxml-ruby on Windows, then it is highly recommended
-you use VC++.
+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
@@ -52,11 +52,13 @@ functionality such as:
 
 * SAX
 * DOM
+* HTML Parsing
 * XMLReader
 * XPath
 * XPointer
-* XML Schema
 * DTDs 
+* RelaxNG Schemas
+* XML Schema
 * XSLT (split into the libxslt-ruby bindings) 
 
 libxml-ruby provides impressive coverage of libxml's functionality 
@@ -84,16 +86,35 @@ From https://svn.concord.org/svn/projects/trunk/common/ruby/xml_benchmarks/
  rexml    22.859000   0.047000  22.906000 ( 23.203000) 
 
 == USAGE
-
 For in-depth information about using libxml-ruby please refer
-to its online Rdoc documentation.  Some simple examples
-are shown below.
+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 
+write code like this: 
+
+require 'xml'
+document = XML::Document.new
+
+If you prefer not to add the LibXML module to the global namepace, then
+write your code like this:
+
+require 'libxml'
+
+class MyClass
+  def some_method
+    document = LibXML::XML::Document.new
+  end
+end
+
+Some simple examples are shown below.
 
 === READING
 
 There are several ways to read xml documents.
 
-  require 'libxml'
+  require 'xml'
   doc = XML::Document.file('output.xml')
   root = doc.root
   
@@ -126,7 +147,7 @@ And your terminal should look like:
 
 To write a simple document:
 
-  require 'libxml'
+  require 'xml'
   
   doc = XML::Document.new()
   doc.root = XML::Node.new('root_node')

data/doc/rdoc/classes/LibXML.html

@@ -106,6 +106,10 @@
                 <a href="../files/ext/libxml/ruby_xml_reader_c.html">
                 ext/libxml/ruby_xml_reader.c
                 </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_relaxng_c.html">
+                ext/libxml/ruby_xml_relaxng.c
+                </a>
         <br />
                 <a href="../files/ext/libxml/ruby_xml_sax_parser_c.html">
                 ext/libxml/ruby_xml_sax_parser.c

data/doc/rdoc/classes/LibXML/XML.html

@@ -108,6 +108,12 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <p>
+Please see the LICENSE file for copyright and distribution information
+</p>
+
+    </div>
 
 
    </div>
@@ -136,6 +142,7 @@ Class <a href="XML/NS.html" class="link">LibXML::XML::NS</a><br />
 Class <a href="XML/Node.html" class="link">LibXML::XML::Node</a><br />
 Class <a href="XML/Parser.html" class="link">LibXML::XML::Parser</a><br />
 Class <a href="XML/Reader.html" class="link">LibXML::XML::Reader</a><br />
+Class <a href="XML/RelaxNG.html" class="link">LibXML::XML::RelaxNG</a><br />
 Class <a href="XML/SaxParser.html" class="link">LibXML::XML::SaxParser</a><br />
 Class <a href="XML/Schema.html" class="link">LibXML::XML::Schema</a><br />
 Class <a href="XML/State.html" class="link">LibXML::XML::State</a><br />

data/doc/rdoc/classes/LibXML/XML/Attr.html

@@ -85,13 +85,13 @@
     <div id="description">
       <p>
 Provides access to an single element attribute. Accessed by calling <a
-href="Node.html#M000129">XML::Node#attributes</a> method.
+href="Node.html#M000132">XML::Node#attributes</a> method.
 </p>
 <p>
 Basic Usage:
 </p>
 <pre>
- require 'libxml'
+ require 'xml'
 
  doc = XML::Document.new(&lt;some_file&gt;)
  attribute = doc.root.attributes.get_attribute_ns('http://www.w3.org/1999/xlink', 'href')
@@ -109,33 +109,33 @@ Basic Usage:
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000237">child</a>&nbsp;&nbsp;
-      <a href="#M000238">child?</a>&nbsp;&nbsp;
-      <a href="#M000239">doc</a>&nbsp;&nbsp;
-      <a href="#M000240">doc?</a>&nbsp;&nbsp;
-      <a href="#M000259">each</a>&nbsp;&nbsp;
-      <a href="#M000258">each_attr</a>&nbsp;&nbsp;
-      <a href="#M000257">each_sibling</a>&nbsp;&nbsp;
-      <a href="#M000241">last</a>&nbsp;&nbsp;
-      <a href="#M000242">last?</a>&nbsp;&nbsp;
-      <a href="#M000243">name</a>&nbsp;&nbsp;
-      <a href="#M000236">new</a>&nbsp;&nbsp;
-      <a href="#M000244">next</a>&nbsp;&nbsp;
-      <a href="#M000245">next?</a>&nbsp;&nbsp;
-      <a href="#M000246">node_type_name</a>&nbsp;&nbsp;
-      <a href="#M000247">ns</a>&nbsp;&nbsp;
-      <a href="#M000248">ns?</a>&nbsp;&nbsp;
-      <a href="#M000249">parent</a>&nbsp;&nbsp;
-      <a href="#M000250">parent?</a>&nbsp;&nbsp;
-      <a href="#M000251">prev</a>&nbsp;&nbsp;
-      <a href="#M000252">prev?</a>&nbsp;&nbsp;
-      <a href="#M000253">remove!</a>&nbsp;&nbsp;
-      <a href="#M000256">siblings</a>&nbsp;&nbsp;
-      <a href="#M000261">to_a</a>&nbsp;&nbsp;
-      <a href="#M000260">to_h</a>&nbsp;&nbsp;
-      <a href="#M000262">to_s</a>&nbsp;&nbsp;
-      <a href="#M000254">value</a>&nbsp;&nbsp;
-      <a href="#M000255">value=</a>&nbsp;&nbsp;
+      <a href="#M000240">child</a>&nbsp;&nbsp;
+      <a href="#M000241">child?</a>&nbsp;&nbsp;
+      <a href="#M000242">doc</a>&nbsp;&nbsp;
+      <a href="#M000243">doc?</a>&nbsp;&nbsp;
+      <a href="#M000262">each</a>&nbsp;&nbsp;
+      <a href="#M000261">each_attr</a>&nbsp;&nbsp;
+      <a href="#M000260">each_sibling</a>&nbsp;&nbsp;
+      <a href="#M000244">last</a>&nbsp;&nbsp;
+      <a href="#M000245">last?</a>&nbsp;&nbsp;
+      <a href="#M000246">name</a>&nbsp;&nbsp;
+      <a href="#M000239">new</a>&nbsp;&nbsp;
+      <a href="#M000247">next</a>&nbsp;&nbsp;
+      <a href="#M000248">next?</a>&nbsp;&nbsp;
+      <a href="#M000249">node_type_name</a>&nbsp;&nbsp;
+      <a href="#M000250">ns</a>&nbsp;&nbsp;
+      <a href="#M000251">ns?</a>&nbsp;&nbsp;
+      <a href="#M000252">parent</a>&nbsp;&nbsp;
+      <a href="#M000253">parent?</a>&nbsp;&nbsp;
+      <a href="#M000254">prev</a>&nbsp;&nbsp;
+      <a href="#M000255">prev?</a>&nbsp;&nbsp;
+      <a href="#M000256">remove!</a>&nbsp;&nbsp;
+      <a href="#M000259">siblings</a>&nbsp;&nbsp;
+      <a href="#M000264">to_a</a>&nbsp;&nbsp;
+      <a href="#M000263">to_h</a>&nbsp;&nbsp;
+      <a href="#M000265">to_s</a>&nbsp;&nbsp;
+      <a href="#M000257">value</a>&nbsp;&nbsp;
+      <a href="#M000258">value=</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -164,11 +164,11 @@ Basic Usage:
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000236" class="method-detail">
-        <a name="M000236"></a>
+      <div id="method-M000239" class="method-detail">
+        <a name="M000239"></a>
 
         <div class="method-heading">
-          <a href="#M000236" class="method-signature">
+          <a href="#M000239" class="method-signature">
           <span class="method-name">attr.initialize(node, "name", "value")<br />
 </span>
           </a>
@@ -176,18 +176,21 @@ Basic Usage:
       
         <div class="method-description">
           <p>
-Creates a new attribute for the node.
+Creates a <a href="Attr.html#M000239">new</a> attribute for the node.
 </p>
 <p>
 node: The <a href="Node.html">XML::Node</a> that will contain the attribute
-name: The name of the attribute value: The value of the attribute
+<a href="Attr.html#M000246">name</a>: The <a
+href="Attr.html#M000246">name</a> of the attribute <a
+href="Attr.html#M000257">value</a>: The <a
+href="Attr.html#M000257">value</a> of the attribute
 </p>
 <pre>
  attr = XML::Attr.new(doc.root, 'name', 'libxml')
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000236-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000236-source">
+            onclick="toggleCode('M000239-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000239-source">
 <pre>
 /*
  * call-seq:
@@ -211,11 +214,11 @@ ruby_xml_attr_initialize(int argc, VALUE *argv, VALUE self) {
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000237" class="method-detail">
-        <a name="M000237"></a>
+      <div id="method-M000240" class="method-detail">
+        <a name="M000240"></a>
 
         <div class="method-heading">
-          <a href="#M000237" class="method-signature">
+          <a href="#M000240" class="method-signature">
           <span class="method-name">attr.child &rarr; node<br />
 </span>
           </a>
@@ -223,11 +226,12 @@ ruby_xml_attr_initialize(int argc, VALUE *argv, VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain this attribute&#8217;s child attribute(s).
+Obtain this attribute&#8216;s <a href="Attr.html#M000240">child</a>
+attribute(s).
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000237-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000237-source">
+            onclick="toggleCode('M000240-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000240-source">
 <pre>
 /*
  * call-seq:
@@ -243,11 +247,11 @@ ruby_xml_attr_child_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000238" class="method-detail">
-        <a name="M000238"></a>
+      <div id="method-M000241" class="method-detail">
+        <a name="M000241"></a>
 
         <div class="method-heading">
-          <a href="#M000238" class="method-signature">
+          <a href="#M000241" class="method-signature">
           <span class="method-name">attr.child? &rarr; (true|false)<br />
 </span>
           </a>
@@ -255,11 +259,12 @@ ruby_xml_attr_child_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Determine whether this attribute has child attributes.
+Determine whether this attribute has <a href="Attr.html#M000240">child</a>
+attributes.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000238-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000238-source">
+            onclick="toggleCode('M000241-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000241-source">
 <pre>
 /*
  * call-seq:
@@ -275,11 +280,11 @@ ruby_xml_attr_child_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000239" class="method-detail">
-        <a name="M000239"></a>
+      <div id="method-M000242" class="method-detail">
+        <a name="M000242"></a>
 
         <div class="method-heading">
-          <a href="#M000239" class="method-signature">
+          <a href="#M000242" class="method-signature">
           <span class="method-name">attr.doc &rarr; XML::Document<br />
 </span>
           </a>
@@ -287,14 +292,14 @@ ruby_xml_attr_child_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Returns this attribute&#8217;s document.
+Returns this attribute&#8216;s document.
 </p>
 <pre>
  doc.root.attributes.get_attribute('name').doc == doc
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000239-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000239-source">
+            onclick="toggleCode('M000242-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000242-source">
 <pre>
 /*
  * call-seq:
@@ -312,11 +317,11 @@ ruby_xml_attr_doc_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000240" class="method-detail">
-        <a name="M000240"></a>
+      <div id="method-M000243" class="method-detail">
+        <a name="M000243"></a>
 
         <div class="method-heading">
-          <a href="#M000240" class="method-signature">
+          <a href="#M000243" class="method-signature">
           <span class="method-name">attr.doc? &rarr; (true|false)<br />
 </span>
           </a>
@@ -328,8 +333,8 @@ Determine whether this attribute is associated with an <a
 href="Document.html">XML::Document</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000240-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000240-source">
+            onclick="toggleCode('M000243-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000243-source">
 <pre>
 /*
  * call-seq:
@@ -346,8 +351,8 @@ ruby_xml_attr_doc_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000259" class="method-detail">
-        <a name="M000259"></a>
+      <div id="method-M000262" class="method-detail">
+        <a name="M000262"></a>
 
         <div class="method-heading">
           <span class="method-name">each</span><span class="method-args">(&amp;blk)</span>
@@ -355,13 +360,13 @@ ruby_xml_attr_doc_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Alias for <a href="Attr.html#M000257">each_sibling</a>
+Alias for <a href="Attr.html#M000260">each_sibling</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000258" class="method-detail">
-        <a name="M000258"></a>
+      <div id="method-M000261" class="method-detail">
+        <a name="M000261"></a>
 
         <div class="method-heading">
           <span class="method-name">each_attr</span><span class="method-args">(&amp;blk)</span>
@@ -369,24 +374,24 @@ Alias for <a href="Attr.html#M000257">each_sibling</a>
       
         <div class="method-description">
           <p>
-Alias for <a href="Attr.html#M000257">each_sibling</a>
+Alias for <a href="Attr.html#M000260">each_sibling</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000257" class="method-detail">
-        <a name="M000257"></a>
+      <div id="method-M000260" class="method-detail">
+        <a name="M000260"></a>
 
         <div class="method-heading">
-          <a href="#M000257" class="method-signature">
+          <a href="#M000260" class="method-signature">
           <span class="method-name">each_sibling</span><span class="method-args">(&amp;blk)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000257-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000257-source">
+            onclick="toggleCode('M000260-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000260-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/libxml/attr.rb, line 19</span>
 19:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_sibling</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
@@ -397,11 +402,11 @@ Alias for <a href="Attr.html#M000257">each_sibling</a>
         </div>
       </div>
 
-      <div id="method-M000241" class="method-detail">
-        <a name="M000241"></a>
+      <div id="method-M000244" class="method-detail">
+        <a name="M000244"></a>
 
         <div class="method-heading">
-          <a href="#M000241" class="method-signature">
+          <a href="#M000244" class="method-signature">
           <span class="method-name">attr.last &rarr; node<br />
 </span>
           </a>
@@ -409,11 +414,11 @@ Alias for <a href="Attr.html#M000257">each_sibling</a>
       
         <div class="method-description">
           <p>
-Obtain the last attribute.
+Obtain the <a href="Attr.html#M000244">last</a> attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000241-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000241-source">
+            onclick="toggleCode('M000244-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000244-source">
 <pre>
 /*
  * call-seq:
@@ -429,11 +434,11 @@ ruby_xml_attr_last_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000242" class="method-detail">
-        <a name="M000242"></a>
+      <div id="method-M000245" class="method-detail">
+        <a name="M000245"></a>
 
         <div class="method-heading">
-          <a href="#M000242" class="method-signature">
+          <a href="#M000245" class="method-signature">
           <span class="method-name">attr.last? &rarr; (true|false)<br />
 </span>
           </a>
@@ -441,11 +446,12 @@ ruby_xml_attr_last_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Determine whether this is the last attribute.
+Determine whether this is the <a href="Attr.html#M000244">last</a>
+attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000242-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000242-source">
+            onclick="toggleCode('M000245-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000245-source">
 <pre>
 /*
  * call-seq:
@@ -461,11 +467,11 @@ ruby_xml_attr_last_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000243" class="method-detail">
-        <a name="M000243"></a>
+      <div id="method-M000246" class="method-detail">
+        <a name="M000246"></a>
 
         <div class="method-heading">
-          <a href="#M000243" class="method-signature">
+          <a href="#M000246" class="method-signature">
           <span class="method-name">attr.name &rarr; "name"<br />
 </span>
           </a>
@@ -473,11 +479,11 @@ ruby_xml_attr_last_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain this attribute&#8217;s name.
+Obtain this attribute&#8216;s <a href="Attr.html#M000246">name</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000243-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000243-source">
+            onclick="toggleCode('M000246-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000246-source">
 <pre>
 /*
  * call-seq:
@@ -493,11 +499,11 @@ ruby_xml_attr_name_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000244" class="method-detail">
-        <a name="M000244"></a>
+      <div id="method-M000247" class="method-detail">
+        <a name="M000247"></a>
 
         <div class="method-heading">
-          <a href="#M000244" class="method-signature">
+          <a href="#M000247" class="method-signature">
           <span class="method-name">attr.next &rarr; node<br />
 </span>
           </a>
@@ -505,11 +511,11 @@ ruby_xml_attr_name_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain the next attribute.
+Obtain the <a href="Attr.html#M000247">next</a> attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000244-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000244-source">
+            onclick="toggleCode('M000247-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000247-source">
 <pre>
 /*
  * call-seq:
@@ -525,11 +531,11 @@ ruby_xml_attr_next_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000245" class="method-detail">
-        <a name="M000245"></a>
+      <div id="method-M000248" class="method-detail">
+        <a name="M000248"></a>
 
         <div class="method-heading">
-          <a href="#M000245" class="method-signature">
+          <a href="#M000248" class="method-signature">
           <span class="method-name">attr.next? &rarr; (true|false)<br />
 </span>
           </a>
@@ -537,11 +543,12 @@ ruby_xml_attr_next_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Determine whether there is a next attribute.
+Determine whether there is a <a href="Attr.html#M000247">next</a>
+attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000245-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000245-source">
+            onclick="toggleCode('M000248-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000248-source">
 <pre>
 /*
  * call-seq:
@@ -557,11 +564,11 @@ ruby_xml_attr_next_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000246" class="method-detail">
-        <a name="M000246"></a>
+      <div id="method-M000249" class="method-detail">
+        <a name="M000249"></a>
 
         <div class="method-heading">
-          <a href="#M000246" class="method-signature">
+          <a href="#M000249" class="method-signature">
           <span class="method-name">attr.type_name &rarr; "attribute"<br />
 </span>
           </a>
@@ -569,11 +576,12 @@ ruby_xml_attr_next_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain this attribute node&#8217;s type name.
+Obtain this attribute node&#8216;s type <a
+href="Attr.html#M000246">name</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000246-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000246-source">
+            onclick="toggleCode('M000249-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000249-source">
 <pre>
 /*
  * call-seq:
@@ -589,11 +597,11 @@ ruby_xml_attr_node_type_name(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000247" class="method-detail">
-        <a name="M000247"></a>
+      <div id="method-M000250" class="method-detail">
+        <a name="M000250"></a>
 
         <div class="method-heading">
-          <a href="#M000247" class="method-signature">
+          <a href="#M000250" class="method-signature">
           <span class="method-name">attr.ns &rarr; namespace<br />
 </span>
           </a>
@@ -601,12 +609,12 @@ ruby_xml_attr_node_type_name(VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain this attribute&#8217;s associated <a href="NS.html">XML::NS</a>, if
+Obtain this attribute&#8216;s associated <a href="NS.html">XML::NS</a>, if
 any.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000247-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000247-source">
+            onclick="toggleCode('M000250-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000250-source">
 <pre>
 /*
  * call-seq:
@@ -622,11 +630,11 @@ ruby_xml_attr_ns_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000248" class="method-detail">
-        <a name="M000248"></a>
+      <div id="method-M000251" class="method-detail">
+        <a name="M000251"></a>
 
         <div class="method-heading">
-          <a href="#M000248" class="method-signature">
+          <a href="#M000251" class="method-signature">
           <span class="method-name">attr.ns? &rarr; (true|false)<br />
 </span>
           </a>
@@ -637,8 +645,8 @@ ruby_xml_attr_ns_get(VALUE self) {
 Determine whether this attribute has an associated namespace.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000248-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000248-source">
+            onclick="toggleCode('M000251-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000251-source">
 <pre>
 /*
  * call-seq:
@@ -655,11 +663,11 @@ ruby_xml_attr_ns_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000249" class="method-detail">
-        <a name="M000249"></a>
+      <div id="method-M000252" class="method-detail">
+        <a name="M000252"></a>
 
         <div class="method-heading">
-          <a href="#M000249" class="method-signature">
+          <a href="#M000252" class="method-signature">
           <span class="method-name">attr.parent &rarr; node<br />
 </span>
           </a>
@@ -667,11 +675,11 @@ ruby_xml_attr_ns_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Obtain this attribute node&#8217;s parent.
+Obtain this attribute node&#8216;s <a href="Attr.html#M000252">parent</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000249-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000249-source">
+            onclick="toggleCode('M000252-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000252-source">
 <pre>
 /*
  * call-seq:
@@ -687,11 +695,11 @@ ruby_xml_attr_parent_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000250" class="method-detail">
-        <a name="M000250"></a>
+      <div id="method-M000253" class="method-detail">
+        <a name="M000253"></a>
 
         <div class="method-heading">
-          <a href="#M000250" class="method-signature">
+          <a href="#M000253" class="method-signature">
           <span class="method-name">attr.parent? &rarr; (true|false)<br />
 </span>
           </a>
@@ -699,11 +707,12 @@ ruby_xml_attr_parent_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Determine whether this attribute has a parent.
+Determine whether this attribute has a <a
+href="Attr.html#M000252">parent</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000250-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000250-source">
+            onclick="toggleCode('M000253-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000253-source">
 <pre>
 /*
  * call-seq:
@@ -719,11 +728,11 @@ ruby_xml_attr_parent_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000251" class="method-detail">
-        <a name="M000251"></a>
+      <div id="method-M000254" class="method-detail">
+        <a name="M000254"></a>
 
         <div class="method-heading">
-          <a href="#M000251" class="method-signature">
+          <a href="#M000254" class="method-signature">
           <span class="method-name">attr.prev &rarr; node<br />
 </span>
           </a>
@@ -734,8 +743,8 @@ ruby_xml_attr_parent_q(VALUE self) {
 Obtain the previous attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000251-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000251-source">
+            onclick="toggleCode('M000254-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000254-source">
 <pre>
 /*
  * call-seq:
@@ -751,11 +760,11 @@ ruby_xml_attr_prev_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000252" class="method-detail">
-        <a name="M000252"></a>
+      <div id="method-M000255" class="method-detail">
+        <a name="M000255"></a>
 
         <div class="method-heading">
-          <a href="#M000252" class="method-signature">
+          <a href="#M000255" class="method-signature">
           <span class="method-name">attr.prev? &rarr; (true|false)<br />
 </span>
           </a>
@@ -766,8 +775,8 @@ ruby_xml_attr_prev_get(VALUE self) {
 Determine whether there is a previous attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000252-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000252-source">
+            onclick="toggleCode('M000255-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000255-source">
 <pre>
 /*
  * call-seq:
@@ -783,11 +792,11 @@ ruby_xml_attr_prev_q(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000253" class="method-detail">
-        <a name="M000253"></a>
+      <div id="method-M000256" class="method-detail">
+        <a name="M000256"></a>
 
         <div class="method-heading">
-          <a href="#M000253" class="method-signature">
+          <a href="#M000256" class="method-signature">
           <span class="method-name">node.remove! &rarr; nil<br />
 </span>
           </a>
@@ -795,11 +804,12 @@ ruby_xml_attr_prev_q(VALUE self) {
       
         <div class="method-description">
           <p>
-Removes this attribute from it&#8217;s parent.
+Removes this attribute from it&#8216;s <a
+href="Attr.html#M000252">parent</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000253-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000253-source">
+            onclick="toggleCode('M000256-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000256-source">
 <pre>
 /*
  * call-seq:
@@ -815,11 +825,11 @@ ruby_xml_attr_remove_ex(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000256" class="method-detail">
-        <a name="M000256"></a>
+      <div id="method-M000259" class="method-detail">
+        <a name="M000259"></a>
 
         <div class="method-heading">
-          <a href="#M000256" class="method-signature">
+          <a href="#M000259" class="method-signature">
           <span class="method-name">siblings</span><span class="method-args">(node, &amp;blk)</span>
           </a>
         </div>
@@ -829,8 +839,8 @@ ruby_xml_attr_remove_ex(VALUE self) {
 Iterates nodes and attributes
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000256-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000256-source">
+            onclick="toggleCode('M000259-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000259-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/libxml/attr.rb, line 10</span>
 10:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">siblings</span>(<span class="ruby-identifier">node</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
@@ -846,19 +856,19 @@ Iterates nodes and attributes
         </div>
       </div>
 
-      <div id="method-M000261" class="method-detail">
-        <a name="M000261"></a>
+      <div id="method-M000264" class="method-detail">
+        <a name="M000264"></a>
 
         <div class="method-heading">
-          <a href="#M000261" class="method-signature">
+          <a href="#M000264" class="method-signature">
           <span class="method-name">to_a</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000261-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000261-source">
+            onclick="toggleCode('M000264-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000264-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/libxml/attr.rb, line 33</span>
 33:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_a</span>
@@ -872,19 +882,19 @@ Iterates nodes and attributes
         </div>
       </div>
 
-      <div id="method-M000260" class="method-detail">
-        <a name="M000260"></a>
+      <div id="method-M000263" class="method-detail">
+        <a name="M000263"></a>
 
         <div class="method-heading">
-          <a href="#M000260" class="method-signature">
+          <a href="#M000263" class="method-signature">
           <span class="method-name">to_h</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000260-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000260-source">
+            onclick="toggleCode('M000263-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000263-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/libxml/attr.rb, line 26</span>
 26:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>
@@ -898,19 +908,19 @@ Iterates nodes and attributes
         </div>
       </div>
 
-      <div id="method-M000262" class="method-detail">
-        <a name="M000262"></a>
+      <div id="method-M000265" class="method-detail">
+        <a name="M000265"></a>
 
         <div class="method-heading">
-          <a href="#M000262" class="method-signature">
+          <a href="#M000265" class="method-signature">
           <span class="method-name">to_s</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000262-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000262-source">
+            onclick="toggleCode('M000265-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000265-source">
 <pre>
     <span class="ruby-comment cmt"># File lib/libxml/attr.rb, line 40</span>
 40:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
@@ -921,11 +931,11 @@ Iterates nodes and attributes
         </div>
       </div>
 
-      <div id="method-M000254" class="method-detail">
-        <a name="M000254"></a>
+      <div id="method-M000257" class="method-detail">
+        <a name="M000257"></a>
 
         <div class="method-heading">
-          <a href="#M000254" class="method-signature">
+          <a href="#M000257" class="method-signature">
           <span class="method-name">attr.value &rarr; "value"<br />
 </span>
           </a>
@@ -933,11 +943,11 @@ Iterates nodes and attributes
       
         <div class="method-description">
           <p>
-Obtain the value of this attribute.
+Obtain the <a href="Attr.html#M000257">value</a> of this attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000254-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000254-source">
+            onclick="toggleCode('M000257-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000257-source">
 <pre>
 /*
  * call-seq:
@@ -953,11 +963,11 @@ ruby_xml_attr_value_get(VALUE self) {
         </div>
       </div>
 
-      <div id="method-M000255" class="method-detail">
-        <a name="M000255"></a>
+      <div id="method-M000258" class="method-detail">
+        <a name="M000258"></a>
 
         <div class="method-heading">
-          <a href="#M000255" class="method-signature">
+          <a href="#M000258" class="method-signature">
           <span class="method-name">attr.value = "value"<br />
 </span>
           </a>
@@ -965,11 +975,11 @@ ruby_xml_attr_value_get(VALUE self) {
       
         <div class="method-description">
           <p>
-Sets the value of this attribute.
+Sets the <a href="Attr.html#M000257">value</a> of this attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000255-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000255-source">
+            onclick="toggleCode('M000258-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000258-source">
 <pre>
 /*
  * call-seq: