numru-misc 0.1.1

data/ChangeLog

@@ -0,0 +1,41 @@
+Mon Aug 11  2011   T Horinouchi
+	* numru-misc-0.1.1 released (relase tag: numru-misc-0_1_1)
+	* LICENCE.txt: Added (BSD 2-clause licence)
+
+Mon Mar 15  2010   T Horinouchi
+	* numru-misc-0.1.0 released (relase tag: numru-misc-0_1_0)
+
+2008-02-05  S Otsuka
+	* install.rb: for ruby 1.9
+
+Fri May 13  2005   T Horinouchi
+	* numru-misc-0.0.6 released (relase tag: numru-misc-0_0_6)
+	* keywordopt.rb: KeywordOpt#keys --> public (returns @keys.dup).
+	  Added KeywordOpt#select_keys.
+Tue Aug 12  2004   T Horinouchi
+	* keywordopt.rb: modified KeywordOptAutoHelp#set to show help
+	  message if 'help'==true.
+Tue Aug 10  2004   T Horinouchi
+	* numru-misc-0.0.5 released (relase tag: numru-misc-0_0_5)
+	* package renamed from misc to numru-misc: started new CVS
+Fri Mar 19  2004   T Horinouchi
+	* emath.rb: basically, a refactoring
+	* install.rb: debug
+Wed Dec 10  2003   T Horinouchi
+	* misc-0.0.4 released
+	* emath.rb: NumRu::EMath --> NumRu::Misc::EMath
+	            Documentation.
+	* misc.rb: documentation update for EMath.
+Tue Oct  7  2003   T Horinouchi
+	* emath.rb: created
+Mon Sep  1  2003   T Horinouchi
+	* misc-0.0.3 released
+	* keywordopt.rb: minor debug of the help messaging in 
+	  KeywordOptAutoHelp#interpret
+Tue Aug 26  2003   T Horinouchi
+	* keywordopt.rb: added class KeywordOptAutoHelp. refined help.
+	  allowed KeywordOpt.new to accept another KeywordOpt.
+Mon Aug 25  2003   T Horinouchi
+	* keywordopt.rb: KeywordOpt#interpret slightly modified
+Mon Aug 25  2003   T Horinouchi
+	* version 0.0.2 released

data/LICENSE.txt

