inochi 0.0.0

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2008 Suraj N. Kurapati <sunaku@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'lib/inochi'
+
+Inochi.rake :Inochi,
+  :rubyforge_project => 'sunaku',
+  :upload_target => File.expand_path('~/www/lib/inochi/'),
+  :upload_delete => true

data/bin/inochi

@@ -0,0 +1,413 @@
+#!/usr/bin/ruby -w
+#
+# Progress indicators:
+#
+#   create:   A file is being created because it does not exist.
+#
+#   skip:     A file is being skipped because it is already up to date.
+#
+#   update:   A file will be updated because it is out of date.  A text
+#             merging tool (see the "--merger" option) will be launched to
+#             transfer content from the old file (*.old) and the new file
+#             (*.new) to the out of date file.  If a text merging tool is
+#             not specified, then you will have to do the merging by hand.
+#
+# Usage:
+#
+#   inochi [Option...] ModuleName
+#
+
+# command line
+  require File.join(File.dirname(__FILE__), '..', 'lib', 'inochi')
+
+  @options = Inochi.main :Inochi do
+    opt :merger, 'A command that invokes a text merging tool with three arguments: (1) old file, (2) new file, (3) output file.  The command should write the result of merging the old file and the new file to the output file.  The command may only modify the output file; it must NOT modify the old file or the new file.', :type => :string
+  end
+
+# utility logic
+  require 'fileutils'
+  require 'digest/sha1'
+
+  # Notify the user about some action being performed.
+  def notify *args # :nodoc:
+    printf "%8s  %s\n", *args
+  end
+
+  # Writes the given contents to the file at the given path. If the given path
+  # already exists, then a backup is created before invoking the merging tool.
+  def create path, body, merger = @options[:merger]
+    # remove leading space
+    body = body.to_s
+    data = body.strip.gsub(/^#{body[/^[ \t]*(?=\S)/]}/, '') << "\n"
+
+    if File.exist? path
+      old_digest = Digest::SHA1.digest(File.read(path))
+      new_digest = Digest::SHA1.digest(data)
+
+      if old_digest == new_digest
+        notify :skip, path
+      else
+        notify :update, path
+        cur, old, new = path, "#{path}.old", "#{path}.new"
+
+        FileUtils.cp cur, old, :preserve => true
+        File.write new, data
+
+        system merger, old, new, cur if merger
+      end
+    else
+      notify :create, path
+      FileUtils.mkdir_p File.dirname(path)
+      File.write path, data
+    end
+  end
+
+# program body
+  target = ARGV.shift or
+    raise ArgumentError, "Project was not specified.  Run `#{$0} -h` for help."
+
+  project = Inochi.calc_project_symbol(target)
+  program = Inochi.calc_program_name(project)
+  version = '0.0.0'
+  release = Time.now.strftime('%F')
+
+  preamble = %{
+    require 'rubygems'
+    gem '#{Inochi::PROGRAM}', '~> #{Inochi::VERSION[/^\d+/]}'
+    require '#{Inochi::PROGRAM}'
+  }.strip
+
+  create "#{program}/LICENSE", %{
+    Copyright #{Time.now.year} Your Name <your@email.here>
+
+    Permission to use, copy, modify, and/or distribute this software for any
+    purpose with or without fee is hereby granted, provided that the above
+    copyright notice and this permission notice appear in all copies.
+
+    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+    WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+    MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+    ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+  }
+
+  create "#{program}/Rakefile", %{
+    #{preamble}
+
+    Inochi.rake #{project.inspect} do |gem|
+      # TODO: additional gem configuration.
+      # NOTE: this is completely optional!
+      #
+      # gem.extensions = ['foo.so']
+      # gem.files += ['other', 'files']
+    end
+  }
+
+  bin_file = "#{program}/bin/#{program}"
+  create bin_file, %{
+    #!/usr/bin/ruby -w
+    #
+    # TODO: Explain the command-line usage of this program here.
+    #
+    # Usage:
+    #
+    #   #{program} [Option...] Arg1 Arg2 Arg3...
+    #
+
+    #{preamble}
+
+    options = Inochi.main #{project.inspect} do
+      # TODO: define command-line options here.
+      #       see http://trollop.rubyforge.org/
+      #
+      # NOTE: this is completely optional!
+    end
+
+    # TODO: add the body of your program here
+
+    puts "Command-line options:   \#{options.inspect}"
+    puts "Command-line arguments: \#{ARGV.inspect}"
+  }
+  FileUtils.chmod 0755, bin_file
+
+  create "#{program}/lib/#{program}.rb", %{
+    #{preamble}
+
+    Inochi.init #{project.inspect},
+      :project => '#{target}',
+      :version => '#{version}',
+      :release => '#{release}',
+      :website => 'http://#{program}.rubyforge.org',
+      :tagline => 'TODO: put a single line description of your project here.',
+      :require => {
+        # TODO: list gems required by your project 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,
+      }
+  }
+
+  create "#{program}/doc/index.erb", %{
+    <% Inochi.book #{project.inspect}, self %>
+
+    <%# include intro.erb #%>
+    <%# include setup.erb #%>
+    <%# include theory.erb #%>
+    <%# include usage.erb #%>
+    <%# include history.erb #%>
+  }
+
+  create "#{program}/doc/intro.erb", %{
+    <% chapter "Introduction" do %>
+      <% project_summary do %>
+        > TODO: explain the purpose of your project
+
+        ****<%= $project %>**** is a __________ that __________.
+      <% end %>
+
+      > TODO: explain why your project is important
+
+      **<%= $project %>** is exciting because:
+      * It lets you __________.
+      * 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://)
+
+      <% paragraph "Etymology" do %>
+        > TODO: explain the meaning of the name of your project
+      <% end %>
+
+      <% section "Logistics" do %>
+        * <%= xref "History", "Release notes" %> --- history of project releases.
+        * [Source code](http://github.com/#{ENV['USER']}/<%= $program %>) --- obtain via [Git](http://git.or.cz) or browse online.
+        * [API reference](api/index.html) --- documentation for source code.
+
+        To get help or provide feedback, simply
+        <%= xref "License", "contact the author(s)" %>.
+
+        <% paragraph "Version numbers" do %>
+          **<%= $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>
+        <% end %>
+      <% end %>
+
+      <% section "License" do %>
+        <%# include ../LICENSE #%>
+      <% end %>
+
+      <% section "Credits" do %>
+        > TODO: give attribution to your predecessors and contributors
+      <% end %>
+    <% end %>
+  }
+
+  create "#{program}/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. |
+      <% end %>
+
+      <% section "Installation" do %>
+        You can install **<%= $project %>** by running this command:
+
+            gem install <%= $program %>
+
+        To check whether the installation was sucessful, run this command:
+
+            <%= $program %> --version
+
+        If the installation was successful, you will see output like this:
+
+        <pre><%= verbatim `ruby bin/\#{$program} --version` %></pre>
+
+        If you do not see such output, you may
+        <%= xref "License", "ask the author(s)" %> for help.
+      <% end %>
+
+      <% section "Manifest" do %>
+        You will see the following items inside **<%= $project %>**'s installation
+        directory, whose path you can determine by running this command:
+
+            <%= $program %> --version
+
+        > TODO: list important files your project provides here
+
+        * <tt>bin/</tt>
+
+          * <tt><%= $program %></tt> --- the main **<%= $project %>** executable.
+
+        * <tt>lib/</tt>
+
+          * <tt><%= $program %>.rb</tt> --- the main **<%= $project %>** library.
+
+          * <tt><%= $program %>/</tt>
+
+            > TODO: list sub-libraries your project provides here
+
+        * <tt>doc/</tt>
+
+          * <tt>api/</tt> --- API reference documentation.
+
+          * <tt>index.erb</tt> --- source of this user manual.
+
+        * <tt>LICENSE</tt> --- copyright notice and legal conditions.
+      <% end %>
+    <% end %>
+  }
+
+  create "#{program}/doc/theory.erb", %{
+    <% chapter "Theory of operation" do %>
+      > TODO: explain how your project does what it does
+    <% end %>
+  }
+
+  create "#{program}/doc/usage.erb", %{
+    <% chapter "Usage" do %>
+      <% section "Command-line interface" do %>
+        When you run this command:
+
+            <%= $program %> --help
+
+        You will see this output:
+
+        <pre><%= verbatim `ruby bin/\#{$program} --help` %></pre>
+
+        > TODO: explain the command-line arguments
+      <% end %>
+
+      <% section "Ruby library interface" do %>
+        > TODO: explain how to use your project's Ruby library
+        >       from inside another Ruby program or library
+      <% end %>
+
+      <% section "Tutorial" do %>
+        This tutorial shows how **<%= $project %>** is used to __________.
+
+        > TODO: give examples for doing common tasks
+      <% end %>
+
+      > TODO: explain how to do more (advanced) things
+    <% end %>
+  }
+
+  create "#{program}/doc/history.erb", %{
+    <% chapter "History" do %>
+      > TODO: put a brief history about your project here
+
+      <% project_history do %>
+        > TODO: put release notes for your project
+        >       here -- newest first, oldest last.
+
+        <% section "Version #{version} (#{release})" do %>
+          > TODO: write a short summary of the changes in this release
+
+          This release changes __________, adds __________, and fixes __________.
+
+          <% paragraph "Contributor kudos" do %>
+            > TODO: list everyone who contributed to this
+            >       release and what their contribution was
+
+            * __________ contributed __________ which __________.
+
+            * __________ fixed __________ which __________.
+
+            * __________ added __________ which __________.
+          <% end %>
+
+          <% paragraph "Incompatible changes" do %>
+            > TODO: list all backward-incompatible changes in this release
+
+            * __________ has been __________ to __________.
+
+            * __________.
+
+            * __________.
+          <% end %>
+
+          <% paragraph "New features" do %>
+            > TODO: list new features added in this release
+
+            * __________.
+
+            * __________.
+
+            * __________.
+          <% end %>
+
+          <% paragraph "Bug fixes" do %>
+            > TODO: describe all bugs that are fixed in this release
+
+            * __________ was __________.
+
+            * __________ were __________.
+
+            * __________ did __________.
+          <% end %>
+
+          <% paragraph "Housekeeping" do %>
+            > TODO: list the refactorings, clean ups, and other
+            >       improvements that were done for this release
+
+            * __________.
+
+            * __________.
+
+            * __________.
+          <% end %>
+        <% end %>
+      <% end %>
+    <% end %>
+  }

data/doc/README

@@ -0,0 +1,6 @@
+The "inochi.png" image and its "inochi.svg" source utilize the
+["3 flowers"][1] graphic, which was created and released into
+the public domain by [Peileppe Production][2] on June 25, 2008.
+
+[1]: http://openclipart.org/media/files/Peileppe/8978
+[2]: http://openclipart.org/media/people/Peileppe

data/doc/api/Inochi.html

@@ -0,0 +1,2337 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
+<link rel="stylesheet" href="style.css" type="text/css" charset="utf-8" />
+<link rel="stylesheet" href="syntax_highlight.css" type="text/css" charset="utf-8" />
+
+    <script src="jquery.js" type="text/javascript" charset="utf-8"></script>
+    <script src="app.js" type="text/javascript" charset="utf-8"></script>
+    <title>Module: Inochi</title>
+  </head>
+  <body>
+    <div id="content">
+      <div class="section module Inochi">
+  <h1 class="title">Module: Inochi</h1>
+  <div class="section constants">
+  
+</div>  <div class="section visibilitygroup public">
+    <h1>Public Visibility</h1>
+      <div class="section methodsummary class public">
+    <h1>Public Class Method Summary</h1>
+<table class="summary">
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="book" href="#book-class_method">book</a></span><span class='args'>(project_symbol, book_template)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Provides a common configuration for the project&#8217;s user manual:.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="calc_program_name" href="#calc_program_name-class_method">calc_program_name</a></span><span class='args'>(project_symbol)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Returns the name of the main program executable, which is the same as the
+project name fully in lowercase.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="calc_project_symbol" href="#calc_project_symbol-class_method">calc_project_symbol</a></span><span class='args'>(project_name)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Calculates the name of the project module from the given project name.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="camel_to_snake_case" href="#camel_to_snake_case-class_method">camel_to_snake_case</a></span><span class='args'>(input)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Transforms the given input from CamelCase to snake_case.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="init" href="#init-class_method">init</a></span><span class='args'>(project_symbol, project_config = )</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Establishes your project in Ruby&#8217;s runtime environment by defining
+the project module (which serves as a namespace for all code in the
+project) and providing a common configuration for the project module:.
+</p>
+
+        
+          <p class='returns'>
+            Returns: 
+              <span class='return_types'>
+                 <tt>Module</tt>
+              </span>
+          </p>
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="main" href="#main-class_method">main</a></span><span class='args'>(project_symbol, *trollop_args, &amp;trollop_config)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Provides a common configuration for the main project executable:.
+</p>
+
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a title="rake" href="#rake-class_method">rake</a></span><span class='args'>(project_symbol, options = )</span>
+        <span class='block'>{|gem_spec| ... }</span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+Provides Rake tasks for packaging, publishing, and announcing your project.
+</p>
+
+        
+      </td>
+    </tr>
+  
+</table>
+  </div>
+<div class="section methoddetails class public">
+  <h1>Public Class Method Details</h1>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>book</h3>
+</div><div id="book-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>book</span><span class='args'>(project_symbol, book_template)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Provides a common configuration for the project&#8217;s user manual:
+</p>
+<ul>
+<li>Assigns the title, subtitle, date, and authors for the document.
+
+<p>
+You may override these assignments by reassigning these document parameters
+AFTER this method is invoked.
+</p>
+<p>
+Refer to the &quot;document parameters&quot; for the XHTML format in the
+&quot;erbook&quot; user manual for details.
+</p>
+</li>
+<li>Provides the project&#8217;s configuration as global variables in the
+document.
+
+<p>
+For example, &lt;%= $version %&gt; is the same as &lt;%=
+project_module::VERSION %&gt; in the document.
+</p>
+</li>
+<li>Defines a &quot;project_summary&quot; node for use in the document. The
+body of this node should contain a brief introduction to the project.
+
+</li>
+<li>Defines a &quot;project_history&quot; node for use in the document. The
+body of this node should contain other nodes, each of which represent a
+single set of release notes for one of the project&#8217;s releases.
+
+</li>
+</ul>
+<p>
+It is assumed that this method is called from within the Inochi.rake()
+environment.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+    
+      <dt>
+        <span class='type'>[<tt>Symbol</tt>]</span>
+        <span class='name'>project_symbol</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Name of the Ruby constant which serves as a namespace for the entire
+project.
+</p>
+</span>
+      </dd>
+    
+  
+    
+      <dt>
+        <span class='type'>[<tt>ERBook::Document::Template</tt>]</span>
+        <span class='name'>book_template</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+The eRuby template which serves as the documentation for the project.
+</p>
+</span>
+      </dd>
+    
+  
+  </dl>
+</div>
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+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
+917
+918
+919
+920
+921
+922
+923
+924
+925</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 887</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>
+
+  <span class='comment val'># provide project constants as global variables to the user manual</span>
+  <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='INOCHI constant id'>INOCHI</span><span class='dot token'>.</span><span class='each_pair identifier id'>each_pair</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='param identifier id'>param</span><span class='comma token'>,</span> <span class='value identifier id'>value</span><span class='bitor op'>|</span>
+    <span class='eval identifier id'>eval</span> <span class='dstring node'>&quot;$#{param} = value&quot;</span><span class='comma token'>,</span> <span class='binding identifier id'>binding</span>
+  <span class='end end kw'>end</span>
+
+  <span class='comment val'># set document parameters for the user manual</span>
+  <span class='$title gvar id'>$title</span>    <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DISPLAY constant id'>DISPLAY</span>
+  <span class='$subtitle gvar id'>$subtitle</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='TAGLINE constant id'>TAGLINE</span>
+  <span class='$feeds gvar id'>$feeds</span>    <span class='assign token'>=</span> <span class='lbrace 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='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DOCSITE constant id'>DOCSITE</span><span class='comma token'>,</span> <span class='string val'>'ann.xml'</span><span class='rparen token'>)</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:rss</span> <span class='rbrace token'>}</span>
+  <span class='$authors gvar id'>$authors</span>  <span class='assign token'>=</span> <span class='Hash constant id'>Hash</span><span class='lbrack token'>[</span>
+    <span class='mult op'>*</span><span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='AUTHORS constant id'>AUTHORS</span><span class='dot token'>.</span><span class='map identifier id'>map</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='addr identifier id'>addr</span><span class='bitor op'>|</span>
+      <span class='comment val'># convert raw e-mail addresses into URLs for the erbook XHTML format</span>
+      <span class='addr identifier id'>addr</span> <span class='assign token'>=</span> <span class='dstring node'>&quot;mailto:#{addr}&quot;</span> <span class='unless unless_mod kw'>unless</span> <span class='addr identifier id'>addr</span> <span class='match op'>=~</span> <span class='regexp val'>/^\w+:/</span>
+
+      <span class='lbrack token'>[</span><span class='name identifier id'>name</span><span class='comma token'>,</span> <span class='addr identifier id'>addr</span><span class='rbrack token'>]</span>
+    <span class='end end kw'>end</span><span class='dot token'>.</span><span class='flatten identifier id'>flatten</span>
+  <span class='rbrack token'>]</span>
+
+  <span class='class class kw'>class</span> <span class='lshft op'>&lt;&lt;</span> <span class='book_template identifier id'>book_template</span>
+    <span class='def def kw'>def</span> <span class='project_summary identifier id'>project_summary</span>
+      <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='string val'>'block must be given'</span> <span class='unless unless_mod kw'>unless</span> <span class='block_given? fid id'>block_given?</span>
+      <span class='node identifier id'>node</span> <span class='do do kw'>do</span>
+        <span class='$project_summary_node gvar id'>$project_summary_node</span> <span class='assign token'>=</span> <span class='@nodes ivar id'>@nodes</span><span class='dot token'>.</span><span class='last identifier id'>last</span>
+        <span class='yield yield kw'>yield</span>
+      <span class='end end kw'>end</span>
+    <span class='end end kw'>end</span>
+
+    <span class='def def kw'>def</span> <span class='project_history identifier id'>project_history</span>
+      <span class='raise identifier id'>raise</span> <span class='ArgumentError constant id'>ArgumentError</span><span class='comma token'>,</span> <span class='string val'>'block must be given'</span> <span class='unless unless_mod kw'>unless</span> <span class='block_given? fid id'>block_given?</span>
+      <span class='node identifier id'>node</span> <span class='do do kw'>do</span>
+        <span class='$project_history_node gvar id'>$project_history_node</span> <span class='assign token'>=</span> <span class='@nodes ivar id'>@nodes</span><span class='dot token'>.</span><span class='last identifier id'>last</span>
+        <span class='yield yield kw'>yield</span>
+      <span class='end end kw'>end</span>
+    <span class='end end kw'>end</span>
+  <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>calc_program_name</h3>
+</div><div id="calc_program_name-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>calc_program_name</span><span class='args'>(project_symbol)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Returns the name of the main program executable, which is the same as the
+project name fully in lowercase.
+</p>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+931
+932
+933</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 931</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>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>calc_project_symbol</h3>
+</div><div id="calc_project_symbol-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>calc_project_symbol</span><span class='args'>(project_name)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Calculates the name of the project module from the given project name.
+</p>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+938
+939
+940
+941</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 938</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>
+  <span class='lparen token'>(</span><span class='name identifier id'>name</span><span class='lbrack token'>[</span><span class='integer val'>0</span><span class='comma token'>,</span><span class='integer val'>1</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='upcase identifier id'>upcase</span> <span class='plus op'>+</span> <span class='name identifier id'>name</span><span class='lbrack token'>[</span><span class='float val'>1</span><span class='dot2 op'>..</span><span class='integer val'>-1</span><span class='rbrack token'>]</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='to_sym identifier id'>to_sym</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>camel_to_snake_case</h3>
+</div><div id="camel_to_snake_case-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>camel_to_snake_case</span><span class='args'>(input)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Transforms the given input from CamelCase to snake_case.
+</p>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+946
+947
+948
+949
+950
+951
+952
+953
+954
+955
+956
+957
+958</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 946</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>
+
+  <span class='comment val'># handle camel case like FooBar =&gt; Foo_Bar</span>
+  <span class='while while kw'>while</span> <span class='input identifier id'>input</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span><span class='lparen token'>(</span><span class='regexp val'>/([a-z]+)([A-Z])(\w+)/</span><span class='rparen token'>)</span> <span class='lbrace token'>{</span> <span class='$1 nth_ref id'>$1</span> <span class='plus op'>+</span> <span class='string val'>'_'</span> <span class='plus op'>+</span> <span class='$2 nth_ref id'>$2</span> <span class='plus op'>+</span> <span class='$3 nth_ref id'>$3</span> <span class='rbrace token'>}</span>
+  <span class='end end kw'>end</span>
+
+  <span class='comment val'># handle abbreviations like XMLParser =&gt; XML_Parser</span>
+  <span class='while while kw'>while</span> <span class='input identifier id'>input</span><span class='dot token'>.</span><span class='gsub! fid id'>gsub!</span><span class='lparen token'>(</span><span class='regexp val'>/([A-Z]+)([A-Z])([a-z]+)/</span><span class='rparen token'>)</span> <span class='lbrace token'>{</span> <span class='$1 nth_ref id'>$1</span> <span class='plus op'>+</span> <span class='string val'>'_'</span> <span class='plus op'>+</span> <span class='$2 nth_ref id'>$2</span> <span class='plus op'>+</span> <span class='$3 nth_ref id'>$3</span> <span class='rbrace token'>}</span>
+  <span class='end end kw'>end</span>
+
+  <span class='input identifier id'>input</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>init</h3>
+</div><div id="init-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'><tt>Module</tt></span>
+    <span class='name'>init</span><span class='args'>(project_symbol, project_config = )</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Establishes your project in Ruby&#8217;s runtime environment by defining
+the project module (which serves as a namespace for all code in the
+project) and providing a common configuration for the project module:
+</p>
+<ul>
+<li>Adds the project lib/ directory to the Ruby load path.
+
+</li>
+<li>Defines the INOCHI constant in the project module. This constant contains
+the effective configuration parameters (@see project_config).
+
+</li>
+<li>Defines all configuration parameters as constants in the project module.
+
+</li>
+</ul>
+<p>
+This method must be invoked from immediately within (that is, not from
+within any of its descendant directories) the project lib/ directory.
+Ideally, this method would be invoked from the main project library.
+</p>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+    
+      <dt>
+        <span class='type'>[<tt>Symbol</tt>]</span>
+        <span class='name'>project_symbol</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Name of the Ruby constant which serves as a namespace for the entire
+project.
+</p>
+</span>
+      </dd>
+    
+  
+    
+      <dt>
+        <span class='type'>[<tt>Hash</tt>]</span>
+        <span class='name'>project_config</span>
+        
+          <em class="default">(defaults to: <tt></tt>)</em>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Project configuration parameters:
+</p>
+<dl>
+<dt>String</dt><dd>:project =&gt; Name of the project.
+
+</dd>
+</dl>
+<p>
+The default value is the value of the project_symbol parameter.
+</p>
+<dl>
+<dt>String</dt><dd>:tagline =&gt; An enticing, single line description of the project.
+
+</dd>
+</dl>
+<p>
+The default value is an empty string.
+</p>
+<dl>
+<dt>String</dt><dd>:website =&gt; URL of the published project website.
+
+</dd>
+</dl>
+<p>
+The default value is an empty string.
+</p>
+<dl>
+<dt>String</dt><dd>:docsite =&gt; URL of the published user manual.
+
+</dd>
+</dl>
+<p>
+The default value is the same value as the :website parameter.
+</p>
+<dl>
+<dt>String</dt><dd>:program =&gt; Name of the main project executable.
+
+</dd>
+</dl>
+<p>
+The default value is the value of the :project parameter in lowercase and
+CamelCase converted into snake_case.
+</p>
+<dl>
+<dt>String</dt><dd>:version =&gt; Version of the project.
+
+</dd>
+</dl>
+<p>
+The default value is &quot;0.0.0&quot;.
+</p>
+<dl>
+<dt>String</dt><dd>:release =&gt; Date when this version was released.
+
+</dd>
+</dl>
+<p>
+The default value is the current time.
+</p>
+<dl>
+<dt>String</dt><dd>:display =&gt; How the project name should be displayed.
+
+</dd>
+</dl>
+<p>
+The default value is the project name and version together.
+</p>
+<dl>
+<dt>String</dt><dd>:install =&gt; Path to the directory which contains the project.
+
+</dd>
+</dl>
+<p>
+The default value is one directory above the parent directory of the file
+from which this method was called.
+</p>
+<dl>
+<dt>Hash</dt><dd>:require =&gt; The names and version constraints of ruby gems required by
+this project. This information must be expressed as follows:
+
+</dd>
+</dl>
+<ul>
+<li>Each hash key must be the name of a ruby gem.
+
+</li>
+<li>Each hash value must be either <tt>nil</tt>, a single version number
+requirement string (see Gem::Requirement) or an Array thereof.
+
+</li>
+</ul>
+<p>
+The default value is an empty Hash.
+</p>
+</span>
+      </dd>
+    
+  
+  </dl>
+</div><div class="return">
+  <h3>Returns:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>Module</tt>]</span>
+      
+      
+        <span class='name'></span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+The newly configured project module.
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+88
+89
+90
+91
+92
+93
+94
+95
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107
+108
+109
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126
+127
+128
+129
+130
+131
+132
+133
+134</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 88</span>
+
+<span class='def def kw'>def</span> <span class='init identifier id'>init</span> <span class='project_symbol identifier id'>project_symbol</span><span class='comma token'>,</span> <span class='project_config identifier id'>project_config</span> <span class='assign token'>=</span> <span class='semicolon token'>;</span><span class='lbrace token'>{</span><span class='rbrace token'>}</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'># this method is not re-entrant</span>
+    <span class='@already_seen ivar id'>@already_seen</span> <span class='opasgn op'>||=</span> <span class='lbrack token'>[</span><span class='rbrack token'>]</span>
+    <span class='return return kw'>return</span> <span class='project_module identifier id'>project_module</span> <span class='if if_mod kw'>if</span> <span class='@already_seen ivar id'>@already_seen</span><span class='dot token'>.</span><span class='include? fid id'>include?</span> <span class='project_module identifier id'>project_module</span>
+    <span class='@already_seen ivar id'>@already_seen</span> <span class='lshft op'>&lt;&lt;</span> <span class='project_module identifier id'>project_module</span>
+
+  <span class='comment val'># put project on Ruby load path</span>
+    <span class='project_file identifier id'>project_file</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='expand_path identifier id'>expand_path</span><span class='lparen token'>(</span><span class='first_caller_file identifier id'>first_caller_file</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='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='project_file identifier id'>project_file</span><span class='rparen token'>)</span>
+    <span class='$LOAD_PATH gvar id'>$LOAD_PATH</span><span class='dot token'>.</span><span class='unshift identifier id'>unshift</span> <span class='project_libs identifier id'>project_libs</span>
+
+  <span class='comment val'># supply configuration defaults</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:project</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='project_symbol identifier id'>project_symbol</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:tagline</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='string val'>''</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:version</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='string val'>'0.0.0'</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:release</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='Time constant id'>Time</span><span class='dot token'>.</span><span class='now identifier id'>now</span><span class='dot token'>.</span><span class='strftime identifier id'>strftime</span><span class='lparen token'>(</span><span class='string val'>'%F'</span><span class='rparen token'>)</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:website</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='string val'>''</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:docsite</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:website</span><span class='rbrack token'>]</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:display</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='dstring node'>&quot;#{project_config[:project]} #{project_config[:version]}&quot;</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:program</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='calc_program_name identifier id'>calc_program_name</span><span class='lparen token'>(</span><span class='project_symbol identifier id'>project_symbol</span><span class='rparen token'>)</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:install</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='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='project_libs identifier id'>project_libs</span><span class='rparen token'>)</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:require</span><span class='rbrack token'>]</span> <span class='opasgn op'>||=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span>
+
+  <span class='comment val'># establish gem version dependencies and</span>
+  <span class='comment val'># sanitize the values while we're at it</span>
+    <span class='src identifier id'>src</span> <span class='assign token'>=</span> <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:require</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='dup identifier id'>dup</span>
+    <span class='dst identifier id'>dst</span> <span class='assign token'>=</span> <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:require</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='clear identifier id'>clear</span>
+
+    <span class='src identifier id'>src</span><span class='dot token'>.</span><span class='each_pair identifier id'>each_pair</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='gem_name identifier id'>gem_name</span><span class='comma token'>,</span> <span class='version_reqs identifier id'>version_reqs</span><span class='bitor op'>|</span>
+      <span class='gem_name identifier id'>gem_name</span>     <span class='assign token'>=</span> <span class='gem_name identifier id'>gem_name</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span>
+      <span class='version_reqs identifier id'>version_reqs</span> <span class='assign token'>=</span> <span class='lbrack token'>[</span><span class='version_reqs identifier id'>version_reqs</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='flatten identifier id'>flatten</span><span class='dot token'>.</span><span class='compact identifier id'>compact</span>
+
+      <span class='dst identifier id'>dst</span><span class='lbrack token'>[</span><span class='gem_name identifier id'>gem_name</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='version_reqs identifier id'>version_reqs</span>
+      <span class='gem identifier id'>gem</span> <span class='gem_name identifier id'>gem_name</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='version_reqs identifier id'>version_reqs</span>
+    <span class='end end kw'>end</span>
+
+  <span class='comment val'># make configuration parameters available as constants</span>
+    <span class='project_config identifier id'>project_config</span><span class='lbrack token'>[</span><span class='symbol val'>:inochi</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='project_config identifier id'>project_config</span>
+
+    <span class='project_config identifier id'>project_config</span><span class='dot token'>.</span><span class='each_pair identifier id'>each_pair</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='param identifier id'>param</span><span class='comma token'>,</span> <span class='value identifier id'>value</span><span class='bitor op'>|</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='param identifier id'>param</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span><span class='dot token'>.</span><span class='upcase identifier id'>upcase</span><span class='comma token'>,</span> <span class='value identifier id'>value</span>
+    <span class='end end kw'>end</span>
+
+  <span class='project_module identifier id'>project_module</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>main</h3>
+</div><div id="main-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>main</span><span class='args'>(project_symbol, *trollop_args, &amp;trollop_config)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Provides a common configuration for the main project executable:
+</p>
+<ul>
+<li>The program description (the sequence of non-blank lines at the top of the
+file in which this method is invoked) is properly formatted and displayed
+at the top of program&#8217;s help information.
+
+</li>
+<li>The program version information is fetched from the project module and
+formatted in YAML fashion for easy consumption by other tools.
+
+</li>
+<li>A list of command-line options is displayed at the bottom of the
+program&#8217;s help information.
+
+</li>
+</ul>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+    
+      <dt>
+        <span class='type'>[<tt>Symbol</tt>]</span>
+        <span class='name'>project_symbol</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Name of the Ruby constant which serves as a namespace for the entire
+project.
+</p>
+</span>
+      </dd>
+    
+  
+  </dl>
+</div><div class="return">
+  <h3>Returns:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>Object</tt>]</span>
+      
+      
+        <span class='name'></span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+The result of Trollop::options().
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+161
+162
+163
+164
+165
+166
+167
+168
+169
+170
+171
+172
+173
+174
+175
+176
+177
+178
+179
+180
+181
+182
+183
+184
+185
+186
+187
+188
+189
+190
+191
+192
+193
+194
+195
+196
+197
+198
+199
+200
+201
+202
+203</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 161</span>
+
+<span class='def def kw'>def</span> <span class='main identifier id'>main</span> <span class='project_symbol identifier id'>project_symbol</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='trollop_args identifier id'>trollop_args</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='trollop_config identifier id'>trollop_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>
+  <span class='program_home identifier id'>program_home</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='File constant id'>File</span><span class='dot token'>.</span><span class='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='program_file identifier id'>program_file</span><span class='rparen token'>)</span><span class='rparen token'>)</span>
+
+  <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='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='program_home identifier id'>program_home</span><span class='comma 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='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'># parse command-line options</span>
+    <span class='require identifier id'>require</span> <span class='string val'>'trollop'</span>
+
+    <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='Trollop constant id'>Trollop</span><span class='dot token'>.</span><span class='options identifier id'>options</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='trollop_args identifier id'>trollop_args</span><span class='rparen token'>)</span> <span class='do do kw'>do</span>
+
+      <span class='comment val'># show project description</span>
+      <span class='text identifier id'>text</span> <span class='dstring node'>&quot;#{project_module::PROJECT} - #{project_module::TAGLINE}&quot;</span>
+      <span class='text identifier id'>text</span> <span class='string val'>''</span>
+
+      <span class='comment val'># show program description</span>
+      <span class='text identifier id'>text</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='program_file identifier id'>program_file</span><span class='rparen token'>)</span><span class='lbrack token'>[</span><span class='regexp val'>/\A.*?^$\n/</span><span class='m identifier id'>m</span><span class='rbrack token'>]</span><span class='dot token'>.</span> <span class='comment val'># grab the header</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><span class='dot token'>.</span> <span class='comment val'># strip the comment markers</span>
+           <span class='sub identifier id'>sub</span><span class='lparen token'>(</span><span class='regexp val'>/\A!.*?\n/</span><span class='comma token'>,</span> <span class='string val'>''</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='lstrip identifier id'>lstrip</span> <span class='comment val'># omit the shebang line</span>
+      <span class='text identifier id'>text</span> <span class='string val'>''</span>
+
+      <span class='instance_eval identifier id'>instance_eval</span><span class='lparen token'>(</span><span class='bitand op'>&amp;</span><span class='trollop_config identifier id'>trollop_config</span><span class='rparen token'>)</span> <span class='if if_mod kw'>if</span> <span class='trollop_config identifier id'>trollop_config</span>
+
+      <span class='comment val'># show version information</span>
+      <span class='version identifier id'>version</span> <span class='dstring node'>%w[PROJECT VERSION RELEASE WEBSITE INSTALL]</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='c identifier id'>c</span><span class='bitor op'>|</span>
+        <span class='dstring node'>&quot;#{c.downcase}: #{project_module.const_get c}&quot;</span>
+      <span class='rbrace token'>}</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='string val'>&quot;\n&quot;</span><span class='rparen token'>)</span>
+
+      <span class='opt identifier id'>opt</span> <span class='symbol val'>:manual</span><span class='comma token'>,</span> <span class='string val'>'Show the user manual'</span>
+    <span class='end end kw'>end</span>
+
+    <span class='if if kw'>if</span> <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='colon op'>:</span><span class='manual identifier id'>manual</span><span class='rbrack token'>]</span>
+      <span class='require identifier id'>require</span> <span class='string val'>'launchy'</span>
+      <span class='Launchy constant id'>Launchy</span><span class='colon2 op'>::</span><span class='Browser constant id'>Browser</span><span class='dot token'>.</span><span class='run identifier id'>run</span> <span class='dstring node'>&quot;#{project_module::INSTALL}/doc/index.xhtml&quot;</span>
+      <span class='exit identifier id'>exit</span>
+    <span class='end end kw'>end</span>
+
+    <span class='options identifier id'>options</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>rake</h3>
+</div><div id="rake-class_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>rake</span><span class='args'>(project_symbol, options = )</span>
+    <span class='block'>{|gem_spec| ... }</span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+Provides Rake tasks for packaging, publishing, and announcing your project.
+</p>
+<ul>
+<li>An AUTHORS constant (which has the form &quot;[[name, info]]&quot; where
+&quot;name&quot; is the name of a copyright holder and &quot;info&quot; is
+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
+project maintainer.
+</p>
+<p>
+Copyright notices must be in the following form:
+</p>
+<pre class="code">
+    <span class='Copyright constant id'>Copyright</span> <span class='YEAR constant id'>YEAR</span> <span class='HOLDER constant id'>HOLDER</span> <span class='lt op'>&lt;</span><span class='EMAIL constant id'>EMAIL</span><span class='gt op'>&gt;</span>
+</pre>
+<p>
+Where HOLDER is the name of the copyright holder, YEAR is the year when the
+copyright holder first began working on the project, and EMAIL is
+(optional) the email address of the copyright holder.
+</p>
+</li>
+</ul>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+    
+      <dt>
+        <span class='type'>[<tt>Symbol</tt>]</span>
+        <span class='name'>project_symbol</span>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Name of the Ruby constant which serves as a namespace for the entire
+project.
+</p>
+</span>
+      </dd>
+    
+  
+    
+      <dt>
+        <span class='type'>[<tt>Hash</tt>]</span>
+        <span class='name'>options</span>
+        
+          <em class="default">(defaults to: <tt></tt>)</em>
+        
+      </dt>
+      <dd>
+        <span class='desc'><p>
+Additional method parameters, which are all optional:
+</p>
+<dl>
+<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.
+
+</dd>
+</dl>
+<p>
+The default value is &quot;LICENSE&quot;.
+</p>
+<dl>
+<dt>String</dt><dd>:logins_file =&gt; Path to the YAML file which contains login information
+for publishing release announcements.
+
+</dd>
+</dl>
+<p>
+The default value is &quot;~/.config/inochi/logins.yaml&quot; where
+&quot;~&quot; is the path to your home directory.
+</p>
+<dl>
+<dt>String</dt><dd>:rubyforge_project =&gt; Name of the RubyForge project where release
+packages will be published.
+
+</dd>
+</dl>
+<p>
+The default value is the value of the PROGRAM constant.
+</p>
+<dl>
+<dt>String</dt><dd>:rubyforge_section =&gt; Name of the RubyForge project&#8217;s File Release
+System section where release packages will be published.
+
+</dd>
+</dl>
+<p>
+The default value is the value of the :rubyforge_project parameter.
+</p>
+<dl>
+<dt>String</dt><dd>:raa_project =&gt; Name of the RAA (Ruby Application Archive) entry for
+this project.
+
+</dd>
+</dl>
+<p>
+The default value is the value of the PROGRAM constant.
+</p>
+<dl>
+<dt>String</dt><dd>:upload_target =&gt; Where to upload the project documentation. See
+&quot;destination&quot; in the rsync manual.
+
+</dd>
+</dl>
+<p>
+The default value is nil.
+</p>
+<dl>
+<dt>String</dt><dd>:upload_delete =&gt; Delete unknown files at the upload target location?
+
+</dd>
+</dl>
+<p>
+The default value is false.
+</p>
+<dl>
+<dt>Array</dt><dd>:upload_options =&gt; Additional command-line arguments to the rsync
+command.
+
+</dd>
+</dl>
+<p>
+The default value is an empty array.
+</p>
+</span>
+      </dd>
+    
+  
+  </dl>
+</div><div class="yieldparam">
+  <h3>Yield Parameters:</h3>
+  <dl>
+  
+    <dt>
+      
+        <span class='type'>[<tt>Gem::Specification</tt>]</span>
+      
+      
+        <span class='name'>gem_spec</span>
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+the gem specification
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+283
+284
+285
+286
+287
+288
+289
+290
+291
+292
+293
+294
+295
+296
+297
+298
+299
+300
+301
+302
+303
+304
+305
+306
+307
+308
+309
+310
+311
+312
+313
+314
+315
+316
+317
+318
+319
+320
+321
+322
+323
+324
+325
+326
+327
+328
+329
+330
+331
+332
+333
+334
+335
+336
+337
+338
+339
+340
+341
+342
+343
+344
+345
+346
+347
+348
+349
+350
+351
+352
+353
+354
+355
+356
+357
+358
+359
+360
+361
+362
+363
+364
+365
+366
+367
+368
+369
+370
+371
+372
+373
+374
+375
+376
+377
+378
+379
+380
+381
+382
+383
+384
+385
+386
+387
+388
+389
+390
+391
+392
+393
+394
+395
+396
+397
+398
+399
+400
+401
+402
+403
+404
+405
+406
+407
+408
+409
+410
+411
+412
+413
+414
+415
+416
+417
+418
+419
+420
+421
+422
+423
+424
+425
+426
+427
+428
+429
+430
+431
+432
+433
+434
+435
+436
+437
+438
+439
+440
+441
+442
+443
+444
+445
+446
+447
+448
+449
+450
+451
+452
+453
+454
+455
+456
+457
+458
+459
+460
+461
+462
+463
+464
+465
+466
+467
+468
+469
+470
+471
+472
+473
+474
+475
+476
+477
+478
+479
+480
+481
+482
+483
+484
+485
+486
+487
+488
+489
+490
+491
+492
+493
+494
+495
+496
+497
+498
+499
+500
+501
+502
+503
+504
+505
+506
+507
+508
+509
+510
+511
+512
+513
+514
+515
+516
+517
+518
+519
+520
+521
+522
+523
+524
+525
+526
+527
+528
+529
+530
+531
+532
+533
+534
+535
+536
+537
+538
+539
+540
+541
+542
+543
+544
+545
+546
+547
+548
+549
+550
+551
+552
+553
+554
+555
+556
+557
+558
+559
+560
+561
+562
+563
+564
+565
+566
+567
+568
+569
+570
+571
+572
+573
+574
+575
+576
+577
+578
+579
+580
+581
+582
+583
+584
+585
+586
+587
+588
+589
+590
+591
+592
+593
+594
+595
+596
+597
+598
+599
+600
+601
+602
+603
+604
+605
+606
+607
+608
+609
+610
+611
+612
+613
+614
+615
+616
+617
+618
+619
+620
+621
+622
+623
+624
+625
+626
+627
+628
+629
+630
+631
+632
+633
+634
+635
+636
+637
+638
+639
+640
+641
+642
+643
+644
+645
+646
+647
+648
+649
+650
+651
+652
+653
+654
+655
+656
+657
+658
+659
+660
+661
+662
+663
+664
+665
+666
+667
+668
+669
+670
+671
+672
+673
+674
+675
+676
+677
+678
+679
+680
+681
+682
+683
+684
+685
+686
+687
+688
+689
+690
+691
+692
+693
+694
+695
+696
+697
+698
+699
+700
+701
+702
+703
+704
+705
+706
+707
+708
+709
+710
+711
+712
+713
+714
+715
+716
+717
+718
+719
+720
+721
+722
+723
+724
+725
+726
+727
+728
+729
+730
+731
+732
+733
+734
+735
+736
+737
+738
+739
+740
+741
+742
+743
+744
+745
+746
+747
+748
+749
+750
+751
+752
+753
+754
+755
+756
+757
+758
+759
+760
+761
+762
+763
+764
+765
+766
+767
+768
+769
+770
+771
+772
+773
+774
+775
+776
+777
+778
+779
+780
+781
+782
+783
+784
+785
+786
+787
+788
+789
+790
+791
+792
+793
+794
+795
+796
+797
+798
+799
+800
+801
+802
+803
+804
+805
+806
+807
+808
+809
+810
+811
+812
+813
+814
+815
+816
+817
+818
+819
+820
+821
+822
+823
+824
+825
+826
+827
+828
+829
+830
+831
+832
+833
+834
+835
+836
+837
+838
+839
+840
+841
+842
+843
+844
+845
+846
+847
+848
+849
+850
+851
+852</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/inochi/inochi.rb', line 283</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>
+  <span class='program_home identifier id'>program_home</span> <span class='assign token'>=</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='program_file identifier id'>program_file</span><span class='rparen token'>)</span>
+
+  <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='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='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='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='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>
+
+  <span class='require identifier id'>require</span> <span class='string val'>'rake/clean'</span>
+
+  <span class='hide_rake_task identifier id'>hide_rake_task</span> <span class='assign token'>=</span> <span class='lambda identifier id'>lambda</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='name identifier id'>name</span><span class='bitor op'>|</span>
+    <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'># 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>
+
+    <span class='comment val'># user manual</span>
+      <span class='doc_man_src identifier id'>doc_man_src</span> <span class='assign token'>=</span> <span class='string val'>'doc/index.erb'</span>
+      <span class='doc_man_dst identifier id'>doc_man_dst</span> <span class='assign token'>=</span> <span class='string val'>'doc/index.xhtml'</span>
+      <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='assign token'>=</span> <span class='FileList constant id'>FileList</span><span class='lbrack token'>[</span><span class='string val'>'doc/*.erb'</span><span class='rbrack token'>]</span>
+
+      <span class='doc_man_doc identifier id'>doc_man_doc</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:doc_man_doc</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_src identifier id'>doc_man_src</span> <span class='do do kw'>do</span>
+        <span class='unless unless kw'>unless</span> <span class='doc_man_doc identifier id'>doc_man_doc</span>
+          <span class='require identifier id'>require</span> <span class='string val'>'erbook'</span> <span class='unless unless_mod kw'>unless</span> <span class='defined? defined kw'>defined?</span> <span class='ERBook constant id'>ERBook</span>
+          <span class='doc_man_txt identifier id'>doc_man_txt</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='doc_man_src identifier id'>doc_man_src</span><span class='rparen token'>)</span>
+          <span class='doc_man_doc identifier id'>doc_man_doc</span> <span class='assign token'>=</span> <span class='ERBook constant id'>ERBook</span><span class='colon2 op'>::</span><span class='Document constant id'>Document</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='symbol val'>:xhtml</span><span class='comma token'>,</span> <span class='doc_man_txt identifier id'>doc_man_txt</span><span class='comma token'>,</span> <span class='doc_man_src identifier id'>doc_man_src</span><span class='comma token'>,</span> <span class='symbol val'>:unindent</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='true true kw'>true</span><span class='rparen token'>)</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Build the user manual.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'doc:man'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_dst identifier id'>doc_man_dst</span>
+
+      <span class='file identifier id'>file</span> <span class='doc_man_dst identifier id'>doc_man_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='do do kw'>do</span>
+        <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='symbol val'>:doc_man_doc</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+        <span class='File constant id'>File</span><span class='dot token'>.</span><span class='write identifier id'>write</span> <span class='doc_man_dst identifier id'>doc_man_dst</span><span class='comma token'>,</span> <span class='doc_man_doc identifier id'>doc_man_doc</span>
+      <span class='end end kw'>end</span>
+
+      <span class='CLOBBER constant id'>CLOBBER</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='doc_man_dst identifier id'>doc_man_dst</span>
+
+    <span class='comment val'># API reference</span>
+      <span class='doc_api_dst identifier id'>doc_api_dst</span> <span class='assign token'>=</span> <span class='string val'>'doc/api'</span>
+
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Build API reference.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'doc:api'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_api_dst identifier id'>doc_api_dst</span>
+
+      <span class='require identifier id'>require</span> <span class='string val'>'yard'</span>
+      <span class='YARD constant id'>YARD</span><span class='colon2 op'>::</span><span class='Rake constant id'>Rake</span><span class='colon2 op'>::</span><span class='YardocTask constant id'>YardocTask</span><span class='dot token'>.</span><span class='new identifier id'>new</span> <span class='doc_api_dst identifier id'>doc_api_dst</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='t identifier id'>t</span><span class='bitor op'>|</span>
+        <span class='t identifier id'>t</span><span class='dot token'>.</span><span class='options identifier id'>options</span><span class='dot token'>.</span><span class='push identifier id'>push</span> <span class='string val'>'--protected'</span><span class='comma token'>,</span>
+          <span class='string val'>'--output-dir'</span><span class='comma token'>,</span> <span class='doc_api_dst identifier id'>doc_api_dst</span><span class='comma token'>,</span>
+          <span class='string val'>'--readme'</span><span class='comma 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='task identifier id'>task</span> <span class='doc_api_dst identifier id'>doc_api_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</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='end end kw'>end</span>
+
+      <span class='hide_rake_task identifier id'>hide_rake_task</span><span class='lbrack token'>[</span><span class='doc_api_dst identifier id'>doc_api_dst</span><span class='rbrack token'>]</span>
+
+      <span class='CLEAN constant id'>CLEAN</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='string val'>'.yardoc'</span>
+      <span class='CLOBBER constant id'>CLOBBER</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='doc_api_dst identifier id'>doc_api_dst</span>
+
+  <span class='comment val'># announcements</span>
+    <span class='desc identifier id'>desc</span> <span class='string val'>'Build all release announcements.'</span>
+    <span class='task identifier id'>task</span> <span class='symbol val'>:ann</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='dstring node'>%w[ ann:feed ann:html ann:text ann:mail ]</span>
+
+    <span class='comment val'># it has long been a tradition to use an &quot;[ANN]&quot; prefix</span>
+    <span class='comment val'># when announcing things on the ruby-talk mailing list</span>
+    <span class='ann_prefix identifier id'>ann_prefix</span> <span class='assign token'>=</span> <span class='string val'>'[ANN] '</span>
+    <span class='ann_subject identifier id'>ann_subject</span> <span class='assign token'>=</span> <span class='ann_prefix identifier id'>ann_prefix</span> <span class='plus op'>+</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DISPLAY constant id'>DISPLAY</span>
+    <span class='ann_project identifier id'>ann_project</span> <span class='assign token'>=</span> <span class='ann_prefix identifier id'>ann_prefix</span> <span class='plus op'>+</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='PROJECT constant id'>PROJECT</span>
+
+    <span class='comment val'># fetch the project summary from user manual</span>
+      <span class='ann_nfo_doc identifier id'>ann_nfo_doc</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:ann_nfo_doc</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:doc_man_doc</span> <span class='do do kw'>do</span>
+        <span class='ann_nfo_doc identifier id'>ann_nfo_doc</span> <span class='assign token'>=</span> <span class='$project_summary_node gvar id'>$project_summary_node</span>
+      <span class='end end kw'>end</span>
+
+    <span class='comment val'># fetch release notes from user manual</span>
+      <span class='ann_rel_doc identifier id'>ann_rel_doc</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:ann_rel_doc</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:doc_man_doc</span> <span class='do do kw'>do</span>
+        <span class='unless unless kw'>unless</span> <span class='ann_rel_doc identifier id'>ann_rel_doc</span>
+          <span class='if if kw'>if</span> <span class='parent identifier id'>parent</span> <span class='assign token'>=</span> <span class='$project_history_node gvar id'>$project_history_node</span>
+            <span class='if if kw'>if</span> <span class='child identifier id'>child</span> <span class='assign token'>=</span> <span class='parent identifier id'>parent</span><span class='dot token'>.</span><span class='children identifier id'>children</span><span class='dot token'>.</span><span class='first identifier id'>first</span>
+              <span class='ann_rel_doc identifier id'>ann_rel_doc</span> <span class='assign token'>=</span> <span class='child identifier id'>child</span>
+            <span class='else else kw'>else</span>
+              <span class='raise identifier id'>raise</span> <span class='string val'>'The &quot;project_history&quot; node in the user manual lacks child nodes.'</span>
+            <span class='end end kw'>end</span>
+          <span class='else else kw'>else</span>
+            <span class='raise identifier id'>raise</span> <span class='string val'>'The user manual lacks a &quot;project_history&quot; node.'</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+    <span class='comment val'># build release notes in HTML and plain text</span>
+      <span class='comment val'># converts the given HTML into plain text.  we do this using</span>
+      <span class='comment val'># lynx because (1) it outputs a list of all hyperlinks used</span>
+      <span class='comment val'># in the HTML document and (2) it runs on all major platforms</span>
+      <span class='convert_html_to_text identifier id'>convert_html_to_text</span> <span class='assign token'>=</span> <span class='lambda identifier id'>lambda</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='html identifier id'>html</span><span class='bitor op'>|</span>
+        <span class='require identifier id'>require</span> <span class='string val'>'tempfile'</span>
+
+        <span class='begin begin kw'>begin</span>
+          <span class='comment val'># lynx's -dump option requires a .html file</span>
+          <span class='tmp_file identifier id'>tmp_file</span> <span class='assign token'>=</span> <span class='Tempfile constant id'>Tempfile</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='Inochi constant id'>Inochi</span><span class='colon2 op'>::</span><span class='PROGRAM constant id'>PROGRAM</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='path identifier id'>path</span> <span class='plus op'>+</span> <span class='string val'>'.html'</span>
+
+          <span class='File constant id'>File</span><span class='dot token'>.</span><span class='write identifier id'>write</span> <span class='tmp_file identifier id'>tmp_file</span><span class='comma token'>,</span> <span class='html identifier id'>html</span>
+          <span class='text identifier id'>text</span> <span class='assign token'>=</span> <span class='dxstring node'>`lynx -dump #{tmp_file} -width 70`</span>
+        <span class='ensure ensure kw'>ensure</span>
+          <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='text identifier id'>text</span>
+      <span class='end end kw'>end</span>
+
+      <span class='comment val'># binds relative addresses in the given HTML to the project docsite</span>
+      <span class='resolve_html_links identifier id'>resolve_html_links</span> <span class='assign token'>=</span> <span class='lambda identifier id'>lambda</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='html identifier id'>html</span><span class='bitor op'>|</span>
+        <span class='comment val'># resolve relative URLs into absolute URLs</span>
+        <span class='comment val'># see http://en.wikipedia.org/wiki/URI_scheme#Generic_syntax</span>
+        <span class='require identifier id'>require</span> <span class='string val'>'addressable/uri'</span>
+        <span class='uri identifier id'>uri</span> <span class='assign token'>=</span> <span class='Addressable constant id'>Addressable</span><span class='colon2 op'>::</span><span class='URI constant id'>URI</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span><span class='lparen token'>(</span><span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DOCSITE constant id'>DOCSITE</span><span class='rparen token'>)</span>
+        <span class='doc_url identifier id'>doc_url</span> <span class='assign token'>=</span> <span class='uri identifier id'>uri</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span>
+        <span class='dir_url identifier id'>dir_url</span> <span class='assign token'>=</span> <span class='uri identifier id'>uri</span><span class='dot token'>.</span><span class='path identifier id'>path</span> <span class='match op'>=~</span> <span class='regexp val'>%r{/$|^$}</span> <span class='question op'>?</span> <span class='doc_url identifier id'>doc_url</span> <span class='colon op'>:</span> <span class='File constant id'>File</span><span class='dot token'>.</span><span class='dirname identifier id'>dirname</span><span class='lparen token'>(</span><span class='doc_url identifier id'>doc_url</span><span class='rparen token'>)</span>
+
+        <span class='html identifier id'>html</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='regexp val'>%r{(href=|src=)(.)(.*?)(\2)}</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='match identifier id'>match</span><span class='bitor op'>|</span>
+          <span class='a identifier id'>a</span><span class='comma token'>,</span> <span class='b identifier id'>b</span> <span class='assign token'>=</span> <span class='$1 nth_ref id'>$1</span> <span class='plus op'>+</span> <span class='$2 nth_ref id'>$2</span><span class='comma token'>,</span> <span class='$3 nth_ref id'>$3</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span> <span class='lshft op'>&lt;&lt;</span> <span class='$4 nth_ref id'>$4</span>
+
+          <span class='case case kw'>case</span> <span class='$3 nth_ref id'>$3</span>
+          <span class='when when kw'>when</span> <span class='regexp val'>%r{^[[:alpha:]][[:alnum:]\+\.\-]*://}</span> <span class='comment val'># already absolute</span>
+            <span class='match identifier id'>match</span>
+
+          <span class='when when kw'>when</span> <span class='regexp val'>/^#/</span>
+            <span class='a identifier id'>a</span> <span class='lshft op'>&lt;&lt;</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='doc_url identifier id'>doc_url</span><span class='comma token'>,</span> <span class='b identifier id'>b</span><span class='rparen token'>)</span>
+
+          <span class='else else kw'>else</span>
+            <span class='a identifier id'>a</span> <span class='lshft op'>&lt;&lt;</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='dir_url identifier id'>dir_url</span><span class='comma token'>,</span> <span class='b identifier id'>b</span><span class='rparen token'>)</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+      <span class='ann_html identifier id'>ann_html</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:ann_html</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='lbrack token'>[</span><span class='symbol val'>:doc_man_doc</span><span class='comma token'>,</span> <span class='symbol val'>:ann_nfo_doc</span><span class='comma token'>,</span> <span class='symbol val'>:ann_rel_doc</span><span class='rbrack token'>]</span> <span class='do do kw'>do</span>
+        <span class='unless unless kw'>unless</span> <span class='ann_html identifier id'>ann_html</span>
+          <span class='ann_html identifier id'>ann_html</span> <span class='assign token'>=</span> <span class='dstring node'>%{
+            &lt;center&gt;
+              &lt;h1&gt;#{project_module::DISPLAY}&lt;/h1&gt;
+              &lt;p&gt;#{project_module::TAGLINE}&lt;/p&gt;
+              &lt;p&gt;#{project_module::WEBSITE}&lt;/p&gt;
+            &lt;/center&gt;
+            #{ann_nfo_doc}
+            #{ann_rel_doc}
+          }</span>
+
+          <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='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>
+
+      <span class='ann_text identifier id'>ann_text</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:ann_text</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:ann_html</span> <span class='do do kw'>do</span>
+        <span class='unless unless kw'>unless</span> <span class='ann_text identifier id'>ann_text</span>
+          <span class='ann_text identifier id'>ann_text</span> <span class='assign token'>=</span> <span class='convert_html_to_text identifier id'>convert_html_to_text</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>
+
+      <span class='ann_nfo_text identifier id'>ann_nfo_text</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='task identifier id'>task</span> <span class='symbol val'>:ann_nfo_text</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:ann_nfo_doc</span> <span class='do do kw'>do</span>
+        <span class='unless unless kw'>unless</span> <span class='ann_nfo_text identifier id'>ann_nfo_text</span>
+          <span class='ann_nfo_html identifier id'>ann_nfo_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_nfo_doc identifier id'>ann_nfo_doc</span><span class='rbrack token'>]</span>
+          <span class='ann_nfo_text identifier id'>ann_nfo_text</span> <span class='assign token'>=</span> <span class='convert_html_to_text identifier id'>convert_html_to_text</span><span class='lbrack token'>[</span><span class='ann_nfo_html identifier id'>ann_nfo_html</span><span class='rbrack token'>]</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+    <span class='comment val'># HTML</span>
+      <span class='ann_html_dst identifier id'>ann_html_dst</span> <span class='assign token'>=</span> <span class='string val'>'ANN.html'</span>
+
+      <span class='desc identifier id'>desc</span> <span class='dstring node'>&quot;Build HTML announcement: #{ann_html_dst}&quot;</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'ann:html'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='ann_html_dst identifier id'>ann_html_dst</span>
+
+      <span class='file identifier id'>file</span> <span class='ann_html_dst identifier id'>ann_html_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='do do kw'>do</span>
+        <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='symbol val'>:ann_html</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+        <span class='File constant id'>File</span><span class='dot token'>.</span><span class='write identifier id'>write</span> <span class='ann_html_dst identifier id'>ann_html_dst</span><span class='comma token'>,</span> <span class='ann_html identifier id'>ann_html</span>
+      <span class='end end kw'>end</span>
+
+      <span class='CLEAN constant id'>CLEAN</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='ann_html_dst identifier id'>ann_html_dst</span>
+
+    <span class='comment val'># RSS feed</span>
+      <span class='ann_feed_dst identifier id'>ann_feed_dst</span> <span class='assign token'>=</span> <span class='string val'>'doc/ann.xml'</span>
+
+      <span class='desc identifier id'>desc</span> <span class='dstring node'>&quot;Build RSS announcement: #{ann_feed_dst}&quot;</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'ann:feed'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='ann_feed_dst identifier id'>ann_feed_dst</span>
+
+      <span class='file identifier id'>file</span> <span class='ann_feed_dst identifier id'>ann_feed_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='do do kw'>do</span>
+        <span class='require identifier id'>require</span> <span class='string val'>'time'</span>
+        <span class='require identifier id'>require</span> <span class='string val'>'rss/maker'</span>
+
+        <span class='feed identifier id'>feed</span> <span class='assign token'>=</span> <span class='RSS constant id'>RSS</span><span class='colon2 op'>::</span><span class='Maker constant id'>Maker</span><span class='dot token'>.</span><span class='make identifier id'>make</span><span class='lparen token'>(</span><span class='string val'>'2.0'</span><span class='rparen token'>)</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='feed identifier id'>feed</span><span class='bitor op'>|</span>
+          <span class='feed identifier id'>feed</span><span class='dot token'>.</span><span class='channel identifier id'>channel</span><span class='dot token'>.</span><span class='title identifier id'>title</span>       <span class='assign token'>=</span> <span class='ann_project identifier id'>ann_project</span>
+          <span class='feed identifier id'>feed</span><span class='dot token'>.</span><span class='channel identifier id'>channel</span><span class='dot token'>.</span><span class='link identifier id'>link</span>        <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='WEBSITE constant id'>WEBSITE</span>
+          <span class='feed identifier id'>feed</span><span class='dot token'>.</span><span class='channel identifier id'>channel</span><span class='dot token'>.</span><span class='description identifier id'>description</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='TAGLINE constant id'>TAGLINE</span>
+
+          <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='symbol val'>:ann_rel_doc</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+          <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='symbol val'>:ann_html</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+
+          <span class='item identifier id'>item</span>             <span class='assign token'>=</span> <span class='feed identifier id'>feed</span><span class='dot token'>.</span><span class='items identifier id'>items</span><span class='dot token'>.</span><span class='new_item identifier id'>new_item</span>
+          <span class='item identifier id'>item</span><span class='dot token'>.</span><span class='title identifier id'>title</span>       <span class='assign token'>=</span> <span class='ann_rel_doc identifier id'>ann_rel_doc</span><span class='dot token'>.</span><span class='title identifier id'>title</span>
+          <span class='item identifier id'>item</span><span class='dot token'>.</span><span class='link identifier id'>link</span>        <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DOCSITE constant id'>DOCSITE</span> <span class='plus op'>+</span> <span class='string val'>'#'</span> <span class='plus op'>+</span> <span class='ann_rel_doc identifier id'>ann_rel_doc</span><span class='dot token'>.</span><span class='here_frag identifier id'>here_frag</span>
+          <span class='item identifier id'>item</span><span class='dot token'>.</span><span class='date identifier id'>date</span>        <span class='assign token'>=</span> <span class='Time constant id'>Time</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span><span class='lparen token'>(</span><span class='item identifier id'>item</span><span class='dot token'>.</span><span class='title identifier id'>title</span><span class='rparen token'>)</span>
+          <span class='item identifier id'>item</span><span class='dot token'>.</span><span class='description identifier id'>description</span> <span class='assign token'>=</span> <span class='ann_html identifier id'>ann_html</span>
+        <span class='end end kw'>end</span>
+
+        <span class='File constant id'>File</span><span class='dot token'>.</span><span class='write identifier id'>write</span> <span class='ann_feed_dst identifier id'>ann_feed_dst</span><span class='comma token'>,</span> <span class='feed identifier id'>feed</span>
+      <span class='end end kw'>end</span>
+
+      <span class='CLOBBER constant id'>CLOBBER</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='ann_feed_dst identifier id'>ann_feed_dst</span>
+
+    <span class='comment val'># plain text</span>
+      <span class='ann_text_dst identifier id'>ann_text_dst</span> <span class='assign token'>=</span> <span class='string val'>'ANN.txt'</span>
+
+      <span class='desc identifier id'>desc</span> <span class='dstring node'>&quot;Build plain text announcement: #{ann_text_dst}&quot;</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'ann:text'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='ann_text_dst identifier id'>ann_text_dst</span>
+
+      <span class='file identifier id'>file</span> <span class='ann_text_dst identifier id'>ann_text_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='do do kw'>do</span>
+        <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='symbol val'>:ann_text</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+        <span class='File constant id'>File</span><span class='dot token'>.</span><span class='write identifier id'>write</span> <span class='ann_text_dst identifier id'>ann_text_dst</span><span class='comma token'>,</span> <span class='ann_text identifier id'>ann_text</span>
+      <span class='end end kw'>end</span>
+
+      <span class='CLEAN constant id'>CLEAN</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='ann_text_dst identifier id'>ann_text_dst</span>
+
+    <span class='comment val'># e-mail</span>
+      <span class='ann_mail_dst identifier id'>ann_mail_dst</span> <span class='assign token'>=</span> <span class='string val'>'ANN.eml'</span>
+
+      <span class='desc identifier id'>desc</span> <span class='dstring node'>&quot;Build e-mail announcement: #{ann_mail_dst}&quot;</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'ann:mail'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='ann_mail_dst identifier id'>ann_mail_dst</span>
+
+      <span class='file identifier id'>file</span> <span class='ann_mail_dst identifier id'>ann_mail_dst</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='doc_man_deps identifier id'>doc_man_deps</span> <span class='do do kw'>do</span>
+        <span class='File constant id'>File</span><span class='dot token'>.</span><span class='open identifier id'>open</span> <span class='ann_mail_dst identifier id'>ann_mail_dst</span><span class='comma token'>,</span> <span class='string val'>'w'</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='f identifier id'>f</span><span class='bitor op'>|</span>
+          <span class='require identifier id'>require</span> <span class='string val'>'time'</span>
+          <span class='f identifier id'>f</span><span class='dot token'>.</span><span class='puts identifier id'>puts</span> <span class='dstring node'>&quot;Date: #{Time.now.rfc822}&quot;</span>
+
+          <span class='f identifier id'>f</span><span class='dot token'>.</span><span class='puts identifier id'>puts</span> <span class='string val'>'To: ruby-talk@ruby-lang.org'</span>
+          <span class='f identifier id'>f</span><span class='dot token'>.</span><span class='puts identifier id'>puts</span> <span class='string val'>'From: &quot;%s&quot; &lt;%s&gt;'</span> <span class='mod op'>%</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='AUTHORS constant id'>AUTHORS</span><span class='dot token'>.</span><span class='first identifier id'>first</span>
+          <span class='f identifier id'>f</span><span class='dot token'>.</span><span class='puts identifier id'>puts</span> <span class='dstring node'>&quot;Subject: #{ann_subject}&quot;</span>
+
+          <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='symbol val'>:ann_text</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+          <span class='f identifier id'>f</span><span class='dot token'>.</span><span class='puts identifier id'>puts</span> <span class='string val'>''</span><span class='comma token'>,</span> <span class='ann_text identifier id'>ann_text</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+      <span class='CLEAN constant id'>CLEAN</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='ann_mail_dst identifier id'>ann_mail_dst</span>
+
+  <span class='comment val'># packaging</span>
+    <span class='desc identifier id'>desc</span> <span class='string val'>'Build a release.'</span>
+    <span class='task identifier id'>task</span> <span class='symbol val'>:pak</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='lbrack token'>[</span><span class='symbol val'>:clobber</span><span class='comma token'>,</span> <span class='symbol val'>:doc</span><span class='rbrack token'>]</span> <span class='do do kw'>do</span>
+      <span class='sh identifier id'>sh</span> <span class='$0 gvar id'>$0</span><span class='comma token'>,</span> <span class='string val'>'package'</span>
+    <span class='end end kw'>end</span>
+    <span class='CLEAN constant id'>CLEAN</span><span class='dot token'>.</span><span class='include identifier id'>include</span> <span class='string val'>'pkg'</span>
+
+    <span class='comment val'># ruby gem</span>
+      <span class='require identifier id'>require</span> <span class='string val'>'rake/gempackagetask'</span>
+
+      <span class='gem identifier id'>gem</span> <span class='assign token'>=</span> <span class='Gem constant id'>Gem</span><span class='colon2 op'>::</span><span class='Specification constant id'>Specification</span><span class='dot token'>.</span><span class='new identifier id'>new</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='gem identifier id'>gem</span><span class='bitor op'>|</span>
+        <span class='authors identifier id'>authors</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='AUTHORS constant id'>AUTHORS</span>
+
+        <span class='if if kw'>if</span> <span class='author identifier id'>author</span> <span class='assign token'>=</span> <span class='authors identifier id'>authors</span><span class='dot token'>.</span><span class='first identifier id'>first</span>
+          <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='author identifier id'>author</span><span class='comma token'>,</span> <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='email identifier id'>email</span> <span class='assign token'>=</span> <span class='author identifier id'>author</span>
+        <span class='end end kw'>end</span>
+
+        <span class='if if kw'>if</span> <span class='authors identifier id'>authors</span><span class='dot token'>.</span><span class='length identifier id'>length</span> <span class='gt op'>&gt;</span> <span class='integer val'>1</span>
+          <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='authors identifier id'>authors</span> <span class='assign token'>=</span> <span class='authors identifier id'>authors</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='name identifier id'>name</span><span class='comma token'>,</span> <span class='mail identifier id'>mail</span><span class='bitor op'>|</span> <span class='name identifier id'>name</span> <span class='rbrace token'>}</span>
+        <span class='end end kw'>end</span>
+
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='rubyforge_project identifier id'>rubyforge_project</span> <span class='assign token'>=</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='comment val'># XXX: In theory, `gem.name` should be assigned to</span>
+        <span class='comment val'>#      ::PROJECT instead of ::PROGRAM</span>
+        <span class='comment val'>#</span>
+        <span class='comment val'>#      In practice, PROJECT may contain non-word</span>
+        <span class='comment val'>#      characters and may also contain a mixture</span>
+        <span class='comment val'>#      of lowercase and uppercase letters.</span>
+        <span class='comment val'>#</span>
+        <span class='comment val'>#      This makes it difficult for people to</span>
+        <span class='comment val'>#      install the project gem because they must</span>
+        <span class='comment val'>#      remember the exact spelling used in</span>
+        <span class='comment val'>#      `gem.name` when running `gem install ____`.</span>
+        <span class='comment val'>#</span>
+        <span class='comment val'>#      For example, consider the &quot;RedCloth&quot; gem.</span>
+        <span class='comment val'>#</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='name identifier id'>name</span>        <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='PROGRAM constant id'>PROGRAM</span>
+
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='version identifier id'>version</span>     <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='VERSION constant id'>VERSION</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='summary identifier id'>summary</span>     <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='TAGLINE constant id'>TAGLINE</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='description identifier id'>description</span> <span class='assign token'>=</span> <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='summary identifier id'>summary</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='homepage identifier id'>homepage</span>    <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='WEBSITE constant id'>WEBSITE</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='files identifier id'>files</span>       <span class='assign token'>=</span> <span class='FileList constant id'>FileList</span><span class='lbrack token'>[</span><span class='string val'>'**/*'</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='exclude identifier id'>exclude</span><span class='lparen token'>(</span><span class='string val'>'_darcs'</span><span class='rparen token'>)</span> <span class='minus op'>-</span> <span class='CLEAN constant id'>CLEAN</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='executables identifier id'>executables</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='PROGRAM constant id'>PROGRAM</span>
+        <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='has_rdoc identifier id'>has_rdoc</span>    <span class='assign token'>=</span> <span class='true true kw'>true</span>
+
+        <span class='unless unless kw'>unless</span> <span class='project_module identifier id'>project_module</span> <span class='eq op'>==</span> <span class='Inochi constant id'>Inochi</span>
+          <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='add_dependency identifier id'>add_dependency</span> <span class='string val'>'inochi'</span><span class='comma token'>,</span> <span class='Inochi constant id'>Inochi</span><span class='colon2 op'>::</span><span class='VERSION constant id'>VERSION</span>
+        <span class='end end kw'>end</span>
+
+        <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='REQUIRE constant id'>REQUIRE</span><span class='dot token'>.</span><span class='each_pair identifier id'>each_pair</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='gem_name identifier id'>gem_name</span><span class='comma token'>,</span> <span class='version_reqs identifier id'>version_reqs</span><span class='bitor op'>|</span>
+          <span class='gem identifier id'>gem</span><span class='dot token'>.</span><span class='add_dependency identifier id'>add_dependency</span> <span class='gem_name identifier id'>gem_name</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='version_reqs identifier id'>version_reqs</span>
+        <span class='end end kw'>end</span>
+
+        <span class='comment val'># additional configuration is done by user</span>
+        <span class='yield yield kw'>yield</span> <span class='gem identifier id'>gem</span> <span class='if if_mod kw'>if</span> <span class='gem_config identifier id'>gem_config</span>
+      <span class='end end kw'>end</span>
+
+      <span class='Rake constant id'>Rake</span><span class='colon2 op'>::</span><span class='GemPackageTask constant id'>GemPackageTask</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='gem identifier id'>gem</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='define identifier id'>define</span>
+
+      <span class='comment val'># XXX: hide the tasks defined by the above gem packaging library</span>
+      <span class='dstring node'>%w[gem package repackage clobber_package]</span><span class='dot token'>.</span><span class='each identifier id'>each</span> <span class='lbrace token'>{</span><span class='bitor op'>|</span><span class='t identifier id'>t</span><span class='bitor op'>|</span> <span class='hide_rake_task identifier id'>hide_rake_task</span><span class='lbrack token'>[</span><span class='t identifier id'>t</span><span class='rbrack token'>]</span> <span class='rbrace token'>}</span>
+
+  <span class='comment val'># releasing</span>
+    <span class='desc identifier id'>desc</span> <span class='string val'>'Publish a release.'</span>
+    <span class='task identifier id'>task</span> <span class='string val'>'pub'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='dstring node'>%w[ pub:pak pub:doc pub:ann ]</span>
+
+    <span class='comment val'># connect to RubyForge services</span>
+      <span class='pub_forge identifier id'>pub_forge</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+      <span class='pub_forge_project identifier id'>pub_forge_project</span> <span class='assign token'>=</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='pub_forge_section identifier id'>pub_forge_section</span> <span class='assign token'>=</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='task identifier id'>task</span> <span class='symbol val'>:pub_forge</span> <span class='do do kw'>do</span>
+        <span class='require identifier id'>require</span> <span class='string val'>'rubyforge'</span>
+        <span class='pub_forge identifier id'>pub_forge</span> <span class='assign token'>=</span> <span class='RubyForge constant id'>RubyForge</span><span class='dot token'>.</span><span class='new identifier id'>new</span>
+        <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='configure identifier id'>configure</span><span class='lparen token'>(</span><span class='string val'>'release_date'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='RELEASE constant id'>RELEASE</span><span class='rparen token'>)</span>
+
+        <span class='unless unless kw'>unless</span> <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='autoconfig identifier id'>autoconfig</span><span class='lbrack token'>[</span><span class='string val'>'group_ids'</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='key? fid id'>key?</span> <span class='pub_forge_project identifier id'>pub_forge_project</span>
+          <span class='raise identifier id'>raise</span> <span class='dstring node'>&quot;The #{pub_forge_project.inspect} project was not recognized by the RubyForge client.  Either specify a different RubyForge project by passing the :rubyforge_project option to Inochi.rake(), or ensure that the client is configured correctly (see `rubyforge --help` for help) and try again.&quot;</span>
+        <span class='end end kw'>end</span>
+
+        <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='login identifier id'>login</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'>'Publish documentation to project website.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:doc'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='lbrack token'>[</span><span class='symbol val'>:doc</span><span class='comma token'>,</span> <span class='string val'>'ann:feed'</span><span class='rbrack token'>]</span> <span class='do do kw'>do</span>
+        <span class='target identifier id'>target</span> <span class='assign token'>=</span> <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:upload_target</span><span class='rbrack token'>]</span>
+
+        <span class='unless unless kw'>unless</span> <span class='target identifier id'>target</span>
+          <span class='require identifier id'>require</span> <span class='string val'>'addressable/uri'</span>
+          <span class='docsite identifier id'>docsite</span> <span class='assign token'>=</span> <span class='Addressable constant id'>Addressable</span><span class='colon2 op'>::</span><span class='URI constant id'>URI</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span><span class='lparen token'>(</span><span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='DOCSITE constant id'>DOCSITE</span><span class='rparen token'>)</span>
+
+          <span class='comment val'># provide uploading capability to websites hosted on RubyForge</span>
+          <span class='if if kw'>if</span> <span class='docsite identifier id'>docsite</span><span class='dot token'>.</span><span class='host identifier id'>host</span><span class='dot token'>.</span><span class='include? fid id'>include?</span> <span class='string val'>'.rubyforge.org'</span>
+            <span class='target identifier id'>target</span> <span class='assign token'>=</span> <span class='dstring node'>&quot;#{pub_forge.userconfig['username']}@rubyforge.org:#{File.join '/var/www/gforge-projects', options[:rubyforge_project], docsite.path}&quot;</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+
+        <span class='if if kw'>if</span> <span class='target identifier id'>target</span>
+          <span class='cmd identifier id'>cmd</span> <span class='assign token'>=</span> <span class='lbrack token'>[</span><span class='string val'>'rsync'</span><span class='comma token'>,</span> <span class='string val'>'-auvz'</span><span class='comma token'>,</span> <span class='string val'>'doc/'</span><span class='comma token'>,</span> <span class='dstring node'>&quot;#{target}/&quot;</span><span class='rbrack token'>]</span>
+          <span class='cmd identifier id'>cmd</span><span class='dot token'>.</span><span class='push identifier id'>push</span> <span class='string val'>'--delete'</span> <span class='if if_mod kw'>if</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='cmd identifier id'>cmd</span><span class='dot token'>.</span><span class='concat identifier id'>concat</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='p identifier id'>p</span> <span class='cmd identifier id'>cmd</span>
+          <span class='sh identifier id'>sh</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='cmd identifier id'>cmd</span><span class='rparen token'>)</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+    <span class='comment val'># announcement</span>
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Publish all announcements.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:ann'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='dstring node'>%w[ pub:ann:forge pub:ann:raa pub:ann:talk ]</span>
+
+      <span class='comment val'># login information</span>
+        <span class='ann_logins_file identifier id'>ann_logins_file</span> <span class='assign token'>=</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='ann_logins identifier id'>ann_logins</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span>
+
+        <span class='task identifier id'>task</span> <span class='symbol val'>:ann_logins</span> <span class='do do kw'>do</span>
+          <span class='ann_logins identifier id'>ann_logins</span> <span class='assign token'>=</span> <span class='begin begin kw'>begin</span>
+            <span class='require identifier id'>require</span> <span class='string val'>'yaml'</span>
+            <span class='YAML constant id'>YAML</span><span class='dot token'>.</span><span class='load_file identifier id'>load_file</span> <span class='ann_logins_file identifier id'>ann_logins_file</span>
+          <span class='rescue rescue kw'>rescue</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='e identifier id'>e</span>
+            <span class='warn identifier id'>warn</span> <span class='dstring node'>&quot;Could not read login information from #{ann_logins_file.inspect}:&quot;</span>
+            <span class='warn identifier id'>warn</span> <span class='e identifier id'>e</span>
+            <span class='warn identifier id'>warn</span> <span class='string val'>&quot;** You will NOT be able to publish release announcements! **&quot;</span>
+            <span class='lbrace token'>{</span><span class='rbrace token'>}</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Announce to RubyForge news.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:ann:forge'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:pub_forge</span> <span class='do do kw'>do</span>
+        <span class='project identifier id'>project</span> <span class='assign token'>=</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='if if kw'>if</span> <span class='group_id identifier id'>group_id</span> <span class='assign token'>=</span> <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='autoconfig identifier id'>autoconfig</span><span class='lbrack token'>[</span><span class='string val'>'group_ids'</span><span class='rbrack token'>]</span><span class='lbrack token'>[</span><span class='project identifier id'>project</span><span class='rbrack token'>]</span>
+          <span class='comment val'># check if this release was already announced</span>
+            <span class='require identifier id'>require</span> <span class='string val'>'mechanize'</span>
+            <span class='www identifier id'>www</span> <span class='assign token'>=</span> <span class='WWW constant id'>WWW</span><span class='colon2 op'>::</span><span class='Mechanize constant id'>Mechanize</span><span class='dot token'>.</span><span class='new identifier id'>new</span>
+            <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='www identifier id'>www</span><span class='dot token'>.</span><span class='get identifier id'>get</span> <span class='dstring node'>&quot;http://rubyforge.org/news/?group_id=#{group_id}&quot;</span>
+
+            <span class='posts identifier id'>posts</span> <span class='assign token'>=</span> <span class='lparen token'>(</span><span class='page identifier id'>page</span><span class='div op'>/</span><span class='string val'>'//a[starts-with(./@href, &quot;/forum/forum.php?forum_id=&quot;)]/text()'</span><span class='rparen token'>)</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='e identifier id'>e</span><span class='bitor op'>|</span> <span class='e identifier id'>e</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='string val'>&quot;\302\240&quot;</span><span class='comma token'>,</span> <span class='string val'>''</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='strip identifier id'>strip</span> <span class='rbrace token'>}</span>
+
+            <span class='already_announced identifier id'>already_announced</span> <span class='assign token'>=</span> <span class='posts identifier id'>posts</span><span class='dot token'>.</span><span class='include? fid id'>include?</span> <span class='ann_subject identifier id'>ann_subject</span>
+
+          <span class='if if kw'>if</span> <span class='already_announced identifier id'>already_announced</span>
+            <span class='warn identifier id'>warn</span> <span class='string val'>&quot;This release was already announced to RubyForge news, so I will NOT announce it there again.&quot;</span>
+          <span class='else else kw'>else</span>
+            <span class='comment val'># make the announcement</span>
+            <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='symbol val'>:ann_text</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+            <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='post_news identifier id'>post_news</span> <span class='project identifier id'>project</span><span class='comma token'>,</span> <span class='ann_subject identifier id'>ann_subject</span><span class='comma token'>,</span> <span class='ann_text identifier id'>ann_text</span>
+
+            <span class='puts identifier id'>puts</span> <span class='string val'>&quot;Successfully announced to RubyForge news:&quot;</span>
+            <span class='puts identifier id'>puts</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='uri identifier id'>uri</span>
+          <span class='end end kw'>end</span>
+        <span class='else else kw'>else</span>
+          <span class='raise identifier id'>raise</span> <span class='dstring node'>&quot;Could not determine the group_id of the #{project.inspect} RubyForge project.  Run `rubyforge config` and try again.&quot;</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Announce to ruby-talk mailing list.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:ann:talk'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:ann_logins</span> <span class='do do kw'>do</span>
+        <span class='host identifier id'>host</span> <span class='assign token'>=</span> <span class='string val'>'http://ruby-forum.com'</span>
+        <span class='ruby_talk identifier id'>ruby_talk</span> <span class='assign token'>=</span> <span class='integer val'>4</span> <span class='comment val'># ruby-talk forum ID</span>
+
+        <span class='require identifier id'>require</span> <span class='string val'>'mechanize'</span>
+        <span class='www identifier id'>www</span> <span class='assign token'>=</span> <span class='WWW constant id'>WWW</span><span class='colon2 op'>::</span><span class='Mechanize constant id'>Mechanize</span><span class='dot token'>.</span><span class='new identifier id'>new</span>
+
+        <span class='comment val'># check if this release was already announced</span>
+        <span class='already_announced identifier id'>already_announced</span> <span class='assign token'>=</span>
+          <span class='begin begin kw'>begin</span>
+            <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='www identifier id'>www</span><span class='dot token'>.</span><span class='get identifier id'>get</span> <span class='dstring node'>&quot;#{host}/forum/#{ruby_talk}&quot;</span><span class='comma token'>,</span> <span class='symbol val'>:filter</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='dstring node'>%{&quot;#{ann_subject}&quot;}</span>
+
+            <span class='posts identifier id'>posts</span> <span class='assign token'>=</span> <span class='lparen token'>(</span><span class='page identifier id'>page</span><span class='div op'>/</span><span class='string val'>'//div[@class=&quot;forum&quot;]//a[starts-with(./@href, &quot;/topic/&quot;)]/text()'</span><span class='rparen token'>)</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='e identifier id'>e</span><span class='bitor op'>|</span> <span class='e identifier id'>e</span><span class='dot token'>.</span><span class='to_s identifier id'>to_s</span><span class='dot token'>.</span><span class='strip identifier id'>strip</span> <span class='rbrace token'>}</span>
+            <span class='posts identifier id'>posts</span><span class='dot token'>.</span><span class='include? fid id'>include?</span> <span class='ann_subject identifier id'>ann_subject</span>
+          <span class='rescue rescue kw'>rescue</span>
+            <span class='false false kw'>false</span>
+          <span class='end end kw'>end</span>
+
+        <span class='if if kw'>if</span> <span class='already_announced identifier id'>already_announced</span>
+          <span class='warn identifier id'>warn</span> <span class='string val'>&quot;This release was already announced to the ruby-talk mailing list, so I will NOT announce it there again.&quot;</span>
+        <span class='else else kw'>else</span>
+          <span class='comment val'># log in to RubyForum</span>
+          <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='www identifier id'>www</span><span class='dot token'>.</span><span class='get identifier id'>get</span> <span class='dstring node'>&quot;#{host}/user/login&quot;</span>
+          <span class='form identifier id'>form</span> <span class='assign token'>=</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='forms identifier id'>forms</span><span class='dot token'>.</span><span class='first identifier id'>first</span>
+
+          <span class='if if kw'>if</span> <span class='login identifier id'>login</span> <span class='assign token'>=</span> <span class='ann_logins identifier id'>ann_logins</span><span class='lbrack token'>[</span><span class='string val'>'www.ruby-forum.com'</span><span class='rbrack token'>]</span>
+            <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'name'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='login identifier id'>login</span><span class='lbrack token'>[</span><span class='string val'>'user'</span><span class='rbrack token'>]</span>
+            <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'password'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='login identifier id'>login</span><span class='lbrack token'>[</span><span class='string val'>'pass'</span><span class='rbrack token'>]</span>
+          <span class='end end kw'>end</span>
+
+          <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='form identifier id'>form</span><span class='dot token'>.</span><span class='click_button identifier id'>click_button</span> <span class='comment val'># use the first submit button</span>
+
+          <span class='if if kw'>if</span> <span class='lparen token'>(</span><span class='page identifier id'>page</span><span class='div op'>/</span><span class='string val'>'//a[@href=&quot;/user/logout&quot;]'</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+            <span class='warn identifier id'>warn</span> <span class='dstring node'>&quot;Could not log in to RubyForum using the login information in #{ann_logins_file.inspect}, so I can NOT announce this release to the ruby-talk mailing list.&quot;</span>
+          <span class='else else kw'>else</span>
+            <span class='comment val'># make the announcement</span>
+            <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='www identifier id'>www</span><span class='dot token'>.</span><span class='get identifier id'>get</span> <span class='dstring node'>&quot;#{host}/topic/new?forum_id=#{ruby_talk}&quot;</span>
+            <span class='form identifier id'>form</span> <span class='assign token'>=</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='forms identifier id'>forms</span><span class='dot token'>.</span><span class='first identifier id'>first</span>
+
+            <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='symbol val'>:ann_text</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+            <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'post[subject]'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='ann_subject identifier id'>ann_subject</span>
+            <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'post[text]'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='ann_text identifier id'>ann_text</span>
+
+            <span class='form identifier id'>form</span><span class='dot token'>.</span><span class='checkboxes identifier id'>checkboxes</span><span class='dot token'>.</span><span class='first identifier id'>first</span><span class='dot token'>.</span><span class='check identifier id'>check</span> <span class='comment val'># enable email notification</span>
+            <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='form identifier id'>form</span><span class='dot token'>.</span><span class='submit identifier id'>submit</span>
+
+            <span class='errors identifier id'>errors</span> <span class='assign token'>=</span> <span class='lbrack token'>[</span><span class='page identifier id'>page</span><span class='div op'>/</span><span class='string val'>'//div[@class=&quot;error&quot;]/text()'</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='flatten identifier id'>flatten</span>
+            <span class='if if kw'>if</span> <span class='errors identifier id'>errors</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+              <span class='puts identifier id'>puts</span> <span class='string val'>&quot;Successfully announced to ruby-talk mailing list:&quot;</span>
+              <span class='puts identifier id'>puts</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='uri identifier id'>uri</span>
+            <span class='else else kw'>else</span>
+              <span class='warn identifier id'>warn</span> <span class='string val'>&quot;Could not announce to ruby-talk mailing list:&quot;</span>
+              <span class='warn identifier id'>warn</span> <span class='errors identifier id'>errors</span><span class='dot token'>.</span><span class='join identifier id'>join</span><span class='lparen token'>(</span><span class='string val'>&quot;\n&quot;</span><span class='rparen token'>)</span>
+            <span class='end end kw'>end</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Announce to RAA (Ruby Application Archive).'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:ann:raa'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:ann_logins</span> <span class='do do kw'>do</span>
+        <span class='show_page_error identifier id'>show_page_error</span> <span class='assign token'>=</span> <span class='lambda identifier id'>lambda</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='page identifier id'>page</span><span class='comma token'>,</span> <span class='message identifier id'>message</span><span class='bitor op'>|</span>
+          <span class='warn identifier id'>warn</span> <span class='dstring node'>&quot;#{message}, so I can NOT announce this release to RAA:&quot;</span>
+          <span class='warn identifier id'>warn</span> <span class='dstring node'>&quot;#{(page/'h2').text} -- #{(page/'p').first.text.strip}&quot;</span>
+        <span class='end end kw'>end</span>
+
+        <span class='resource identifier id'>resource</span> <span class='assign token'>=</span> <span class='dstring node'>&quot;#{options[:raa_project].inspect} project entry on RAA&quot;</span>
+
+        <span class='require identifier id'>require</span> <span class='string val'>'mechanize'</span>
+        <span class='www identifier id'>www</span> <span class='assign token'>=</span> <span class='WWW constant id'>WWW</span><span class='colon2 op'>::</span><span class='Mechanize constant id'>Mechanize</span><span class='dot token'>.</span><span class='new identifier id'>new</span>
+        <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='www identifier id'>www</span><span class='dot token'>.</span><span class='get identifier id'>get</span> <span class='dstring node'>&quot;http://raa.ruby-lang.org/update.rhtml?name=#{options[:raa_project]}&quot;</span>
+
+        <span class='if if kw'>if</span> <span class='form identifier id'>form</span> <span class='assign token'>=</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='forms identifier id'>forms</span><span class='lbrack token'>[</span><span class='integer val'>1</span><span class='rbrack token'>]</span>
+          <span class='resource identifier id'>resource</span> <span class='lshft op'>&lt;&lt;</span> <span class='dstring node'>&quot; (owned by #{form.owner.inspect})&quot;</span>
+
+          <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='symbol val'>:ann_nfo_text</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'description'</span><span class='rbrack token'>]</span>       <span class='assign token'>=</span> <span class='ann_nfo_text identifier id'>ann_nfo_text</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'description_style'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='string val'>'Pre-formatted'</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'short_description'</span><span class='rbrack token'>]</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='TAGLINE constant id'>TAGLINE</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'version'</span><span class='rbrack token'>]</span>           <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='VERSION constant id'>VERSION</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'url'</span><span class='rbrack token'>]</span>               <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='WEBSITE constant id'>WEBSITE</span>
+          <span class='form identifier id'>form</span><span class='lbrack token'>[</span><span class='string val'>'pass'</span><span class='rbrack token'>]</span>              <span class='assign token'>=</span> <span class='ann_logins identifier id'>ann_logins</span><span class='lbrack token'>[</span><span class='string val'>'raa.ruby-lang.org'</span><span class='rbrack token'>]</span><span class='lbrack token'>[</span><span class='string val'>'pass'</span><span class='rbrack token'>]</span>
+
+          <span class='page identifier id'>page</span> <span class='assign token'>=</span> <span class='form identifier id'>form</span><span class='dot token'>.</span><span class='submit identifier id'>submit</span>
+
+          <span class='if if kw'>if</span> <span class='page identifier id'>page</span><span class='dot token'>.</span><span class='title identifier id'>title</span> <span class='match op'>=~</span> <span class='regexp val'>/error/i</span>
+            <span class='show_page_error identifier id'>show_page_error</span><span class='lbrack token'>[</span><span class='page identifier id'>page</span><span class='comma token'>,</span> <span class='dstring node'>&quot;Could not update #{resource}&quot;</span><span class='rbrack token'>]</span>
+          <span class='else else kw'>else</span>
+            <span class='puts identifier id'>puts</span> <span class='string val'>&quot;Successfully announced to RAA (Ruby Application Archive).&quot;</span>
+          <span class='end end kw'>end</span>
+        <span class='else else kw'>else</span>
+          <span class='show_page_error identifier id'>show_page_error</span><span class='lbrack token'>[</span><span class='page identifier id'>page</span><span class='comma token'>,</span> <span class='dstring node'>&quot;Could not access #{resource}&quot;</span><span class='rbrack token'>]</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+
+    <span class='comment val'># release packages</span>
+      <span class='desc identifier id'>desc</span> <span class='string val'>'Publish release packages to RubyForge.'</span>
+      <span class='task identifier id'>task</span> <span class='string val'>'pub:pak'</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='symbol val'>:pub_forge</span> <span class='do do kw'>do</span>
+        <span class='comment val'># check if this release was already published</span>
+        <span class='version identifier id'>version</span> <span class='assign token'>=</span> <span class='project_module identifier id'>project_module</span><span class='colon2 op'>::</span><span class='VERSION constant id'>VERSION</span>
+        <span class='packages identifier id'>packages</span> <span class='assign token'>=</span> <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='autoconfig identifier id'>autoconfig</span><span class='lbrack token'>[</span><span class='string val'>'release_ids'</span><span class='rbrack token'>]</span><span class='lbrack token'>[</span><span class='pub_forge_section identifier id'>pub_forge_section</span><span class='rbrack token'>]</span>
+
+        <span class='if if kw'>if</span> <span class='packages identifier id'>packages</span> <span class='and and kw'>and</span> <span class='packages identifier id'>packages</span><span class='dot token'>.</span><span class='key? fid id'>key?</span> <span class='version identifier id'>version</span>
+          <span class='warn identifier id'>warn</span> <span class='string val'>&quot;The release packages were already published, so I will NOT publish them again.&quot;</span>
+        <span class='else else kw'>else</span>
+          <span class='comment val'># create the FRS package section</span>
+          <span class='unless unless kw'>unless</span> <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='autoconfig identifier id'>autoconfig</span><span class='lbrack token'>[</span><span class='string val'>'package_ids'</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='key? fid id'>key?</span> <span class='pub_forge_section identifier id'>pub_forge_section</span>
+            <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='create_package identifier id'>create_package</span> <span class='pub_forge_project identifier id'>pub_forge_project</span><span class='comma token'>,</span> <span class='pub_forge_section identifier id'>pub_forge_section</span>
+          <span class='end end kw'>end</span>
+
+          <span class='comment val'># publish the package to the section</span>
+          <span class='uploader identifier id'>uploader</span> <span class='assign token'>=</span> <span class='lambda identifier id'>lambda</span> <span class='do do kw'>do</span> <span class='bitor op'>|</span><span class='command identifier id'>command</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='files identifier id'>files</span><span class='bitor op'>|</span>
+            <span class='pub_forge identifier id'>pub_forge</span><span class='dot token'>.</span><span class='__send__ identifier id'>__send__</span> <span class='command identifier id'>command</span><span class='comma token'>,</span> <span class='pub_forge_project identifier id'>pub_forge_project</span><span class='comma token'>,</span> <span class='pub_forge_section identifier id'>pub_forge_section</span><span class='comma token'>,</span> <span class='version identifier id'>version</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='files identifier id'>files</span>
+          <span class='end end kw'>end</span>
+
+          <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='symbol val'>:pak</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='invoke identifier id'>invoke</span>
+          <span class='packages identifier id'>packages</span> <span class='assign token'>=</span> <span class='Dir constant id'>Dir</span><span class='lbrack token'>[</span><span class='string val'>'pkg/*.[a-z]*'</span><span class='rbrack token'>]</span>
+
+          <span class='unless unless kw'>unless</span> <span class='packages identifier id'>packages</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+            <span class='comment val'># NOTE: use the 'add_release' command ONLY for the first</span>
+            <span class='comment val'>#       file because it creates a new sub-section on the</span>
+            <span class='comment val'>#       RubyForge download page; we do not want one package</span>
+            <span class='comment val'>#       per sub-section on the RubyForge download page!</span>
+            <span class='comment val'>#</span>
+            <span class='uploader identifier id'>uploader</span><span class='lbrack token'>[</span><span class='symbol val'>:add_release</span><span class='comma token'>,</span> <span class='packages identifier id'>packages</span><span class='dot token'>.</span><span class='shift identifier id'>shift</span><span class='rbrack token'>]</span>
+
+            <span class='unless unless kw'>unless</span> <span class='packages identifier id'>packages</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+              <span class='uploader identifier id'>uploader</span><span class='lbrack token'>[</span><span class='symbol val'>:add_file</span><span class='comma token'>,</span> <span class='mult op'>*</span><span class='packages identifier id'>packages</span><span class='rbrack token'>]</span>
+            <span class='end end kw'>end</span>
+
+            <span class='puts identifier id'>puts</span> <span class='string val'>&quot;Successfully published release packages to RubyForge.&quot;</span>
+          <span class='end end kw'>end</span>
+        <span class='end end kw'>end</span>
+      <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+</div>
+  </div>
+
+</div>
+    </div>
+  </body>
+</html>