libxml-ruby 0.8.1 → 0.8.2

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

@@ -78,6 +78,18 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <pre>
+  #define RUBY_XML_PARSER_ENABLED_INIT(func, method) \
+</pre>
+<p>
+rb_define_singleton_method(cXMLParser, method, \
+</p>
+<pre>
+                          ruby_xml_parser_enabled_##func##_q, 0);
+</pre>
+
+    </div>
 
 
    </div>

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

@@ -78,6 +78,12 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <p>
+Rdoc needs to know.
+</p>
+
+    </div>
 
 
    </div>
@@ -86,53 +92,54 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000298">[]</a>&nbsp;&nbsp;
-      <a href="#M000285">attribute_count</a>&nbsp;&nbsp;
-      <a href="#M000289">base_uri</a>&nbsp;&nbsp;
-      <a href="#M000303">byte_consumed</a>&nbsp;&nbsp;
-      <a href="#M000266">close</a>&nbsp;&nbsp;
-      <a href="#M000304">column_number</a>&nbsp;&nbsp;
-      <a href="#M000306">default?</a>&nbsp;&nbsp;
-      <a href="#M000294">depth</a>&nbsp;&nbsp;
-      <a href="#M000307">empty_element?</a>&nbsp;&nbsp;
-      <a href="#M000288">encoding</a>&nbsp;&nbsp;
-      <a href="#M000302">expand</a>&nbsp;&nbsp;
-      <a href="#M000263">file</a>&nbsp;&nbsp;
-      <a href="#M000297">has_attributes?</a>&nbsp;&nbsp;
-      <a href="#M000299">has_value?</a>&nbsp;&nbsp;
-      <a href="#M000305">line_number</a>&nbsp;&nbsp;
-      <a href="#M000287">local_name</a>&nbsp;&nbsp;
-      <a href="#M000301">lookup_namespace</a>&nbsp;&nbsp;
-      <a href="#M000267">move_to_attribute</a>&nbsp;&nbsp;
-      <a href="#M000270">move_to_element</a>&nbsp;&nbsp;
-      <a href="#M000268">move_to_first_attribute</a>&nbsp;&nbsp;
-      <a href="#M000269">move_to_next_attribute</a>&nbsp;&nbsp;
-      <a href="#M000286">name</a>&nbsp;&nbsp;
-      <a href="#M000308">namespace_declaration?</a>&nbsp;&nbsp;
-      <a href="#M000290">namespace_uri</a>&nbsp;&nbsp;
-      <a href="#M000265">new</a>&nbsp;&nbsp;
-      <a href="#M000271">next</a>&nbsp;&nbsp;
-      <a href="#M000272">next_sibling</a>&nbsp;&nbsp;
-      <a href="#M000283">node_type</a>&nbsp;&nbsp;
-      <a href="#M000284">normalization</a>&nbsp;&nbsp;
-      <a href="#M000293">prefix</a>&nbsp;&nbsp;
-      <a href="#M000295">quote_char</a>&nbsp;&nbsp;
-      <a href="#M000273">read</a>&nbsp;&nbsp;
-      <a href="#M000274">read_attribute_value</a>&nbsp;&nbsp;
-      <a href="#M000275">read_inner_xml</a>&nbsp;&nbsp;
-      <a href="#M000276">read_outer_xml</a>&nbsp;&nbsp;
-      <a href="#M000277">read_state</a>&nbsp;&nbsp;
-      <a href="#M000278">read_string</a>&nbsp;&nbsp;
-      <a href="#M000281">relax_ng_validate</a>&nbsp;&nbsp;
-      <a href="#M000280">reset_error_handler</a>&nbsp;&nbsp;
-      <a href="#M000282">schema_validate</a>&nbsp;&nbsp;
-      <a href="#M000279">set_error_handler</a>&nbsp;&nbsp;
-      <a href="#M000296">standalone</a>&nbsp;&nbsp;
-      <a href="#M000309">valid?</a>&nbsp;&nbsp;
-      <a href="#M000300">value</a>&nbsp;&nbsp;
-      <a href="#M000264">walker</a>&nbsp;&nbsp;
-      <a href="#M000291">xml_lang</a>&nbsp;&nbsp;
-      <a href="#M000292">xml_version</a>&nbsp;&nbsp;
+      <a href="#M000302">[]</a>&nbsp;&nbsp;
+      <a href="#M000289">attribute_count</a>&nbsp;&nbsp;
+      <a href="#M000293">base_uri</a>&nbsp;&nbsp;
+      <a href="#M000307">byte_consumed</a>&nbsp;&nbsp;
+      <a href="#M000270">close</a>&nbsp;&nbsp;
+      <a href="#M000308">column_number</a>&nbsp;&nbsp;
+      <a href="#M000310">default?</a>&nbsp;&nbsp;
+      <a href="#M000298">depth</a>&nbsp;&nbsp;
+      <a href="#M000311">empty_element?</a>&nbsp;&nbsp;
+      <a href="#M000292">encoding</a>&nbsp;&nbsp;
+      <a href="#M000306">expand</a>&nbsp;&nbsp;
+      <a href="#M000266">file</a>&nbsp;&nbsp;
+      <a href="#M000301">has_attributes?</a>&nbsp;&nbsp;
+      <a href="#M000303">has_value?</a>&nbsp;&nbsp;
+      <a href="#M000267">io</a>&nbsp;&nbsp;
+      <a href="#M000309">line_number</a>&nbsp;&nbsp;
+      <a href="#M000291">local_name</a>&nbsp;&nbsp;
+      <a href="#M000305">lookup_namespace</a>&nbsp;&nbsp;
+      <a href="#M000271">move_to_attribute</a>&nbsp;&nbsp;
+      <a href="#M000274">move_to_element</a>&nbsp;&nbsp;
+      <a href="#M000272">move_to_first_attribute</a>&nbsp;&nbsp;
+      <a href="#M000273">move_to_next_attribute</a>&nbsp;&nbsp;
+      <a href="#M000290">name</a>&nbsp;&nbsp;
+      <a href="#M000312">namespace_declaration?</a>&nbsp;&nbsp;
+      <a href="#M000294">namespace_uri</a>&nbsp;&nbsp;
+      <a href="#M000269">new</a>&nbsp;&nbsp;
+      <a href="#M000275">next</a>&nbsp;&nbsp;
+      <a href="#M000276">next_sibling</a>&nbsp;&nbsp;
+      <a href="#M000287">node_type</a>&nbsp;&nbsp;
+      <a href="#M000288">normalization</a>&nbsp;&nbsp;
+      <a href="#M000297">prefix</a>&nbsp;&nbsp;
+      <a href="#M000299">quote_char</a>&nbsp;&nbsp;
+      <a href="#M000277">read</a>&nbsp;&nbsp;
+      <a href="#M000278">read_attribute_value</a>&nbsp;&nbsp;
+      <a href="#M000279">read_inner_xml</a>&nbsp;&nbsp;
+      <a href="#M000280">read_outer_xml</a>&nbsp;&nbsp;
+      <a href="#M000281">read_state</a>&nbsp;&nbsp;
+      <a href="#M000282">read_string</a>&nbsp;&nbsp;
+      <a href="#M000285">relax_ng_validate</a>&nbsp;&nbsp;
+      <a href="#M000284">reset_error_handler</a>&nbsp;&nbsp;
+      <a href="#M000286">schema_validate</a>&nbsp;&nbsp;
+      <a href="#M000283">set_error_handler</a>&nbsp;&nbsp;
+      <a href="#M000300">standalone</a>&nbsp;&nbsp;
+      <a href="#M000313">valid?</a>&nbsp;&nbsp;
+      <a href="#M000304">value</a>&nbsp;&nbsp;
+      <a href="#M000268">walker</a>&nbsp;&nbsp;
+      <a href="#M000295">xml_lang</a>&nbsp;&nbsp;
+      <a href="#M000296">xml_version</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -322,11 +329,11 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000263" class="method-detail">
-        <a name="M000263"></a>
+      <div id="method-M000266" class="method-detail">
+        <a name="M000266"></a>
 
         <div class="method-heading">
-          <a href="#M000263" class="method-signature">
+          <a href="#M000266" class="method-signature">
           <span class="method-name">XML::Reader.file(path, encoding=nil, options=0) &rarr; reader<br />
 </span>
           </a>
@@ -334,12 +341,13 @@
       
         <div class="method-description">
           <p>
-Parse an <a href="../XML.html">XML</a> file from the filesystem or the
-network. The parsing flags options are a combination of xmlParserOption.
+Parse an <a href="../XML.html">XML</a> <a
+href="Reader.html#M000266">file</a> from the filesystem or the network. The
+parsing flags options are a combination of xmlParserOption.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000263-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000263-source">
+            onclick="toggleCode('M000266-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000266-source">
 <pre>
 /*
  * call-seq:
@@ -371,11 +379,74 @@ ruby_xml_reader_new_file(int argc, VALUE *argv, VALUE self)
         </div>
       </div>
 
-      <div id="method-M000265" class="method-detail">
-        <a name="M000265"></a>
+      <div id="method-M000267" class="method-detail">
+        <a name="M000267"></a>
+
+        <div class="method-heading">
+          <a href="#M000267" class="method-signature">
+          <span class="method-name">XML::Reader.io(io, url=nil, encoding=nil, options=0) &rarr; reader<br />
+</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Parse an <a href="../XML.html">XML</a> <a
+href="Reader.html#M000266">file</a> from a <a
+href="Reader.html#M000266">file</a> handle. The parsing flags options are a
+combination of xmlParserOption.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000267-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000267-source">
+<pre>
+/*
+ * call-seq:
+ *    XML::Reader.io(io, url=nil, encoding=nil, options=0) -&gt; reader
+ *
+ * Parse an XML file from a file handle. The parsing flags options are
+ * a combination of xmlParserOption. 
+ */
+static VALUE
+ruby_xml_reader_new_io(int argc, VALUE *argv, VALUE self)
+{
+  xmlTextReaderPtr reader;
+  VALUE io, url, encoding, options;
+  OpenFile *fptr;
+  FILE *f;
+
+  #ifdef _WIN32
+    rb_raise(rb_eRuntimeError, &quot;Reading an io stream is not supported on Windows&quot;);
+  #endif             
+
+  rb_scan_args(argc, argv, &quot;13&quot;, &amp;io, &amp;url, &amp;encoding, &amp;options);
+
+  if (!rb_obj_is_kind_of(io, rb_cIO))
+    rb_raise(rb_eTypeError, &quot;need an IO object&quot;);
+
+  GetOpenFile(io, fptr);
+  rb_io_check_readable(fptr);
+  f = GetWriteFile(fptr);
+
+  reader = xmlReaderForIO((xmlInputReadCallback) ctxtRead, NULL, f,
+                          NIL_P(url) ? NULL : RVAL2CSTR(url),
+                          NIL_P(encoding) ? NULL : RVAL2CSTR(encoding), 
+                          NIL_P(options) ? 0 : FIX2INT(options));
+  if (reader == NULL)
+    rb_raise(rb_eRuntimeError, &quot;cannot create text reader for given stream&quot;);
+
+  return ruby_xml_reader_new(self, reader); 
+}
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000269" class="method-detail">
+        <a name="M000269"></a>
 
         <div class="method-heading">
-          <a href="#M000265" class="method-signature">
+          <a href="#M000269" class="method-signature">
           <span class="method-name">XML::Reader.new(data, url=nil, encoding=nil, options=0) &rarr; reader<br />
 XML::Reader.string(data, url=nil, encoding=nil, options=0) &rarr; reader<br />
 </span>
@@ -389,8 +460,8 @@ href="../XML.html">XML</a> in-memory document. The parsing flags options
 are a combination of xmlParserOption.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000265-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000265-source">
+            onclick="toggleCode('M000269-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000269-source">
 <pre>
 /*
  * call-seq:
@@ -425,11 +496,11 @@ ruby_xml_reader_new_data(int argc, VALUE *argv, VALUE self)
         </div>
       </div>
 
-      <div id="method-M000264" class="method-detail">
-        <a name="M000264"></a>
+      <div id="method-M000268" class="method-detail">
+        <a name="M000268"></a>
 
         <div class="method-heading">
-          <a href="#M000264" class="method-signature">
+          <a href="#M000268" class="method-signature">
           <span class="method-name">XML::Reader.walker(doc) &rarr; reader<br />
 XML::Reader.document(doc) &rarr; reader<br />
 </span>
@@ -442,8 +513,8 @@ Create an <a href="../XML.html">XML</a> text reader for a preparsed
 document.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000264-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000264-source">
+            onclick="toggleCode('M000268-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000268-source">
 <pre>
 /*
  * call-seq:
@@ -473,11 +544,11 @@ ruby_xml_reader_new_walker(VALUE self, VALUE doc)
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000298" class="method-detail">
-        <a name="M000298"></a>
+      <div id="method-M000302" class="method-detail">
+        <a name="M000302"></a>
 
         <div class="method-heading">
-          <a href="#M000298" class="method-signature">
+          <a href="#M000302" class="method-signature">
           <span class="method-name">reader[key] &rarr; value<br />
 </span>
           </a>
@@ -485,13 +556,14 @@ ruby_xml_reader_new_walker(VALUE self, VALUE doc)
       
         <div class="method-description">
           <p>
-Provide the value of the attribute with the specified index (if
-<tt>key</tt> is an integer) or with the specified name (if <tt>key</tt> is
-a string) relative to the containing element, as a string.
+Provide the <a href="Reader.html#M000304">value</a> of the attribute with
+the specified index (if <tt>key</tt> is an integer) or with the specified
+<a href="Reader.html#M000290">name</a> (if <tt>key</tt> is a string)
+relative to the containing element, as a string.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000298-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000298-source">
+            onclick="toggleCode('M000302-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000302-source">
 <pre>
 /*
  * call-seq:
@@ -522,11 +594,11 @@ ruby_xml_reader_attribute(VALUE self, VALUE key)
         </div>
       </div>
 
-      <div id="method-M000285" class="method-detail">
-        <a name="M000285"></a>
+      <div id="method-M000289" class="method-detail">
+        <a name="M000289"></a>
 
         <div class="method-heading">
-          <a href="#M000285" class="method-signature">
+          <a href="#M000289" class="method-signature">
           <span class="method-name">reader.attribute_count &rarr; count<br />
 </span>
           </a>
@@ -537,8 +609,8 @@ ruby_xml_reader_attribute(VALUE self, VALUE key)
 Provide the number of attributes of the current node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000285-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000285-source">
+            onclick="toggleCode('M000289-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000289-source">
 <pre>
 /*
  * call-seq:
@@ -556,11 +628,11 @@ ruby_xml_reader_attr_count(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000289" class="method-detail">
-        <a name="M000289"></a>
+      <div id="method-M000293" class="method-detail">
+        <a name="M000293"></a>
 
         <div class="method-heading">
-          <a href="#M000289" class="method-signature">
+          <a href="#M000293" class="method-signature">
           <span class="method-name">reader.base_uri &rarr; URI<br />
 </span>
           </a>
@@ -571,8 +643,8 @@ ruby_xml_reader_attr_count(VALUE self)
 Determine the base URI of the node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000289-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000289-source">
+            onclick="toggleCode('M000293-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000293-source">
 <pre>
 /*
  * call-seq:
@@ -590,11 +662,11 @@ ruby_xml_reader_base_uri(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000303" class="method-detail">
-        <a name="M000303"></a>
+      <div id="method-M000307" class="method-detail">
+        <a name="M000307"></a>
 
         <div class="method-heading">
-          <a href="#M000303" class="method-signature">
+          <a href="#M000307" class="method-signature">
           <span class="method-name">reader.byte_consumed &rarr; value<br />
 </span>
           </a>
@@ -606,8 +678,8 @@ This method provides the current index of the parser used by the reader,
 relative to the start of the current entity.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000303-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000303-source">
+            onclick="toggleCode('M000307-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000307-source">
 <pre>
 /*
  * call-seq:
@@ -626,11 +698,11 @@ ruby_xml_reader_byte_consumed(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000266" class="method-detail">
-        <a name="M000266"></a>
+      <div id="method-M000270" class="method-detail">
+        <a name="M000270"></a>
 
         <div class="method-heading">
-          <a href="#M000266" class="method-signature">
+          <a href="#M000270" class="method-signature">
           <span class="method-name">parser.close &rarr; code<br />
 </span>
           </a>
@@ -639,11 +711,12 @@ ruby_xml_reader_byte_consumed(VALUE self)
         <div class="method-description">
           <p>
 This method releases any resources allocated by the current instance
-changes the state to Closed and close any underlying input.
+changes the state to Closed and <a href="Reader.html#M000270">close</a> any
+underlying input.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000266-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000266-source">
+            onclick="toggleCode('M000270-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000270-source">
 <pre>
 /*
  * call-seq:
@@ -662,11 +735,11 @@ ruby_xml_reader_close(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000304" class="method-detail">
-        <a name="M000304"></a>
+      <div id="method-M000308" class="method-detail">
+        <a name="M000308"></a>
 
         <div class="method-heading">
-          <a href="#M000304" class="method-signature">
+          <a href="#M000308" class="method-signature">
           <span class="method-name">reader.column_number &rarr; number<br />
 </span>
           </a>
@@ -677,8 +750,8 @@ ruby_xml_reader_close(VALUE self)
 Provide the column number of the current parsing point.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000304-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000304-source">
+            onclick="toggleCode('M000308-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000308-source">
 <pre>
 /*
  * call-seq:
@@ -696,11 +769,11 @@ ruby_xml_reader_column_number(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000306" class="method-detail">
-        <a name="M000306"></a>
+      <div id="method-M000310" class="method-detail">
+        <a name="M000310"></a>
 
         <div class="method-heading">
-          <a href="#M000306" class="method-signature">
+          <a href="#M000310" class="method-signature">
           <span class="method-name">reader.default? &rarr; bool<br />
 </span>
           </a>
@@ -708,12 +781,12 @@ ruby_xml_reader_column_number(VALUE self)
       
         <div class="method-description">
           <p>
-Return whether an Attribute node was generated from the default value
-defined in the DTD or schema.
+Return whether an Attribute node was generated from the default <a
+href="Reader.html#M000304">value</a> defined in the DTD or schema.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000306-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000306-source">
+            onclick="toggleCode('M000310-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000310-source">
 <pre>
 /*
  * call-seq:
@@ -732,11 +805,11 @@ ruby_xml_reader_default(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000294" class="method-detail">
-        <a name="M000294"></a>
+      <div id="method-M000298" class="method-detail">
+        <a name="M000298"></a>
 
         <div class="method-heading">
-          <a href="#M000294" class="method-signature">
+          <a href="#M000298" class="method-signature">
           <span class="method-name">reader.depth &rarr; depth<br />
 </span>
           </a>
@@ -744,11 +817,11 @@ ruby_xml_reader_default(VALUE self)
       
         <div class="method-description">
           <p>
-Get the depth of the node in the tree.
+Get the <a href="Reader.html#M000298">depth</a> of the node in the tree.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000294-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000294-source">
+            onclick="toggleCode('M000298-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000298-source">
 <pre>
 /*
  * call-seq:
@@ -766,11 +839,11 @@ ruby_xml_reader_depth(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000307" class="method-detail">
-        <a name="M000307"></a>
+      <div id="method-M000311" class="method-detail">
+        <a name="M000311"></a>
 
         <div class="method-heading">
-          <a href="#M000307" class="method-signature">
+          <a href="#M000311" class="method-signature">
           <span class="method-name">reader.empty_element? &rarr; bool<br />
 </span>
           </a>
@@ -781,8 +854,8 @@ ruby_xml_reader_depth(VALUE self)
 Check if the current node is empty.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000307-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000307-source">
+            onclick="toggleCode('M000311-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000311-source">
 <pre>
 /*
  * call-seq:
@@ -800,11 +873,11 @@ ruby_xml_reader_empty_element(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000288" class="method-detail">
-        <a name="M000288"></a>
+      <div id="method-M000292" class="method-detail">
+        <a name="M000292"></a>
 
         <div class="method-heading">
-          <a href="#M000288" class="method-signature">
+          <a href="#M000292" class="method-signature">
           <span class="method-name">reader.encoding &rarr; encoding<br />
 </span>
           </a>
@@ -812,11 +885,12 @@ ruby_xml_reader_empty_element(VALUE self)
       
         <div class="method-description">
           <p>
-Determine the encoding of the document being read.
+Determine the <a href="Reader.html#M000292">encoding</a> of the document
+being <a href="Reader.html#M000277">read</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000288-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000288-source">
+            onclick="toggleCode('M000292-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000292-source">
 <pre>
 /*
  * call-seq:
@@ -834,11 +908,11 @@ ruby_xml_reader_encoding(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000302" class="method-detail">
-        <a name="M000302"></a>
+      <div id="method-M000306" class="method-detail">
+        <a name="M000306"></a>
 
         <div class="method-heading">
-          <a href="#M000302" class="method-signature">
+          <a href="#M000306" class="method-signature">
           <span class="method-name">reader.expand &rarr; node<br />
 </span>
           </a>
@@ -847,15 +921,16 @@ ruby_xml_reader_encoding(VALUE self)
         <div class="method-description">
           <p>
 Read the contents of the current node and the full subtree. It then makes
-the subtree available until the next read call.
+the subtree available until the <a href="Reader.html#M000275">next</a> <a
+href="Reader.html#M000277">read</a> call.
 </p>
 <p>
 Return an <a href="Node.html">XML::Node</a> object, or nil in case of
 error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000302-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000302-source">
+            onclick="toggleCode('M000306-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000306-source">
 <pre>
 /*
  * call-seq:
@@ -894,11 +969,11 @@ ruby_xml_reader_expand(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000297" class="method-detail">
-        <a name="M000297"></a>
+      <div id="method-M000301" class="method-detail">
+        <a name="M000301"></a>
 
         <div class="method-heading">
-          <a href="#M000297" class="method-signature">
+          <a href="#M000301" class="method-signature">
           <span class="method-name">reader.has_attributes? &rarr; bool<br />
 </span>
           </a>
@@ -909,8 +984,8 @@ ruby_xml_reader_expand(VALUE self)
 Get whether the node has attributes.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000297-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000297-source">
+            onclick="toggleCode('M000301-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000301-source">
 <pre>
 /*
  * call-seq:
@@ -928,11 +1003,11 @@ ruby_xml_reader_has_attributes(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000299" class="method-detail">
-        <a name="M000299"></a>
+      <div id="method-M000303" class="method-detail">
+        <a name="M000303"></a>
 
         <div class="method-heading">
-          <a href="#M000299" class="method-signature">
+          <a href="#M000303" class="method-signature">
           <span class="method-name">reader.has_value? &rarr; bool<br />
 </span>
           </a>
@@ -940,11 +1015,12 @@ ruby_xml_reader_has_attributes(VALUE self)
       
         <div class="method-description">
           <p>
-Get whether the node can have a text value.
+Get whether the node can have a text <a
+href="Reader.html#M000304">value</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000299-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000299-source">
+            onclick="toggleCode('M000303-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000303-source">
 <pre>
 /*
  * call-seq:
@@ -962,11 +1038,11 @@ ruby_xml_reader_has_value(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000305" class="method-detail">
-        <a name="M000305"></a>
+      <div id="method-M000309" class="method-detail">
+        <a name="M000309"></a>
 
         <div class="method-heading">
-          <a href="#M000305" class="method-signature">
+          <a href="#M000309" class="method-signature">
           <span class="method-name">reader.line_number &rarr; number<br />
 </span>
           </a>
@@ -977,8 +1053,8 @@ ruby_xml_reader_has_value(VALUE self)
 Provide the line number of the current parsing point.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000305-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000305-source">
+            onclick="toggleCode('M000309-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000309-source">
 <pre>
 /*
  * call-seq:
@@ -996,11 +1072,11 @@ ruby_xml_reader_line_number(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000287" class="method-detail">
-        <a name="M000287"></a>
+      <div id="method-M000291" class="method-detail">
+        <a name="M000291"></a>
 
         <div class="method-heading">
-          <a href="#M000287" class="method-signature">
+          <a href="#M000291" class="method-signature">
           <span class="method-name">reader.local_name &rarr; name<br />
 </span>
           </a>
@@ -1008,11 +1084,11 @@ ruby_xml_reader_line_number(VALUE self)
       
         <div class="method-description">
           <p>
-Return the local name of the node.
+Return the local <a href="Reader.html#M000290">name</a> of the node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000287-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000287-source">
+            onclick="toggleCode('M000291-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000291-source">
 <pre>
 /* 
  * call-seq:
@@ -1030,11 +1106,11 @@ ruby_xml_reader_local_name(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000301" class="method-detail">
-        <a name="M000301"></a>
+      <div id="method-M000305" class="method-detail">
+        <a name="M000305"></a>
 
         <div class="method-heading">
-          <a href="#M000301" class="method-signature">
+          <a href="#M000305" class="method-signature">
           <span class="method-name">reader.lookup_namespace(prefix) &rarr; value<br />
 </span>
           </a>
@@ -1042,12 +1118,13 @@ ruby_xml_reader_local_name(VALUE self)
       
         <div class="method-description">
           <p>
-Resolve a namespace prefix in the scope of the current element. To return
-the default namespace, specify nil as <tt>prefix</tt>.
+Resolve a namespace <a href="Reader.html#M000297">prefix</a> in the scope
+of the current element. To return the default namespace, specify nil as
+<tt><a href="Reader.html#M000297">prefix</a></tt>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000301-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000301-source">
+            onclick="toggleCode('M000305-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000305-source">
 <pre>
 /*
  * call-seq:
@@ -1066,11 +1143,11 @@ ruby_xml_reader_lookup_namespace(VALUE self, VALUE prefix)
         </div>
       </div>
 
-      <div id="method-M000267" class="method-detail">
-        <a name="M000267"></a>
+      <div id="method-M000271" class="method-detail">
+        <a name="M000271"></a>
 
         <div class="method-heading">
-          <a href="#M000267" class="method-signature">
+          <a href="#M000271" class="method-signature">
           <span class="method-name">parser.move_to_attribute(val) &rarr; code<br />
 </span>
           </a>
@@ -1079,12 +1156,13 @@ ruby_xml_reader_lookup_namespace(VALUE self, VALUE prefix)
         <div class="method-description">
           <p>
 Move the position of the current instance to the attribute with the
-specified index (if <tt>val</tt> is an integer) or name (if <tt>val</tt> is
-a string) relative to the containing element.
+specified index (if <tt>val</tt> is an integer) or <a
+href="Reader.html#M000290">name</a> (if <tt>val</tt> is a string) relative
+to the containing element.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000267-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000267-source">
+            onclick="toggleCode('M000271-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000271-source">
 <pre>
 /*
  * call-seq:
@@ -1116,11 +1194,11 @@ ruby_xml_reader_move_to_attr(VALUE self, VALUE val)
         </div>
       </div>
 
-      <div id="method-M000270" class="method-detail">
-        <a name="M000270"></a>
+      <div id="method-M000274" class="method-detail">
+        <a name="M000274"></a>
 
         <div class="method-heading">
-          <a href="#M000270" class="method-signature">
+          <a href="#M000274" class="method-signature">
           <span class="method-name">reader.move_to_element &rarr; code<br />
 </span>
           </a>
@@ -1132,8 +1210,8 @@ Move the position of the current instance to the node that contains the
 current attribute node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000270-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000270-source">
+            onclick="toggleCode('M000274-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000274-source">
 <pre>
 /*
  * call-seq:
@@ -1152,11 +1230,11 @@ ruby_xml_reader_move_to_element(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000268" class="method-detail">
-        <a name="M000268"></a>
+      <div id="method-M000272" class="method-detail">
+        <a name="M000272"></a>
 
         <div class="method-heading">
-          <a href="#M000268" class="method-signature">
+          <a href="#M000272" class="method-signature">
           <span class="method-name">reader.move_to_first_attribute &rarr; code<br />
 </span>
           </a>
@@ -1168,8 +1246,8 @@ Move the position of the current instance to the first attribute associated
 with the current node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000268-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000268-source">
+            onclick="toggleCode('M000272-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000272-source">
 <pre>
 /*
  * call-seq:
@@ -1188,11 +1266,11 @@ ruby_xml_reader_move_to_first_attr(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000269" class="method-detail">
-        <a name="M000269"></a>
+      <div id="method-M000273" class="method-detail">
+        <a name="M000273"></a>
 
         <div class="method-heading">
-          <a href="#M000269" class="method-signature">
+          <a href="#M000273" class="method-signature">
           <span class="method-name">reader.move_to_next_attribute &rarr; code<br />
 </span>
           </a>
@@ -1200,12 +1278,13 @@ ruby_xml_reader_move_to_first_attr(VALUE self)
       
         <div class="method-description">
           <p>
-Move the position of the current instance to the next attribute associated
-with the current node.
+Move the position of the current instance to the <a
+href="Reader.html#M000275">next</a> attribute associated with the current
+node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000269-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000269-source">
+            onclick="toggleCode('M000273-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000273-source">
 <pre>
 /*
  * call-seq:
@@ -1224,11 +1303,11 @@ ruby_xml_reader_move_to_next_attr(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000286" class="method-detail">
-        <a name="M000286"></a>
+      <div id="method-M000290" class="method-detail">
+        <a name="M000290"></a>
 
         <div class="method-heading">
-          <a href="#M000286" class="method-signature">
+          <a href="#M000290" class="method-signature">
           <span class="method-name">reader.name &rarr; name<br />
 </span>
           </a>
@@ -1236,11 +1315,11 @@ ruby_xml_reader_move_to_next_attr(VALUE self)
       
         <div class="method-description">
           <p>
-Return the qualified name of the node.
+Return the qualified <a href="Reader.html#M000290">name</a> of the node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000286-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000286-source">
+            onclick="toggleCode('M000290-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000290-source">
 <pre>
 /* 
  * call-seq:
@@ -1258,11 +1337,11 @@ ruby_xml_reader_name(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000308" class="method-detail">
-        <a name="M000308"></a>
+      <div id="method-M000312" class="method-detail">
+        <a name="M000312"></a>
 
         <div class="method-heading">
-          <a href="#M000308" class="method-signature">
+          <a href="#M000312" class="method-signature">
           <span class="method-name">reader.namespace_declaration? &rarr; bool<br />
 </span>
           </a>
@@ -1274,8 +1353,8 @@ Determine whether the current node is a namespace declaration rather than a
 regular attribute.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000308-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000308-source">
+            onclick="toggleCode('M000312-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000312-source">
 <pre>
 /*
  * call-seq:
@@ -1294,11 +1373,11 @@ ruby_xml_reader_namespace_declaration(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000290" class="method-detail">
-        <a name="M000290"></a>
+      <div id="method-M000294" class="method-detail">
+        <a name="M000294"></a>
 
         <div class="method-heading">
-          <a href="#M000290" class="method-signature">
+          <a href="#M000294" class="method-signature">
           <span class="method-name">reader.namespace_uri &rarr; URI<br />
 </span>
           </a>
@@ -1309,8 +1388,8 @@ ruby_xml_reader_namespace_declaration(VALUE self)
 Determine the namespace URI of the node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000290-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000290-source">
+            onclick="toggleCode('M000294-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000294-source">
 <pre>
 /*
  * call-seq:
@@ -1328,11 +1407,11 @@ ruby_xml_reader_namespace_uri(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000271" class="method-detail">
-        <a name="M000271"></a>
+      <div id="method-M000275" class="method-detail">
+        <a name="M000275"></a>
 
         <div class="method-heading">
-          <a href="#M000271" class="method-signature">
+          <a href="#M000275" class="method-signature">
           <span class="method-name">reader.next &rarr; code<br />
 </span>
           </a>
@@ -1344,8 +1423,8 @@ Skip to the node following the current one in document order while avoiding
 the subtree if any.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000271-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000271-source">
+            onclick="toggleCode('M000275-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000275-source">
 <pre>
 /*
  * call-seq:
@@ -1364,11 +1443,11 @@ ruby_xml_reader_next(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000272" class="method-detail">
-        <a name="M000272"></a>
+      <div id="method-M000276" class="method-detail">
+        <a name="M000276"></a>
 
         <div class="method-heading">
-          <a href="#M000272" class="method-signature">
+          <a href="#M000276" class="method-signature">
           <span class="method-name">reader.next_sibling &rarr; code<br />
 </span>
           </a>
@@ -1381,8 +1460,8 @@ the subtree if any. Currently implemented only for Readers built on a
 document.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000272-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000272-source">
+            onclick="toggleCode('M000276-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000276-source">
 <pre>
 /*
  * call-seq:
@@ -1402,11 +1481,11 @@ ruby_xml_reader_next_sibling(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000283" class="method-detail">
-        <a name="M000283"></a>
+      <div id="method-M000287" class="method-detail">
+        <a name="M000287"></a>
 
         <div class="method-heading">
-          <a href="#M000283" class="method-signature">
+          <a href="#M000287" class="method-signature">
           <span class="method-name">reader.node_type &rarr; type<br />
 </span>
           </a>
@@ -1418,8 +1497,8 @@ Get the node type of the current node. Reference: <a
 href="http://dotgnu.org/pnetlib-doc/System/Xml/XmlNodeType.html">dotgnu.org/pnetlib-doc/System/Xml/XmlNodeType.html</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000283-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000283-source">
+            onclick="toggleCode('M000287-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000287-source">
 <pre>
 /*
  * call-seq:
@@ -1438,11 +1517,11 @@ ruby_xml_reader_node_type(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000284" class="method-detail">
-        <a name="M000284"></a>
+      <div id="method-M000288" class="method-detail">
+        <a name="M000288"></a>
 
         <div class="method-heading">
-          <a href="#M000284" class="method-signature">
+          <a href="#M000288" class="method-signature">
           <span class="method-name">reader.normalization &rarr; value<br />
 </span>
           </a>
@@ -1450,18 +1529,20 @@ ruby_xml_reader_node_type(VALUE self)
       
         <div class="method-description">
           <p>
-The value indicating whether to normalize white space and attribute values.
-Since attribute value and end of line normalizations are a MUST in the <a
-href="../XML.html">XML</a> specification only the value true is accepted.
-The broken bahaviour of accepting out of range character entities like
-&amp;0; is of course not supported either.
+The <a href="Reader.html#M000304">value</a> indicating whether to normalize
+white space and attribute values. Since attribute <a
+href="Reader.html#M000304">value</a> and end of line normalizations are a
+MUST in the <a href="../XML.html">XML</a> specification only the <a
+href="Reader.html#M000304">value</a> true is accepted. The broken bahaviour
+of accepting out of range character entities like &amp;0; is of course not
+supported either.
 </p>
 <p>
 Return 1 or -1 in case of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000284-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000284-source">
+            onclick="toggleCode('M000288-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000288-source">
 <pre>
 /*
  * call-seq:
@@ -1485,11 +1566,11 @@ ruby_xml_reader_normalization(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000293" class="method-detail">
-        <a name="M000293"></a>
+      <div id="method-M000297" class="method-detail">
+        <a name="M000297"></a>
 
         <div class="method-heading">
-          <a href="#M000293" class="method-signature">
+          <a href="#M000297" class="method-signature">
           <span class="method-name">reader.prefix &rarr; prefix<br />
 </span>
           </a>
@@ -1500,8 +1581,8 @@ ruby_xml_reader_normalization(VALUE self)
 Get a shorthand reference to the namespace associated with the node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000293-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000293-source">
+            onclick="toggleCode('M000297-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000297-source">
 <pre>
 /* 
  * call-seq:
@@ -1519,11 +1600,11 @@ ruby_xml_reader_prefix(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000295" class="method-detail">
-        <a name="M000295"></a>
+      <div id="method-M000299" class="method-detail">
+        <a name="M000299"></a>
 
         <div class="method-heading">
-          <a href="#M000295" class="method-signature">
+          <a href="#M000299" class="method-signature">
           <span class="method-name">reader.quote_char &rarr; char<br />
 </span>
           </a>
@@ -1531,12 +1612,13 @@ ruby_xml_reader_prefix(VALUE self)
       
         <div class="method-description">
           <p>
-Get the quotation mark character used to enclose the value of an attribute,
-as an integer value (and -1 in case of error).
+Get the quotation mark character used to enclose the <a
+href="Reader.html#M000304">value</a> of an attribute, as an integer <a
+href="Reader.html#M000304">value</a> (and -1 in case of error).
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000295-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000295-source">
+            onclick="toggleCode('M000299-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000299-source">
 <pre>
 /*
  * call-seq:
@@ -1555,11 +1637,11 @@ ruby_xml_reader_quote_char(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000273" class="method-detail">
-        <a name="M000273"></a>
+      <div id="method-M000277" class="method-detail">
+        <a name="M000277"></a>
 
         <div class="method-heading">
-          <a href="#M000273" class="method-signature">
+          <a href="#M000277" class="method-signature">
           <span class="method-name">reader.read &rarr; code<br />
 </span>
           </a>
@@ -1567,16 +1649,18 @@ ruby_xml_reader_quote_char(VALUE self)
       
         <div class="method-description">
           <p>
-Move the position of the current instance to the next node in the stream,
-exposing its properties.
+Move the position of the current instance to the <a
+href="Reader.html#M000275">next</a> node in the stream, exposing its
+properties.
 </p>
 <p>
-Return 1 if the node was read successfully, 0 if there is no more nodes to
-read, or -1 in case of error.
+Return 1 if the node was <a href="Reader.html#M000277">read</a>
+successfully, 0 if there is no more nodes to <a
+href="Reader.html#M000277">read</a>, or -1 in case of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000273-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000273-source">
+            onclick="toggleCode('M000277-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000277-source">
 <pre>
 /*
  * call-seq:
@@ -1598,11 +1682,11 @@ ruby_xml_reader_read(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000274" class="method-detail">
-        <a name="M000274"></a>
+      <div id="method-M000278" class="method-detail">
+        <a name="M000278"></a>
 
         <div class="method-heading">
-          <a href="#M000274" class="method-signature">
+          <a href="#M000278" class="method-signature">
           <span class="method-name">reader.read_attribute_value &rarr; code<br />
 </span>
           </a>
@@ -1610,16 +1694,17 @@ ruby_xml_reader_read(VALUE self)
       
         <div class="method-description">
           <p>
-Parse an attribute value into one or more Text and EntityReference nodes.
+Parse an attribute <a href="Reader.html#M000304">value</a> into one or more
+Text and EntityReference nodes.
 </p>
 <p>
 Return 1 in case of success, 0 if the reader was not positionned on an
-attribute node or all the attribute values have been read, or -1 in case of
-error.
+attribute node or all the attribute values have been <a
+href="Reader.html#M000277">read</a>, or -1 in case of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000274-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000274-source">
+            onclick="toggleCode('M000278-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000278-source">
 <pre>
 /*
  * call-seq:
@@ -1641,11 +1726,11 @@ ruby_xml_reader_read_attr_value(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000275" class="method-detail">
-        <a name="M000275"></a>
+      <div id="method-M000279" class="method-detail">
+        <a name="M000279"></a>
 
         <div class="method-heading">
-          <a href="#M000275" class="method-signature">
+          <a href="#M000279" class="method-signature">
           <span class="method-name">reader.read_inner_xml &rarr; data<br />
 </span>
           </a>
@@ -1661,8 +1746,8 @@ nil if the current node is neither an element nor attribute, or has no
 child nodes.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000275-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000275-source">
+            onclick="toggleCode('M000279-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000279-source">
 <pre>
 /*
  * call-seq:
@@ -1683,11 +1768,11 @@ ruby_xml_reader_read_inner_xml(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000276" class="method-detail">
-        <a name="M000276"></a>
+      <div id="method-M000280" class="method-detail">
+        <a name="M000280"></a>
 
         <div class="method-heading">
-          <a href="#M000276" class="method-signature">
+          <a href="#M000280" class="method-signature">
           <span class="method-name">reader.read_outer_xml &rarr; data<br />
 </span>
           </a>
@@ -1703,8 +1788,8 @@ nil if the current node is neither an element nor attribute, or has no
 child nodes.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000276-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000276-source">
+            onclick="toggleCode('M000280-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000280-source">
 <pre>
 /*
  * call-seq:
@@ -1725,11 +1810,11 @@ ruby_xml_reader_read_outer_xml(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000277" class="method-detail">
-        <a name="M000277"></a>
+      <div id="method-M000281" class="method-detail">
+        <a name="M000281"></a>
 
         <div class="method-heading">
-          <a href="#M000277" class="method-signature">
+          <a href="#M000281" class="method-signature">
           <span class="method-name">reader.read_state &rarr; state<br />
 </span>
           </a>
@@ -1737,11 +1822,11 @@ ruby_xml_reader_read_outer_xml(VALUE self)
       
         <div class="method-description">
           <p>
-Get the read state of the reader.
+Get the <a href="Reader.html#M000277">read</a> state of the reader.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000277-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000277-source">
+            onclick="toggleCode('M000281-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000281-source">
 <pre>
 /*
  * call-seq:
@@ -1759,11 +1844,11 @@ ruby_xml_reader_read_state(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000278" class="method-detail">
-        <a name="M000278"></a>
+      <div id="method-M000282" class="method-detail">
+        <a name="M000282"></a>
 
         <div class="method-heading">
-          <a href="#M000278" class="method-signature">
+          <a href="#M000282" class="method-signature">
           <span class="method-name">reader.read_string &rarr; string<br />
 </span>
           </a>
@@ -1778,8 +1863,8 @@ Return a string containing the contents of the Element or Text node, or nil
 if the reader is positioned on any other type of node.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000278-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000278-source">
+            onclick="toggleCode('M000282-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000282-source">
 <pre>
 /*
  * call-seq:
@@ -1800,11 +1885,11 @@ ruby_xml_reader_read_string(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000281" class="method-detail">
-        <a name="M000281"></a>
+      <div id="method-M000285" class="method-detail">
+        <a name="M000285"></a>
 
         <div class="method-heading">
-          <a href="#M000281" class="method-signature">
+          <a href="#M000285" class="method-signature">
           <span class="method-name">reader.relax_ng_validate(rng) &rarr; code<br />
 </span>
           </a>
@@ -1812,17 +1897,18 @@ ruby_xml_reader_read_string(VALUE self)
       
         <div class="method-description">
           <p>
-Use RelaxNG to validate the document as it is processed. Activation is only
-possible before the first read. If <tt>rng</tt> is nil, the RelaxNG
-validation is desactivated.
+Use <a href="RelaxNG.html">RelaxNG</a> to validate the document as it is
+processed. Activation is only possible before the first <a
+href="Reader.html#M000277">read</a>. If <tt>rng</tt> is nil, the <a
+href="RelaxNG.html">RelaxNG</a> validation is desactivated.
 </p>
 <p>
-Return 0 in case the RelaxNG validation could be (des)activated and -1 in
-case of error.
+Return 0 in case the <a href="RelaxNG.html">RelaxNG</a> validation could be
+(des)activated and -1 in case of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000281-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000281-source">
+            onclick="toggleCode('M000285-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000285-source">
 <pre>
 /*
  * call-seq:
@@ -1845,11 +1931,11 @@ ruby_xml_reader_relax_ng_validate(VALUE self, VALUE rng)
         </div>
       </div>
 
-      <div id="method-M000280" class="method-detail">
-        <a name="M000280"></a>
+      <div id="method-M000284" class="method-detail">
+        <a name="M000284"></a>
 
         <div class="method-heading">
-          <a href="#M000280" class="method-signature">
+          <a href="#M000284" class="method-signature">
           <span class="method-name">reader.reset_error_handler<br />
 </span>
           </a>
@@ -1860,8 +1946,8 @@ ruby_xml_reader_relax_ng_validate(VALUE self, VALUE rng)
 Restore the default error and warning handlers.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000280-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000280-source">
+            onclick="toggleCode('M000284-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000284-source">
 <pre>
 /*
  * call-seq:
@@ -1880,11 +1966,11 @@ ruby_xml_reader_reset_error_handler(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000282" class="method-detail">
-        <a name="M000282"></a>
+      <div id="method-M000286" class="method-detail">
+        <a name="M000286"></a>
 
         <div class="method-heading">
-          <a href="#M000282" class="method-signature">
+          <a href="#M000286" class="method-signature">
           <span class="method-name">reader.schema_validate(schema) &rarr; code<br />
 </span>
           </a>
@@ -1893,17 +1979,17 @@ ruby_xml_reader_reset_error_handler(VALUE self)
         <div class="method-description">
           <p>
 Use W3C XSD schema to validate the document as it is processed. Activation
-is only possible before the first read. If <tt>schema</tt> is nil, then <a
-href="../XML.html">XML</a> <a href="Schema.html">Schema</a> validation is
-desactivated.
+is only possible before the first <a href="Reader.html#M000277">read</a>.
+If <tt>schema</tt> is nil, then <a href="../XML.html">XML</a> <a
+href="Schema.html">Schema</a> validation is desactivated.
 </p>
 <p>
 Return 0 in case the schemas validation could be (de)activated and -1 in
 case of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000282-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000282-source">
+            onclick="toggleCode('M000286-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000286-source">
 <pre>
 /*
  * call-seq:
@@ -1926,11 +2012,11 @@ ruby_xml_reader_schema_validate(VALUE self, VALUE xsd)
         </div>
       </div>
 
-      <div id="method-M000279" class="method-detail">
-        <a name="M000279"></a>
+      <div id="method-M000283" class="method-detail">
+        <a name="M000283"></a>
 
         <div class="method-heading">
-          <a href="#M000279" class="method-signature">
+          <a href="#M000283" class="method-signature">
           <span class="method-name">reader.set_error_handler { ... }<br />
 </span>
           </a>
@@ -1943,8 +2029,8 @@ block will be called with 5 parameters: the reader, the error message, the
 severity, the base URI and the line number.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000279-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000279-source">
+            onclick="toggleCode('M000283-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000283-source">
 <pre>
 /*
  * call-seq:
@@ -1979,11 +2065,11 @@ ruby_xml_reader_set_error_handler(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000296" class="method-detail">
-        <a name="M000296"></a>
+      <div id="method-M000300" class="method-detail">
+        <a name="M000300"></a>
 
         <div class="method-heading">
-          <a href="#M000296" class="method-signature">
+          <a href="#M000300" class="method-signature">
           <span class="method-name">reader.standalone &rarr; code<br />
 </span>
           </a>
@@ -1991,16 +2077,19 @@ ruby_xml_reader_set_error_handler(VALUE self)
       
         <div class="method-description">
           <p>
-Determine the standalone status of the document being read.
+Determine the <a href="Reader.html#M000300">standalone</a> status of the
+document being <a href="Reader.html#M000277">read</a>.
 </p>
 <p>
-Return 1 if the document was declared to be standalone, 0 if it was
-declared to be not standalone, or -1 if the document did not specify its
-standalone status or in case of error.
+Return 1 if the document was declared to be <a
+href="Reader.html#M000300">standalone</a>, 0 if it was declared to be not
+<a href="Reader.html#M000300">standalone</a>, or -1 if the document did not
+specify its <a href="Reader.html#M000300">standalone</a> status or in case
+of error.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000296-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000296-source">
+            onclick="toggleCode('M000300-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000300-source">
 <pre>
 /*
  * call-seq:
@@ -2022,11 +2111,11 @@ ruby_xml_reader_standalone(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000309" class="method-detail">
-        <a name="M000309"></a>
+      <div id="method-M000313" class="method-detail">
+        <a name="M000313"></a>
 
         <div class="method-heading">
-          <a href="#M000309" class="method-signature">
+          <a href="#M000313" class="method-signature">
           <span class="method-name">reader.valid? &rarr; bool<br />
 </span>
           </a>
@@ -2037,8 +2126,8 @@ ruby_xml_reader_standalone(VALUE self)
 Retrieve the validity status from the parser context.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000309-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000309-source">
+            onclick="toggleCode('M000313-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000313-source">
 <pre>
 /*
  * call-seq:
@@ -2056,11 +2145,11 @@ ruby_xml_reader_valid(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000300" class="method-detail">
-        <a name="M000300"></a>
+      <div id="method-M000304" class="method-detail">
+        <a name="M000304"></a>
 
         <div class="method-heading">
-          <a href="#M000300" class="method-signature">
+          <a href="#M000304" class="method-signature">
           <span class="method-name">reader.value &rarr; text<br />
 </span>
           </a>
@@ -2068,11 +2157,12 @@ ruby_xml_reader_valid(VALUE self)
       
         <div class="method-description">
           <p>
-Provide the text value of the node if present.
+Provide the text <a href="Reader.html#M000304">value</a> of the node if
+present.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000300-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000300-source">
+            onclick="toggleCode('M000304-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000304-source">
 <pre>
 /*
  * call-seq:
@@ -2090,11 +2180,11 @@ ruby_xml_reader_value(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000291" class="method-detail">
-        <a name="M000291"></a>
+      <div id="method-M000295" class="method-detail">
+        <a name="M000295"></a>
 
         <div class="method-heading">
-          <a href="#M000291" class="method-signature">
+          <a href="#M000295" class="method-signature">
           <span class="method-name">reader.xml_lang &rarr; value<br />
 </span>
           </a>
@@ -2105,8 +2195,8 @@ ruby_xml_reader_value(VALUE self)
 Get the xml:lang scope within which the node resides.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000291-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000291-source">
+            onclick="toggleCode('M000295-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000295-source">
 <pre>
 /*
  * call-seq:
@@ -2124,11 +2214,11 @@ ruby_xml_reader_xml_lang(VALUE self)
         </div>
       </div>
 
-      <div id="method-M000292" class="method-detail">
-        <a name="M000292"></a>
+      <div id="method-M000296" class="method-detail">
+        <a name="M000296"></a>
 
         <div class="method-heading">
-          <a href="#M000292" class="method-signature">
+          <a href="#M000296" class="method-signature">
           <span class="method-name">reader.xml_version &rarr; version<br />
 </span>
           </a>
@@ -2137,11 +2227,11 @@ ruby_xml_reader_xml_lang(VALUE self)
         <div class="method-description">
           <p>
 Determine the <a href="../XML.html">XML</a> version of the document being
-read.
+<a href="Reader.html#M000277">read</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000292-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000292-source">
+            onclick="toggleCode('M000296-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000296-source">
 <pre>
 /*
  * call-seq: