RubyGems - testunitxml - Versions diffs - 0.1.3 → 0.1.4 - Mend

testunitxml 0.1.3 → 0.1.4

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 (45) hide show

data/CHANGES +15 -0
data/MIT-LICENSE +21 -0
data/README +119 -0
data/docs/html/classes/REXML/Attributes.html +6 -6
data/docs/html/classes/REXML/Attributes.src/{M000001.html → M000004.html} +0 -0
data/docs/html/classes/REXML/DocType.html +207 -0
data/docs/html/classes/REXML/DocType.src/M000005.html +18 -0
data/docs/html/classes/REXML/DocType.src/M000006.html +18 -0
data/docs/html/classes/REXML/DocType.src/M000007.html +18 -0
data/docs/html/classes/REXML/DocType.src/M000008.html +20 -0
data/docs/html/classes/REXML/NotationDecl.html +188 -0
data/docs/html/classes/REXML/NotationDecl.src/M000001.html +18 -0
data/docs/html/classes/REXML/NotationDecl.src/M000002.html +18 -0
data/docs/html/classes/REXML/NotationDecl.src/M000003.html +19 -0
data/docs/html/classes/REXML.html +10 -0
data/docs/html/classes/Test/Unit/XML/NodeIterator/NullNodeFilter.html +5 -5
data/docs/html/classes/Test/Unit/XML/NodeIterator/NullNodeFilter.src/{M000007.html → M000014.html} +0 -0
data/docs/html/classes/Test/Unit/XML/NodeIterator.html +20 -20
data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000003.html → M000010.html} +0 -0
data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000004.html → M000011.html} +0 -0
data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000005.html → M000012.html} +0 -0
data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000006.html → M000013.html} +0 -0
data/docs/html/classes/Test/Unit/XML/XmlEqualFilter.html +5 -5
data/docs/html/classes/Test/Unit/XML/XmlEqualFilter.src/{M000008.html → M000015.html} +4 -0
data/docs/html/classes/Test/Unit/XML.html +49 -11
data/docs/html/classes/Test/Unit/XML.src/{M000002.html → M000009.html} +1 -1
data/docs/html/created.rid +1 -1
data/docs/html/files/CHANGES.html +127 -0
data/docs/html/files/README.html +64 -25
data/docs/html/files/lib/test/unit/xml/doctype_mixin_rb.html +101 -0
data/docs/html/files/lib/test/unit/xml/notationdecl_mixin_rb.html +101 -0
data/docs/html/files/lib/test/unit/xml/xml_assertions_rb.html +3 -1
data/docs/html/files/lib/test/unit/xml/xmlequalfilter_rb.html +1 -1
data/docs/html/fr_class_index.html +2 -0
data/docs/html/fr_file_index.html +3 -0
data/docs/html/fr_method_index.html +15 -8
data/lib/test/unit/xml/doctype_mixin.rb +32 -0
data/lib/test/unit/xml/notationdecl_mixin.rb +54 -0
data/lib/test/unit/xml/xml_assertions.rb +75 -7
data/lib/test/unit/xml/xmlequalfilter.rb +10 -6
data/setup.rb +1585 -0
data/test/tc_notationdecl_mixin.rb +50 -0
data/test/tc_testunitxml.rb +172 -1
data/test/ts_testunitxml.rb +12 -0
metadata +33 -11

data/docs/html/classes/REXML/NotationDecl.src/M000001.html ADDED Viewed

@@ -0,0 +1,18 @@
+<?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>name (REXML::NotationDecl)</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/test/unit/xml/notationdecl_mixin.rb, line 9</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">name</span>
+      <span class="ruby-ivar">@name</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/docs/html/classes/REXML/NotationDecl.src/M000002.html ADDED Viewed

@@ -0,0 +1,18 @@
+<?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>system (REXML::NotationDecl)</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/test/unit/xml/notationdecl_mixin.rb, line 16</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">system</span>
+      <span class="ruby-identifier">parse_rest</span>(<span class="ruby-ivar">@rest</span>)[<span class="ruby-value">1</span>]
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/docs/html/classes/REXML/NotationDecl.src/M000003.html ADDED Viewed

@@ -0,0 +1,19 @@
+<?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>public (REXML::NotationDecl)</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/test/unit/xml/notationdecl_mixin.rb, line 23</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">public</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@middle</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;PUBLIC&quot;</span>
+      <span class="ruby-identifier">parse_rest</span>(<span class="ruby-ivar">@rest</span>)[<span class="ruby-value">0</span>]
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/docs/html/classes/REXML.html CHANGED Viewed

