RubyGems - sdl4r - Versions diffs - 0.9.5 → 0.9.6 - Mend

sdl4r 0.9.5 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

data/CHANGELOG +11 -2
data/Rakefile +1 -1
data/TODO +9 -1
data/doc/classes/SDL4R.html +42 -196
data/doc/classes/SDL4R/Parser.html +45 -107
data/doc/classes/SDL4R/SdlBinary.html +59 -119
data/doc/classes/SDL4R/SdlParseError.html +28 -50
data/doc/classes/SDL4R/SdlTimeSpan.html +257 -475
data/doc/classes/SDL4R/Tag.html +497 -828
data/doc/created.rid +1 -1
data/doc/files/CHANGELOG.html +46 -18
data/doc/files/LICENSE.html +51 -42
data/doc/files/README.html +42 -32
data/doc/files/lib/sdl4r/parser/reader_rb.html +21 -11
data/doc/files/lib/sdl4r/parser/time_span_with_zone_rb.html +21 -11
data/doc/files/lib/sdl4r/parser/token_rb.html +21 -11
data/doc/files/lib/sdl4r/parser/tokenizer_rb.html +21 -11
data/doc/files/lib/sdl4r/parser_rb.html +21 -14
data/doc/files/lib/sdl4r/sdl4r_rb.html +23 -18
data/doc/files/lib/sdl4r/sdl_binary_rb.html +21 -11
data/doc/files/lib/sdl4r/sdl_parse_error_rb.html +21 -11
data/doc/files/lib/sdl4r/sdl_time_span_rb.html +21 -11
data/doc/files/lib/sdl4r/tag_rb.html +23 -18
data/doc/files/lib/sdl4r_rb.html +21 -11
data/doc/fr_class_index.html +11 -14
data/doc/fr_file_index.html +11 -22
data/doc/fr_method_index.html +90 -175
data/doc/index.html +7 -4
data/doc/rdoc-style.css +119 -210
data/lib/sdl4r/tag.rb +23 -12
data/test/sdl4r/tag_test.rb +53 -0
metadata +9 -4

data/doc/classes/SDL4R/Tag.html CHANGED

@@ -1,8 +1,11 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>Class: SDL4R::Tag [RDoc: Simple Declarative Language for Ruby]</title>
+  <title>Class: SDL4R::Tag</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <meta http-equiv="Content-Script-Type" content="text/javascript" />
   <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
@@ -22,7 +25,7 @@
       return false;
     elemStyle = elem.style;
     if ( elemStyle.display != "block" ) {
       elemStyle.display = "block"
     } else {
@@ -31,10 +34,10 @@
     return true;
   }
   // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }<\/style>" )
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
   // ]]>
   </script>
@@ -42,6 +45,7 @@
 <body>
     <div id="classHeader">
         <table class="header-table">
         <tr class="top-aligned-row">
@@ -51,36 +55,27 @@
         <tr class="top-aligned-row">
             <td><strong>In:</strong></td>
             <td>
                 <a href="../../files/lib/sdl4r/tag_rb.html">
                 lib/sdl4r/tag.rb
                 </a>
         <br />
             </td>
         </tr>
         <tr class="top-aligned-row">
             <td><strong>Parent:</strong></td>
             <td>
                 Object
             </td>
         </tr>
         </table>
     </div>
   <!-- banner header -->
   <div id="bodyContent">
   <div id="contextContent">
     <div id="description">
@@ -97,7 +92,7 @@ children/values/attributes/etc in this class returns copies or
 implementations. It can be one or the other depending on the method. The
 implementations are designed to be correct and somewhat efficient, not too
 protect the <a href="Tag.html">Tag</a> internal state from ill-use of the
-returned values.
+returned <a href="Tag.html#M000033">values</a>.
 </p>
 <h2>Authors</h2>
 <p>
@@ -106,165 +101,111 @@ Daniel Leuck, Philippe Vosges
     </div>
