RubyGems - roxml - Versions diffs - 1.2 → 2.3.2 - Mend

roxml 1.2 → 2.3.2

Files changed (97) hide show

data/MIT-LICENSE +18 -0
data/README.rdoc +126 -0
data/Rakefile +100 -0
data/lib/roxml.rb +479 -485
data/lib/roxml/extensions/active_support.rb +32 -0
data/lib/roxml/extensions/array.rb +5 -0
data/lib/roxml/extensions/array/conversions.rb +25 -0
data/lib/roxml/extensions/deprecation.rb +28 -0
data/lib/roxml/extensions/string.rb +21 -0
data/lib/roxml/extensions/string/conversions.rb +44 -0
data/lib/roxml/extensions/string/iterators.rb +12 -0
data/lib/roxml/options.rb +266 -0
data/lib/roxml/xml.rb +223 -0
data/lib/roxml/xml/libxml.rb +63 -0
data/lib/roxml/xml/rexml.rb +64 -0
data/roxml.gemspec +105 -0
data/test/fixtures/book_text_with_attribute.xml +1 -1
data/test/fixtures/book_valid.xml +2 -2
data/test/fixtures/book_with_authors.xml +7 -0
data/test/fixtures/book_with_contributors_attrs.xml +7 -0
data/test/fixtures/book_with_default_namespace.xml +9 -0
data/test/fixtures/book_with_depth.xml +6 -0
data/test/fixtures/book_with_wrapped_attr.xml +3 -0
data/test/fixtures/dictionary_of_attr_name_clashes.xml +8 -0
data/test/fixtures/dictionary_of_attrs.xml +6 -0
data/test/fixtures/dictionary_of_guarded_names.xml +6 -0
data/test/fixtures/dictionary_of_mixeds.xml +4 -0
data/test/fixtures/dictionary_of_name_clashes.xml +10 -0
data/test/fixtures/dictionary_of_names.xml +4 -0
data/test/fixtures/dictionary_of_texts.xml +10 -0
data/test/fixtures/library.xml +1 -1
data/test/fixtures/library_uppercase.xml +30 -0
data/test/fixtures/muffins.xml +3 -0
data/test/fixtures/nameless_ageless_youth.xml +2 -0
data/test/fixtures/node_with_attr_name_conflicts.xml +1 -0
data/test/fixtures/node_with_name_conflicts.xml +4 -0
data/test/fixtures/numerology.xml +4 -0
data/test/fixtures/person_with_guarded_mothers.xml +13 -0
data/test/fixtures/person_with_mothers.xml +10 -0
data/test/mocks/dictionaries.rb +56 -0
data/test/mocks/mocks.rb +244 -48
data/test/release/dependencies_test.rb +32 -0
data/test/test_helper.rb +44 -0
data/test/unit/inheritance_test.rb +19 -0
data/test/unit/options_test.rb +102 -0
data/test/unit/roxml_test.rb +24 -0
data/test/unit/string_test.rb +11 -0
data/test/unit/to_xml_test.rb +52 -0
data/test/unit/xml_attribute_test.rb +39 -0
data/test/unit/xml_block_test.rb +81 -0
data/test/unit/xml_bool_test.rb +105 -0
data/test/unit/xml_construct_test.rb +77 -0
data/test/unit/xml_hash_test.rb +65 -0
data/test/unit/xml_initialize_test.rb +50 -0
data/test/unit/xml_name_test.rb +108 -0
data/test/unit/xml_namespace_test.rb +38 -0
data/test/unit/xml_object_test.rb +116 -0
data/test/unit/xml_required_test.rb +93 -0
data/test/unit/xml_text_test.rb +68 -0
metadata +138 -87
data/MIT-LICENSE.txt +0 -9
data/README +0 -2
data/doc/classes/ROXML.html +0 -374
data/doc/classes/ROXML.src/M000003.html +0 -19
data/doc/classes/ROXML.src/M000004.html +0 -25
data/doc/classes/ROXML.src/M000005.html +0 -22
data/doc/classes/ROXML/ROXML_Class.html +0 -429
data/doc/classes/ROXML/ROXML_Class.src/M000006.html +0 -27
data/doc/classes/ROXML/ROXML_Class.src/M000007.html +0 -18
data/doc/classes/ROXML/ROXML_Class.src/M000008.html +0 -19
data/doc/classes/ROXML/ROXML_Class.src/M000009.html +0 -25
data/doc/classes/ROXML/ROXML_Class.src/M000010.html +0 -24
data/doc/classes/ROXML/ROXML_Class.src/M000011.html +0 -18
data/doc/classes/ROXML/ROXML_Class.src/M000012.html +0 -18
data/doc/classes/ROXML/XMLAttributeRef.html +0 -175
data/doc/classes/ROXML/XMLAttributeRef.src/M000015.html +0 -19
data/doc/classes/ROXML/XMLAttributeRef.src/M000016.html +0 -19
data/doc/classes/ROXML/XMLObjectRef.html +0 -175
data/doc/classes/ROXML/XMLObjectRef.src/M000013.html +0 -26
data/doc/classes/ROXML/XMLObjectRef.src/M000014.html +0 -32
data/doc/classes/ROXML/XMLRef.html +0 -166
data/doc/classes/ROXML/XMLRef.src/M000017.html +0 -21
data/doc/classes/ROXML/XMLTextRef.html +0 -198
data/doc/classes/ROXML/XMLTextRef.src/M000018.html +0 -28
data/doc/classes/ROXML/XMLTextRef.src/M000019.html +0 -34
data/doc/classes/String.html +0 -165
data/doc/classes/String.src/M000001.html +0 -23
data/doc/classes/String.src/M000002.html +0 -23
data/doc/created.rid +0 -1
data/doc/files/lib/roxml_rb.html +0 -234
data/doc/fr_class_index.html +0 -33
data/doc/fr_file_index.html +0 -27
data/doc/fr_method_index.html +0 -45
data/doc/index.html +0 -24
data/doc/rdoc-style.css +0 -208
data/test/fixture_helper.rb +0 -5
data/test/test_roxml.rb +0 -105