@@ -0,0 +1,34 @@
+NumRu::Misc is copyrighted free software by Takeshi Horinouchi and
+GFD Dennou Club (http://www.gfd-dennou.org/).
+
+Copyright 2011 (C) Takeshi Horinouchi and GFD Dennou Club
+(http://www.gfd-dennou.org/) All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   1. Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in
+      the documentation and/or other materials provided with the
+      distribution.
+
+THIS SOFTWARE IS PROVIDED BY GFD DENNOU CLUB AND CONTRIBUTORS ``AS IS'' 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GFD DENNOU CLUB OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+The views and conclusions contained in the software and documentation
+are those of the authors and should not be interpreted as representing
+official policies, either expressed or implied, of Takeshi Horinouchi
+and GFD Dennou Club.

data/Rakefile

@@ -0,0 +1,38 @@
+require 'rake/gempackagetask'
+
+NAME = 'numru-misc'
+VER = '0.1.1'
+
+PKG_FILES = FileList[
+  '**',
+  'lib/**/*',
+  'doc/**/*'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name             = NAME
+  s.version          = VER
+  s.authors           = ["Takeshi Horinouchi"]
+  s.email            = ['eriko@gfd-dennou.org']
+  s.homepage         = 'http://www.gfd-dennou.org/arch/ruby/products/numru-misc/'
+  s.licenses         = ["Takeshi Horinouchi", "GFD Dennou Club"]
+  s.platform         = Gem::Platform::RUBY
+  s.summary          = %q{Collection of miscellaneous functions and classes to facilitate programming.}
+  s.description      = %q{Miscellaneous functions and classes to help Ruby programming. To be used in other NumRu libraries.}
+
+  s.files            = PKG_FILES.to_a
+  s.require_paths    = ['lib']
+  #s.test_files = Dir.glob("test/*")
+  #s.has_rdoc         = true
+  s.required_ruby_version = Gem::Requirement.new(">= 1.6")
+  s.add_runtime_dependency(%q<narray>, [">= 0"])
+  #s.add_runtime_dependency(%q<narray_miss>, [">= 0"])
+  #s.extra_rdoc_files = ['README']
+
+  #s.extensions << "install.rb"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_tar = true
+end

data/doc/emath.html

@@ -0,0 +1,26 @@
+<?xml version="1.0" ?>
+<!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">
+<head>
+<title>lib/numru/misc/emath.rb</title>
+</head>
+<body>
+<h1><a name="label:0" id="label:0">module NumRu::Misc::EMath</a></h1><!-- RDLabel: "module NumRu::Misc::EMath" -->
+<p>To be included instead of the Math predefined module (or NMath in NArray).
+Unlike Math and NMath, EMath handles unknown classes by calling its
+native instance method (assuming the same name).</p>
+<p>Therefore, if included, its function (module method) is used as:</p>
+<pre>cos( obj )</pre>
+<p>and so on. If obj is not of a supported class, EMath calls, obj.cos in
+this case.  (If cos is not a method of obj, then an exception is
+raised.)  Supported classes are Numeric (by Math) and NArray (by
+NMath).  EMath stands for "good Math" (for obvious reason for a
+Japanese).</p>
+<p>Note: as for atan2(a,b), a.atan2(b) will be called if a or b
+is not supported. This is the case for all functions that take
+two or more arguments.</p>
+
+</body>
+</html>

data/doc/index.html

@@ -0,0 +1,83 @@
+<?xml version="1.0" ?>
+<!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">
+<head>
+<title>lib/numru/misc/misc.rb</title>
+</head>
+<body>
+<h1><a name="label:0" id="label:0">module NumRu::Misc</a></h1><!-- RDLabel: "module NumRu::Misc" -->
+<h2><a name="label:1" id="label:1">Overview</a></h2><!-- RDLabel: "Overview" -->
+<p>Miscellaneous functions and classes to facilitate programming.</p>
+<h2><a name="label:2" id="label:2">Index</a></h2><!-- RDLabel: "Index" -->
+<p>CLASSES</p>
+<ul>
+<li><a href="keywordopt.html">class KeywordOpt</a>
+  to support keyward arguments with default values.</li>
+<li><a href="narray_ext.html">class NArray (enhancement of NArray made by M Tanaka)</a></li>
+</ul>
+<p>MODULES</p>
+<ul>
+<li><a href="md_iterators.html">module MD_Iterators</a> A Mixin for classes with
+  multi-dimension indexing support (such as NArray).</li>
+<li><a href="emath.html">module EMath</a> 
+  To be included instead of the Math predefined module (or NMath in NArray).
+  Unlike Math and NMath, EMath handles unknown classes by calling its
+  native instance method (assuming the same name).</li>
+</ul>
+<p>MODULE FUNCTIONS</p>
+<ul>
+<li><a href="#label:4">check_shape_consistency</a></li>
+</ul>
+<h2><a name="label:3" id="label:3">Module functions</a></h2><!-- RDLabel: "Module functions" -->
+<dl>
+<dt><a name="label:4" id="label:4"><code>check_shape_consistency(<var>cshapes</var>, *<var>args</var>)</code></a></dt><!-- RDLabel: "check_shape_consistency" -->
+<dd>
+<p>Check the consistency of array shapes (multi-dim such as NArray).
+Exception is raised if inconsistent.</p>
+<p>ARGUMENTS</p>
+<ul>
+<li>cshapes (String) : description of the shapes of the args.
+       Delimited by one-or-more spaces between arrays,
+       and the shape of each array is delimited by a comma. The lengths are 
+       expressed with string names as identifiers (in that case, length 
+       values are unquestioned) or specified as positive integers.
+       Use '..' or '...' for repetition of the last shape.
+       See EXAMPLES below.</li>
+<li>args (multi-dim arrays such as NArray): arrays to be checked</li>
+</ul>
+<p>RETURN VALUE</p>
+<ul>
+<li>nil</li>
+</ul>
+<p>POSSIBLE EXCEPTIONS</p>
+<ul>
+<li>exception is raised if cshapes and args are inconsistent:
+<ul>
+<li>RuntimeError, if the arrays do not have shapes specified by cshapes.</li>
+<li>ArgeumentError, if the number of args are inconsistent with cshapes. 
+         This is likely a coding error of the user.</li>
+</ul></li>
+</ul>
+<p>EXAMPLES</p>
+<ul>
+<li><p>to check whether three arrays u, v, and w are shaped as
+        u[nx], v[ny], and w[nx,ny], where nx and ny are any integer:</p>
+<pre>NumRu::Misc.check_shape_consistency('nx ny nx,ny',u,v,w)</pre>
+<p>Or equivalently,</p>
+<pre>NumRu::Misc.check_shape_consistency('m  n  m,n',u,v,w)</pre>
+<p>because actual strings does not matter.</p></li>
+<li><p>To specify fixed lengths, use integers instead of names:</p>
+<pre>NumRu::Misc.check_shape_consistency('4  n  4,n',u,v,w)</pre>
+<p>In this case, u,v,w must have shapes [4], [ny], and [4,ny],
+where ny is any length.</p></li>
+<li><p>Use '..' or '...' to repeat the same shape:</p>
+<pre>NumRu::Misc.check_shape_consistency('nx,ny ...',u,v,w)</pre>
+<p>This ensures that u, v, and w are 2D arrays with the same shape.
+Note: '..' and '...' are the same, so you can use whichever you like.</p></li>
+</ul></dd>
+</dl>
+
+</body>
+</html>

data/doc/keywordopt.html

@@ -0,0 +1,179 @@
+<?xml version="1.0" ?>
+<!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">
+<head>
+<title>lib/numru/misc/keywordopt.rb</title>
+</head>
+<body>
+<h2><a name="label:0" id="label:0">Index</a></h2><!-- RDLabel: "Index" -->
+<ul>
+<li><a href="#label:1">class NumRu::Misc::KeywordOpt</a></li>
+<li><a href="#label:13">class NumRu::Misc::KeywordOptAutoHelp &lt; NumRu::Misc::KeywordOpt</a></li>
+</ul>
+<h1><a name="label:1" id="label:1">class NumRu::Misc::KeywordOpt</a></h1><!-- RDLabel: "class NumRu::Misc::KeywordOpt" -->
+<h2><a name="label:2" id="label:2">Overview</a></h2><!-- RDLabel: "Overview" -->
+<p>A class to facilitate optional keyword arguments. More specifically,
+it helps the use of a Hash to mimic the keyword argument system.
+With this, you can set default values and description to each 
+keyword argument.</p>
+<h2><a name="label:3" id="label:3">Classes defined supplementarilly</a></h2><!-- RDLabel: "Classes defined supplementarilly" -->
+<h3><a name="label:4" id="label:4">class NumRu::Misc::HelpMessagingException &lt; StandardError</a></h3><!-- RDLabel: "class NumRu::Misc::HelpMessagingException < StandardError" -->
+<p>This is for your convenience. See the usage example below.</p>
+<h2><a name="label:5" id="label:5">Usage example</a></h2><!-- RDLabel: "Usage example" -->
+<p>Suppose that you introduce keyword arguments "flag" and "number"
+to the method "hoge" in a class/module Foo. It can be done as 
+follows:</p>
+<pre>require 'numru/misc'  # or, specifically, require 'numru/misc/keywordopt'
+include NumRu
+
+class Foo
+  @@opt_hoge = Misc::KeywordOpt.new(
+    ['flag',   false, 'whether or not ...'],
+    ['number', 1,     'number of ...'],
+    ['help',   false, 'show help message']
+  )
+  def hoge(regular_arg1, regular_arg2, options=nil)
+    opt = @@opt_hoge.interpret(options)
+    if opt['help']
+      puts @@opt_hoge.help
+      puts ' Current values='+opt.inspect
+      raise Misc::HelpMessagingException, '** show help message and raise **'
+    end
+    # do what you want below 
+    # (options are set in the Hash opt: opt['flag'] and opt['number'])
+  end
+end</pre>
+<p>Here, the options are defined in the class variable @@opt_hoge
+with option names, default values, and descriptions (for help 
+messaging). One can use the method hoge as follows:</p>
+<pre>foo = Foo.new
+...
+x = ...
+y = ...
+...
+foo.hoge( x, y, {'flag'=&gt;true, 'number'=&gt;10} )</pre>
+<p>Or equivalently,</p>
+<pre>foo.hoge( x, y, 'flag'=&gt;true, 'number'=&gt;10 )</pre>
+<p>because '{}' can be omitted here. </p>
+<p>Tails of options names can be shortened as long as unambiguous:</p>
+<pre>foo.hoge( x, y, 'fla'=&gt;true, 'num'=&gt;10 )</pre>
+<p>To show the help message, call</p>
+<pre>foo.hoge( x, y, 'help'=&gt;true )</pre>
+<p>This will cause the following help message printed with the 
+exception HelpMessagingException raised.</p>
+<pre>&lt;&lt; Description of options &gt;&gt;
+ option name =&gt; default value   description:
+  "flag" =&gt;     false   whether or not ...
+  "number" =&gt;   1       number of ...
+  "help" =&gt;     false   show help message
+Current values={"help"=&gt;true, "number"=&gt;1, "flag"=&gt;false}
+NumRu::Misc::HelpMessagingException: ** help messaging done **
+       from (irb):78:in "hoge"
+       from (irb):83</pre>
+<p>Do not affraid to write long descriptions. The help method  
+breaks lines nicely if they are long.</p>
+<h2><a name="label:6" id="label:6">Class methods</a></h2><!-- RDLabel: "Class methods" -->
+<dl>
+<dt><a name="label:7" id="label:7"><code>KeywordOpt.new( *<var>args</var> )</code></a></dt><!-- RDLabel: "KeywordOpt.new" -->
+<dd>
+<p>Constructor.</p>
+<p>ARGUMENTS</p>
+<ul>
+<li><p>args : (case 1) arrays of two or three elements: [option name, 
+      default value, description ], or [option name, default value]
+      if you do not want to write descriptions. Option names and 
+      descriptions must be String. (case 2) another KeywordOpt.
+      Cases 1 and 2 can be mixed. </p>
+<p>When case 2, a link to the other KeywordOpt is kept. Thus, change
+of values in it is reflected to the current one. However,
+the link is deleted if values are changed by <a href="#label:10">set</a>.</p></li>
+</ul>
+<p>RETURN VALUE</p>
+<ul>
+<li>a KeywordOpt object</li>
+</ul>
+<p>EXAMPLE</p>
+<ul>
+<li>case 1</li>
+</ul></dd>
+</dl>
+<pre>opt = Misc::KeywordOpt.new(
+  ['flag',   false, 'whether or not ...'],
+  ['help',   false, 'show help message']
+)</pre>
+<ul>
+<li><p>case 2</p>
+<pre>opt = Misc::KeywordOpt.new( optA, optB )</pre></li>
+<li>case 1 &amp; 2</li>
+</ul>
+<pre>opt = Misc::KeywordOpt.new(
+  ['flag',   false, 'whether or not ...'],
+  optA
+)</pre>
+<h2><a name="label:8" id="label:8">Methods</a></h2><!-- RDLabel: "Methods" -->
+<dl>
+<dt><a name="label:9" id="label:9"><code>interpret(<var>hash</var>)</code></a></dt><!-- RDLabel: "interpret" -->
+<dd>
+<p>Interprets a hash that specifies option values.</p>
+<p>ARGUMENTS</p>
+<ul>
+<li>hash (Hash or nil) : a hash with string keys matching option names 
+      (initializedwhen constructed). The matching is case sensitive and done
+      such that the tail of a option name can be omitted as long as 
+      unambiguous (for example, 'num' for 'number'). 
+      If the argument is nil, the current values are returned.
+      If there are two options like 'max' and 'maxval', to use 
+      a key 'max' (identical to the former paramer) is allowed, although
+      it matches 'maxval' as well. (Again 'ma' is regarded ambiguous.)</li>
+</ul>
+<p>RETURN VALUE</p>
+<ul>
+<li>a Hash containing the option values (default values overwritten
+      with hash).</li>
+</ul>
+<p>POSSIBLE EXCEPTION</p>
+<ul>
+<li>hash has a key that does not match any of the option names.</li>
+<li>hash has a key that is ambiguous</li>
+</ul></dd>
+<dt><a name="label:10" id="label:10"><code>set(<var>hash</var>)</code></a></dt><!-- RDLabel: "set" -->
+<dd>
+<p>Similar to <a href="#label:9">interpret</a> but changes internal values.</p>
+<p>ARGUMENTS</p>
+<ul>
+<li>hash (Hash) : see <a href="#label:9">interpret</a>. (Here, nil is not permitted though)</li>
+</ul>
+<p>RETURN VALUE</p>
+<ul>
+<li>a Hash containing the values replaced (the ones before calling this 
+      method)</li>
+</ul>
+<p>POSSIBLE EXCEPTION</p>
+<ul>
+<li>the argument is not a Hash</li>
+<li>others are same as in <a href="#label:9">interpret</a></li>
+</ul></dd>
+<dt><a name="label:11" id="label:11"><code>help</code></a></dt><!-- RDLabel: "help" -->
+<dd>
+<p>Returns a help message</p>
+<p>RETURN VALUE</p>
+<ul>
+<li>a String describing the option names, default values, and descriptions</li>
+</ul></dd>
+<dt><a name="label:12" id="label:12"><code>[<var>key</var>]</code></a></dt><!-- RDLabel: "[]" -->
+<dd>
+<p>Returns a value associated with the key (exact matching unlike interpret)</p></dd>
+</dl>
+<h1><a name="label:13" id="label:13">class NumRu::Misc::KeywordOptAutoHelp &lt; NumRu::Misc::KeywordOpt</a></h1><!-- RDLabel: "class NumRu::Misc::KeywordOptAutoHelp < NumRu::Misc::KeywordOpt" -->
+<p>Same as <a href="#label:1">class NumRu::Misc::KeywordOpt</a>, but the method <a href="#label:9">interpret</a>
+shows a help message and raise an exception if option 'help' is provided
+as an argument and is not nil or false 
+(<code>NumRu::Misc::HelpMessagingException &lt; StandardError</code>) 
+or if the arguments cannot be interpreted correctly (<code>ArgumentError</code>).
+Option 'help' is automatically defined, so you do not have to define it
+yourself.</p>
+
+</body>
+</html>

data/doc/md_iterators.html

@@ -0,0 +1,86 @@
+<?xml version="1.0" ?>
+<!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">
+<head>
+<title>lib/numru/misc/md_iterators.rb</title>
+</head>
+<body>
+<h1><a name="label:0" id="label:0">module NumRu::Misc::MD_Iterators</a></h1><!-- RDLabel: "module NumRu::Misc::MD_Iterators" -->
+<p>A Mixin.
+To be included in a class with multi-dimension indexing support
+(such as NArray).</p>
+<h2><a name="label:1" id="label:1">Index</a></h2><!-- RDLabel: "Index" -->
+<ul>
+<li><a href="#label:3">each_subary_at_dims</a></li>
+<li><a href="#label:4">each_subary_at_dims_with_index</a></li>
+</ul>
+<h2><a name="label:2" id="label:2">Methods</a></h2><!-- RDLabel: "Methods" -->
+<dl>
+<dt><a name="label:3" id="label:3"><code>each_subary_at_dims( *<var>dims</var> )</code></a></dt><!-- RDLabel: "each_subary_at_dims" -->
+<dd>
+<p>Iterator for each sub-array (not each element) specified by dimensions.</p>
+<p>ARGUMENT</p>
+<ul>
+<li><var>dims</var> (integers) : specifies subsets at dimensions 
+      specified here with the beginning-to-end selection. 
+      For example, [0, 1] to specify the first 2 dimensions 
+      (subsets will be 2D then), and [2] to specify the 3rd 
+      dimension (subsets will be 1D). Duplication has no effect, 
+      so [0,0] and [0] are the same. Also, its order has no effect.
+      See EXAMPLE below for more.</li>
+</ul>
+<p>RETURN VALUE</p>
+<ul>
+<li>self</li>
+</ul>
+<p>POSSIBLE EXCEPTIONS</p>
+<ul>
+<li>exception is raised if ( dims.min&lt;0 || dims.max&gt;=self.rank ).</li>
+</ul>
+<p>EXAMPLE</p>
+<ul>
+<li><p>Suppose that you want to do something with 2D sub-arrays in a
+      multi-dimension NArray. First, you include this module as follows:</p>
+<pre>require "narray"
+class NArray
+   include NumRu::Misc::MD_Iterators
+end</pre>
+<p>And prepare the array if you have not (here, it is 4D):</p>
+<pre>na = NArray.int(10,2,5,2).indgen!</pre>
+<p>Then you do the job like this:</p>
+<pre>na.each_subary_at_dims(0,2){ |sub|
+  ...  # do whatever with sub
+}</pre>
+<p>This is equivalent to the following:</p>
+<pre>(0...na.shape[3]).each{|j|
+  (0...na.shape[1]).each{|i|
+    sub = na[0..-1, i, 0..-1, j]
+    ...  # do whatever with sub
+  }
+}</pre>
+<p>Note that the loop must be nested 3 times when na is a 5D array,
+if the latter approach is used. On the other hand, it will still 
+require the same single loop with the former.      </p></li>
+</ul></dd>
+<dt><a name="label:4" id="label:4"><code>each_subary_at_dims_with_index( *<var>dims</var> )</code></a></dt><!-- RDLabel: "each_subary_at_dims_with_index" -->
+<dd>
+<p>Like <a href="#label:3">each_subary_at_dims</a> but the block takes two arguments:
+subset and the subset specifier (index).</p>
+<p>EXAMPLE</p>
+<ul>
+<li><p>Suppose the example above in <a href="#label:3">each_subary_at_dims</a> (EXAMPLE).
+      And suppose that you want to overwrite na with the result
+      you get. You can do it like this:</p>
+<pre>na.each_subary_at_dims_with_index(0,2){ |sub,idx|
+  result = (sub + 10) / 2
+  na[*idx] = result
+}</pre>
+<p>Here, idx is an Array to be fed in the []= or [] methods
+with asterisk (ungrouping).</p></li>
+</ul></dd>
+</dl>
+
+</body>
+</html>