sdl4r 0.9.4 → 0.9.5

data/CHANGELOG

@@ -1,3 +1,16 @@
+== v0.9.5 (建設中)
+
+== v0.9.6 (8-aug-2010)
+
+=== Major changes:
+
+* Fixes in order to make SDL4R work in Ruby 1.9 (mainly concerning encodings and dates).
+* Commented out debug code (writing to files) inside sdl4r_test.rb.
+
+=== Minor changes:
+
+* General & contact info in the README
+
 == v0.9.4 (6-aug-2010)
 
 === Major changes:
@@ -11,3 +24,18 @@
 * SDL4R#coerce_or_fail has been implemented, which means that random objects can't be added to a
   Tag as before. Rational instances are coerced using Rational#to_f.
 * Added usual time methods to SdlTimeSpan: day(), hour(), min(), sec(), usec()
+
+== v0.9.3
+
+=== Major changes
+
+* Tag: any method that use to take namespace/name parameters now follows the natural order
+  "namespace" and then "name":
+
+    Tag.new "ns1", "tag1"
+
+  WARNING: this was the contrary before!!!
+  Also, the "recursive" parameter should always be at the first place now.
+
+* It is now possible to override SDL4R::new_date_time in order to create Time instances when parsing
+  rather than DateTime instances.

data/README

@@ -1,5 +1,14 @@
 = SDL (Simple Declarative Language)
 
+SDL version supported: 1.3
+
+Site:: http://www.ikayzo.org/confluence/display/SDL/Home
+Downloads:: http://www.ikayzo.org/confluence/display/SDL/Downloads
+
+Users mailing list:: sdl-users@ikayzo.org
+Developers mailing list:: sdl-developers@ikayzo.org
+
+
 == Getting Started with SDL4R
 
 To get the Ruby Gem:

data/Rakefile

@@ -10,7 +10,7 @@ spec = Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.summary = "Simple Declarative Language for Ruby library"
   s.name = 'sdl4r'
-  s.version = '0.9.4'
+  s.version = '0.9.5'
   s.requirements << 'none'
   s.require_path = 'lib'
   s.authors = ['Philippe Vosges', 'Daniel Leuck']
@@ -51,7 +51,8 @@ Rake::RDocTask.new do |rd|
   rd.main = 'README'
   rd.rdoc_files.include(files)
   rd.rdoc_dir = "doc"
-  rd.title = "Simple Declarative Language for Ruby"
+  rd.title = "RDoc: Simple Declarative Language for Ruby"
+  rd.options << '--charset' << 'utf-8'
 end
 
 Rake::TestTask.new do |t|

data/TODO