data/doc/classes/ROXML/XMLTextRef.src/M000018.html DELETED Viewed

@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>update_xml (ROXML::XMLTextRef)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 153</span>
-        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_xml</span>(<span class="ruby-identifier">xml</span>, <span class="ruby-identifier">value</span>)
-            <span class="ruby-identifier">parent</span> = (<span class="ruby-identifier">wrapper</span> <span class="ruby-value">? </span><span class="ruby-identifier">xml</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">wrapper</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">xml</span>)
-            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">text_content</span>
-              <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">text</span> = (<span class="ruby-identifier">cdata</span> <span class="ruby-value">? </span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">CData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>)
-            <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">array</span>
-                <span class="ruby-identifier">value</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
-                    <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">name</span>).<span class="ruby-identifier">text</span> = (<span class="ruby-identifier">cdata</span> <span class="ruby-value">? </span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">CData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>)
-                <span class="ruby-keyword kw">end</span>
-            <span class="ruby-keyword kw">else</span>
-                <span class="ruby-identifier">parent</span>.<span class="ruby-identifier">add_element</span>(<span class="ruby-identifier">name</span>).<span class="ruby-identifier">text</span> = (<span class="ruby-identifier">cdata</span> <span class="ruby-value">? </span><span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">CData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_utf</span>)
-            <span class="ruby-keyword kw">end</span>
-            <span class="ruby-identifier">xml</span>
-        <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/doc/classes/ROXML/XMLTextRef.src/M000019.html DELETED Viewed

@@ -1,34 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>populate (ROXML::XMLTextRef)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 169</span>
-        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">populate</span>(<span class="ruby-identifier">xml</span>, <span class="ruby-identifier">instance</span>)
-            <span class="ruby-identifier">data</span> = <span class="ruby-keyword kw">nil</span>
-            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">text_content</span>
-              <span class="ruby-identifier">data</span> = <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">text</span>
-            <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">array</span>
-                <span class="ruby-identifier">xpath</span> = (<span class="ruby-identifier">wrapper</span> <span class="ruby-value">? </span><span class="ruby-node">&quot;#{wrapper}/#{name}&quot;</span> <span class="ruby-operator">:</span> <span class="ruby-node">&quot;#{name}&quot;</span>)
-                <span class="ruby-identifier">data</span> = []
-                <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">each_element</span>(<span class="ruby-identifier">xpath</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
-                    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">text</span>
-                        <span class="ruby-identifier">data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">to_latin</span>
-                    <span class="ruby-keyword kw">end</span>
-                <span class="ruby-keyword kw">end</span>
-            <span class="ruby-keyword kw">else</span>
-                <span class="ruby-identifier">child</span> = <span class="ruby-identifier">xml</span>.<span class="ruby-identifier">elements</span>[<span class="ruby-value">1</span>, <span class="ruby-identifier">name</span>]
-                <span class="ruby-identifier">data</span> = <span class="ruby-identifier">child</span>.<span class="ruby-identifier">text</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">child</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">text</span>
-            <span class="ruby-keyword kw">end</span>
-            <span class="ruby-identifier">instance</span>.<span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-node">&quot;@#{accessor}&quot;</span>, <span class="ruby-identifier">data</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">data</span>
-            <span class="ruby-identifier">instance</span>
-        <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/doc/classes/String.html DELETED Viewed

@@ -1,165 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!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: String</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">String</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../files/lib/roxml_rb.html">
-                lib/roxml.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">
-      <p>
-Extension of <a href="String.html">String</a> class to handle conversion
-from/to UTF-8/ISO-8869-1
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000002">to_latin</a>&nbsp;&nbsp;
-      <a href="#M000001">to_utf</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-        <div class="method-heading">
-          <a href="String.src/M000002.html" target="Code" class="method-signature"
-            onclick="popupCode('String.src/M000002.html');return false;">
-          <span class="method-name">to_latin</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Convert this string to iso-8850-1
-</p>
-        </div>
-      </div>
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-        <div class="method-heading">
-          <a href="String.src/M000001.html" target="Code" class="method-signature"
-            onclick="popupCode('String.src/M000001.html');return false;">
-          <span class="method-name">to_utf</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Return an utf-8 representation of this string.
-</p>
-        </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>

data/doc/classes/String.src/M000001.html DELETED Viewed

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>to_utf (String)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 486</span>
-        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_utf</span>
-            <span class="ruby-keyword kw">begin</span>
-                <span class="ruby-constant">Iconv</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;utf-8&quot;</span>, <span class="ruby-value str">&quot;iso-8859-1&quot;</span>).<span class="ruby-identifier">iconv</span>(<span class="ruby-keyword kw">self</span>)
-            <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Iconv</span><span class="ruby-operator">::</span><span class="ruby-constant">IllegalSequence</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-                <span class="ruby-constant">STDERR</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;!! Failed converting from UTF-8 -&gt; ISO-8859-1 (#{self}). Already the right charset?&quot;</span>
-                <span class="ruby-keyword kw">self</span>
-            <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/doc/classes/String.src/M000002.html DELETED Viewed

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>to_latin (String)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/roxml.rb, line 498</span>
-        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_latin</span>
-            <span class="ruby-keyword kw">begin</span>
-                <span class="ruby-constant">Iconv</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;iso-8859-1&quot;</span>, <span class="ruby-value str">&quot;utf-8&quot;</span>).<span class="ruby-identifier">iconv</span>(<span class="ruby-keyword kw">self</span>)
-            <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Iconv</span><span class="ruby-operator">::</span><span class="ruby-constant">IllegalSequence</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-                <span class="ruby-constant">STDERR</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;!! Failed converting from ISO-8859-1 -&gt; UTF-8 (#{self}). Already the right charset?&quot;</span>
-                <span class="ruby-keyword kw">self</span>
-            <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/doc/created.rid DELETED Viewed

	@@ -1 +0,0 @@
1	- Sat Nov 10 13:51:57 -0500 2007

data/doc/files/lib/roxml_rb.html DELETED Viewed

@@ -1,234 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!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>File: roxml.rb</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-  <div id="fileHeader">
-    <h1>roxml.rb</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>lib/roxml.rb
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Tue Oct 16 20:37:44 -0400 2007</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-<a href="../../classes/ROXML.html">ROXML</a> Ruby Object to XML mapping
-library. For more information visit <a
-href="http://roxml.rubyforge.org">roxml.rubyforge.org</a>
-</p>
-<p>
-Copyright (c) 2004-2006 Zak Mandhro and Anders Engstrom
-</p>
-<p>
-Permission is hereby granted, free of charge, to any person obtaining a
-copy of this software and associated documentation files (the
-&quot;Software&quot;), to deal in the Software without restriction,
-including without limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to the
-following conditions:
-</p>
-<p>
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-</p>
-<p>
-THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-USE OR OTHER DEALINGS IN THE SOFTWARE.
-</p>
-<h1>Quick Start Guide</h1>
-<p>
-This is a short usage example. See <a
-href="../../classes/ROXML/ROXML_Class.html">ROXML::ROXML_Class</a> and
-packaged test cases for more information.
-</p>
-<p>
-Consider an XML document representing a Library containing a number of
-Books. You can map this structure to Ruby classes that provide addition
-useful behavior. With <a href="../../classes/ROXML.html">ROXML</a>, you can
-annotate the Ruby classes as follows:
-</p>
-<pre>
-  class Book
-      include ROXML
-      xml_attribute :isbn, &quot;ISBN&quot;
-      xml_text :title
-      xml_text :description, nil, ROXML::TAG_CDATA
-      xml_text :author
-  end
-  class Library
-      include ROXML
-      xml_text :name, &quot;NAME&quot;, ROXML::TAG_CDATA
-      xml_object :books, Book, ROXML::TAG_ARRAY, &quot;books&quot;
-  end
-</pre>
-<p>
-To create a library and put a number of books in it we could run the
-following code:
-</p>
-<pre>
-  book = Book.new()
-  book.isbn = &quot;0201710897&quot;
-  book.title = &quot;The PickAxe&quot;
-  book.description = &quot;Best Ruby book out there!&quot;
-  book.author = &quot;David Thomas, Andrew Hunt, Dave Thomas&quot;
-  lib = Library.new()
-  lib.name = &quot;Favorite Books&quot;
-  lib &lt;&lt; book
-</pre>
-<p>
-To save this information to an XML file:
-</p>
-<pre>
-  File.open(&quot;library.xml&quot;, &quot;w&quot;) do |f|
-      lib.to_xml.write(f, 0)
-  end
-</pre>
-<p>
-To later populate the library object from the XML file:
-</p>
-<pre>
-  lib = Library.parse(File.read(&quot;library.xml&quot;))
-</pre>
-<p>
-Similarly, to do a one-to-one mapping between XML objects, such as book and
-publisher, you would use the <b>xml_object</b> annotation. For example:
-</p>
-<pre>
-      &lt;book isbn=&quot;0974514055&quot;&gt;
-        &lt;title&gt;Programming Ruby - 2nd Edition&lt;/title&gt;
-        &lt;description&gt;Second edition of the great book.&lt;/description&gt;
-        &lt;publisher&gt;
-           &lt;name&gt;Pragmatic Bookshelf&lt;/name&gt;
-        &lt;/publisher&gt;
-      &lt;/book&gt;
-</pre>
-<p>
-can be mapped using the following code:
-</p>
-<pre>
-      class BookWithPublisher
-      include ROXML
-          xml_name :book
-          xml_object :publisher, Publisher
-      end
-</pre>
-<p>
-Note: In the above example, <em>xml_name</em> annotation tells <a
-href="../../classes/ROXML.html">ROXML</a> to set the element name to
-&quot;book&quot; for mapping to XML. The default is XML element name is the
-class name in lowercase; &quot;bookwithpublisher&quot; in this case.
-</p>
-<p>
-For more information on available annotations, see <a
-href="../../classes/ROXML/ROXML_Class.html">ROXML::ROXML_Class</a>
-</p>
-    </div>
-    <div id="requires-list">
-      <h3 class="section-bar">Required files</h3>
-      <div class="name-list">
-      rexml/document&nbsp;&nbsp;
-      iconv&nbsp;&nbsp;
-      </div>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>