-   </div>
+   </div>
     <div id="method-list">
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-        <a href="#M000041">&lt;&lt;</a>&nbsp;&nbsp;
-        <a href="#M000077">==</a>&nbsp;&nbsp;
-        <a href="#M000040">add_child</a>&nbsp;&nbsp;
-        <a href="#M000054">add_value</a>&nbsp;&nbsp;
-        <a href="#M000061">attribute</a>&nbsp;&nbsp;
-        <a href="#M000063">attributes</a>&nbsp;&nbsp;
-        <a href="#M000067">attributes=</a>&nbsp;&nbsp;
-        <a href="#M000049">child</a>&nbsp;&nbsp;
-        <a href="#M000046">child_count</a>&nbsp;&nbsp;
-        <a href="#M000047">children</a>&nbsp;&nbsp;
-        <a href="#M000075">children_to_string</a>&nbsp;&nbsp;
-        <a href="#M000048">children_values</a>&nbsp;&nbsp;
-        <a href="#M000065">clear_attributes</a>&nbsp;&nbsp;
-        <a href="#M000043">clear_children</a>&nbsp;&nbsp;
-        <a href="#M000057">clear_values</a>&nbsp;&nbsp;
-        <a href="#M000076">eql?</a>&nbsp;&nbsp;
-        <a href="#M000062">has_attribute?</a>&nbsp;&nbsp;
-        <a href="#M000050">has_child?</a>&nbsp;&nbsp;
-        <a href="#M000051">has_children?</a>&nbsp;&nbsp;
-        <a href="#M000055">has_value?</a>&nbsp;&nbsp;
-        <a href="#M000078">hash</a>&nbsp;&nbsp;
-        <a href="#M000068">name=</a>&nbsp;&nbsp;
-        <a href="#M000069">namespace=</a>&nbsp;&nbsp;
-        <a href="#M000038">new</a>&nbsp;&nbsp;
-        <a href="#M000039">new_child</a>&nbsp;&nbsp;
-        <a href="#M000070">read</a>&nbsp;&nbsp;
-        <a href="#M000071">read_from_io</a>&nbsp;&nbsp;
-        <a href="#M000064">remove_attribute</a>&nbsp;&nbsp;
-        <a href="#M000042">remove_child</a>&nbsp;&nbsp;
-        <a href="#M000056">remove_value</a>&nbsp;&nbsp;
-        <a href="#M000060">set_attribute</a>&nbsp;&nbsp;
-        <a href="#M000066">set_attributes</a>&nbsp;&nbsp;
-        <a href="#M000052">to_child_hash</a>&nbsp;&nbsp;
-        <a href="#M000053">to_child_string_hash</a>&nbsp;&nbsp;
-        <a href="#M000073">to_s</a>&nbsp;&nbsp;
-        <a href="#M000074">to_string</a>&nbsp;&nbsp;
-        <a href="#M000079">to_xml_string</a>&nbsp;&nbsp;
-        <a href="#M000045">value</a>&nbsp;&nbsp;
-        <a href="#M000044">value=</a>&nbsp;&nbsp;
-        <a href="#M000058">values</a>&nbsp;&nbsp;
-        <a href="#M000059">values=</a>&nbsp;&nbsp;
-        <a href="#M000072">write</a>&nbsp;&nbsp;
+      <a href="#M000016">&lt;&lt;</a>&nbsp;&nbsp;
+      <a href="#M000052">==</a>&nbsp;&nbsp;
+      <a href="#M000015">add_child</a>&nbsp;&nbsp;
+      <a href="#M000029">add_value</a>&nbsp;&nbsp;
+      <a href="#M000036">attribute</a>&nbsp;&nbsp;
+      <a href="#M000038">attributes</a>&nbsp;&nbsp;
+      <a href="#M000042">attributes=</a>&nbsp;&nbsp;
+      <a href="#M000024">child</a>&nbsp;&nbsp;
+      <a href="#M000021">child_count</a>&nbsp;&nbsp;
+      <a href="#M000022">children</a>&nbsp;&nbsp;
+      <a href="#M000050">children_to_string</a>&nbsp;&nbsp;
+      <a href="#M000023">children_values</a>&nbsp;&nbsp;
+      <a href="#M000040">clear_attributes</a>&nbsp;&nbsp;
+      <a href="#M000018">clear_children</a>&nbsp;&nbsp;
+      <a href="#M000032">clear_values</a>&nbsp;&nbsp;
+      <a href="#M000051">eql?</a>&nbsp;&nbsp;
+      <a href="#M000037">has_attribute?</a>&nbsp;&nbsp;
+      <a href="#M000025">has_child?</a>&nbsp;&nbsp;
+      <a href="#M000026">has_children?</a>&nbsp;&nbsp;
+      <a href="#M000030">has_value?</a>&nbsp;&nbsp;
+      <a href="#M000053">hash</a>&nbsp;&nbsp;
+      <a href="#M000043">name=</a>&nbsp;&nbsp;
+      <a href="#M000044">namespace=</a>&nbsp;&nbsp;
+      <a href="#M000013">new</a>&nbsp;&nbsp;
+      <a href="#M000014">new_child</a>&nbsp;&nbsp;
+      <a href="#M000045">read</a>&nbsp;&nbsp;
+      <a href="#M000046">read_from_io</a>&nbsp;&nbsp;
+      <a href="#M000039">remove_attribute</a>&nbsp;&nbsp;
+      <a href="#M000017">remove_child</a>&nbsp;&nbsp;
+      <a href="#M000031">remove_value</a>&nbsp;&nbsp;
+      <a href="#M000035">set_attribute</a>&nbsp;&nbsp;
+      <a href="#M000041">set_attributes</a>&nbsp;&nbsp;
+      <a href="#M000027">to_child_hash</a>&nbsp;&nbsp;
+      <a href="#M000028">to_child_string_hash</a>&nbsp;&nbsp;
+      <a href="#M000048">to_s</a>&nbsp;&nbsp;
+      <a href="#M000049">to_string</a>&nbsp;&nbsp;
+      <a href="#M000054">to_xml_string</a>&nbsp;&nbsp;
+      <a href="#M000020">value</a>&nbsp;&nbsp;
+      <a href="#M000019">value=</a>&nbsp;&nbsp;
+      <a href="#M000033">values</a>&nbsp;&nbsp;
+      <a href="#M000034">values=</a>&nbsp;&nbsp;
+      <a href="#M000047">write</a>&nbsp;&nbsp;
       </div>
     </div>
   </div>
     <!-- if includes -->
     <div id="section">
     <div id="attribute-list">
       <h3 class="section-bar">Attributes</h3>
       <div class="name-list">
         <table>
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">name</td>
           <td class="context-item-value">&nbsp;[R]&nbsp;</td>
           <td class="context-item-desc">
 the name of this <a href="Tag.html">Tag</a>
 </td>
         </tr>
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">namespace</td>
           <td class="context-item-value">&nbsp;[R]&nbsp;</td>
           <td class="context-item-desc">
 the namespace of this <a href="Tag.html">Tag</a> or an empty string when
 there is no namespace (i.e. default namespace).
 </td>
         </tr>
         </table>
       </div>
     </div>
     <!-- if method_list -->
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000038" class="method-detail">
-        <a name="M000038"></a>
+      <div id="method-M000013" class="method-detail">
+        <a name="M000013"></a>
         <div class="method-heading">
-          <a href="#M000038" class="method-signature">
+          <a href="#M000013" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(namespace, name = nil, &amp;block)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Creates an empty tag in the given namespace. If the <tt>namespace</tt> is
 nil it will be coerced to an empty String.