@@ -58,6 +58,14 @@
                 <a href="../files/lib/test/unit/xml/attributes_mixin_rb.html">
                 lib/test/unit/xml/attributes_mixin.rb
                 </a>
+        <br />
+                <a href="../files/lib/test/unit/xml/doctype_mixin_rb.html">
+                lib/test/unit/xml/doctype_mixin.rb
+                </a>
+        <br />
+                <a href="../files/lib/test/unit/xml/notationdecl_mixin_rb.html">
+                lib/test/unit/xml/notationdecl_mixin.rb
+                </a>
         <br />
             </td>
         </tr>
@@ -88,6 +96,8 @@
       <h3 class="section-bar">Classes and Modules</h3>
       Class <a href="REXML/Attributes.html" class="link">REXML::Attributes</a><br />
+Class <a href="REXML/DocType.html" class="link">REXML::DocType</a><br />
+Class <a href="REXML/NotationDecl.html" class="link">REXML::NotationDecl</a><br />
     </div>

data/docs/html/classes/Test/Unit/XML/NodeIterator/NullNodeFilter.html CHANGED Viewed

@@ -86,7 +86,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000007">accept</a>&nbsp;&nbsp;
+      <a href="#M000014">accept</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -108,12 +108,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000007" class="method-detail">
-        <a name="M000007"></a>
+      <div id="method-M000014" class="method-detail">
+        <a name="M000014"></a>
         <div class="method-heading">
-          <a href="NullNodeFilter.src/M000007.html" target="Code" class="method-signature"
-            onclick="popupCode('NullNodeFilter.src/M000007.html');return false;">
+          <a href="NullNodeFilter.src/M000014.html" target="Code" class="method-signature"
+            onclick="popupCode('NullNodeFilter.src/M000014.html');return false;">
           <span class="method-name">accept</span><span class="method-args">(node)</span>
           </a>
         </div>

data/docs/html/classes/Test/Unit/XML/NodeIterator/NullNodeFilter.src/{M000007.html → M000014.html} RENAMED Viewed

File without changes

data/docs/html/classes/Test/Unit/XML/NodeIterator.html CHANGED Viewed

@@ -86,10 +86,10 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000003">find_next_node</a>&nbsp;&nbsp;
-      <a href="#M000005">has_next</a>&nbsp;&nbsp;
-      <a href="#M000004">new</a>&nbsp;&nbsp;
-      <a href="#M000006">next</a>&nbsp;&nbsp;
+      <a href="#M000010">find_next_node</a>&nbsp;&nbsp;
+      <a href="#M000012">has_next</a>&nbsp;&nbsp;
+      <a href="#M000011">new</a>&nbsp;&nbsp;
+      <a href="#M000013">next</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -117,12 +117,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
+      <div id="method-M000010" class="method-detail">
+        <a name="M000010"></a>
         <div class="method-heading">
-          <a href="NodeIterator.src/M000003.html" target="Code" class="method-signature"
-            onclick="popupCode('NodeIterator.src/M000003.html');return false;">
+          <a href="NodeIterator.src/M000010.html" target="Code" class="method-signature"
+            onclick="popupCode('NodeIterator.src/M000010.html');return false;">
           <span class="method-name">find_next_node</span><span class="method-args">(node, node_filter = NullNodeFilter.new)</span>
           </a>
         </div>
@@ -136,12 +136,12 @@ filter.
         </div>
       </div>
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
+      <div id="method-M000011" class="method-detail">
+        <a name="M000011"></a>
         <div class="method-heading">
-          <a href="NodeIterator.src/M000004.html" target="Code" class="method-signature"
-            onclick="popupCode('NodeIterator.src/M000004.html');return false;">
+          <a href="NodeIterator.src/M000011.html" target="Code" class="method-signature"
+            onclick="popupCode('NodeIterator.src/M000011.html');return false;">
           <span class="method-name">new</span><span class="method-args">(node, node_filter = NullNodeFilter.new)</span>
           </a>
         </div>
@@ -152,12 +152,12 @@ filter.
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
+      <div id="method-M000012" class="method-detail">
+        <a name="M000012"></a>
         <div class="method-heading">
-          <a href="NodeIterator.src/M000005.html" target="Code" class="method-signature"
-            onclick="popupCode('NodeIterator.src/M000005.html');return false;">
+          <a href="NodeIterator.src/M000012.html" target="Code" class="method-signature"
+            onclick="popupCode('NodeIterator.src/M000012.html');return false;">
           <span class="method-name">has_next</span><span class="method-args">()</span>
           </a>
         </div>