@@ -0,0 +1,78 @@
+[x] Is Base64 really compatible with the format defined in the Java version ?
+    ==> Seems so after having implemented more of the standard tests.
+[ ] Add more unit tests
+    [x] Attribute tests
+    [x] Date tests
+    [x] Date + time test
+    [x] Time zone tests
+    [x] Number literal tests
+    [x] Strings literals (especially with line continuations)
+    [x] Sub tags tests
+    [x] "null" value test
+    [x] Comment tests
+    [ ] Bad syntax tests
+[ ] Test write (unit tests)
+    [ ] Dates
+    [ ] Numbers
+[A] Use YARD in order to generate documentation ?
+    ==> alternatively, I tried to generate some RDoc templates but none worked in Rake...
+[ ] BUG: the line number is too high by 1 (the column is correct).
+[/] Fix the differences between test_basic_types.sdl and what is generated from the parsed structure
+    [x] chars
+    [x] longs
+    [x] doubles
+    [x] decimals
+    [x] booleans
+    [x] null
+    [x] dates
+    [x] times
+        [x] negative times
+    [x] datetimes
+        [/] zone codes
+        ==> Time only works in UTC, which means that the original zone code is lost.
+        ==> DateTime doesn't give the zone code but only the offset.
+        [ ] Use TzTime? Use a custom object that knows whether a time zone was specified?
+            ==> http://tztime.rubyforge.org/
+            ==> along with TzInfo: http://tzinfo.rubyforge.org/
+[ ] See how Ruby floats relate to Java floats and doubles.
+[ ] Add tests for the SDL class
+[ ] Allow unicode characters in identifiers.
+[ ] FUTURE: It might be useful to allow people to replace the standard types by their own. This
+    could be useful for dates or numbers, for instance.
+[N] To install a gem in the Netbeans gems repository, it needs to run as an administrator.
+    Otherwise, it fails silently.
+[ ] FUTURE: Consider being able to read text files that are not UTF-8(?)
+[ ] BUG: the report on the line no in errors is off by 1 (at least in some cases)
+[x] Return copies or original arrays in Tag?
+    ==> we return the implementation Arrays or Hashes (or whatever) for efficiency.
+        However, we ask the users not to assume anything as we might protect the returned objects in
+        the future.
+[ ] Tag.hash: the implementation is not very efficient.
+    ==> Difficult to make better and still simple
+    ==> Maybe possible when it's frozen.
+[ ] FUTURE: xpath, ypath ==> sdlpath(?)
+[ ] FUTURE: evenemential parsing(?)
+[ ] FUTURE: add a way to insert a tag after or before another(?)
+[ ] FUTURE: allow some way of generating YAML(?)
+[ ] FUTURE: allow to turn a YAML structure into a SDL one(?)
+[ ] BUG: "rake package" tries to archive the contents twice: once with the command that I configure
+    in Rakefile, once with a zip command that can't work on my machine (zip is not installed). Why?
+    At least, the first archive is created and seems correct.
+[ ] FUTURE: Would we need a "write" method in SDL4R?
+[x] Add tests and release a RC or beta version
+[x] Make the methods of Tag that take a block have a better yield doc/completion
+    ==> I added :yields: RDoc directives, which doesn't look like it's helping but I guess that's
+        all I can do for now.
+[N] Never call a class "Test" => it can easily conflict with the "Test" module of Test::Unit and
+    then, it becomes quite difficult to understand why.
+[ ] Input relevant URLs on http://rubygems.org
+[x] What prevents from doing the following?
+    tag.values << IO.new("toto.txt")
+    ==> It doesn't break the behavior as long as the value type is OK. Even if it is not allowed,
+        it still is not too bad.
+[x] Look at the returned values of method who do not have their return values documented e.g.
+    Tag.add_value
+    ==> Minor change: we return nil for the methods were nothing was really returned explicitely
+        (for the time being).
+[x] State somewhere that we support SDL 1.3.
+[ ] If there is any success, maybe create/recreate the Rubyforge site for the support.

data/doc/classes/SDL4R.html

@@ -1,12 +1,9 @@
-<?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">
-
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>Module: SDL4R</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <title>Module: SDL4R [RDoc: Simple Declarative Language for Ruby]</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" />
   <script type="text/javascript">
@@ -25,7 +22,7 @@
       return false;
 
     elemStyle = elem.style;
