inochi 0.1.0 → 0.2.0

data/bin/inochi

@@ -1,6 +1,12 @@
 #!/usr/bin/ruby -w
 #
-# Progress indicators:
+# Generates a project scaffold using the given information.
+#
+# Existing files are backed up and NOT overwritten.  It is your
+# responsibility to merge changes between the existing files and
+# the newly generated files.  See the --merge option for details.
+#
+# This tool announces its progress as it runs, using these indicators:
 #
 #   create:   A file is being created because it does not exist.
 #
@@ -14,7 +20,19 @@
 #
 # Usage:
 #
-#   inochi [Option...] ModuleName
+#   inochi [Options] ProjectName [ProgramName]
+#
+#
+#   ProjectName:  Name of your project, which will be normalized
+#                 into the naame of a Ruby module that will serve
+#                 as a namespace for all code in your project.
+#
+#   ProgramName:  (Optional) Name of the main project executable,
+#                 which also serves as the name of the generated
+#                 project directory and the main project library.
+#
+#
+# Options:
 #
 
 # command line
@@ -63,21 +81,25 @@
   end
 
 # program body
-  target = ARGV.shift or
-    raise ArgumentError, "Project was not specified.  Run `#{$0} -h` for help."
+  project_name, program_name = ARGV
+
+  unless project_name
+    raise ArgumentError, "ProjectName must be given.  Run `#{$0} -h` for help."
+  end
 
-  project = Inochi.calc_project_symbol(target)
-  program = Inochi.calc_program_name(project)
-  version = '0.0.0'
-  release = Time.now.strftime('%F')
+  project_symbol = Inochi.calc_project_symbol(project_name)
+  program_name ||= Inochi.calc_program_name(project_symbol)
 