@@ -294,10 +235,9 @@ ArgumentError if the name is not a legal SDL identifier (see <a
 href="../SDL4R.html#M000005">SDL4R#validate_identifier</a>) or the
 namespace is non-blank and is not a legal SDL identifier.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000038-source">
+            onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000013-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 95</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">name</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -325,36 +265,30 @@ namespace is non-blank and is not a legal SDL identifier.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
+      <div id="method-M000016" class="method-detail">
+        <a name="M000016"></a>
         <div class="method-heading">
-          <a href="#M000041" class="method-signature">
+          <a href="#M000016" class="method-signature">
           <span class="method-name">&lt;&lt;</span><span class="method-args">(o)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Adds the given object as a child if it is a <tt>Tag</tt>, as an attribute
-if it is a Hash {key => value} (supports namespaces), or as a value
-otherwise. If it is an array, each of its elements is added to this <a
-href="Tag.html">Tag</a> via this operator. If any of its elements is itself
-an array, then an anonymous tag is created and the array is passed to it
-via this operator (see the examples below)
+Adds the given object as a <a href="Tag.html#M000024">child</a> if it is a
+<tt><a href="Tag.html">Tag</a></tt>, as an <a
+href="Tag.html#M000036">attribute</a> if it is a Hash {key =&gt; <a
+href="Tag.html#M000020">value</a>} (supports namespaces), or as a <a
+href="Tag.html#M000020">value</a> otherwise. If it is an array, each of its
+elements is added to this <a href="Tag.html">Tag</a> via this operator. If
+any of its elements is itself an array, then an anonymous tag is created
+and the array is passed to it via this operator (see the examples below)
 </p>
 <pre>
   tag &lt;&lt; Tag.new(&quot;child&quot;)
@@ -373,12 +307,11 @@ via this operator (see the examples below)
 Returns <tt>self</tt>.
 </p>
 <p>
-Use other accessors for a stricter and less &#8220;magical&#8221; behavior.
+Use other accessors for a stricter and less &quot;magical&quot; behavior.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000041-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000041-source">
+            onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000016-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 169</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">&lt;&lt;</span>(<span class="ruby-identifier">o</span>)
@@ -406,60 +339,48 @@ Use other accessors for a stricter and less &#8220;magical&#8221; behavior.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000077" class="method-detail">
-        <a name="M000077"></a>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
         <div class="method-heading">
           <span class="method-name">==</span><span class="method-args">(o)</span>
         </div>
         <div class="method-description">
           <p>
-Alias for <a href="Tag.html#M000076">eql?</a>
+Alias for eql?
 </p>
         </div>
       </div>
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
+      <div id="method-M000015" class="method-detail">
+        <a name="M000015"></a>
         <div class="method-heading">
-          <a href="#M000040" class="method-signature">
+          <a href="#M000015" class="method-signature">
           <span class="method-name">add_child</span><span class="method-args">(child)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Add a child to this <a href="Tag.html">Tag</a>.
+Add a <a href="Tag.html#M000024">child</a> to this <a
+href="Tag.html">Tag</a>.
 </p>
 <table>
-<tr><td valign="top"><tt>child</tt>:</td><td>The child to add
+<tr><td valign="top"><tt><a href="Tag.html#M000024">child</a></tt>:</td><td>The <a href="Tag.html#M000024">child</a> to add
 </td></tr>
 </table>
 <p>
-Returns the added child.
+Returns the added <a href="Tag.html#M000024">child</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000040-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000040-source">
+            onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000015-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 142</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_child</span>(<span class="ruby-identifier">child</span>)
@@ -468,43 +389,37 @@ Returns the added child.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
+      <div id="method-M000029" class="method-detail">
+        <a name="M000029"></a>
         <div class="method-heading">
-          <a href="#M000054" class="method-signature">
+          <a href="#M000029" class="method-signature">
           <span class="method-name">add_value</span><span class="method-args">(v)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Adds a value to this <a href="Tag.html">Tag</a>. See <a
+Adds a <a href="Tag.html#M000020">value</a> to this <a
+href="Tag.html">Tag</a>. See <a
 href="../SDL4R.html#M000004">SDL4R#coerce_or_fail</a> to know about the
 allowable types.
 </p>
 <table>
-<tr><td valign="top"><tt>v</tt>:</td><td>The value to add
+<tr><td valign="top"><tt>v</tt>:</td><td>The <a href="Tag.html#M000020">value</a> to add
 </td></tr>
 </table>
 <p>
-Raises an <tt>ArgumentError</tt> if the value is not a legal SDL type
+Raises an <tt>ArgumentError</tt> if the <a
+href="Tag.html#M000020">value</a> is not a legal SDL type
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000054-source">
+            onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000029-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 409</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_value</span>(<span class="ruby-identifier">v</span>)
@@ -513,38 +428,30 @@ Raises an <tt>ArgumentError</tt> if the value is not a legal SDL type
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000061" class="method-detail">
-        <a name="M000061"></a>
+      <div id="method-M000036" class="method-detail">
+        <a name="M000036"></a>
         <div class="method-heading">
-          <a href="#M000061" class="method-signature">
+          <a href="#M000036" class="method-signature">
           <span class="method-name">attribute</span><span class="method-args">(namespace, key = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   attribute(key)
   attribute(namespace, key)
 </pre>
 <p>
-Returns the attribute of the specified <tt>namespace</tt> of specified
-<tt>key</tt> or <tt>nil</tt> if not found.
+Returns the <a href="Tag.html#M000036">attribute</a> of the specified
+<tt>namespace</tt> of specified <tt>key</tt> or <tt>nil</tt> if not found.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000061-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000061-source">
+            onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000036-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 518</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">attribute</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">key</span> = <span class="ruby-keyword kw">nil</span>)
@@ -554,29 +461,22 @@ Returns the attribute of the specified <tt>namespace</tt> of specified
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
+      <div id="method-M000038" class="method-detail">
+        <a name="M000038"></a>
         <div class="method-heading">
-          <a href="#M000063" class="method-signature">
+          <a href="#M000038" class="method-signature">
           <span class="method-name">attributes</span><span class="method-args">(namespace = nil) {|namespace, key, value| ...}</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns a Hash of the attributes of the specified <tt>namespace</tt>
-(default is all) or enumerates them.
+Returns a Hash of the <a href="Tag.html#M000038">attributes</a> of the
+specified <tt>namespace</tt> (default is all) or enumerates them.
 </p>
 <pre>
   tag.attributes # =&gt; { &quot;length&quot; =&gt; 123, &quot;width&quot; = 25.4, &quot;orig:color&quot; =&gt; &quot;gray&quot; }
@@ -585,15 +485,16 @@ Returns a Hash of the attributes of the specified <tt>namespace</tt>
   end
 </pre>
 <p>
-<tt>namespace</tt>:: namespace of the returned attributes. If nil, all
-attributes are returned with qualified names (e.g.
-&#8220;meat:color&#8221;). If &#8220;&#8221;, attributes of the default
-namespace are returned.
+<tt>namespace</tt>:: namespace of the returned <a
+href="Tag.html#M000038">attributes</a>. If nil, all <a
+href="Tag.html#M000038">attributes</a> are returned with qualified names
+(e.g. &quot;meat:color&quot;). If &quot;&quot;, <a
+href="Tag.html#M000038">attributes</a> of the default namespace are
+returned.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000063-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000063-source">
+            onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000038-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 556</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">attributes</span>(<span class="ruby-identifier">namespace</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment cmt"># :yields: namespace, key, value</span>
@@ -618,37 +519,29 @@ namespace are returned.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000067" class="method-detail">
-        <a name="M000067"></a>
+      <div id="method-M000042" class="method-detail">
+        <a name="M000042"></a>
         <div class="method-heading">
-          <a href="#M000067" class="method-signature">
+          <a href="#M000042" class="method-signature">
           <span class="method-name">attributes=</span><span class="method-args">(attribute_hash)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Sets all the attributes of the default namespace for this <a
-href="Tag.html">Tag</a> in one operation.
+Sets all the <a href="Tag.html#M000038">attributes</a> of the default
+namespace for this <a href="Tag.html">Tag</a> in one operation.
 </p>
 <p>
-See <a href="Tag.html#M000066">set_attributes</a>
+See <a href="Tag.html#M000041">set_attributes</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000067-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000067-source">
+            onclick="toggleCode('M000042-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000042-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 660</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">attributes=</span>(<span class="ruby-identifier">attribute_hash</span>)
@@ -656,52 +549,45 @@ See <a href="Tag.html#M000066">set_attributes</a>
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
         <div class="method-heading">
-          <a href="#M000049" class="method-signature">
+          <a href="#M000024" class="method-signature">
           <span class="method-name">child</span><span class="method-args">(recursive = false, name = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   child
   child(name)
   child(recursive, name)
 </pre>
 <p>
-Get the first child with the given name, optionally using a recursive
-search.
+Get the first <a href="Tag.html#M000024">child</a> with the given name,
+optionally using a recursive search.
 </p>
 <table>
-<tr><td valign="top"><tt>name</tt>:</td><td>the name of the child <a href="Tag.html">Tag</a>. If <tt>nil</tt>, the
-first child is returned (<tt>nil</tt> if there are
+<tr><td valign="top"><tt>name</tt>:</td><td>the name of the <a href="Tag.html#M000024">child</a> <a
+href="Tag.html">Tag</a>. If <tt>nil</tt>, the first <a
+href="Tag.html#M000024">child</a> is returned (<tt>nil</tt> if there are
 </td></tr>
 </table>
 <p>
-no children at all).
+no <a href="Tag.html#M000022">children</a> at all).
 </p>
 <p>
-Returns the first child tag having the given name or <tt>nil</tt> if no
-such child exists
+Returns the first <a href="Tag.html#M000024">child</a> tag having the given
+name or <tt>nil</tt> if no such <a href="Tag.html#M000024">child</a> exists
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000049-source">
+            onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000024-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 313</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">child</span>(<span class="ruby-identifier">recursive</span> = <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">name</span> = <span class="ruby-keyword kw">nil</span>)
@@ -718,33 +604,26 @@ such child exists
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
+      <div id="method-M000021" class="method-detail">
+        <a name="M000021"></a>
         <div class="method-heading">
-          <a href="#M000046" class="method-signature">
+          <a href="#M000021" class="method-signature">
           <span class="method-name">child_count</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns the number of children <a href="Tag.html">Tag</a>.
+Returns the number of <a href="Tag.html#M000022">children</a> <a
+href="Tag.html">Tag</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000046-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000046-source">
+            onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000021-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 234</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">child_count</span>
@@ -752,26 +631,19 @@ Returns the number of children <a href="Tag.html">Tag</a>.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000022" class="method-detail">
+        <a name="M000022"></a>
         <div class="method-heading">
-          <a href="#M000047" class="method-signature">
+          <a href="#M000022" class="method-signature">
           <span class="method-name">children</span><span class="method-args">(recursive = false, namespace = nil, name = :DEFAULT) {|child| ...}</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   children(recursive)
   children(recursive, name)
@@ -782,18 +654,19 @@ Returns the number of children <a href="Tag.html">Tag</a>.
   children(recursive, namespace, name) { |child| ... }
 </pre>
 <p>
-Returns an Array of the children Tags of this <a href="Tag.html">Tag</a> or
-enumerates them.
+Returns an Array of the <a href="Tag.html#M000022">children</a> Tags of
+this <a href="Tag.html">Tag</a> or enumerates them.
 </p>
 <table>
-<tr><td valign="top"><tt>recursive</tt>:</td><td>if true children and all descendants will be returned. False by default.
+<tr><td valign="top"><tt>recursive</tt>:</td><td>if true <a href="Tag.html#M000022">children</a> and all descendants will be
+returned. False by default.
 </td></tr>
-<tr><td valign="top"><tt>name</tt>:</td><td>if not nil, only children having this name will be returned. Nil by
-default.
+<tr><td valign="top"><tt>name</tt>:</td><td>if not nil, only <a href="Tag.html#M000022">children</a> having this name
+will be returned. Nil by default.
 </td></tr>
-<tr><td valign="top"><tt>namespace</tt>:</td><td>use nil for all namespaces and &#8220;&#8221; for the default one. Nil by
+<tr><td valign="top"><tt>namespace</tt>:</td><td>use nil for all namespaces and &quot;&quot; for the default one. Nil by
 default.
 </td></tr>
@@ -805,10 +678,9 @@ default.
   tag.children(false, &quot;name&quot;) # =&gt; children of name &quot;name&quot;
   tag.children(false, &quot;ns&quot;, nil) # =&gt; children of namespace &quot;ns&quot;
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000047-source">
+            onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000022-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 258</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">children</span>(<span class="ruby-identifier">recursive</span> = <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">namespace</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">name</span> = <span class="ruby-identifier">:DEFAULT</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment cmt"># :yields: child</span>
@@ -836,28 +708,22 @@ default.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
         <div class="method-heading">
-          <a href="#M000075" class="method-signature">
+          <a href="#M000050" class="method-signature">
           <span class="method-name">children_to_string</span><span class="method-args">(line_prefix = &quot;&quot;, s = &quot;&quot;)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns a string representation of the children tags.
+Returns a string representation of the <a
+href="Tag.html#M000022">children</a> tags.
 </p>
 <table>
 <tr><td valign="top"><tt>linePrefix</tt>:</td><td>A prefix to insert before every line.
@@ -870,12 +736,11 @@ Returns a string representation of the children tags.
 <p>
 TODO: break up long lines using the backslash
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000075-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000075-source">
+            onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000050-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 822</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 833</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">children_to_string</span>(<span class="ruby-identifier">line_prefix</span> = <span class="ruby-value str">&quot;&quot;</span>, <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>)
       <span class="ruby-ivar">@children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span>
         <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">to_string</span>(<span class="ruby-identifier">line_prefix</span>) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">$/</span>
@@ -885,41 +750,38 @@ TODO: break up long lines using the backslash
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
         <div class="method-heading">
-          <a href="#M000048" class="method-signature">
+          <a href="#M000023" class="method-signature">
           <span class="method-name">children_values</span><span class="method-args">(name = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns the values of all the children with the given <tt>name</tt>. If the
-child has more than one value, all the values will be added as an array. If
-the child has no value, <tt>nil</tt> will be added. The search is not
-recursive.
+Returns the <a href="Tag.html#M000033">values</a> of all the <a
+href="Tag.html#M000022">children</a> with the given <tt>name</tt>. If the
+<a href="Tag.html#M000024">child</a> has more than one <a
+href="Tag.html#M000020">value</a>, all the <a
+href="Tag.html#M000033">values</a> will be added as an array. If the <a
+href="Tag.html#M000024">child</a> has no <a
+href="Tag.html#M000020">value</a>, <tt>nil</tt> will be added. The search
+is not recursive.
 </p>
 <table>
-<tr><td valign="top"><tt>name</tt>:</td><td>if nil, all children are considered (nil by default).
+<tr><td valign="top"><tt>name</tt>:</td><td>if nil, all <a href="Tag.html#M000022">children</a> are considered (nil by
+default).
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000048-source">
+            onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000023-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 287</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">children_values</span>(<span class="ruby-identifier">name</span> = <span class="ruby-keyword kw">nil</span>)
@@ -938,34 +800,27 @@ recursive.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000065" class="method-detail">
-        <a name="M000065"></a>
+      <div id="method-M000040" class="method-detail">
+        <a name="M000040"></a>
         <div class="method-heading">
-          <a href="#M000065" class="method-signature">
+          <a href="#M000040" class="method-signature">
           <span class="method-name">clear_attributes</span><span class="method-args">(namespace = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Clears the attributes of the specified namespace or all the attributes if
+Clears the <a href="Tag.html#M000038">attributes</a> of the specified
+namespace or all the <a href="Tag.html#M000038">attributes</a> if
 <tt>namespace</tt> is <tt>nil</tt>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000065-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000065-source">
+            onclick="toggleCode('M000040-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000040-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 596</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_attributes</span>(<span class="ruby-identifier">namespace</span> = <span class="ruby-keyword kw">nil</span>)
@@ -977,33 +832,25 @@ Clears the attributes of the specified namespace or all the attributes if
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000043" class="method-detail">
-        <a name="M000043"></a>
+      <div id="method-M000018" class="method-detail">
+        <a name="M000018"></a>
         <div class="method-heading">
-          <a href="#M000043" class="method-signature">
+          <a href="#M000018" class="method-signature">
           <span class="method-name">clear_children</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Removes all children.
+Removes all <a href="Tag.html#M000022">children</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000043-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000043-source">
+            onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000018-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 205</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_children</span>
@@ -1012,33 +859,25 @@ Removes all children.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
+      <div id="method-M000032" class="method-detail">
+        <a name="M000032"></a>
         <div class="method-heading">
-          <a href="#M000057" class="method-signature">
+          <a href="#M000032" class="method-signature">
           <span class="method-name">clear_values</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Removes all values.
+Removes all <a href="Tag.html#M000033">values</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000057-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000057-source">
+            onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000032-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 437</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_values</span>
@@ -1047,84 +886,71 @@ Removes all values.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
         <div class="method-heading">
-          <a href="#M000076" class="method-signature">
+          <a href="#M000051" class="method-signature">
           <span class="method-name">eql?</span><span class="method-args">(o)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns true if this tag (including all of its values, attributes, and
-children) is equivalent to the given tag.
+Returns true if this tag (including all of its <a
+href="Tag.html#M000033">values</a>, <a
+href="Tag.html#M000038">attributes</a>, and <a
+href="Tag.html#M000022">children</a>) is equivalent to the given tag.
 </p>
 <p>
 Returns true if the tags are equivalet
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000076-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000076-source">
+            onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000051-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 835</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 846</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">eql?</span>(<span class="ruby-identifier">o</span>)
       <span class="ruby-comment cmt"># this is safe because to_string() dumps the full state</span>
       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Tag</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">to_string</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">to_string</span>;
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000062" class="method-detail">
-        <a name="M000062"></a>
+      <div id="method-M000037" class="method-detail">
+        <a name="M000037"></a>
         <div class="method-heading">
-          <a href="#M000062" class="method-signature">
+          <a href="#M000037" class="method-signature">
           <span class="method-name">has_attribute?</span><span class="method-args">(namespace = nil, key = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Indicates whether there is at least an attribute in this <a
-href="Tag.html">Tag</a>.
+Indicates whether there is at least an <a
+href="Tag.html#M000036">attribute</a> in this <a href="Tag.html">Tag</a>.
 </p>
 <pre>
   has_attribute?
 </pre>
 <p>
-Indicates whether there is the specified attribute exists in this <a
+Indicates whether there is the specified <a
+href="Tag.html#M000036">attribute</a> exists in this <a
 href="Tag.html">Tag</a>.
 </p>
 <pre>
   has_attribute?(key)
   has_attribute?(namespace, key)
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000062-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000062-source">
+            onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000037-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 531</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_attribute?</span>(<span class="ruby-identifier">namespace</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">key</span> = <span class="ruby-keyword kw">nil</span>)
@@ -1141,39 +967,32 @@ href="Tag.html">Tag</a>.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000025" class="method-detail">
+        <a name="M000025"></a>
         <div class="method-heading">
-          <a href="#M000050" class="method-signature">
+          <a href="#M000025" class="method-signature">
           <span class="method-name">has_child?</span><span class="method-args">(name)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Indicates whether the child <a href="Tag.html">Tag</a> of given name
-exists.
+Indicates whether the <a href="Tag.html#M000024">child</a> <a
+href="Tag.html">Tag</a> of given name exists.
 </p>
 <table>
-<tr><td valign="top"><tt>name</tt>:</td><td>name of the searched child <a href="Tag.html">Tag</a>
+<tr><td valign="top"><tt>name</tt>:</td><td>name of the searched <a href="Tag.html#M000024">child</a> <a
+href="Tag.html">Tag</a>
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000050-source">
+            onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000025-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 330</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_child?</span>(<span class="ruby-identifier">name</span>)
@@ -1181,33 +1000,26 @@ exists.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
         <div class="method-heading">
-          <a href="#M000051" class="method-signature">
+          <a href="#M000026" class="method-signature">
           <span class="method-name">has_children?</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Indicates whether there are children <a href="Tag.html">Tag</a>.
+Indicates whether there are <a href="Tag.html#M000022">children</a> <a
+href="Tag.html">Tag</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000051-source">
+            onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000026-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 336</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_children?</span>
@@ -1215,33 +1027,26 @@ Indicates whether there are children <a href="Tag.html">Tag</a>.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
+      <div id="method-M000030" class="method-detail">
+        <a name="M000030"></a>
         <div class="method-heading">
-          <a href="#M000055" class="method-signature">
+          <a href="#M000030" class="method-signature">
           <span class="method-name">has_value?</span><span class="method-args">(v)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns true if <tt>v</tt> is a value of this Tag&#8217;s.
+Returns true if <tt>v</tt> is a <a href="Tag.html#M000020">value</a> of
+this <a href="Tag.html">Tag</a>&#8216;s.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000055-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000055-source">
+            onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000030-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 416</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_value?</span>(<span class="ruby-identifier">v</span>)
@@ -1249,60 +1054,46 @@ Returns true if <tt>v</tt> is a value of this Tag&#8217;s.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
         <div class="method-heading">
-          <a href="#M000078" class="method-signature">
+          <a href="#M000053" class="method-signature">
           <span class="method-name">hash</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns The hash (based on the output from toString())
+Returns The <a href="Tag.html#M000053">hash</a> (based on the output from
+toString())
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000078-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000078-source">
+            onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000053-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 843</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 854</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">hash</span>
       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_string</span>.<span class="ruby-identifier">hash</span>
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000068" class="method-detail">
-        <a name="M000068"></a>
+      <div id="method-M000043" class="method-detail">
+        <a name="M000043"></a>
         <div class="method-heading">
-          <a href="#M000068" class="method-signature">
+          <a href="#M000043" class="method-signature">
           <span class="method-name">name=</span><span class="method-args">(a_name)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Sets the name of this <a href="Tag.html">Tag</a>.
 </p>
@@ -1312,10 +1103,9 @@ Raises <tt>ArgumentError</tt> if the name is not a legal SDL
 <pre>
     identifier (see SDL4R#validate_identifier)
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000068-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000068-source">
+            onclick="toggleCode('M000043-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000043-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 669</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">name=</span>(<span class="ruby-identifier">a_name</span>)
@@ -1325,26 +1115,19 @@ Raises <tt>ArgumentError</tt> if the name is not a legal SDL
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000069" class="method-detail">
-        <a name="M000069"></a>
+      <div id="method-M000044" class="method-detail">
+        <a name="M000044"></a>
         <div class="method-heading">
-          <a href="#M000069" class="method-signature">
+          <a href="#M000044" class="method-signature">
           <span class="method-name">namespace=</span><span class="method-args">(a_namespace)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 The namespace to set. <tt>nil</tt> will be coerced to the empty string.
 </p>
@@ -1354,10 +1137,9 @@ Raises <tt>ArgumentError</tt> if the namespace is non-blank and is not
 <pre>
     a legal SDL identifier (see {@link SDL4R#validate_identifier(String)})
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000069-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000069-source">
+            onclick="toggleCode('M000044-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000044-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 680</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">namespace=</span>(<span class="ruby-identifier">a_namespace</span>)
@@ -1367,29 +1149,23 @@ Raises <tt>ArgumentError</tt> if the namespace is non-blank and is not
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
+      <div id="method-M000014" class="method-detail">
+        <a name="M000014"></a>
         <div class="method-heading">
-          <a href="#M000039" class="method-signature">
+          <a href="#M000014" class="method-signature">
           <span class="method-name">new_child</span><span class="method-args">(*args, &amp;block)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Creates a new child tag. Can take a block so that you can write something
-like:
+Creates a <a href="Tag.html#M000013">new</a> <a
+href="Tag.html#M000024">child</a> tag. Can take a block so that you can <a
+href="Tag.html#M000047">write</a> something like:
 </p>
 <pre>
   car = Tag.new(&quot;car&quot;) do
@@ -1399,15 +1175,16 @@ like:
   end
 </pre>
 <p>
-The context of execution of the given block is the child instance
+The context of execution of the given block is the <a
+href="Tag.html#M000024">child</a> instance
 </p>
 <p>
-Returns the created child <a href="Tag.html">Tag</a>.
+Returns the created <a href="Tag.html#M000024">child</a> <a
+href="Tag.html">Tag</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000039-source">
+            onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000014-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 132</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">new_child</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1415,38 +1192,31 @@ Returns the created child <a href="Tag.html">Tag</a>.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000070" class="method-detail">
-        <a name="M000070"></a>
+      <div id="method-M000045" class="method-detail">
+        <a name="M000045"></a>
         <div class="method-heading">
-          <a href="#M000070" class="method-signature">
+          <a href="#M000045" class="method-signature">
           <span class="method-name">read</span><span class="method-args">(input)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Adds all the tags specified in the given IO, String, Pathname or URI to
 this <a href="Tag.html">Tag</a>.
 </p>
 <p>
-Returns this <a href="Tag.html">Tag</a> after adding all the children read
+Returns this <a href="Tag.html">Tag</a> after adding all the <a
+href="Tag.html#M000022">children</a> <a href="Tag.html#M000045">read</a>
 from <tt>input</tt>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000070-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000070-source">
+            onclick="toggleCode('M000045-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000045-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 690</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">input</span>)
@@ -1467,34 +1237,26 @@ from <tt>input</tt>.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000071" class="method-detail">
-        <a name="M000071"></a>
+      <div id="method-M000046" class="method-detail">
+        <a name="M000046"></a>
         <div class="method-heading">
-          <a href="#M000071" class="method-signature">
+          <a href="#M000046" class="method-signature">
           <span class="method-name">read_from_io</span><span class="method-args">(close_io) {|| ...}</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Reads and parses the <tt>io</tt> returned by the specified block and closes
 this <tt>io</tt> if <tt>close_io</tt> is true.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000071-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000071-source">
+            onclick="toggleCode('M000046-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000046-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 709</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_from_io</span>(<span class="ruby-identifier">close_io</span>)
@@ -1513,50 +1275,44 @@ this <tt>io</tt> if <tt>close_io</tt> is true.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000064" class="method-detail">
-        <a name="M000064"></a>
+      <div id="method-M000039" class="method-detail">
+        <a name="M000039"></a>
         <div class="method-heading">
-          <a href="#M000064" class="method-signature">
+          <a href="#M000039" class="method-signature">
           <span class="method-name">remove_attribute</span><span class="method-args">(namespace, key = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   remove_attribute(key)
   remove_attribute(namespace, key)
 </pre>
 <p>
-Removes the attribute, whose name and namespace are specified.
+Removes the <a href="Tag.html#M000036">attribute</a>, whose name and
+namespace are specified.
 </p>
 <table>
 <tr><td valign="top"><tt>key</tt>:</td><td>name of the removed atribute
 </td></tr>
-<tr><td valign="top"><tt>namespace</tt>:</td><td>namespace of the removed attribute (equal to &#8220;&#8221;, default
-namespace, by default)
+<tr><td valign="top"><tt>namespace</tt>:</td><td>namespace of the removed <a href="Tag.html#M000036">attribute</a> (equal to
+&quot;&quot;, default namespace, by default)
 </td></tr>
 </table>
 <p>
-Returns the value of the removed attribute or <tt>nil</tt> if it
-didn&#8217;t exist.
+Returns the <a href="Tag.html#M000020">value</a> of the removed <a
+href="Tag.html#M000036">attribute</a> or <tt>nil</tt> if it didn&#8216;t
+exist.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000064-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000064-source">
+            onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000039-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 587</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_attribute</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">key</span> = <span class="ruby-keyword kw">nil</span>)
@@ -1566,41 +1322,35 @@ didn&#8217;t exist.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
+      <div id="method-M000017" class="method-detail">
+        <a name="M000017"></a>
         <div class="method-heading">
-          <a href="#M000042" class="method-signature">
+          <a href="#M000017" class="method-signature">
           <span class="method-name">remove_child</span><span class="method-args">(child)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Remove a child from this <a href="Tag.html">Tag</a>
+Remove a <a href="Tag.html#M000024">child</a> from this <a
+href="Tag.html">Tag</a>
 </p>
 <table>
-<tr><td valign="top"><tt>child</tt>:</td><td>the child to remove
+<tr><td valign="top"><tt><a href="Tag.html#M000024">child</a></tt>:</td><td>the <a href="Tag.html#M000024">child</a> to remove
 </td></tr>
 </table>
 <p>
-Returns true if the child exists and is removed
+Returns true if the <a href="Tag.html#M000024">child</a> exists and is
+removed
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000042-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000042-source">
+            onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000017-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 199</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_child</span>(<span class="ruby-identifier">child</span>)
@@ -1608,42 +1358,35 @@ Returns true if the child exists and is removed
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
+      <div id="method-M000031" class="method-detail">
+        <a name="M000031"></a>
         <div class="method-heading">
-          <a href="#M000056" class="method-signature">
+          <a href="#M000031" class="method-signature">
           <span class="method-name">remove_value</span><span class="method-args">(v)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Removes the first occurence of the specified value from this <a
-href="Tag.html">Tag</a>.
+Removes the first occurence of the specified <a
+href="Tag.html#M000020">value</a> from this <a href="Tag.html">Tag</a>.
 </p>
 <table>
-<tr><td valign="top"><tt>v</tt>:</td><td>The value to remove
+<tr><td valign="top"><tt>v</tt>:</td><td>The <a href="Tag.html#M000020">value</a> to remove
 </td></tr>
 </table>
 <p>
-Returns true If the value exists and is removed
+Returns true If the <a href="Tag.html#M000020">value</a> exists and is
+removed
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000056-source">
+            onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000031-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 426</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_value</span>(<span class="ruby-identifier">v</span>)
@@ -1656,43 +1399,38 @@ Returns true If the value exists and is removed
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
+      <div id="method-M000035" class="method-detail">
+        <a name="M000035"></a>
         <div class="method-heading">
-          <a href="#M000060" class="method-signature">
-          <span class="method-name">set_attribute</span><span class="method-args">(namespace, key, value = nil)</span>
+          <a href="#M000035" class="method-signature">
+          <span class="method-name">set_attribute</span><span class="method-args">(namespace, key, value = :default)</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   set_attribute(key, value)
   set_attribute(namespace, key, value)
 </pre>
 <p>
-Set an attribute in the given namespace for this tag. The allowable
-attribute value types are the same as those allowed for {@link
-addValue(Object)}
+Set an <a href="Tag.html#M000036">attribute</a> in the given namespace for
+this tag. The allowable <a href="Tag.html#M000036">attribute</a> <a
+href="Tag.html#M000020">value</a> types are the same as those allowed for
+{@link addValue(Object)}
 </p>
 <table>
-<tr><td valign="top"><tt>namespace</tt>:</td><td>The namespace for this attribute
+<tr><td valign="top"><tt>namespace</tt>:</td><td>The namespace for this <a href="Tag.html#M000036">attribute</a>
 </td></tr>
-<tr><td valign="top"><tt>key</tt>:</td><td>The attribute key
+<tr><td valign="top"><tt>key</tt>:</td><td>The <a href="Tag.html#M000036">attribute</a> key
 </td></tr>
-<tr><td valign="top"><tt>value</tt>:</td><td>The attribute value
+<tr><td valign="top"><tt><a href="Tag.html#M000020">value</a></tt>:</td><td>The <a href="Tag.html#M000036">attribute</a> <a
+href="Tag.html#M000020">value</a>
 </td></tr>
 </table>
@@ -1704,14 +1442,13 @@ addValue(Object)}
     namespace is non-blank and is not a legal SDL identifier, or the
     value is not a legal SDL type
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000060-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000060-source">
+            onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000035-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 488</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_attribute</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span> = <span class="ruby-keyword kw">nil</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">nil?</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_attribute</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span> = <span class="ruby-identifier">:default</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">:default</span>
         <span class="ruby-identifier">value</span> = <span class="ruby-identifier">key</span>
         <span class="ruby-identifier">key</span> = <span class="ruby-identifier">namespace</span>
         <span class="ruby-identifier">namespace</span> = <span class="ruby-value str">&quot;&quot;</span>
@@ -1735,41 +1472,36 @@ addValue(Object)}
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000066" class="method-detail">
-        <a name="M000066"></a>
+      <div id="method-M000041" class="method-detail">
+        <a name="M000041"></a>
         <div class="method-heading">
-          <a href="#M000066" class="method-signature">
+          <a href="#M000041" class="method-signature">
           <span class="method-name">set_attributes</span><span class="method-args">(namespace, attribute_hash = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <pre>
   set_attributes(attribute_hash)
   set_attributes(namespace, attribute_hash)
 </pre>
 <p>
-Sets the attributes specified by a Hash in the given <tt>namespace</tt> in
-one operation. The previous attributes of the specified <tt>namespace</tt>
-are removed. See <a href="Tag.html#M000060">set_attribute</a> for allowable
-attribute value types.
+Sets the <a href="Tag.html#M000038">attributes</a> specified by a Hash in
+the given <tt>namespace</tt> in one operation. The previous <a
+href="Tag.html#M000038">attributes</a> of the specified <tt>namespace</tt>
+are removed. See <a href="Tag.html#M000035">set_attribute</a> for allowable
+<a href="Tag.html#M000036">attribute</a> <a
+href="Tag.html#M000020">value</a> types.
 </p>
 <table>
-<tr><td valign="top"><tt>attributes</tt>:</td><td>a Hash where keys are attribute keys
+<tr><td valign="top"><tt><a href="Tag.html#M000038">attributes</a></tt>:</td><td>a Hash where keys are <a href="Tag.html#M000036">attribute</a> keys
 </td></tr>
-<tr><td valign="top"><tt>namespace</tt>:</td><td>&#8220;&#8221; (default namespace) by default
+<tr><td valign="top"><tt>namespace</tt>:</td><td>&quot;&quot; (default namespace) by default
 </td></tr>
 </table>
@@ -1780,10 +1512,9 @@ Raises an <tt>ArgumentError</tt> if any key in the map is not a legal SDL
     identifier (see SDL4R#validate_identifier), or any value
     is not a legal SDL type.
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000066-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000066-source">
+            onclick="toggleCode('M000041-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000041-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 637</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_attributes</span>(<span class="ruby-identifier">namespace</span>, <span class="ruby-identifier">attribute_hash</span> = <span class="ruby-keyword kw">nil</span>)
@@ -1805,29 +1536,24 @@ Raises an <tt>ArgumentError</tt> if any key in the map is not a legal SDL
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
         <div class="method-heading">
-          <a href="#M000052" class="method-signature">
+          <a href="#M000027" class="method-signature">
           <span class="method-name">to_child_hash</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns a new Hash where the children&#8217;s names as keys and their
-values as the key&#8217;s value. Example:
+Returns a <a href="Tag.html#M000013">new</a> Hash where the <a
+href="Tag.html#M000022">children</a>&#8216;s names as keys and their <a
+href="Tag.html#M000033">values</a> as the key&#8216;s <a
+href="Tag.html#M000020">value</a>. Example:
 </p>
 <pre>
   child1 &quot;toto&quot;
@@ -1839,10 +1565,9 @@ would give
 <pre>
   { &quot;child1&quot; =&gt; &quot;toto&quot;, &quot;child2&quot; =&gt; 2 }
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000052-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000052-source">
+            onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000027-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 375</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_child_hash</span>
@@ -1852,30 +1577,26 @@ would give
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
         <div class="method-heading">
-          <a href="#M000053" class="method-signature">
+          <a href="#M000028" class="method-signature">
           <span class="method-name">to_child_string_hash</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns a new Hash where the children&#8217;s names as keys and their
-values as the key&#8217;s value. Values are converted to Strings.
-<tt>nil</tt> values become empty Strings. Example:
+Returns a <a href="Tag.html#M000013">new</a> Hash where the <a
+href="Tag.html#M000022">children</a>&#8216;s names as keys and their <a
+href="Tag.html#M000033">values</a> as the key&#8216;s <a
+href="Tag.html#M000020">value</a>. Values are converted to Strings.
+<tt>nil</tt> <a href="Tag.html#M000033">values</a> become empty Strings.
+Example:
 </p>
 <pre>
   child1 &quot;toto&quot;
@@ -1888,10 +1609,9 @@ would give
 <pre>
   { &quot;child1&quot; =&gt; &quot;toto&quot;, &quot;child2&quot; =&gt; &quot;2&quot;, &quot;child3&quot; =&gt; &quot;&quot; }
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000053-source">
+            onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000028-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 393</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_child_string_hash</span>
@@ -1905,65 +1625,51 @@ would give
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000073" class="method-detail">
-        <a name="M000073"></a>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
         <div class="method-heading">
-          <a href="#M000073" class="method-signature">
+          <a href="#M000048" class="method-signature">
           <span class="method-name">to_s</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Get a String representation of this SDL <a href="Tag.html">Tag</a>. This
-method returns a complete description of the Tag&#8217;s state using SDL
-(i.e. the output can be parsed by {@link read(String)})
+method returns a complete description of the <a
+href="Tag.html">Tag</a>&#8216;s state using SDL (i.e. the output can be
+parsed by {@link read(String)})
 </p>
 <p>
 Returns A string representation of this tag using SDL
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000073-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000073-source">
+            onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000048-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 755</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 766</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
       <span class="ruby-identifier">to_string</span>
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000074" class="method-detail">
-        <a name="M000074"></a>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
         <div class="method-heading">
-          <a href="#M000074" class="method-signature">
+          <a href="#M000049" class="method-signature">
           <span class="method-name">to_string</span><span class="method-args">(line_prefix = &quot;&quot;, indent = &quot;\t&quot;)</span>
           </a>
         </div>
         <div class="method-description">
           <table>
 <tr><td valign="top"><tt>linePrefix</tt>:</td><td>A prefix to insert before every line.
@@ -1975,12 +1681,11 @@ Returns A string representation of this tag using SDL
 <p>
 TODO: break up long lines using the backslash
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000074-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000074-source">
+            onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000049-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 765</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 776</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_string</span>(<span class="ruby-identifier">line_prefix</span> = <span class="ruby-value str">&quot;&quot;</span>, <span class="ruby-identifier">indent</span> = <span class="ruby-value str">&quot;\t&quot;</span>)
       <span class="ruby-identifier">line_prefix</span> = <span class="ruby-value str">&quot;&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">line_prefix</span>.<span class="ruby-identifier">nil?</span>
       <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>
@@ -2032,26 +1737,19 @@ TODO: break up long lines using the backslash
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
+      <div id="method-M000054" class="method-detail">
+        <a name="M000054"></a>
         <div class="method-heading">
-          <a href="#M000079" class="method-signature">
+          <a href="#M000054" class="method-signature">
           <span class="method-name">to_xml_string</span><span class="method-args">(line_prefix = &quot;&quot;, uri_by_namespace = nil)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
 Returns a string containing an XML representation of this tag. Values will
 be represented using _val0, _val1, etc.
@@ -2064,12 +1762,11 @@ be represented using _val0, _val1, etc.
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000079-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000079-source">
+            onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000054-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 853</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 864</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_xml_string</span>(<span class="ruby-identifier">line_prefix</span> = <span class="ruby-value str">&quot;&quot;</span>, <span class="ruby-identifier">uri_by_namespace</span> = <span class="ruby-keyword kw">nil</span>)
       <span class="ruby-identifier">line_prefix</span> <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot;&quot;</span>
@@ -2124,33 +1821,26 @@ be represented using _val0, _val1, etc.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
+      <div id="method-M000020" class="method-detail">
+        <a name="M000020"></a>
         <div class="method-heading">
-          <a href="#M000045" class="method-signature">
+          <a href="#M000020" class="method-signature">
           <span class="method-name">value</span><span class="method-args">()</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-A convenience method that returns the first value.
+A convenience method that returns the first <a
+href="Tag.html#M000020">value</a>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000045-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000045-source">
+            onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000020-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 228</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">value</span>
@@ -2158,45 +1848,39 @@ A convenience method that returns the first value.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000044" class="method-detail">
-        <a name="M000044"></a>
+      <div id="method-M000019" class="method-detail">
+        <a name="M000019"></a>
         <div class="method-heading">
-          <a href="#M000044" class="method-signature">
+          <a href="#M000019" class="method-signature">
           <span class="method-name">value=</span><span class="method-args">(value)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-A convenience method that sets the first value in the value list. See
-{@link addValue(Object)} for legal types.
+A convenience method that sets the first <a
+href="Tag.html#M000020">value</a> in the <a
+href="Tag.html#M000020">value</a> list. See {@link addValue(Object)} for
+legal types.
 </p>
 <table>
-<tr><td valign="top"><tt>value</tt>:</td><td>The value to be set.
+<tr><td valign="top"><tt><a href="Tag.html#M000020">value</a></tt>:</td><td>The <a href="Tag.html#M000020">value</a> to be set.
 </td></tr>
 </table>
 <h3>Raises</h3>
 <table>
-<tr><td valign="top"><tt>ArgumentError</tt>:</td><td>if the value is not a legal SDL type
+<tr><td valign="top"><tt>ArgumentError</tt>:</td><td>if the <a href="Tag.html#M000020">value</a> is not a legal SDL type
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000044-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000044-source">
+            onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000019-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 220</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">value=</span>(<span class="ruby-identifier">value</span>)
@@ -2205,38 +1889,30 @@ A convenience method that sets the first value in the value list. See
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000058" class="method-detail">
-        <a name="M000058"></a>
+      <div id="method-M000033" class="method-detail">
+        <a name="M000033"></a>
         <div class="method-heading">
-          <a href="#M000058" class="method-signature">
+          <a href="#M000033" class="method-signature">
           <span class="method-name">values</span><span class="method-args">( {|value| ...}</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Returns an Array of the values of this <a href="Tag.html">Tag</a> or
-enumerates them.
+Returns an Array of the <a href="Tag.html#M000033">values</a> of this <a
+href="Tag.html">Tag</a> or enumerates them.
 </p>
 <pre>
   tag.values # =&gt; [123, &quot;spices&quot;]
   tag.values { |value| puts value }
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000058-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000058-source">
+            onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000033-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 447</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">values</span> <span class="ruby-comment cmt"># :yields: value</span>
@@ -2249,45 +1925,39 @@ enumerates them.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000059" class="method-detail">
-        <a name="M000059"></a>
+      <div id="method-M000034" class="method-detail">
+        <a name="M000034"></a>
         <div class="method-heading">
-          <a href="#M000059" class="method-signature">
+          <a href="#M000034" class="method-signature">
           <span class="method-name">values=</span><span class="method-args">(someValues)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Set the values for this tag. See {@link addValue(Object)} for legal value
-types.
+Set the <a href="Tag.html#M000033">values</a> for this tag. See {@link
+addValue(Object)} for legal <a href="Tag.html#M000020">value</a> types.
 </p>
 <table>
-<tr><td valign="top"><tt>values</tt>:</td><td>The new values
+<tr><td valign="top"><tt><a href="Tag.html#M000033">values</a></tt>:</td><td>The <a href="Tag.html#M000013">new</a> <a
+href="Tag.html#M000033">values</a>
 </td></tr>
 </table>
 <p>
-@throws IllegalArgumentException if the collection contains any values
+@throws IllegalArgumentException if the collection contains any <a
+href="Tag.html#M000033">values</a>
 </p>
 <pre>
     which are not legal SDL types
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000059-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000059-source">
+            onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000034-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 463</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">values=</span>(<span class="ruby-identifier">someValues</span>)
@@ -2300,81 +1970,80 @@ types.
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
-      <div id="method-M000072" class="method-detail">
-        <a name="M000072"></a>
+      <div id="method-M000047" class="method-detail">
+        <a name="M000047"></a>
         <div class="method-heading">
-          <a href="#M000072" class="method-signature">
+          <a href="#M000047" class="method-signature">
           <span class="method-name">write</span><span class="method-args">(output, include_root = false)</span>
           </a>
         </div>
         <div class="method-description">
           <p>
-Write this tag out to the given IO or string (optionally clipping the
-root.)
+Write this tag out to the given IO or StringIO or String (optionally
+clipping the root.) Returns <tt>output</tt>.
 </p>
 <table>
-<tr><td valign="top"><tt>writer</tt>:</td><td>The writer to which we will write this tag
+<tr><td valign="top"><tt>output</tt>:</td><td>an IO or StringIO or a String to <a href="Tag.html#M000047">write</a> to
 </td></tr>
-<tr><td valign="top"><tt>includeRoot</tt>:</td><td>If true this tag will be written out as the root
+<tr><td valign="top"><tt>include_root</tt>:</td><td>if true this tag will be written out as the root element, if false only the
 </td></tr>
 </table>
 <pre>
-       element, if false only the children will be written
+  children will be written. False by default.
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000072-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000072-source">
+            onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000047-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 731</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/tag.rb, line 732</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write</span>(<span class="ruby-identifier">output</span>, <span class="ruby-identifier">include_root</span> = <span class="ruby-keyword kw">false</span>)
-      <span class="ruby-identifier">io</span> = (<span class="ruby-identifier">output</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>))<span class="ruby-operator">?</span> <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">output</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">output</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">output</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">String</span>
+        <span class="ruby-identifier">io</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">output</span>)
+        <span class="ruby-identifier">close_io</span> = <span class="ruby-keyword kw">true</span> <span class="ruby-comment cmt"># indicates we close the IO ourselves</span>
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">output</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">IO</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">output</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">StringIO</span>
+        <span class="ruby-identifier">io</span> = <span class="ruby-identifier">output</span>
+        <span class="ruby-identifier">close_io</span> = <span class="ruby-keyword kw">false</span> <span class="ruby-comment cmt"># let the caller close the IO</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;'output' should be a String or an IO but was #{output.class}&quot;</span>
+      <span class="ruby-keyword kw">end</span>
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">include_root</span>
         <span class="ruby-identifier">io</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">to_s</span>
       <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">each_child</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">io</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">$/</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-          <span class="ruby-identifier">child</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">io</span>)
+        <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">true</span>
+        <span class="ruby-identifier">children</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">io</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">$/</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">first</span>
+          <span class="ruby-identifier">first</span> = <span class="ruby-keyword kw">false</span>
+          <span class="ruby-identifier">io</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">to_s</span>
         <span class="ruby-keyword kw">end</span>
       <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">io</span>.<span class="ruby-identifier">close</span>()
+      <span class="ruby-identifier">io</span>.<span class="ruby-identifier">close</span>() <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">close_io</span>
-      <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">output</span>
     <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
     </div>
   </div>
 <div id="validator-badges">
   <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
 </div>
 </body>
-</html>
+</html>