@@ -166,12 +166,12 @@ filter.
         </div>
       </div>
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
+      <div id="method-M000013" class="method-detail">
+        <a name="M000013"></a>
         <div class="method-heading">
-          <a href="NodeIterator.src/M000006.html" target="Code" class="method-signature"
-            onclick="popupCode('NodeIterator.src/M000006.html');return false;">
+          <a href="NodeIterator.src/M000013.html" target="Code" class="method-signature"
+            onclick="popupCode('NodeIterator.src/M000013.html');return false;">
           <span class="method-name">next</span><span class="method-args">()</span>
           </a>
         </div>

data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000003.html → M000010.html} RENAMED Viewed

File without changes

data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000004.html → M000011.html} RENAMED Viewed

File without changes

data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000005.html → M000012.html} RENAMED Viewed

File without changes

data/docs/html/classes/Test/Unit/XML/NodeIterator.src/{M000006.html → M000013.html} RENAMED Viewed

File without changes

data/docs/html/classes/Test/Unit/XML/XmlEqualFilter.html CHANGED Viewed

@@ -93,7 +93,7 @@ non-significant whitespace
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000008">accept</a>&nbsp;&nbsp;
+      <a href="#M000015">accept</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -115,12 +115,12 @@ non-significant whitespace
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000008" class="method-detail">
-        <a name="M000008"></a>
+      <div id="method-M000015" class="method-detail">
+        <a name="M000015"></a>
         <div class="method-heading">
-          <a href="XmlEqualFilter.src/M000008.html" target="Code" class="method-signature"
-            onclick="popupCode('XmlEqualFilter.src/M000008.html');return false;">
+          <a href="XmlEqualFilter.src/M000015.html" target="Code" class="method-signature"
+            onclick="popupCode('XmlEqualFilter.src/M000015.html');return false;">
           <span class="method-name">accept</span><span class="method-args">(node)</span>
           </a>
         </div>

data/docs/html/classes/Test/Unit/XML/XmlEqualFilter.src/{M000008.html → M000015.html} RENAMED Viewed

@@ -15,6 +15,10 @@
           <span class="ruby-keyword kw">case</span>
           <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">node</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Text</span>)
             <span class="ruby-identifier">is_significant?</span>(<span class="ruby-identifier">node</span>.<span class="ruby-identifier">value</span>)
+          <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">node</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Entity</span>)
+            <span class="ruby-keyword kw">false</span>
+          <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">node</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">NotationDecl</span>)
+            <span class="ruby-keyword kw">false</span>
           <span class="ruby-keyword kw">else</span>
             <span class="ruby-keyword kw">true</span>
           <span class="ruby-keyword kw">end</span>

data/docs/html/classes/Test/Unit/XML.html CHANGED Viewed

@@ -88,7 +88,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000002">assert_xml_equal</a>&nbsp;&nbsp;
+      <a href="#M000009">assert_xml_equal</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -117,12 +117,12 @@ Class <a href="XML/XmlEqualFilter.html" class="link">Test::Unit::XML::XmlEqualFi
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
+      <div id="method-M000009" class="method-detail">
+        <a name="M000009"></a>
         <div class="method-heading">
-          <a href="XML.src/M000002.html" target="Code" class="method-signature"
-            onclick="popupCode('XML.src/M000002.html');return false;">
+          <a href="XML.src/M000009.html" target="Code" class="method-signature"
+            onclick="popupCode('XML.src/M000009.html');return false;">
           <span class="method-name">assert_xml_equal</span><span class="method-args">(expected_doc, actual_doc, message = nil)</span>
           </a>
         </div>
@@ -130,9 +130,8 @@ Class <a href="XML/XmlEqualFilter.html" class="link">Test::Unit::XML::XmlEqualFi
         <div class="method-description">
           <p>
 This method checks whether two well-formed <a href="XML.html">XML</a>
-documents are equal. Doctype declarations are ignored for the purposes of
-comparison. Two <a href="XML.html">XML</a> documents are considered equal
-if:
+documents are equal. Two <a href="XML.html">XML</a> documents are
+considered equal if:
 </p>
 <ul>
 <li>They contain the same type of nodes, in the same order, except for text
@@ -152,12 +151,51 @@ Nodes are tested for equality as follows:
 version, encoding, and stand-alone pseudo-attributes.
 </td></tr>