-  preamble = %{
+  project_version = '0.0.0'
+  project_release = Time.now.strftime('%F')
+
+  inochi_preamble = %{
     require 'rubygems'
     gem '#{Inochi::PROGRAM}', '#{Inochi::VERSION.requirement}'
     require '#{Inochi::PROGRAM}'
   }.strip
 
-  create "#{program}/LICENSE", %{
+  create "#{program_name}/LICENSE", %{
     Copyright #{Time.now.year} Your Name <your@email.here>
 
     Permission to use, copy, modify, and/or distribute this software for any
@@ -93,10 +115,10 @@
     OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
   }
 
-  create "#{program}/Rakefile", %{
-    #{preamble}
+  create "#{program_name}/Rakefile", %{
+    #{inochi_preamble}
 
-    Inochi.rake #{project.inspect} do |gem|
+    Inochi.rake #{project_symbol.inspect} do |gem|
       # TODO: additional gem configuration.
       # NOTE: this is completely optional!
       #
@@ -105,20 +127,31 @@
     end
   }
 
-  bin_file = "#{program}/bin/#{program}"
+  bin_file = "#{program_name}/bin/#{program_name}"
   create bin_file, %{
     #!/usr/bin/ruby -w
     #
     # TODO: Explain the command-line usage of this program here.
     #
+    #
     # Usage:
     #
-    #   #{program} [Option...] Arg1 Arg2 Arg3...
+    #   #{program_name} [Options] Param1 Param2 Param3...
+    #
+    #
+    #   Param1:   Description for the first parameter.
+    #
+    #   Param2:   Description for the second parameter.
+    #
+    #   Param3:   Description for the third parameter.
+    #
+    #
+    # Options:
     #
 
-    #{preamble}
+    #{inochi_preamble}
 
-    options = Inochi.main #{project.inspect} do
+    options = Inochi.main #{project_symbol.inspect} do
       # TODO: define command-line options here.
       #       see http://trollop.rubyforge.org/
       #
@@ -132,14 +165,14 @@
   }
   FileUtils.chmod 0755, bin_file
 
-  create "#{program}/lib/#{program}.rb", %{
-    #{preamble}
+  create "#{program_name}/lib/#{program_name}.rb", %{
+    #{inochi_preamble}
 
-    Inochi.init #{project.inspect},
-      :project => '#{target}',
-      :version => '#{version}',
-      :release => '#{release}',
-      :website => 'http://#{program}.rubyforge.org',
+    Inochi.init #{project_symbol.inspect},
+      :project => '#{project_name}',
+      :version => '#{project_version}',
+      :release => '#{project_release}',
+      :website => 'http://#{program_name}.rubyforge.org',
       :tagline => 'TODO: put a single line description of your project here.',
       :require => {
         # TODO: list gems required by your project here.
@@ -153,8 +186,23 @@
       }
   }
 
-  create "#{program}/doc/index.erb", %{
-    <% Inochi.book #{project.inspect}, self %>
+  create "#{program_name}/test/#{program_name}.rb", %{
+    describe #{project_symbol} do
+      it 'has inochi' do
+        assert #{project_symbol}.const_defined? :INOCHI
+
+        #{project_symbol}::INOCHI.each do |param, value|
+          const = param.to_s.upcase
+
+          assert #{project_symbol}.const_defined? const
+          #{project_symbol}.const_get(const).must_equal value
+        end
+      end
+    end
+  }
+
+  create "#{program_name}/doc/index.erb", %{
+    <% Inochi.book #{project_symbol.inspect}, self %>
 
     <%# include intro.erb #%>
     <%# include setup.erb #%>
@@ -163,12 +211,12 @@
     <%# include history.erb #%>
   }
 
-  create "#{program}/doc/intro.erb", %{
+  create "#{program_name}/doc/intro.erb", %{
     <% chapter "Introduction" do %>
       <% project_summary do %>
         > TODO: explain the purpose of your project
 
-        ****<%= $project %>**** is a __________ that __________.
+        **<%= $project %>** is a __________ that __________.
       <% end %>
 
       > TODO: explain why your project is important
@@ -249,15 +297,15 @@
     <% end %>
   }
 
-  create "#{program}/doc/setup.erb", %{
+  create "#{program_name}/doc/setup.erb", %{
     <% chapter "Setup" do %>
       <% section "Requirements" do %>
         Your system needs the following software to run **<%= $project %>**.
 
-        | Software                        | Description               | Notes                               |
-        | --------                        | -----------               | -----                               |
-        | [Ruby](http://ruby-lang.org)    | Ruby language interpreter | Version #{RUBY_VERSION} is required. |
-        | [RubyGems](http://rubygems.org) | Ruby packaging system     | Version #{`gem --version`.chomp} is required. |
+        | Software                        | Description               | Notes                                        |
+        | --------                        | -----------               | -----                                        |
+        | [Ruby](http://ruby-lang.org)    | Ruby language interpreter | Version #{RUBY_VERSION} is required.         |
+        | [RubyGems](http://rubygems.org) | Ruby packaging system     | Version #{Gem::RubyGemsVersion} is required. |
       <% end %>
 
       <% section "Installation" do %>
@@ -308,13 +356,13 @@
     <% end %>
   }
 
-  create "#{program}/doc/theory.erb", %{
+  create "#{program_name}/doc/theory.erb", %{
     <% chapter "Theory of operation" do %>
       > TODO: explain how your project does what it does
     <% end %>
   }
 
-  create "#{program}/doc/usage.erb", %{
+  create "#{program_name}/doc/usage.erb", %{
     <% chapter "Usage" do %>
       <% section "Command-line interface" do %>
         When you run this command:
@@ -323,7 +371,7 @@
 
         You will see this output:
 
-        <pre><%= verbatim `ruby bin/\#{$program} --help` %></pre>
+        <pre><%= verbatim `ruby bin/\#{$program_name} --help` %></pre>
 
         > TODO: explain the command-line arguments
       <% end %>
@@ -343,7 +391,7 @@
     <% end %>
   }
 
-  create "#{program}/doc/history.erb", %{
+  create "#{program_name}/doc/history.erb", %{
     <% chapter "History" do %>
       > TODO: put a brief history about your project here
 
@@ -351,7 +399,7 @@
         > TODO: put release notes for your project
         >       here -- newest first, oldest last.
 
-        <% section "Version #{version} (#{release})" do %>
+        <% section "Version #{project_version} (#{project_release})" do %>
           > TODO: write a short summary of the changes in this release
 
           This release changes __________, adds __________, and fixes __________.

data/doc/api/Inochi.html

@@ -241,48 +241,48 @@ The eRuby template which serves as the documentation for the project.
           <pre class="lines">
 
 
-910
-911
-912
-913
-914
-915
-916
-917
-918
-919
-920
-921
-922
-923
-924
-925
-926
-927
-928
-929
-930
-931
-932
-933
-934
-935
-936
-937
-938
-939
-940
-941
-942
-943
-944
-945
-946
-947
-948</pre>
+951
+952
+953
+954
+955
+956
+957
+958
+959
+960
+961
+962
+963
+964
+965
+966
+967
+968
+969
+970
+971
+972
+973
+974
+975
+976
+977
+978
+979
+980
+981
+982
+983
+984
+985
+986
+987
+988
+989</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 910</span>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 951</span>
 
 <span class='def def kw'>def</span> <span class='book identifier id'>book</span> <span class='project_symbol identifier id'>project_symbol</span><span class='comma token'>,</span> <span class='book_template identifier id'>book_template</span>
   <span class='project_module identifier id'>project_module</span> <span class='assign token'>=</span> <span class='fetch_project_module identifier id'>fetch_project_module</span><span class='lparen token'>(</span><span class='project_symbol identifier id'>project_symbol</span><span class='rparen token'>)</span>
@@ -361,12 +361,12 @@ project name fully in lowercase.
           <pre class="lines">
 
 
-954
-955
-956</pre>
+995
+996
+997</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 954</span>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 995</span>
 
 <span class='def def kw'>def</span> <span class='calc_program_name identifier id'>calc_program_name</span> <span class='project_symbol identifier id'>project_symbol</span>
   <span class='camel_to_snake_case identifier id'>camel_to_snake_case</span><span class='lparen token'>(</span><span class='project_symbol identifier id'>project_symbol</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='downcase identifier id'>downcase</span>
@@ -408,13 +408,13 @@ Calculates the name of the project module from the given project name.
           <pre class="lines">
 
 
-961
-962
-963
-964</pre>
+1002
+1003
+1004
+1005</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 961</span>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 1002</span>
 
 <span class='def def kw'>def</span> <span class='calc_project_symbol identifier id'>calc_project_symbol</span> <span class='project_name identifier id'>project_name</span>
   <span class='name identifier id'>name</span> <span class='assign token'>=</span> <span class='project_name identifier id'>project_name</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span><span class='dot token'>.</span><span class='gsub identifier id'>gsub</span><span class='lparen token'>(</span><span class='regexp val'>/\W+/</span><span class='comma token'>,</span> <span class='string val'>'_'</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='squeeze identifier id'>squeeze</span><span class='lparen token'>(</span><span class='string val'>'_'</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='gsub identifier id'>gsub</span><span class='lparen token'>(</span><span class='regexp val'>/^_|_$/</span><span class='comma token'>,</span> <span class='string val'>''</span><span class='rparen token'>)</span>
@@ -457,22 +457,22 @@ Transforms the given input from CamelCase to snake_case.
           <pre class="lines">
 
 
-969
-970
-971
-972
-973
-974
-975
-976
-977
-978
-979
-980
-981</pre>
+1010
+1011
+1012
+1013
+1014
+1015
+1016
+1017
+1018
+1019
+1020
+1021
+1022</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 969</span>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 1010</span>
 
 <span class='def def kw'>def</span> <span class='camel_to_snake_case identifier id'>camel_to_snake_case</span> <span class='input identifier id'>input</span>
   <span class='input identifier id'>input</span> <span class='assign token'>=</span> <span class='input identifier id'>input</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span><span class='dot token'>.</span><span class='dup identifier id'>dup</span>
@@ -1050,8 +1050,9 @@ Provides Rake tasks for packaging, publishing, and announcing your project.
 their contact information) is added to the project module.
 
 <p>
-This information is extracted from copyright notices in the project license
-file. NOTE that the first copyright notice must correspond to the primary
+Unless this information is supplied via the :authors option, it is
+automatically extracted from copyright notices in the project license file,
+where the first copyright notice is expected to correspond to the primary
 project maintainer.
 </p>
 <p>
@@ -1102,6 +1103,12 @@ project.
 Additional method parameters, which are all optional:
 </p>
 <dl>
+<dt>Array</dt><dd>:authors =&gt; A list of project authors and their contact information.
+This list must have the form &quot;[[name, info]]&quot; where
+&quot;name&quot; is the name of a project author and &quot;info&quot; is
+their contact information.
+
+</dd>
 <dt>String</dt><dd>:license_file =&gt; Path (relative to the main project directory which
 contains the project Rakefile) to the file which contains the project
 license.
@@ -1211,12 +1218,6 @@ the gem specification
           <pre class="lines">
 
 
-302
-303
-304
-305
-306
-307
 308
 309
 310
@@ -1784,10 +1785,51 @@ the gem specification
 872
 873
 874
-875</pre>
+875
+876
+877
+878
+879
+880
+881
+882
+883
+884
+885
+886
+887
+888
+889
+890
+891
+892
+893
+894
+895
+896
+897
+898
+899
+900
+901
+902
+903
+904
+905
+906
+907
+908
+909
+910
+911
+912
+913
+914
+915
+916</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 302</span>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 308</span>
 
 <span class='def def kw'>def</span> <span class='rake identifier id'>rake</span> <span class='project_symbol identifier id'>project_symbol</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='semicolon token'>;</span><span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='gem_config identifier id'>gem_config</span>
   <span class='program_file identifier id'>program_file</span> <span class='assign token'>=</span> <span class='first_caller_file identifier id'>first_caller_file</span>
@@ -1795,24 +1837,24 @@ the gem specification
 
   <span class='comment val'># load the project module</span>
     <span class='program_name identifier id'>program_name</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='basename identifier id'>basename</span><span class='lparen token'>(</span><span class='program_home identifier id'>program_home</span><span class='rparen token'>)</span>
+    <span class='project_libs identifier id'>project_libs</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='string val'>'lib'</span><span class='comma token'>,</span> <span class='program_name identifier id'>program_name</span><span class='rparen token'>)</span>
 
-    <span class='require identifier id'>require</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='string val'>'lib'</span><span class='comma token'>,</span> <span class='program_name identifier id'>program_name</span><span class='rparen token'>)</span>
+    <span class='require identifier id'>require</span> <span class='project_libs identifier id'>project_libs</span>
     <span class='project_module identifier id'>project_module</span> <span class='assign token'>=</span> <span class='fetch_project_module identifier id'>fetch_project_module</span><span class='lparen token'>(</span><span class='project_symbol identifier id'>project_symbol</span><span class='rparen token'>)</span>
 
   <span class='comment val'># supply default options</span>
     <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:rubyforge_project</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='program_name identifier id'>program_name</span>
     <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:rubyforge_section</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='program_name identifier id'>program_name</span>
-    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:raa_project</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='program_name identifier id'>program_name</span>
-    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:license_file</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='string val'>'LICENSE'</span>
-    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:logins_file</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='ENV constant id'>ENV</span><span class='lbrack token'>[</span><span class='string val'>'HOME'</span><span class='rbrack token'>]</span><span class='comma token'>,</span> <span class='string val'>'.config'</span><span class='comma token'>,</span> <span class='string val'>'inochi'</span><span class='comma token'>,</span> <span class='string val'>'logins.yaml'</span><span class='rparen token'>)</span>
-    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:upload_delete</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='false false kw'>false</span>
-    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:upload_options</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='lbrack token'>[</span><span class='rbrack token'>]</span>
+    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:raa_project</span><span class='rbrack token'>]</span>       <span class='opasgn op'>||=</span> <span class='program_name identifier id'>program_name</span>
+    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:license_file</span><span class='rbrack token'>]</span>      <span class='opasgn op'>||=</span> <span class='string val'>'LICENSE'</span>
+    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:logins_file</span><span class='rbrack token'>]</span>       <span class='opasgn op'>||=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='ENV constant id'>ENV</span><span class='lbrack token'>[</span><span class='string val'>'HOME'</span><span class='rbrack token'>]</span><span class='comma token'>,</span> <span class='string val'>'.config'</span><span class='comma token'>,</span> <span class='string val'>'inochi'</span><span class='comma token'>,</span> <span class='string val'>'logins.yaml'</span><span class='rparen token'>)</span>
+    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:upload_delete</span><span class='rbrack token'>]</span>     <span class='opasgn op'>||=</span> <span class='false false kw'>false</span>
+    <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:upload_options</span><span class='rbrack token'>]</span>    <span class='opasgn op'>||=</span> <span class='lbrack token'>[</span><span class='rbrack token'>]</span>
 
   <span class='comment val'># add AUTHORS constant to the project module</span>
-    <span class='license identifier id'>license</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='read identifier id'>read</span><span class='lparen token'>(</span><span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:license_file</span><span class='rbrack token'>]</span><span class='rparen token'>)</span>
-
-    <span class='copyright_holders identifier id'>copyright_holders</span> <span class='assign token'>=</span>
-      <span class='license identifier id'>license</span><span class='dot token'>.</span><span class='scan identifier id'>scan</span><span class='lparen token'>(</span><span class='regexp val'>/Copyright.*?\d+\s+(.*)/</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='flatten identifier id'>flatten</span><span class='dot token'>.</span>
+    <span class='copyright_holders identifier id'>copyright_holders</span> <span class='assign token'>=</span> <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:authors</span><span class='rbrack token'>]</span> <span class='orop op'>||</span>
+      <span class='File constant id'>File</span><span class='dot token'>.</span><span class='read identifier id'>read</span><span class='lparen token'>(</span><span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:license_file</span><span class='rbrack token'>]</span><span class='rparen token'>)</span><span class='dot token'>.</span>
+      <span class='scan identifier id'>scan</span><span class='lparen token'>(</span><span class='regexp val'>/Copyright.*?\d+\s+(.*)/</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='flatten identifier id'>flatten</span><span class='dot token'>.</span>
       <span class='map identifier id'>map</span> <span class='lbrace token'>{</span><span class='bitor op'>|</span><span class='s identifier id'>s</span><span class='bitor op'>|</span> <span class='lparen token'>(</span><span class='s identifier id'>s</span> <span class='match op'>=~</span> <span class='regexp val'>/\s*&lt;(.*?)&gt;/</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='lbrack token'>[</span><span class='$` back_ref id'>$`</span><span class='comma token'>,</span> <span class='$1 nth_ref id'>$1</span><span class='rbrack token'>]</span> <span class='colon op'>:</span> <span class='lbrack token'>[</span><span class='s identifier id'>s</span><span class='comma token'>,</span> <span class='string val'>''</span><span class='rbrack token'>]</span> <span class='rbrace token'>}</span>
 
     <span class='project_module identifier id'>project_module</span><span class='dot token'>.</span><span class='const_set identifier id'>const_set</span> <span class='symbol val'>:AUTHORS</span><span class='comma token'>,</span> <span class='copyright_holders identifier id'>copyright_holders</span>
@@ -1823,6 +1865,38 @@ the gem specification
     <span class='Rake constant id'>Rake</span><span class='colon2 op'>::</span><span class='Task constant id'>Task</span><span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='instance_variable_set identifier id'>instance_variable_set</span> <span class='symbol val'>:@comment</span><span class='comma token'>,</span> <span class='nil nil kw'>nil</span>
   <span class='end end kw'>end</span>
 
+  <span class='comment val'># testing</span>
+    <span class='desc identifier id'>desc</span> <span class='string val'>'Run all unit tests.'</span>
+    <span class='task identifier id'>task</span> <span class='symbol val'>:test</span> <span class='do do kw'>do</span>
+      <span class='ruby identifier id'>ruby</span> <span class='string val'>'-w'</span><span class='comma token'>,</span> <span class='string val'>'-I.'</span><span class='comma token'>,</span> <span class='string val'>'-Ilib'</span><span class='comma token'>,</span> <span class='string val'>'-r'</span><span class='comma token'>,</span> <span class='program_name identifier id'>program_name</span><span class='comma token'>,</span> <span class='string val'>'-e'</span><span class='comma token'>,</span> <span class='string val'>%q{
+        # set title of test suite
+        $0 = File.basename(Dir.pwd)
+
+        require 'minitest/unit'
+        require 'minitest/spec'
+        require 'minitest/mock'
+        MiniTest::Unit.autorun
+
+        Dir['test/**/*.rb'].sort.each do |test|
+          unit = test.sub('test/', 'lib/')
+
+          if File.exist? unit
+            # strip file extension because require()
+            # does not normalize its input and it
+            # will think that the two paths (with &amp;
+            # without file extension) are different
+            unit_path = unit.sub(/\.rb$/, '').sub('lib/', '')
+            test_path = test.sub(/\.rb$/, '')
+
+            require unit_path
+            require test_path
+          else
+            warn &quot;Skipped test #{test.inspect} because it lacks a corresponding #{unit.inspect} unit.&quot;
+          end
+        end
+      }</span>
+    <span class='end end kw'>end</span>
+
   <span class='comment val'># documentation</span>
     <span class='desc identifier id'>desc</span> <span class='string val'>'Build all documentation.'</span>
     <span class='task identifier id'>task</span> <span class='symbol val'>:doc</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='dstring node'>%w[ doc:api doc:man ]</span>
@@ -1924,9 +1998,9 @@ the gem specification
           <span class='File constant id'>File</span><span class='dot token'>.</span><span class='delete identifier id'>delete</span> <span class='tmp_file identifier id'>tmp_file</span>
         <span class='end end kw'>end</span>
 
-        <span class='comment val'># improve readability of list items that span multiple</span>
-        <span class='comment val'># lines by adding a blank line between such items</span>
-        <span class='text identifier id'>text</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span> <span class='regexp val'>%r{^( *[^\*\s].*)(\r?\n)( *\* \S)}</span><span class='comma token'>,</span> <span class='string val'>'\1\2\2\3'</span>
+        <span class='comment val'># improve readability of list items</span>
+        <span class='comment val'># by adding a blank line between them</span>
+        <span class='text identifier id'>text</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span> <span class='regexp val'>%r{(\r?\n)( +\* \S)}</span><span class='comma token'>,</span> <span class='string val'>'\1\1\2'</span>
 
         <span class='text identifier id'>text</span>
       <span class='end end kw'>end</span>
@@ -1972,6 +2046,9 @@ the gem specification
           <span class='comment val'># remove heading navigation menus</span>
           <span class='ann_html identifier id'>ann_html</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span> <span class='regexp val'>%r{&lt;div class=&quot;nav&quot;[^&gt;]*&gt;(.*?)&lt;/div&gt;}</span><span class='comma token'>,</span> <span class='string val'>''</span>
 
+          <span class='comment val'># remove latex-style heading numbers</span>
+          <span class='ann_html identifier id'>ann_html</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span> <span class='regexp val'>%r&quot;(&lt;(h\d)[^&gt;]*&gt;).+?(?:&amp;nbsp;){2}(.+?)(&lt;/\2&gt;)&quot;</span><span class='m identifier id'>m</span><span class='comma token'>,</span> <span class='string val'>'\1\3\4'</span>
+
           <span class='ann_html identifier id'>ann_html</span> <span class='assign token'>=</span> <span class='resolve_html_links identifier id'>resolve_html_links</span><span class='lbrack token'>[</span><span class='ann_html identifier id'>ann_html</span><span class='rbrack token'>]</span>
         <span class='end end kw'>end</span>
       <span class='end end kw'>end</span>