-    
+
     if ( elemStyle.display != "block" ) {
       elemStyle.display = "block"
     } else {
@@ -34,10 +31,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>
 
@@ -45,7 +42,6 @@
 <body>
 
 
-
     <div id="classHeader">
         <table class="header-table">
         <tr class="top-aligned-row">
@@ -55,88 +51,157 @@
         <tr class="top-aligned-row">
             <td><strong>In:</strong></td>
             <td>
+
+
                 <a href="../files/lib/sdl4r/sdl_time_span_rb.html">
+
                 lib/sdl4r/sdl_time_span.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/sdl_parse_error_rb.html">
+
                 lib/sdl4r/sdl_parse_error.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/tag_rb.html">
+
                 lib/sdl4r/tag.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/parser_rb.html">
+
                 lib/sdl4r/parser.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/sdl_binary_rb.html">
+
                 lib/sdl4r/sdl_binary.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/parser/reader_rb.html">
+
                 lib/sdl4r/parser/reader.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/parser/tokenizer_rb.html">
+
                 lib/sdl4r/parser/tokenizer.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/parser/token_rb.html">
+
                 lib/sdl4r/parser/token.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/parser/time_span_with_zone_rb.html">
+
                 lib/sdl4r/parser/time_span_with_zone.rb
+
                 </a>
+
+
         <br />
+
+
                 <a href="../files/lib/sdl4r/sdl4r_rb.html">
+
                 lib/sdl4r/sdl4r.rb
+
                 </a>
+
+
         <br />
+
             </td>
         </tr>
 
+
         </table>
     </div>
   <!-- banner header -->
 
   <div id="bodyContent">
 
-
-
   <div id="contextContent">
 
     <div id="description">
-      <p>
+      <hr size="1"></hr><p>
 Gathers utility methods.
 </p>
 
     </div>
 
-
    </div>
 
+
     <div id="method-list">
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000001">SdlBinary</a>&nbsp;&nbsp;
-      <a href="#M000004">coerce_or_fail</a>&nbsp;&nbsp;
-      <a href="#M000002">format</a>&nbsp;&nbsp;
-      <a href="#M000003">new_date_time</a>&nbsp;&nbsp;
-      <a href="#M000006">read</a>&nbsp;&nbsp;
-      <a href="#M000009">to_attribute_map</a>&nbsp;&nbsp;
-      <a href="#M000007">to_value</a>&nbsp;&nbsp;
-      <a href="#M000008">to_value_array</a>&nbsp;&nbsp;
-      <a href="#M000005">validate_identifier</a>&nbsp;&nbsp;
+
+        <a href="#M000001">SdlBinary</a>&nbsp;&nbsp;
+
+        <a href="#M000004">coerce_or_fail</a>&nbsp;&nbsp;
+
+        <a href="#M000002">format</a>&nbsp;&nbsp;
+
+        <a href="#M000003">new_date_time</a>&nbsp;&nbsp;
+
+        <a href="#M000006">read</a>&nbsp;&nbsp;
+
+        <a href="#M000009">to_attribute_map</a>&nbsp;&nbsp;
+
+        <a href="#M000007">to_value</a>&nbsp;&nbsp;
+
+        <a href="#M000008">to_value_array</a>&nbsp;&nbsp;
+
+        <a href="#M000005">validate_identifier</a>&nbsp;&nbsp;
+
       </div>
     </div>
 
   </div>
 
-
     <!-- if includes -->
 
     <div id="section">
@@ -157,74 +222,96 @@ Class <a href="SDL4R/Tag.html" class="link">SDL4R::Tag</a><br />
 
       <div class="name-list">
         <table summary="Constants">
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">MAX_INTEGER_32</td>
           <td>=</td>
           <td class="context-item-value">2**31 - 1</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">MIN_INTEGER_32</td>
           <td>=</td>
           <td class="context-item-value">-(2**31)</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">MAX_INTEGER_64</td>
           <td>=</td>
           <td class="context-item-value">2**63 - 1</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">MIN_INTEGER_64</td>
           <td>=</td>
           <td class="context-item-value">-(2**63)</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">BASE64_WRAP_LINE_LENGTH</td>
           <td>=</td>
           <td class="context-item-value">72</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">ESCAPED_QUOTES</td>
           <td>=</td>
           <td class="context-item-value">{       &quot;\&quot;&quot; =&gt; &quot;\\\&quot;&quot;,       &quot;'&quot; =&gt; &quot;\\'&quot;,       &quot;`&quot; =&gt; &quot;\\`&quot;,     }</td>
+
         </tr>
+
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">ESCAPED_CHARS</td>
           <td>=</td>
           <td class="context-item-value">{       &quot;\\&quot; =&gt; &quot;\\\\&quot;,       &quot;\t&quot; =&gt; &quot;\\t&quot;,       &quot;\r&quot; =&gt; &quot;\\r&quot;,       &quot;\n&quot; =&gt; &quot;\\n&quot;,     }</td>
+
         </tr>
+
         </table>
       </div>
     </div>
 
 
 
-      
-
 
     <!-- if method_list -->
+
     <div id="methods">
+
       <h3 class="section-bar">Public Class methods</h3>
 
+
       <div id="method-M000001" class="method-detail">
         <a name="M000001"></a>
 
         <div class="method-heading">
+
           <a href="#M000001" class="method-signature">
+
           <span class="method-name">SdlBinary</span><span class="method-args">(o)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Try to coerce &#8216;o&#8217; into a <a
 href="SDL4R.html#M000001">SdlBinary</a>. Raise an ArgumentError if it
 fails.
 </p>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000001-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl_binary.rb, line 69</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl_binary.rb, line 72</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-constant">SdlBinary</span>(<span class="ruby-identifier">o</span>)
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">SdlBinary</span>
       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">o</span>
@@ -236,19 +323,26 @@ fails.
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000004" class="method-detail">
         <a name="M000004"></a>
 
         <div class="method-heading">
+
           <a href="#M000004" class="method-signature">
+
           <span class="method-name">coerce_or_fail</span><span class="method-args">(o)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Coerce the type to a standard SDL type or raises an ArgumentError.
 </p>
@@ -261,11 +355,12 @@ href="SDL4R.html#M000001">SdlBinary</a>,
 <p>
 Rationals are turned into Floats using Rational#to_f.
 </p>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000004-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 149</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 151</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">coerce_or_fail</span>(<span class="ruby-identifier">o</span>)
     <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">o</span>
 
@@ -291,42 +386,50 @@ Rationals are turned into Floats using Rational#to_f.
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000002" class="method-detail">
         <a name="M000002"></a>
 
         <div class="method-heading">
+
           <a href="#M000002" class="method-signature">
+
           <span class="method-name">format</span><span class="method-args">(o, add_quotes = true, line_prefix = &quot;&quot;, indent = &quot;\t&quot;)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Creates an SDL string representation for a given object and returns it.
 </p>
 <table>
-<tr><td valign="top"><tt>o</tt>:</td><td>the object to <a href="SDL4R.html#M000002">format</a>
+<tr><td valign="top"><tt>o</tt>:</td><td>the object to format
 
 </td></tr>
 <tr><td valign="top"><tt>add_quotes</tt>:</td><td>indicates whether quotes will be added to Strings and characters (true by
 default)
 
 </td></tr>
-<tr><td valign="top"><tt>line_prefix</tt>:</td><td>the line prefix to use (&quot;&quot; by default)
+<tr><td valign="top"><tt>line_prefix</tt>:</td><td>the line prefix to use (&#8220;&#8221; by default)
 
 </td></tr>
-<tr><td valign="top"><tt>indent</tt>:</td><td>the indent string to use (&quot;\t&quot; by default)
+<tr><td valign="top"><tt>indent</tt>:</td><td>the indent string to use (&#8220;t&#8220; by default)
 
 </td></tr>
 </table>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000002-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 42</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 44</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">format</span>(<span class="ruby-identifier">o</span>, <span class="ruby-identifier">add_quotes</span> = <span class="ruby-keyword kw">true</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-keyword kw">if</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">add_quotes</span>
@@ -388,7 +491,7 @@ default)
     <span class="ruby-comment cmt"># Below, we use &quot;#{o.year}&quot; instead of &quot;%Y&quot; because &quot;%Y&quot; always emit 4 chars at least even if</span>
     <span class="ruby-comment cmt"># the date is before 1000.</span>
     <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">DateTime</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Time</span>)
-      <span class="ruby-identifier">milliseconds</span> = <span class="ruby-identifier">o</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">DateTime</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">get_date_milliseconds</span>(<span class="ruby-identifier">o</span>) <span class="ruby-operator">:</span> (<span class="ruby-identifier">o</span>.<span class="ruby-identifier">usec</span> <span class="ruby-operator">/</span> <span class="ruby-value">10</span>).<span class="ruby-identifier">to_i</span>
+      <span class="ruby-identifier">milliseconds</span> = <span class="ruby-identifier">get_datetime_milliseconds</span>(<span class="ruby-identifier">o</span>)
 
       <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">milliseconds</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">o</span>.<span class="ruby-identifier">zone</span>
@@ -413,19 +516,26 @@ default)
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000003" class="method-detail">
         <a name="M000003"></a>
 
         <div class="method-heading">
+
           <a href="#M000003" class="method-signature">
+
           <span class="method-name">new_date_time</span><span class="method-args">(year, month, day, hour, min, sec, time_zone_offset)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Creates and returns the object representing a datetime (DateTime in the
 default implementation). This method is, by default, called by the <a
@@ -440,31 +550,39 @@ parsers.
     end
   end
 </pre>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000003-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 137</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 139</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new_date_time</span>(<span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-identifier">day</span>, <span class="ruby-identifier">hour</span>, <span class="ruby-identifier">min</span>, <span class="ruby-identifier">sec</span>, <span class="ruby-identifier">time_zone_offset</span>)
     <span class="ruby-constant">DateTime</span>.<span class="ruby-identifier">civil</span>(<span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-identifier">day</span>, <span class="ruby-identifier">hour</span>, <span class="ruby-identifier">min</span>, <span class="ruby-identifier">sec</span>, <span class="ruby-identifier">time_zone_offset</span>)
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000006" class="method-detail">
         <a name="M000006"></a>
 
         <div class="method-heading">
+
           <a href="#M000006" class="method-signature">
+
           <span class="method-name">read</span><span class="method-args">(input)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
-Creates and returns a tag named &quot;root&quot; and add all the tags
+Creates and returns a tag named &#8220;root&#8221; and add all the tags
 specified in the given <tt>input</tt>.
 </p>
 <table>
@@ -489,29 +607,37 @@ specified in the given <tt>input</tt>.
 
   root = SDL4R::read(URI.new(&quot;http://my_site/my_file.sdl&quot;))
 </pre>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000006-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 230</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 232</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">input</span>)
     <span class="ruby-constant">Tag</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">&quot;root&quot;</span>).<span class="ruby-identifier">read</span>(<span class="ruby-identifier">input</span>)
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000009" class="method-detail">
         <a name="M000009"></a>
 
         <div class="method-heading">
+
           <a href="#M000009" class="method-signature">
+
           <span class="method-name">to_attribute_map</span><span class="method-args">(s)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Parse a string representing the attributes portion of an SDL tag and return
 the results as a map.
@@ -524,30 +650,38 @@ Example
 
   # { &quot;value&quot; =&gt; 1, &quot;debugging&quot; =&gt; true, &quot;time&quot; =&gt; SdlTimeSpan.new(12, 24, 01) }
 </pre>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000009-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 268</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 270</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_attribute_map</span>(<span class="ruby-identifier">s</span>)
     <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;'s' cannot be null&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">nil?</span>
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">read</span>(<span class="ruby-value str">&quot;atts &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">s</span>).<span class="ruby-identifier">child</span>.<span class="ruby-identifier">attributes</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000007" class="method-detail">
         <a name="M000007"></a>
 
         <div class="method-heading">
+
           <a href="#M000007" class="method-signature">
+
           <span class="method-name">to_value</span><span class="method-args">(s)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Parses and returns the value corresponding with the specified SDL literal.
 </p>
@@ -556,30 +690,38 @@ Parses and returns the value corresponding with the specified SDL literal.
   SDL4R.to_value(&quot;1&quot;) # =&gt; 1
   SDL4R.to_value(&quot;null&quot;) # =&gt; nil
 </pre>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000007-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 240</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 242</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_value</span>(<span class="ruby-identifier">s</span>)
     <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;'s' cannot be null&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">nil?</span>
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">s</span>).<span class="ruby-identifier">child</span>.<span class="ruby-identifier">value</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000008" class="method-detail">
         <a name="M000008"></a>
 
         <div class="method-heading">
+
           <a href="#M000008" class="method-signature">
+
           <span class="method-name">to_value_array</span><span class="method-args">(s)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Parse the string of values and return a list. The string is handled as if
 it is the values portion of an SDL tag.
@@ -593,30 +735,38 @@ Example
 <p>
 Will return an int, a boolean, and a time span.
 </p>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000008-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 254</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 256</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_value_array</span>(<span class="ruby-identifier">s</span>)
     <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;'s' cannot be null&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">nil?</span>
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">s</span>).<span class="ruby-identifier">child</span>.<span class="ruby-identifier">values</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </div>
       </div>
 
+
       <div id="method-M000005" class="method-detail">
         <a name="M000005"></a>
 
         <div class="method-heading">
+
           <a href="#M000005" class="method-signature">
+
           <span class="method-name">validate_identifier</span><span class="method-args">(identifier)</span>
+
           </a>
+
         </div>
-      
+
         <div class="method-description">
+
           <p>
 Validates an SDL identifier String. SDL Identifiers must start with a
 Unicode letter or underscore (_) and contain only unicode letters, digits,
@@ -629,11 +779,12 @@ ArgumentError if the identifier is not legal
 <p>
 TODO: support UTF-8 identifiers
 </p>
+
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000005-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 182</span>
+<span class="ruby-comment cmt"># File lib/sdl4r/sdl4r.rb, line 184</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">validate_identifier</span>(<span class="ruby-identifier">identifier</span>)
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">identifier</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">identifier</span>.<span class="ruby-identifier">empty?</span>
       <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;SDL identifiers cannot be null or empty.&quot;</span>
@@ -663,19 +814,22 @@ TODO: support UTF-8 identifiers
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
+
         </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>