-<tr><td valign="top">Doctype:</td><td>Doctype declarations are ignored.
+<tr><td valign="top">Doctype:</td><td>Doctypes are equal if they fulfill all of the following conditions:
+<ul>
+<li>They have the same public identifier, or neither has a public identifier
+</li>
+<li>If one of the doctypes has a system identifier that is a URN, the other
+doctype must have a system identifier that is the same URN. System
+identifiers that are URLs are ignored for comparison purposes. The reason
+is that the same DTD is very often stored in many different locations (for
+example different directories on different computers). Therefore the
+physical location of the DTD does not say anything useful about whether two
+documents are equal.
+</li>
+<li>An entity declaration present in one of the doctype declarations must also
+be present in the other.
+</li>
+<li>A notation declaration present in one of the doctype declarations must also
+be present in the other.
+</li>
+</ul>
+</td></tr>
+<tr><td valign="top">Internal General Entity Declaration:</td><td>Internal General entity declarations are equal if they have the same name,
+and the same value.
+</td></tr>
+<tr><td valign="top">External General Entity Declaration:</td><td>External general entity declarations are equal if they have the same name,
+and if the identifiers are of the same type (PUBLIC or SYSTEM) and have the
+same value. Note that if the identifiers are URLs, a comparison may fail
+even though both URLS point to the same resource, for example if one URL is
+relative and the other is absolute.
+</td></tr>
+<tr><td valign="top">Notation Declaration:</td><td>Notation declarations are equal if they have the same name, and if the
+identifiers are of the same type (PUBLIC or SYSTEM) and have the same
+value.
 </td></tr>
 <tr><td valign="top">Elements:</td><td>Elements are considered equal if they have the same generic identifier (tag
-name) and belong to the same namespace. The namespace <em>prefixes</em> may
-be different.
+name), belong to the same namespace, and have the same attributes. Note
+that the namespace <em>prefixes</em> of two elements may be different as
+long as they belong to the same namespace.
 </td></tr>
 <tr><td valign="top">Attributes:</td><td>Attributes are equal if they belong to the same namespace, have the same

data/docs/html/classes/Test/Unit/XML.src/{M000002.html → M000009.html} RENAMED Viewed

@@ -10,7 +10,7 @@
   <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/test/unit/xml/xml_assertions.rb, line 68</span>
+  <pre><span class="ruby-comment cmt"># File lib/test/unit/xml/xml_assertions.rb, line 95</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_xml_equal</span>(<span class="ruby-identifier">expected_doc</span>, <span class="ruby-identifier">actual_doc</span>, <span class="ruby-identifier">message</span> = <span class="ruby-keyword kw">nil</span>)
         <span class="ruby-identifier">expected_doc</span> = <span class="ruby-identifier">parse_xml</span>(<span class="ruby-identifier">expected_doc</span>)
         <span class="ruby-identifier">actual_doc</span> = <span class="ruby-identifier">parse_xml</span>(<span class="ruby-identifier">actual_doc</span>)

data/docs/html/created.rid CHANGED Viewed

	@@ -1 +1 @@
1	- Mon Jan 09 22:47:40 CET 2006
1	+ Mon Jan 23 15:05:33 CET 2006

data/docs/html/files/CHANGES.html ADDED Viewed

@@ -0,0 +1,127 @@
+<?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: CHANGES</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>CHANGES</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>CHANGES
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Jan 23 14:04:26 CET 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <h1>Changes</h1>
+<h2>Version 0.1.4</h2>
+<ul>
+<li>Added support for Doctype comparisons in <tt>assert_xml_equal</tt>
+</li>
+<li>Added <tt>setup.rb</tt> file to distribution packages
+</li>
+<li>Added installation section to README file
+</li>
+<li>Added links to online tutorial to README file
+</li>
+<li>Added CHANGES file
+</li>
+</ul>
+<h2>Version 0.1.3</h2>
+<p>
+The initial release.
+</p>
+    </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>

data/docs/html/files/README.html CHANGED Viewed

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Mon Jan 09 22:18:05 CET 2006</td>
+      <td>Mon Jan 23 13:57:30 CET 2006</td>
     </tr>
     </table>
   </div>
@@ -72,7 +72,7 @@
       <h1><a href="../classes/Test/Unit/XML.html">Test::Unit::XML</a></h1>
 <h2>An XML <a href="../classes/Test.html">Test</a> Framework</h2>
 <p>
-Version: 0.1.2
+Version: 0.1.4
 </p>
 <p>
 Author: Henrik M�rtensson
@@ -93,10 +93,58 @@ have an <tt>assert_xml_equal</tt> assertion available in the <a
 href="../classes/Test/Unit/TestCase.html">Test::Unit::TestCase</a> class.
 </p>
 <p>
