inochi 1.0.0 → 1.1.0

data/bin/inochi

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby -w
+#!/usr/bin/env ruby
 #
 # Generates a project scaffold using the given information.
 #
@@ -36,8 +36,8 @@
 #
 
 #--
-# Copyright 2009 Suraj N. Kurapati
-# See the LICENSE file for details.
+# Copyright protects this work.
+# See LICENSE file for details.
 #++
 
 # command line
@@ -143,7 +143,7 @@
 
   bin_file = "#{program_name}/bin/#{program_name}"
   create bin_file, %{
-    #!/usr/bin/ruby -w
+    #!/usr/bin/env ruby
     #
     # TODO: Explain the command-line usage of this program here.
     #
@@ -189,7 +189,17 @@
       :website => 'http://#{program_name}.rubyforge.org',
       :tagline => 'put a single line description of your project here',
       :require => {
-        # TODO: list gems required by your project here.
+        # TODO: list gems required by your project during runtime here.
+        # NOTE: this is completely optional!
+        #
+        # example: if your project needs version 9.9.9 of the 'foo' gem:
+        # 'foo' => '9.9.9',
+        #
+        # example: if any version of a gem is acceptable then:
+        # 'foo' => nil,
+      },
+      :develop => {
+        # TODO: list gems required by your project during development here.
         # NOTE: this is completely optional!
         #
         # example: if your project needs version 9.9.9 of the 'foo' gem:
@@ -221,6 +231,7 @@
   }
 
   create "#{program_name}/doc/index.erb", %{
+
     % Inochi.book #{project_symbol.inspect}, self
 
     %+ "intro.erb"
@@ -228,19 +239,37 @@
     %+ "theory.erb"
     %+ "usage.erb"
     %+ "history.erb"
+
   }
 
   create "#{program_name}/doc/intro.erb", %{
+
     % api_url = './api/index.html'
-    % repo_url = 'http://github.com/__________/' + $program
-    % repo_scm = '[Git](http://git-scm.com)'
+    % src_url = "http://github.com/__________/\#{$program}"
+    % src_scm = '[Git](http://git-scm.com)'
+
 
     %|chapter "Introduction"
+
+
       %|project
+
         > TODO: explain the purpose of your project
 
         <%= $project %> is a __________ that __________.
 
+
+      * <%= xref "History", "What's new?" %> --- history of project releases.
+      * [Source code](<%= src_url %>) --- obtain via <%= src_scm %> or browse online.
+      * [API reference](<%= api_url %>) --- documentation for source code.
+      * [Project home](<%= $website %>) --- the <%= $project %> project home page.
+
+      To get help or provide feedback, simply
+      %= xref "License", "contact the author(s)."
+
+
+      %|section "Features"
+
         > TODO: explain why your project is important
 
         <%= $project %> is exciting because:
@@ -248,81 +277,46 @@
         * Its core contains less than __________ lines of code.
         * It __________.
 
-        > TODO: explain why your project is better than its competitors
 
-        These features distinguish <%= $project %> from the competition:
-        * [competitor 1](http://)
-        * [competitor 2](http://)
-        * [competitor 3](http://)
+      %|section "Etymology"
 
-      %|paragraph "Etymology"
         > TODO: explain the meaning of the name of your project
 
-      %|section "Logistics"
-        * <%= xref "History", "Release notes" %> --- history of project releases.
-        * [Source code](<%= repo_url %>) --- obtain via <%= repo_scm %> or browse online.
-        * [API reference](<%= api_url %>) --- documentation for source code.
-        * [Project home](<%= $website %>) --- the <%= $project %> project home page.
-
-        To get help or provide feedback, simply
-        <%= xref "License", "contact the author(s)" %>.
-
-        %|paragraph "Version numbers"
-          <%= $project %> releases are numbered in *major.minor.patch*
-          form according to the [RubyGems rational versioning
-          policy](http://www.rubygems.org/read/chapter/7), which
-          can be summarized thus:
-
-          <table markdown="1">
-            <thead>
-              <tr>
-                <td rowspan="2">What increased in the version number?</td>
-                <td colspan="3">The increase indicates that the release:</td>
-              </tr>
-              <tr>
-                <th>Is backward compatible?</th>
-                <th>Has new features?</th>
-                <th>Has bug fixes?</th>
-              </tr>
-            </thead>
-            <tbody>
-              <tr>
-                <th>major</th>
-                <td style="background-color: #FFE4E1;">No</td>
-                <td>Yes</td>
-                <td>Yes</td>
-              </tr>
-              <tr>
-                <th>minor</th>
-                <td>Yes</td>
-                <td>Yes</td>
-                <td>Yes</td>
-              </tr>
-              <tr>
-                <th>patch</th>
-                <td>Yes</td>
-                <td style="background-color: #FFE4E1;">No</td>
-                <td>Yes</td>
-              </tr>
-            </tbody>
-          </table>
-
-        %|paragraph "License"
-          %< "../LICENSE"
+
+      %|section "License"
+
+        %< "../LICENSE"
+
 
       %|section "Credits"
+
         > TODO: give attribution to your predecessors and contributors
 
-        <%= $project %> is made possible by
-        <%= xref "History", "contributions" %>
+        %= $project
+        is made possible by
+        %= xref "History", "contributions"
         from users like you:
 
         %< "../CREDITS"
+
+
+      %|section "Related works"
+
+        > TODO: list other projects which are similar to yours
+
+        * [project 1](http://)
+        * [project 2](http://)
+        * [project 3](http://)
+
   }
 
   create "#{program_name}/doc/setup.erb", %{
+
     %|chapter "Setup"
+
+
       %|section "Requirements"
+
         Your system needs the following software to run <%= $project %>.
 
         | Software                        | Description               | Notes                                        |
@@ -330,7 +324,9 @@
         | [Ruby](http://ruby-lang.org)    | Ruby language interpreter | Version #{RUBY_VERSION} has been tested successfully. |
         | [RubyGems](http://rubygems.org) | Ruby packaging system     | Version #{Gem::RubyGemsVersion} or newer is required. |
 
+
       %|section "Installation"
+
         You can install <%= $project %> by running this command:
 
             gem install <%= $program %>
@@ -344,9 +340,12 @@
         <pre><%= verbatim `ruby bin/\#{$program} --version` %></pre>
 
         If you do not see such output, you may
-        <%= xref "License", "ask the author(s)" %> for help.
+        %= xref "License", "ask the author(s)"
+        for help.
+
+
+      %|section "Package contents"
 
-      %|section "Manifest"
         You will see the following items inside <%= $project %>'s installation
         directory, whose path you can determine by running this command:
 
@@ -377,16 +376,65 @@
         * <tt>LICENSE</tt> --- copyright notice and legal conditions.
 
         * <tt>CREDITS</tt> --- attribution of project contributors.
+
+
+      %|section "Version numbers"
+
+        <%= $project %> releases are numbered in *major.minor.patch*
+        form according to the [RubyGems rational versioning
+        policy](http://www.rubygems.org/read/chapter/7), which
+        can be summarized as follows:
+
+        <table markdown="1">
+          <thead>
+            <tr>
+              <td rowspan="2">What increased in the version number?</td>
+              <td colspan="3">The increase indicates that the release:</td>
+            </tr>
+            <tr>
+              <th>Is backward compatible?</th>
+              <th>Has new features?</th>
+              <th>Has bug fixes?</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <th>major</th>
+              <td style="background-color: #FFE4E1;">No</td>
+              <td>Yes</td>
+              <td>Yes</td>
+            </tr>
+            <tr>
+              <th>minor</th>
+              <td>Yes</td>
+              <td>Yes</td>
+              <td>Yes</td>
+            </tr>
+            <tr>
+              <th>patch</th>
+              <td>Yes</td>
+              <td style="background-color: #FFE4E1;">No</td>
+              <td>Yes</td>
+            </tr>
+          </tbody>
+        </table>
+
   }
 
   create "#{program_name}/doc/theory.erb", %{
+
     %|chapter "Theory of operation"
+
       > TODO: explain how your project does what it does
   }
 
   create "#{program_name}/doc/usage.erb", %{
+
     %|chapter "Usage"
+
+
       %|section "Command-line interface"
+
         When you run this command:
 
             <%= $program %> --help
@@ -397,32 +445,48 @@
 
         > TODO: explain the command-line arguments
 
+
       %|section "Ruby library interface"
+
         > TODO: explain how to use your project's Ruby library
         >       from inside another Ruby program or library
 
-      %|section "Tutorial"
-        This tutorial shows how <%= $project %> is used to __________.
+
+      %|section "General walkthrough"
+
+        This tutorial walks you through the typical usage of <%= $project %>.
 
         > TODO: give examples for doing common tasks
 
-      > TODO: explain how to do more (advanced) things
+
+      %|section "Specific topics"
+
+        > TODO: explain how to do more advanced / specific things
+
   }
 
   create "#{program_name}/doc/history.erb", %{
+
     %|chapter "History"
+
       > TODO: put a brief history about your project here
 
+
       %|history
+
         > TODO: put release notes for your project
         >       here -- newest first, oldest last.
 
+
         %|section "Version #{project_version} (#{project_release})"
+
           > TODO: write a short summary of the changes in this release
 
           This release changes __________, adds __________, and fixes __________.
 
+
           %|paragraph "Thank you"
+
             > TODO: list everyone who contributed to this release
 
             * __________ contributed __________
@@ -431,7 +495,9 @@
 
             * __________ helped to __________
 
+
           %|paragraph "Incompatible changes"
+
             > TODO: list all backward-incompatible changes in this release
 
             * __________ has been __________ to __________ ---contributor name
@@ -440,7 +506,9 @@
 
             * __________ ---contributor name
 
+
           %|paragraph "New features"
+
             > TODO: list new features added in this release
 
             * __________ ---contributor name
@@ -449,7 +517,9 @@
 
             * __________ ---contributor name
 
+
           %|paragraph "Bug fixes"
+
             > TODO: describe all bugs that are fixed in this release
 
             * __________ was __________ ---contributor name
@@ -458,7 +528,9 @@
 
             * __________ did __________ ---contributor name
 
+
           %|paragraph "Housekeeping"
+
             > TODO: list the refactorings, clean ups, and other
             >       improvements that were done for this release
 
@@ -467,4 +539,5 @@
             * __________ ---contributor name
 
             * __________ ---contributor name
+
   }

data/doc/api/classes/Array.html

@@ -125,7 +125,7 @@ from this list.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000002_source')" id="l_M000002_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L70" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L70" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000002_source" class="dyn-source">
@@ -165,7 +165,7 @@ Returns all possible combinations of all possible lengths.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000003_source')" id="l_M000003_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L84" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L84" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000003_source" class="dyn-source">
@@ -209,7 +209,7 @@ from this list.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000000_source')" id="l_M000000_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L20" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L20" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000000_source" class="dyn-source">
@@ -267,7 +267,7 @@ Returns all possible enumerations of all possible lengths.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000001_source')" id="l_M000001_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L52" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L52" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000001_source" class="dyn-source">
@@ -311,7 +311,7 @@ from this list.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000004_source')" id="l_M000004_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L102" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L102" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000004_source" class="dyn-source">
@@ -351,7 +351,7 @@ Returns all possible permutations of all possible lengths.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000005_source')" id="l_M000005_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/util/combo.rb#L116" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util/combo.rb#L116" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000005_source" class="dyn-source">

data/doc/api/classes/File.html

@@ -91,7 +91,7 @@ Writes the given content to the given file.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/61f28653cea6fab1bfd8cffb07a666c236b243be/lib/inochi/util.rb#L96" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/util.rb#L96" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000021_source" class="dyn-source">

data/doc/api/classes/Inochi.html

@@ -171,7 +171,7 @@ project.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000011_source')" id="l_M000011_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/5f65225f952717327ab0d21f371307dcd335f34c/lib/inochi/book.rb#L42" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/book.rb#L42" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000011_source" class="dyn-source">
@@ -350,7 +350,7 @@ The newly configured project module.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000022_source')" id="l_M000022_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/61f28653cea6fab1bfd8cffb07a666c236b243be/lib/inochi/init.rb#L107" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/94ea085869f0eab9b04917d057bdae5b64157781/lib/inochi/init.rb#L107" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000022_source" class="dyn-source">
@@ -462,7 +462,7 @@ Returns the result of Trollop::options().
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000010_source')" id="l_M000010_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/766b14740d2fffe75a0e4a11fd807c391e1f0c66/lib/inochi/main.rb#L36" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/c7a54935a163d0b7a35beac0f54ed38c29c3e358/lib/inochi/main.rb#L36" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000010_source" class="dyn-source">
@@ -505,7 +505,7 @@ Returns the result of Trollop::options().
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:manual</span>]
       <span class="ruby-identifier">require</span> <span class="ruby-value str">'launchy'</span>
 
-      <span class="ruby-identifier">manual</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">INSTALL</span>, <span class="ruby-value str">'doc'</span>, <span class="ruby-value str">'index.xhtml'</span>)
+      <span class="ruby-identifier">manual</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">INSTALL</span>, <span class="ruby-value str">'doc'</span>, <span class="ruby-value str">'index.html'</span>)
       <span class="ruby-constant">Launchy</span><span class="ruby-operator">::</span><span class="ruby-constant">Browser</span>.<span class="ruby-identifier">run</span> <span class="ruby-identifier">manual</span>
 
       <span class="ruby-identifier">exit</span>
@@ -668,7 +668,7 @@ configuration.
                     <p class="source-link">
                         Source: <a href="javascript:toggleSource('M000014_source')" id="l_M000014_source">show</a>
                         
-                        | <a href="http://github.com/sunaku/inochi/blob/bb5ea888e45c928e0318cfbef999ce7f41994411/lib/inochi/rake.rb#L110" target="_blank" class="github_url">on GitHub</a>
+                        | <a href="http://github.com/sunaku/inochi/blob/c7a54935a163d0b7a35beac0f54ed38c29c3e358/lib/inochi/rake.rb#L110" target="_blank" class="github_url">on GitHub</a>
                         
                     </p>
                     <div id="M000014_source" class="dyn-source">
@@ -730,9 +730,7 @@ configuration.
     <span class="ruby-identifier">lang_dump_file</span> = <span class="ruby-value str">'lang/phrases.yaml'</span>
 
     <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Extract language phrases for translation.'</span>
-    <span class="ruby-identifier">task</span> <span class="ruby-value str">'lang:dump'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">lang_dump_file</span>
-
-    <span class="ruby-identifier">file</span> <span class="ruby-identifier">lang_dump_file</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">lang_dump_deps</span> <span class="ruby-keyword kw">do</span>
+    <span class="ruby-identifier">task</span> <span class="ruby-value str">'lang:dump'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">lang_dump_deps</span> <span class="ruby-keyword kw">do</span>
       <span class="ruby-constant">ENV</span>[<span class="ruby-value str">'dump_lang_phrases'</span>] = <span class="ruby-value str">'1'</span>
       <span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">Task</span>[<span class="ruby-identifier">:test</span>].<span class="ruby-identifier">invoke</span>
     <span class="ruby-keyword kw">end</span>
@@ -910,7 +908,7 @@ configuration.
 
     <span class="ruby-comment cmt"># user manual</span>
       <span class="ruby-identifier">doc_man_src</span> = <span class="ruby-value str">'doc/index.erb'</span>
-      <span class="ruby-identifier">doc_man_dst</span> = <span class="ruby-value str">'doc/index.xhtml'</span>
+      <span class="ruby-identifier">doc_man_dst</span> = <span class="ruby-value str">'doc/index.html'</span>
       <span class="ruby-identifier">doc_man_deps</span> = <span class="ruby-constant">FileList</span>[<span class="ruby-value str">'doc/*.erb'</span>]
 
       <span class="ruby-identifier">doc_man_doc</span> = <span class="ruby-keyword kw">nil</span>
@@ -941,16 +939,15 @@ configuration.
 
       <span class="ruby-identifier">namespace</span> <span class="ruby-identifier">:doc</span> <span class="ruby-keyword kw">do</span>
         <span class="ruby-identifier">namespace</span> <span class="ruby-identifier">:api</span> <span class="ruby-keyword kw">do</span>
-          <span class="ruby-identifier">require</span> <span class="ruby-value str">'sdoc'</span>
           <span class="ruby-identifier">require</span> <span class="ruby-value str">'rake/rdoctask'</span>
 
           <span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">RDocTask</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
             <span class="ruby-identifier">t</span>.<span class="ruby-identifier">rdoc_dir</span> = <span class="ruby-identifier">doc_api_dst</span>
             <span class="ruby-identifier">t</span>.<span class="ruby-identifier">template</span> = <span class="ruby-value str">'direct'</span> <span class="ruby-comment cmt"># lighter template used on railsapi.com</span>
-            <span class="ruby-identifier">t</span>.<span class="ruby-identifier">options</span>.<span class="ruby-identifier">push</span> <span class="ruby-value str">'--fmt'</span>, <span class="ruby-value str">'shtml'</span> <span class="ruby-comment cmt"># explictly set shtml generator</span>
-            <span class="ruby-identifier">t</span>.<span class="ruby-identifier">rdoc_files</span>.<span class="ruby-identifier">include</span> <span class="ruby-value str">'[A-Z]*'</span>, <span class="ruby-value str">'lib/**/*.rb'</span>, <span class="ruby-value str">'ext/**/*.{rb,c*}'</span>
+            <span class="ruby-identifier">t</span>.<span class="ruby-identifier">options</span>.<span class="ruby-identifier">push</span> <span class="ruby-value str">'--fmt'</span>, <span class="ruby-value str">'shtml'</span> <span class="ruby-comment cmt"># explictly set SDoc generator</span>
+            <span class="ruby-identifier">t</span>.<span class="ruby-identifier">rdoc_files</span>.<span class="ruby-identifier">include</span> <span class="ruby-value str">'[A-Z]*'</span>, <span class="ruby-value str">'{lib,ext}/**/*.{rb,c}'</span>
 
-            <span class="ruby-comment cmt"># regen when sources change</span>
+            <span class="ruby-comment cmt"># regenerate API reference when sources change</span>
             <span class="ruby-identifier">task</span> <span class="ruby-identifier">t</span>.<span class="ruby-identifier">name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">t</span>.<span class="ruby-identifier">rdoc_files</span>
 
             <span class="ruby-identifier">t</span>.<span class="ruby-identifier">main</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:license_file</span>]
@@ -1056,7 +1053,7 @@ configuration.
               &lt;p&gt;#{project_module::WEBSITE}&lt;/p&gt;
             &lt;/center&gt;
             #{ann_nfo_doc}
-            #{ann_rel_doc}
+            #{ann_rel_doc.to_s.sub ann_rel_doc.parent_tabs_begin, '&lt;div&gt;'}
           }</span>
 
           <span class="ruby-comment cmt"># remove heading navigation menus</span>
@@ -1071,9 +1068,7 @@ configuration.
 
       <span class="ruby-identifier">ann_text</span> = <span class="ruby-keyword kw">nil</span>
       <span class="ruby-identifier">task</span> <span class="ruby-identifier">:ann_text</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">:ann_html</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">ann_text</span>
-          <span class="ruby-identifier">ann_text</span> = <span class="ruby-identifier">convert_html_to_text</span>[<span class="ruby-identifier">ann_html</span>]
-        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">ann_text</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">convert_html_to_text</span>[<span class="ruby-identifier">ann_html</span>]
       <span class="ruby-keyword kw">end</span>
 
       <span class="ruby-identifier">ann_nfo_text</span> = <span class="ruby-keyword kw">nil</span>
@@ -1163,15 +1158,11 @@ configuration.
       <span class="ruby-constant">CLEAN</span>.<span class="ruby-identifier">include</span> <span class="ruby-identifier">ann_mail_dst</span>
 
   <span class="ruby-comment cmt"># packaging</span>
-    <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Build a release.'</span>
-    <span class="ruby-identifier">task</span> <span class="ruby-identifier">:gem</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-identifier">:clobber</span>, <span class="ruby-identifier">:doc</span>] <span class="ruby-keyword kw">do</span>
-      <span class="ruby-identifier">sh</span> <span class="ruby-identifier">$0</span>, <span class="ruby-value str">'gem:package'</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-constant">CLEAN</span>.<span class="ruby-identifier">include</span> <span class="ruby-value str">'pkg'</span>
-
-    <span class="ruby-comment cmt"># ruby gem</span>
-      <span class="ruby-identifier">require</span> <span class="ruby-value str">'rake/gempackagetask'</span>
+    <span class="ruby-identifier">directory</span> <span class="ruby-value str">'pkg'</span>
+    <span class="ruby-constant">CLOBBER</span>.<span class="ruby-identifier">include</span> <span class="ruby-value str">'pkg'</span>
 
+    <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Build a release.'</span>
+    <span class="ruby-identifier">task</span> <span class="ruby-identifier">:gem</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-identifier">:doc</span>, <span class="ruby-identifier">:ann_text</span>, <span class="ruby-value str">'pkg'</span>] <span class="ruby-keyword kw">do</span>
       <span class="ruby-identifier">gem_spec</span> = <span class="ruby-constant">Gem</span><span class="ruby-operator">::</span><span class="ruby-constant">Specification</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">gem</span><span class="ruby-operator">|</span>
         <span class="ruby-identifier">authors</span> = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">AUTHORS</span>
 
@@ -1200,10 +1191,10 @@ configuration.
         <span class="ruby-comment cmt">#      For example, consider the &quot;RedCloth&quot; gem.</span>
         <span class="ruby-comment cmt">#</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">name</span>        = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">PROGRAM</span>
-
+        <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">date</span>        = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">RELEASE</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">version</span>     = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">VERSION</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">summary</span>     = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">TAGLINE</span>
-        <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">description</span> = <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">summary</span>
+        <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">description</span> = <span class="ruby-identifier">ann_text</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">homepage</span>    = <span class="ruby-identifier">project_module</span><span class="ruby-operator">::</span><span class="ruby-constant">WEBSITE</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">files</span>       = <span class="ruby-constant">FileList</span>[<span class="ruby-value str">'**/*'</span>].<span class="ruby-identifier">exclude</span>(<span class="ruby-value str">'_darcs'</span>) <span class="ruby-operator">-</span> <span class="ruby-constant">CLEAN</span>
         <span class="ruby-identifier">gem</span>.<span class="ruby-identifier">has_rdoc</span>    = <span class="ruby-keyword kw">true</span>
@@ -1233,18 +1224,11 @@ configuration.
         <span class="ruby-keyword kw">end</span>
 
         <span class="ruby-comment cmt"># additional configuration is done by user</span>
-        <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">gem</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">gem_config</span>
-      <span class="ruby-keyword kw">end</span>
-
-      <span class="ruby-identifier">namespace</span> <span class="ruby-identifier">:gem</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-constant">Rake</span><span class="ruby-operator">::</span><span class="ruby-constant">GemPackageTask</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">gem_spec</span>).<span class="ruby-identifier">define</span>
-
-        <span class="ruby-node">%w[gem package repackage clobber_package]</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">hide_rake_task</span>.<span class="ruby-identifier">call</span> <span class="ruby-node">&quot;gem:#{t}&quot;</span>
-        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">gem_config</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">gem</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">gem_config</span>
       <span class="ruby-keyword kw">end</span>
 
-      <span class="ruby-identifier">task</span> <span class="ruby-identifier">:clobber</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;gem:clobber_package&quot;</span>
+      <span class="ruby-identifier">mv</span> <span class="ruby-constant">Gem</span><span class="ruby-operator">::</span><span class="ruby-constant">Builder</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">gem_spec</span>).<span class="ruby-identifier">build</span>, <span class="ruby-value str">'pkg'</span>
+    <span class="ruby-keyword kw">end</span>
 
   <span class="ruby-comment cmt"># releasing</span>
     <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Publish a release.'</span>
@@ -1314,7 +1298,7 @@ configuration.
 
       <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Announce to RubyForge news.'</span>
       <span class="ruby-identifier">task</span> <span class="ruby-value str">'pub:ann:forge'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">:pub_forge</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-identifier">puts</span> <span class="ruby-value str">'Announcing to RubyForge news...'</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-value str">''</span>, <span class="ruby-value str">'Announcing to RubyForge news...'</span>
 
         <span class="ruby-identifier">project</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:rubyforge_project</span>]
 
@@ -1344,7 +1328,7 @@ configuration.
 
       <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Announce to ruby-talk mailing list.'</span>
       <span class="ruby-identifier">task</span> <span class="ruby-value str">'pub:ann:talk'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">:ann_logins</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-identifier">puts</span> <span class="ruby-value str">'Announcing to ruby-talk mailing list...'</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-value str">''</span>, <span class="ruby-value str">'Announcing to ruby-talk mailing list...'</span>
 
         <span class="ruby-identifier">host</span> = <span class="ruby-value str">'http://ruby-forum.com'</span>
         <span class="ruby-identifier">ruby_talk</span> = <span class="ruby-value">4</span> <span class="ruby-comment cmt"># ruby-talk forum ID</span>
@@ -1406,7 +1390,7 @@ configuration.
 
       <span class="ruby-identifier">desc</span> <span class="ruby-value str">'Announce to RAA (Ruby Application Archive).'</span>
       <span class="ruby-identifier">task</span> <span class="ruby-value str">'pub:ann:raa'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">:ann_logins</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-identifier">puts</span> <span class="ruby-value str">'Announcing to RAA (Ruby Application Archive)...'</span>
+        <span class="ruby-identifier">puts</span> <span class="ruby-value str">''</span>, <span class="ruby-value str">'Announcing to RAA (Ruby Application Archive)...'</span>
 
         <span class="ruby-identifier">show_page_error</span> = <span class="ruby-identifier">lambda</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">page</span>, <span class="ruby-identifier">message</span><span class="ruby-operator">|</span>
           <span class="ruby-identifier">warn</span> <span class="ruby-node">&quot;#{message}, so I can NOT announce this release to RAA:&quot;</span>