-See the test case <a
-href="../../../test/tc_testunitxml.rb">tc_testunitxml.rb</a> included in
-the distribution package for an example.
+In addition to the API documentation included in the package, you can get
+information about how to use <a
+href="../classes/Test/Unit/XML.html">Test::Unit::XML</a> from the following
+sources:
 </p>
+<ul>
+<li>The online <a
+href="http://kallokain.blogspot.com/2006/01/testunitxml-quick-start-tutorial.html">tutorial</a>
+at the <a href="http://kallokain.blogspot.com/">Kallokain</a> blog.
+</li>
+<li>The <a href="../../../test">test cases</a> included in the distribution
+package.
+</li>
+</ul>
+<h2>Installation</h2>
+<h3>Install Using the <tt>RubyGem</tt> Package Manager</h3>
+<p>
+The easiest way to install <a
+href="../classes/Test/Unit/XML.html">Test::Unit::XML</a> is to make a
+remote installation via the RubyGem package manager:
+</p>
+<p>
+<tt>gem install testunitxml</tt>
+</p>
+<p>
+If you have downloaded a gem package from Rubyforge, you can do a local
+installation:
+</p>
+<p>
+<tt>cd <em>download_directory_path</em></tt>
+</p>
+<p>
+<tt>gem install testunitxml -l</tt>
+</p>
+<h3>Install from a Zip file or Tarball</h3>
+<p>
+If you do not have RubyGem installed, you can download a Zip file or
+tarball and install from it instead:
+</p>
+<table>
+<tr><td valign="top">1:</td><td>Unpack the Zip or tarball archive.
+</td></tr>
+<tr><td valign="top">2:</td><td>cd to the directory you just unpacked.
+</td></tr>
+<tr><td valign="top">3:</td><td>Run the command: <tt>ruby setup.rb install</tt>
+</td></tr>
+</table>
 <h2>What Does <em>Equal</em> XML Documents Mean?</h2>
 <p>
 It is hard to define exactly what <em>equal</em> means in the context of
@@ -104,11 +152,6 @@ XML documents. I have tried to follow W3C XML recommendations as far as
 possible. There are a few things worthy of note:
 </p>
 <ul>
-<li>Doctype declarations are not compared with each other. If a declaration is
-present in one document, there must be a Doctype declaration in the other,
-but there is no effort to compare them.
-</li>
 <li>Namespace <em>declarations</em>, i.e. attributes that declare namespaces,
 are ignored for comparison purposes. (The namespaces <em>are</em> used in
 comparisons.) The reason is that XML processors may move the declarations
@@ -130,21 +173,13 @@ transformation engines. These often produce extraneous whitespace.
 There are a few things in the pipeline:
 </p>
 <ul>
-<li>Doctype comparison. There will be assertions for comparing:
+<li>assert_xml_equal_structure - checks that the structure of two documents are
+equal, but ignores content, attributes, processing istructions, comments,
+CDATA, and doctype declarations.
-<pre>
-  - Entity declarations
-  - SYSTEM identifiers
-  - PUBLIC identifiers
-</pre>
 </li>
-<li>Schema Validation. The first thing to add is validation against RELAX NG
-schemas. This will probably be done by having <a
-href="../classes/Test/Unit/XML.html">Test::Unit::XML</a> call Jing, a
-popular RELAX NG validator written in Java. I will also look into DTD
-validation, and (Urgh!) W3C Schema validation, but RELAX NG has top
-priority, because it is the most powerful and flexible of the three schema
-types.
+<li>assert_xml_similar - Like assert_xml_equal, but ignores the order of child
+elements.
 </li>
 <li>Configurability. It <em>might</em> be useful to be able to set
@@ -173,12 +208,16 @@ may also wish to visit my home page, <a
 href="http://www.henrikmartensson.org">www.henrikmartensson.org</a>, for
 more information about <a
 href="../classes/Test/Unit/XML.html">Test::Unit::XML</a> and other
-projects.
+projects. I will write about <a
+href="../classes/Test/Unit/XML.html">Test::Unit::XML</a> at the the <a
+href="http://kallokain.blogspot.com/">Kallokain</a> blog. You are welcome
+to visit, and comment.
 </p>
 <p>
 If you find <a href="../classes/Test/Unit/XML.html">Test::Unit::XML</a>
 useful, please do tell me about it. I would like to list projects that use
-it on my web site.
+it on the <a href="http://testunitxml.rubyforge.org/">Test::Unit::XML web
+site</a>.
 </p>
 <p>
 If you find <a href="../classes/Test/Unit/XML.html">Test::Unit::XML</a>