inochi 4.0.1 → 5.0.0

metadata

@@ -3,18 +3,18 @@ name: inochi
 version: !ruby/object:Gem::Version 
   prerelease: false
   segments: 
-  - 4
+  - 5
   - 0
-  - 1
-  version: 4.0.1
+  - 0
+  version: 5.0.0
 platform: ruby
-authors: 
-- Suraj N. Kurapati
+authors: []
+
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-07-28 00:00:00 -07:00
+date: 2010-08-07 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -133,30 +133,10 @@ dependencies:
         version: "1"
   type: :runtime
   version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  name: ronn
-  prerelease: false
-  requirement: &id007 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 7
-        - 0
-        version: 0.7.0
-    - - <
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        version: "1"
-  type: :runtime
-  version_requirements: *id007
 - !ruby/object:Gem::Dependency 
   name: yard
   prerelease: false
-  requirement: &id008 !ruby/object:Gem::Requirement 
+  requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -172,8 +152,8 @@ dependencies:
         - 1
         version: "1"
   type: :runtime
-  version_requirements: *id008
-description: Inochi is an infrastructure for Ruby projects that helps you test, document, package, publish, and announce your projects. It encourages great documentation and reduces project administrivia.
+  version_requirements: *id007
+description: ""
 email: 
 executables: 
 - inochi
@@ -191,30 +171,28 @@ files:
 - lib/inochi/templates/CREDITS.rbs
 - lib/inochi/templates/inochi.rb.rbs
 - lib/inochi/templates/test_runner.rbs
+- lib/inochi/templates/inochi.conf.rbs
 - lib/inochi/templates/LICENSE.rbs
 - lib/inochi/templates/README.rbs
 - lib/inochi/templates/HACKING.rbs
+- lib/inochi/templates/INSTALL.rbs
 - lib/inochi/templates/USAGE.rbs
 - lib/inochi/templates/library.rbs
 - lib/inochi/templates/command.rbs
 - lib/inochi/templates/HISTORY.rbs
-- lib/inochi/templates/EXAMPLES.rbs
+- lib/inochi/templates/SYNOPSIS.rbs
 - lib/inochi/templates/library_test.rb.rbs
 - lib/inochi/templates/BEYOND.rbs
 - lib/inochi/templates/MANUAL.rbs
-- lib/inochi/templates/inochi.opts.rbs
 - lib/inochi/tasks/2-api.rake
-- lib/inochi/tasks/0-project.rake
+- lib/inochi/tasks/3-man.rake.css
 - lib/inochi/tasks/4-ann.rake
 - lib/inochi/tasks/6-pub.rake
-- lib/inochi/tasks/1-init.rake
 - lib/inochi/tasks/3-man.rake
 - lib/inochi/tasks/5-gem.rake
 - LICENSE
 - CREDITS
-- man.html
-- man/man1/inochi.1.gz
-- logo/inochi.png
+- man/man1/inochi.1
 has_rdoc: true
 homepage: http://snk.tuxfamily.org/lib/inochi/
 licenses: []

data/lib/inochi/tasks/0-project.rake

@@ -1,25 +0,0 @@
-task :@project do
-  begin
-    @project_options_file = 'inochi.opts'
-    @project_options = YAML.load_file(@project_options_file).to_hash
-
-    # load the project module
-    library_file = Dir['lib/*/inochi.rb'].first
-    package_name = File.basename(File.dirname(library_file))
-    library_name = File.read(library_file)[/\b(module|class)\b\s+(\w+)/, 2]
-
-    $LOAD_PATH.unshift 'lib'
-    require "#{package_name}/inochi"
-
-    @project_module = Object.const_get(library_name)
-    @project_package_name = package_name
-    @project_library_name = library_name
-    @project_gem_file = "#{@project_package_name}-#{@project_module::VERSION}.gem"
-  rescue
-    puts
-    puts 'The current directory is not an Inochi project.'
-    puts 'Run the `inochi init` command to make it one.'
-    puts
-    raise
-  end
-end

data/lib/inochi/tasks/1-init.rake

@@ -1,38 +0,0 @@
-desc 'Instill Inochi into current directory.'
-task :init do
-
-  unless project_name = ENV['project']
-    raise ArgumentError, 'project name not specified'
-  end
-
-  library_name = Engine.calc_library_name(project_name)
-  package_name = ENV['package'] || Engine.calc_package_name(library_name)
-
-  project_version = '0.0.0'
-  project_release = Time.now.strftime('%F')
-
-  command_file = "bin/#{package_name}"
-  create_from_rbs binding, command_file, 'command'
-  chmod 0755, command_file
-
-  create_from_rbs binding, 'inochi.opts'
-
-  create_from_rbs binding, "lib/#{package_name}.rb", 'library'
-  create_from_rbs binding, "lib/#{package_name}/inochi.rb"
-
-  create_from_rbs binding, 'test/runner', 'test_runner'
-  chmod 0755, 'test/runner'
-  create_from_rbs binding, 'test/helper.rb', 'test_helper.rb'
-  create_from_rbs binding, "test/#{package_name}_test.rb", 'library_test.rb'
-
-  create_from_rbs binding, 'LICENSE'
-  create_from_rbs binding, 'README'
-  create_from_rbs binding, 'MANUAL'
-  create_from_rbs binding, 'USAGE'
-  create_from_rbs binding, 'EXAMPLES'
-  create_from_rbs binding, 'HACKING'
-  create_from_rbs binding, 'HISTORY'
-  create_from_rbs binding, 'CREDITS'
-  create_from_rbs binding, 'BEYOND'
-
-end

data/lib/inochi/templates/EXAMPLES.rbs

@@ -1,24 +0,0 @@
-%#----------------------------------------------------------------------------
-## EXAMPLES
-%#----------------------------------------------------------------------------
-
-> TODO: give examples of how to use your
->       project to perform certain tasks
-
-%#----------------------------------------------------------------------------
-### A task
-%#----------------------------------------------------------------------------
-
-> TODO: explain how to perform this task
-
-%#----------------------------------------------------------------------------
-### Another task
-%#----------------------------------------------------------------------------
-
-> TODO: explain how to perform this task
-
-%#----------------------------------------------------------------------------
-### Yet another task
-%#----------------------------------------------------------------------------
-
-> TODO: explain how to perform this task

data/man.html

@@ -1,1229 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
-  <title>inochi(1) - Gives life to Ruby projects</title>
-  <style type='text/css' media='all'>
-  /* style: man */
-  body#manpage {margin:0}
-  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
-  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
-  .mp h2 {margin:10px 0 0 0}
-  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
-  .mp h3 {margin:0 0 0 4ex}
-  .mp dt {margin:0;clear:left}
-  .mp dt.flush {float:left;width:8ex}
-  .mp dd {margin:0 0 0 9ex}
-  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
-  .mp pre {margin-bottom:20px}
-  .mp pre+h2,.mp pre+h3 {margin-top:22px}
-  .mp h2+pre,.mp h3+pre {margin-top:5px}
-  .mp img {display:block;margin:auto}
-  .mp h1.man-title {display:none}
-  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
-  .mp h2 {font-size:16px;line-height:1.25}
-  .mp h1 {font-size:20px;line-height:2}
-  .mp {text-align:justify;background:#fff}
-  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
-  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
-  .mp u {text-decoration:underline}
-  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
-  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
-  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
-  .mp b.man-ref {font-weight:normal;color:#434241}
-  .mp pre {padding:5px 1ex;background:#edeceb;border-left:1ex solid #ddd}
-  .mp pre code {font-weight:normal;color:#434241}
-  .mp h2+pre,h3+pre {padding-left:0}
-  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
-  ol.man-decor {width:100%}
-  ol.man-decor li.tl {text-align:left}
-  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
-  ol.man-decor li.tr {text-align:right;float:right}
-  </style>
-  <style type='text/css' media='all'>
-  /* style: toc */
-  .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:36px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
-  .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 20px;color:#999;text-decoration:none}
-  .man-navigation a:hover {color:#111;text-decoration:underline}
-  </style>
-  <style type='text/css' media='all'>
-  /* style: 80c */
-  .mp {max-width:78ex}
-   
-  .man-navigation {left:91ex}
-  </style>
-</head>
-<!--
-  The following styles are deprecated and will be removed at some point:
-  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
-
-  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
-  .man-navigation should be used instead.
--->
-<body id='manpage'>
-  <div class='mp' id='man'>
-
-  <div class='man-navigation' style='display:none'>
-    <a href="#NAME">NAME</a>
-    <a href="#SYNOPSIS">SYNOPSIS</a>
-    <a href="#DESCRIPTION">DESCRIPTION</a>
-    <a href="#OPTIONS">OPTIONS</a>
-    <a href="#TASKS">TASKS</a>
-    <a href="#PROJECTS">PROJECTS</a>
-    <a href="#TUTORIAL">TUTORIAL</a>
-    <a href="#HACKING">HACKING</a>
-    <a href="#HISTORY">HISTORY</a>
-    <a href="#AUTHORS">AUTHORS</a>
-    <a href="#CREDITS">CREDITS</a>
-    <a href="#LICENSE">LICENSE</a>
-    <a href="#SEE-ALSO">SEE ALSO</a>
-    <a href="#Features">Features</a>
-    <a href="#Resources">Resources</a>
-    <a href="#Setup">Setup</a>
-    <a href="#inochi-init">inochi init</a>
-    <a href="#inochi-api">inochi api</a>
-    <a href="#inochi-man">inochi man</a>
-    <a href="#inochi-gem">inochi gem</a>
-    <a href="#inochi-ann">inochi ann</a>
-    <a href="#inochi-pub-ann-ruby-talk">inochi pub:ann:ruby-talk</a>
-    <a href="#inochi-pub-web">inochi pub:web</a>
-    <a href="#Options-file">Options file</a>
-    <a href="#License-file">License file</a>
-    <a href="#Ruby-library">Ruby library</a>
-    <a href="#Test-suite">Test suite</a>
-    <a href="#Shell-command">Shell command</a>
-    <a href="#Help-manual">Help manual</a>
-    <a href="#Web-presence">Web presence</a>
-    <a href="#Creating-a-new-project">Creating a new project</a>
-    <a href="#Running-the-shell-command">Running the shell command</a>
-    <a href="#Building-the-help-manual">Building the help manual</a>
-    <a href="#Implementing-the-project">Implementing the project</a>
-    <a href="#Prerequisites">Prerequisites</a>
-    <a href="#Infrastructure">Infrastructure</a>
-    <a href="#-LOAD_PATH-setup">$LOAD_PATH setup</a>
-    <a href="#RubyGems-setup">RubyGems setup</a>
-    <a href="#Running-tests">Running tests</a>
-    <a href="#Contributing">Contributing</a>
-    <a href="#Version-4-0-1-2010-07-28-">Version 4.0.1 (2010-07-28)</a>
-    <a href="#Version-4-0-0-2010-07-25-">Version 4.0.0 (2010-07-25)</a>
-    <a href="#Version-3-0-0-2010-04-27-">Version 3.0.0 (2010-04-27)</a>
-    <a href="#Version-2-0-1-2010-04-25-">Version 2.0.1 (2010-04-25)</a>
-    <a href="#Version-2-0-0-2010-04-24-">Version 2.0.0 (2010-04-24)</a>
-    <a href="#Version-1-1-1-2009-10-03-">Version 1.1.1 (2009-10-03)</a>
-    <a href="#Version-1-1-0-2009-09-06-">Version 1.1.0 (2009-09-06)</a>
-    <a href="#Version-1-0-0-2009-05-03-">Version 1.0.0 (2009-05-03)</a>
-    <a href="#Version-0-3-0-2009-02-12-">Version 0.3.0 (2009-02-12)</a>
-    <a href="#Version-0-2-0-2009-01-25-">Version 0.2.0 (2009-01-25)</a>
-    <a href="#Version-0-1-0-2009-01-13-">Version 0.1.0 (2009-01-13)</a>
-    <a href="#Version-0-0-1-2009-01-13-">Version 0.0.1 (2009-01-13)</a>
-    <a href="#Version-0-0-0-2009-01-13-">Version 0.0.0 (2009-01-13)</a>
-    </div>
-
-  <ol class='man-decor man-head man head'>
-    <li class='tl'>inochi(1)</li>
-    <li class='tc'>Version 4.0.1</li>
-    <li class='tr'>inochi(1)</li>
-  </ol>
-
-  <h2 id="NAME">NAME</h2>
-<p class="man-name">
-  <code>inochi</code> - <span class="man-whatis">Gives life to Ruby projects</span>
-</p>
-
-<p><img src="logo/inochi.png" alt="" /></p>
-
-<p>Inochi is an infrastructure for Ruby projects that helps you test, document,
-package, publish, and announce your projects.  It encourages <em>great</em>
-documentation and reduces project administrivia.</p>
-
-<h3 id="Features">Features</h3>
-
-<ul>
-<li><p>Provides a comprehensive help manual that is written in <a href="http://en.wikipedia.org/wiki/ERuby">eRuby</a> over
-<a href="http://daringfireball.net/projects/markdown">Markdown</a> and is rendered into a Web page and a UNIX manual page.</p></li>
-<li><p>Announces project releases on <a href="http://raa.ruby-lang.org">RAA</a>, <a href="http://www.ruby-lang.org/en/community/mailing-lists/">ruby-talk</a>, and via RSS feed.</p></li>
-<li><p>Stores project information in a single Ruby source file.</p></li>
-</ul>
-
-
-<h3 id="Resources">Resources</h3>
-
-<dl>
-<dt>Issue tracker (report bugs, request features, get help)</dt><dd><p><a href="http://github.com/sunaku/inochi/issues" data-bare-link="true">http://github.com/sunaku/inochi/issues</a></p></dd>
-<dt>Source code (browse online or obtain with <a href="http://git-scm.com">Git</a>)</dt><dd><p><a href="http://github.com/sunaku/inochi" data-bare-link="true">http://github.com/sunaku/inochi</a></p></dd>
-<dt>API documentation</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/api/" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/api/</a></p></dd>
-<dt>Announcements feed</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/ann.xml" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/ann.xml</a></p></dd>
-<dt>Official website</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/</a></p></dd>
-</dl>
-
-
-<h3 id="Setup">Setup</h3>
-
-<p>Prerequisites:</p>
-
-<ul>
-<li><p><a href="http://ruby-lang.org">Ruby</a> 1.8.6 or newer.</p></li>
-<li><p><a href="http://rubygems.org">RubyGems</a> 1.3.6 or newer.</p></li>
-<li><p><a href="http://lynx.isc.org">Lynx</a> 2.8.6 or newer.</p></li>
-</ul>
-
-
-<p>Installing:</p>
-
-<pre><code>gem install inochi
-</code></pre>
-
-<p>Upgrading:</p>
-
-<pre><code>gem update inochi
-</code></pre>
-
-<p>Removing:</p>
-
-<pre><code>gem uninstall inochi
-</code></pre>
-
-<h2 id="SYNOPSIS">SYNOPSIS</h2>
-
-<p><code>inochi</code> [<var>OPTIONS</var>] <var>TASK</var> [<var>RAKE_OPTIONS</var>]</p>
-
-<p><code>inochi init</code> project=<var>PROJECT</var> [package=<var>PACKAGE</var>] [merger=<var>MERGER</var>]</p>
-
-<h2 id="DESCRIPTION">DESCRIPTION</h2>
-
-<p>Runs the given <var>TASK</var> (see <strong>TASKS</strong> below) while passing the given
-<var>RAKE_OPTIONS</var> to <span class="man-ref">rake<span class="s">(1)</span></span>.</p>
-
-<h2 id="OPTIONS">OPTIONS</h2>
-
-<dl>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>Display this manual and exit.</p></dd>
-<dt><code>-v</code>, <code>--version</code></dt><dd><p>Print version number and exit.</p></dd>
-</dl>
-
-
-<h2 id="TASKS">TASKS</h2>
-
-<p>The following tasks are available for running.  Some of them are explained in
-more detail below.</p>
-
-<dl>
-<dt class="flush"><strong>ann</strong></dt><dd>Build all release announcements.</dd>
-<dt><strong>ann:feed</strong></dt><dd>Build RSS feed announcement.</dd>
-<dt><strong>ann:html</strong></dt><dd>Build HTML announcement.</dd>
-<dt><strong>ann:text</strong></dt><dd>Build plain text announcement.</dd>
-<dt class="flush"><strong>api</strong></dt><dd>Build API documentation.</dd>
-<dt class="flush"><strong>clean</strong></dt><dd>Remove any temporary products.</dd>
-<dt class="flush"><strong>clobber</strong></dt><dd>Remove any generated file.</dd>
-<dt class="flush"><strong>gem</strong></dt><dd>Build release package for RubyGems.</dd>
-<dt class="flush"><strong>init</strong></dt><dd>Instill Inochi into current directory.</dd>
-<dt class="flush"><strong>man</strong></dt><dd>Build the help manual.</dd>
-<dt class="flush"><strong>pub</strong></dt><dd>Publish a release of this project.</dd>
-<dt class="flush"><strong>pub:ann</strong></dt><dd>Announce release on all news outlets.</dd>
-<dt><strong>pub:ann:raa</strong></dt><dd>Announce release on RAA (Ruby Application Archive).</dd>
-<dt><strong>pub:ann:ruby-talk</strong></dt><dd>Announce release on ruby-talk mailing list.</dd>
-<dt class="flush"><strong>pub:gem</strong></dt><dd>Publish gem release package to RubyGems.org.</dd>
-<dt class="flush"><strong>pub:web</strong></dt><dd>Publish help manual, API docs, and RSS feed to project website.</dd>
-</dl>
-
-
-<h3 id="inochi-init">inochi init</h3>
-
-<p>Installs the Inochi infrastructure for the project (see <strong>PROJECTS</strong> below) in
-the current working directory or upgrades a previous installation thereof.</p>
-
-<p><code>inochi</code> init <code>project</code>=<var>PROJECT</var> [<code>package</code>=<var>PACKAGE</var>] [<code>merger</code>=<var>MERGER</var>]</p>
-
-<dl>
-<dt class="flush"><var>PROJECT</var></dt><dd><p>Name of the project.  This will be normalized into the name of a Ruby
-module that will serve as a namespace for all code in the project.</p></dd>
-<dt class="flush"><var>PACKAGE</var></dt><dd><p>Name of the project's package directory, shell command, and basename of the
-project library file.</p></dd>
-<dt class="flush"><var>MERGER</var></dt><dd><p>Command that invokes a text merging tool with three arguments: (1) old file,
-(2) new file, (3) output file.  The command should direct the result of
-merging the old file and the new file to the output file.  In addition, the
-command <em>must not</em> modify the old file or the new file.</p></dd>
-</dl>
-
-
-<p>Pre-existing files are not overwritten.  Instead, it is your responsibility to
-merge changes between pre-existing and newly generated files.  You can do this
-with the aid of an automated text merging tool such as <a href="http://meld.sourceforge.net">meld</a>, <a href="http://tkdiff.sourceforge.net">tkdiff</a>, or
-<a href="http://kdiff3.sourceforge.net">kdiff3</a> by following these steps:</p>
-
-<ol>
-<li><p>Create a file named <code>merge2</code> containing the following text:</p>
-
-<pre><code>#!/bin/sh
-old=$1; new=$2; out=$3;
-# meld "$new" "$out"                            # use meld
-# tkdiff "$old" "$new" -o "$out"                # use tkdiff
-# kdiff3 --merge "$old" "$new" --output "$out"  # use kdiff3
-</code></pre></li>
-<li><p>Uncomment the line corresponding to the tool you wish to use.</p></li>
-<li><p>Make the file executable:</p>
-
-<pre><code>chmod +x merge2
-</code></pre></li>
-<li><p>Pass the file's path as the value of <var>MERGER</var>:</p>
-
-<pre><code>inochi init merger=path/to/merge2
-</code></pre></li>
-</ol>
-
-
-<p>Now your chosen text merging tool will be launched to help you transfer your
-changes.  When you are finished, save the merged file and exit the merging
-tool.  If you do not want to transfer any changes, then simply exit the
-merging tool <em>without saving</em> any changes to the merged file!</p>
-
-<h3 id="inochi-api">inochi api</h3>
-
-<p>Builds API documentation for the project's Ruby library using <a href="http://yardoc.org/more">YARD</a>.  Ruby
-constructs marked with <code>@private</code> are omitted from the API documentation.</p>
-
-<h3 id="inochi-man">inochi man</h3>
-
-<p>Renders the help manual's source files (see <strong>Help manual</strong> below) into:</p>
-
-<dl>
-<dt>man.ronn</dt><dd><p><a href="http://github.com/rtomayko/ronn">Ronn</a> format, rendered by <a href="http://snk.tuxfamily.org/lib/ember/">Ember</a>.</p></dd>
-<dt>man.html</dt><dd><p>HTML (Web page) format, rendered by <a href="http://github.com/rtomayko/ronn">Ronn</a>.</p></dd>
-<dt>man/man1/<var>PACKAGE</var>.1.gz</dt><dd><p>Roff (UNIX manual page) format, rendered by <a href="http://github.com/rtomayko/ronn">Ronn</a>.</p></dd>
-</dl>
-
-
-<h3 id="inochi-gem">inochi gem</h3>
-
-<p>Builds a release package in RubyGems format (plainly known as a <strong>gem</strong>):</p>
-
-<dl>
-<dt><var>PACKAGE</var>-<var>VERSION</var>.gem</dt><dd><p>The gem itself.</p></dd>
-<dt><var>PACKAGE</var>-<var>VERSION</var>.gemspec</dt><dd><p>Ruby representation of the gem's specification.</p></dd>
-</dl>
-
-
-<p>The gem specification is pre-initialized with information from the project's
-Ruby library and help manual.  In particular:</p>
-
-<dl>
-<dt>gem.description</dt><dd><p>Plain text version of all content between the <strong>ABOUT</strong> heading and any
-subsequent heading.</p></dd>
-<dt>gem.authors</dt><dd><p>Plain text version of all content between the <strong>AUTHORS</strong> heading and any
-subsequent heading.</p></dd>
-<dt>gem.files</dt><dd><p>Only contains the project's <code>LICENSE</code> and <code>CREDITS</code> files, rendered help
-manual, Ruby library, shell command, and C extension.</p>
-
-<p>All other files (such as the test suite and help manual source files) are
-omitted (1) to reduce the gem file size and (2) because they are really only
-needed during development.</p></dd>
-</dl>
-
-
-<p>The gem specification can be further customized through the <code>:gem_spec_logic</code>
-parameter defined in the project's options file (see <strong>Options file</strong> below).</p>
-
-<h3 id="inochi-ann">inochi ann</h3>
-
-<p>Builds release announcements which can be edited by hand before publishing:</p>
-
-<dl>
-<dt>ann.html</dt><dd><p>Web page version of the release announcement.</p></dd>
-<dt class="flush">ann.txt</dt><dd><p>Plain text version of the release announcement; converted from the Web page
-version by <a href="http://lynx.isc.org">Lynx</a>.</p></dd>
-<dt class="flush">ann.xml</dt><dd><p>RSS feed version of the release announcement.</p></dd>
-</dl>
-
-
-<h3 id="inochi-pub-ann-ruby-talk">inochi pub:ann:ruby-talk</h3>
-
-<p>Announces the release on the <a href="http://www.ruby-lang.org/en/community/mailing-lists/">ruby-talk</a> mailing list.</p>
-
-<p>It is recommended that you build, review, and edit the <code>ann.txt</code> file <em>by
-hand</em> before running this command because (1) the body of that file is
-published directly as the announcement message and (2) HTML to plain text
-conversion is not perfect.</p>
-
-<h3 id="inochi-pub-web">inochi pub:web</h3>
-
-<p>Publishes the help manual, API documentation, and RSS feed to project website
-using <span class="man-ref">rsync<span class="s">(1)</span></span> according to the :pub_web_* parameters defined in the
-project's options file (see <strong>Options file</strong> below).</p>
-
-<h2 id="PROJECTS">PROJECTS</h2>
-
-<p>A project instilled with Inochi is composed of an options file, a license,
-source code, documentation, and a Web presence; which are all explained below.</p>
-
-<h3 id="Options-file">Options file</h3>
-
-<p>A project's options file is a <a href="http://www.yaml.org/YAML_for_ruby.html">YAML</a> document named <code>inochi.opts</code> that defines
-the following optional parameters for the various <a class="man-ref" href="inochi.1.html">inochi<span class="s">(1)</span></a> sub-commands:</p>
-
-<dl>
-<dt>:pub_web_target</dt><dd><p>Location where <code>inochi pub:web</code> will upload files.  This value
-can use any local/remote/protocol syntax supported by <span class="man-ref">rsync<span class="s">(1)</span></span>.</p></dd>
-<dt>:pub_web_options</dt><dd><p>Options for <span class="man-ref">rsync<span class="s">(1)</span></span>, which uploads files for <code>inochi pub:web</code>.</p></dd>
-<dt>:pub_web_extras</dt><dd><p>Additional files for <code>inochi pub:web</code> to upload.  The values listed
-here can use any local/remote/protocol syntax supported by <span class="man-ref">rsync<span class="s">(1)</span></span>.</p>
-
-<p>Example:</p>
-
-<pre><code>:pub_web_extras:
-  - some/file
-  - some_user@some_host:some/path
-</code></pre></dd>
-<dt>:gem_spec_logic</dt><dd><p>Arbitrary Ruby code that will configure this project's RubyGem before it
-is built by <code>inochi gem</code>.  This code has access to a local variable named
-<code>gem</code> which holds a Gem::Specification object representing this project.</p>
-
-<p>Example:</p>
-
-<pre><code>:gem_spec_logic: |
-  # show the Inochi-provided specification for this project's gem
-  puts gem.to_ruby
-
-  # add files that are outside this project directory to the gem
-  gem.files += ['some', 'files', 'in', 'this', 'directory']
-
-  # omit some added files in this project's directory from the gem
-  gem.files -= ['lib/top_secret.rb', 'bin/more_top_secret_stuff']
-
-  # and so on...  anything is possible!  use your imagination!
-</code></pre></dd>
-</dl>
-
-
-<h3 id="License-file">License file</h3>
-
-<p>A project's license defines the legal conditions under which the project is
-developed and distributed.  It is stored in a file named LICENSE at the root
-of the project directory.</p>
-
-<h3 id="Ruby-library">Ruby library</h3>
-
-<p>A project's Ruby library is composed of the following files:</p>
-
-<dl>
-<dt>lib/<var>PACKAGE</var>.rb</dt><dd><p>Defines the project's namespace (Ruby module or class) and registers
-sub-libraries to be automatically loaded on demand (Kernel#autoload).</p></dd>
-<dt>lib/<var>PACKAGE</var>/inochi.rb</dt><dd><p>Defines project information in Ruby constants within the project's namespace
-(Ruby module or class) and establishes version constraints for gems this
-project depends on if RubyGems is available in the user's environment.
-Unsatisfied constraints are simply printed to the standard error stream;
-they do not raise a <code>Gem::LoadError</code> exception.</p></dd>
-</dl>
-
-
-<h3 id="Test-suite">Test suite</h3>
-
-<p>A project's test suite is composed of the following files:</p>
-
-<dl>
-<dt>test/runner</dt><dd><p>Executable Ruby script that hides the details of running the test suite.</p></dd>
-<dt>test/helper.rb</dt><dd><p>Ruby source file that prepares the testing environment by loading a testing
-library and defining common knowledge and utility logic shared by the actual
-tests.</p></dd>
-<dt>test/**/*_test.rb</dt><dd><p>Part of the test suite.  Performs the actual testing.</p></dd>
-</dl>
-
-
-<h3 id="Shell-command">Shell command</h3>
-
-<p>A project's shell command is an executable Ruby source file that serves as a
-gateway into the project's Ruby library from the command line:</p>
-
-<dl>
-<dt>bin/<var>PACKAGE</var></dt><dd>Expects the project's <code>lib/</code> directory to be on Ruby's $LOAD_PATH (see
-<strong>HACKING</strong> below).  This requirement is automatically met when a user
-installs the project using RubyGems.</dd>
-</dl>
-
-
-<h3 id="Help-manual">Help manual</h3>
-
-<p>A project's help manual is a monolithic <a href="http://en.wikipedia.org/wiki/ERuby">eRuby</a> template that is (1) processed
-by <a href="http://snk.tuxfamily.org/lib/ember/">Ember</a> with its shorthand notation, hierarchical unindentation, and
-missing <code>&lt;% end %></code> inference features enabled, and (2) composed of the
-following source files:</p>
-
-<dl>
-<dt class="flush">MANUAL</dt><dd><p>Primary source file of the help manual that (1) defines common knowledge and
-utility logic and (2) divides its content into the following files for
-easier editing and maintenance.</p></dd>
-<dt class="flush">README</dt><dd><p>Introduces the project, its Web presence, and gives setup instructions.</p></dd>
-<dt class="flush">USAGE</dt><dd><p>Explains how to use the project's shell command.</p></dd>
-<dt>EXAMPLES</dt><dd><p>Illustrates how to perform common tasks with the project's shell command and
-Ruby library, respectively.</p></dd>
-<dt class="flush">HACKING</dt><dd><p>Instructs fellow software developers on running, testing, and hacking the
-project's source code.</p></dd>
-<dt class="flush">HISTORY</dt><dd><p>Records notes about current and past releases of the project in terms of
-incompatible changes, new features, bug fixes, and housekeeping activities.</p></dd>
-<dt class="flush">CREDITS</dt><dd><p>Attributes all developers and contributors whose efforts have made the
-project what it is today.</p></dd>
-<dt class="flush">FURTHER</dt><dd><p>Refers to related commands, help manuals, and topics beyond this project.</p></dd>
-</dl>
-
-
-<h3 id="Web-presence">Web presence</h3>
-
-<p>A project's a Web presence is composed, at minimum, of the following:</p>
-
-<dl>
-<dt>Code repository</dt><dd><p>Where fellow software developers can obtain the latest source code.</p></dd>
-<dt>Issue tracker</dt><dd><p>Where users and contributors can submit patches, request features, and get
-help.</p></dd>
-<dt>Official website</dt><dd><p>Where the help manual, API documentation, and announcements RSS feed can be
-accessed (hopefully) permanently.</p></dd>
-</dl>
-
-
-<p>You may choose to omit some or all of these components by simply not
-mentioning them in the <strong>Resources</strong> section of the help manual's README
-source file.</p>
-
-<h2 id="TUTORIAL">TUTORIAL</h2>
-
-<p>This section shows Inochi is used to create a simple WordCount project.</p>
-
-<h3 id="Creating-a-new-project">Creating a new project</h3>
-
-<p>Create a directory for the project:</p>
-
-<pre><code>mkdir word_count
-</code></pre>
-
-<p>Instill Inochi into the directory:</p>
-
-<pre><code>cd word_count
-inochi init project=WordCount
-</code></pre>
-
-<p>Review pending work marked as "TODO":</p>
-
-<pre><code>grep TODO -R .
-</code></pre>
-
-<h3 id="Running-the-shell-command">Running the shell command</h3>
-
-<p>Run the project's shell command:</p>
-
-<pre><code>ruby -Ilib bin/word_count
-</code></pre>
-
-<p>View the project version number:</p>
-
-<pre><code>ruby -Ilib bin/word_count --version
-</code></pre>
-
-<p>View the project help manual:</p>
-
-<pre><code>ruby -Ilib bin/word_count --help
-</code></pre>
-
-<h3 id="Building-the-help-manual">Building the help manual</h3>
-
-<p>Build the help manual:</p>
-
-<pre><code>inochi man
-</code></pre>
-
-<p>View the help manual in a terminal:</p>
-
-<pre><code>man man/man1/word_count.1.gz
-</code></pre>
-
-<p>View the help manual in a Web browser:</p>
-
-<pre><code>man.html
-</code></pre>
-
-<h3 id="Implementing-the-project">Implementing the project</h3>
-
-<p>Append the following code to the <code>test/word_count_test.rb</code> file:</p>
-
-<pre><code>class TestWordCount &lt; Test::Unit::TestCase
-  def test_handles_empty_input
-    assert_equal(0, WordCount.count(nil))
-    assert_equal(0, WordCount.count(''))
-    assert_equal(0, WordCount.count(' '))
-  end
-
-  def test_handles_single_words
-    assert_equal(1, WordCount.count('a'))
-    assert_equal(1, WordCount.count('foo'))
-    assert_equal(1, WordCount.count('bar'))
-  end
-
-  def test_handles_multiple_words
-    assert_equal(2, WordCount.count('a b'))
-    assert_equal(2, WordCount.count('a-b'))
-    assert_equal(2, WordCount.count('a/b'))
-  end
-
-  def test_ignores_punctuation_and_space
-    assert_equal(0, WordCount.count('!'))
-    assert_equal(0, WordCount.count('! @ # % #!@#'))
-    assert_equal(0, WordCount.count(' !'))
-    assert_equal(0, WordCount.count('! '))
-    assert_equal(0, WordCount.count(' ! '))
-    assert_equal(0, WordCount.count('   !   '))
-  end
-end
-</code></pre>
-
-<p>Run the test suite and observe that all tests fail:</p>
-
-<pre><code>ruby test/runner
-</code></pre>
-
-<p>Append the following code to the <code>lib/word_count.rb</code> file:</p>
-
-<pre><code>module WordCount
-  # Returns the number of words in the given input.
-  def WordCount.count input
-    input.to_s.split(/\W+/).length
-  end
-end
-</code></pre>
-
-<p>Run the test suite again and observe that all tests pass:</p>
-
-<pre><code>ruby test/runner
-</code></pre>
-
-<p>Append the following code to the <code>bin/word_count</code> file:</p>
-
-<pre><code>input = ARGF.read
-total = WordCount.count(input)
-puts "There are #{total} words in the input."
-</code></pre>
-
-<p>Run the project's shell command on the <code>README</code> file:</p>
-
-<pre><code>ruby -Ilib bin/word_count README
-</code></pre>
-
-<h2 id="HACKING">HACKING</h2>
-
-<p>This section is meant for people who want to develop Inochi's source code.</p>
-
-<h3 id="Prerequisites">Prerequisites</h3>
-
-<p>Install Ruby libraries necessary for development:</p>
-
-<pre><code>gem install inochi --development
-</code></pre>
-
-<h3 id="Infrastructure">Infrastructure</h3>
-
-<p><a href="http://snk.tuxfamily.org/lib/inochi/">Inochi</a> serves as the project infrastructure for Inochi.  It handles tasks
-such as building this help manual and API documentation, and packaging,
-announcing, and publishing new releases.  See its help manual and list of
-tasks to get started:</p>
-
-<pre><code>inochi --help     # display help manual
-inochi --tasks    # list available tasks
-</code></pre>
-
-<h3 id="-LOAD_PATH-setup">$LOAD_PATH setup</h3>
-
-<p>Ensure that the <code>lib/</code> directory is listed in Ruby's <code>$LOAD_PATH</code> before you
-use any libraries therein or run any executables in the <code>bin/</code> directory.</p>
-
-<p>This can be achieved by passing an option to Ruby:</p>
-
-<pre><code>ruby -Ilib bin/inochi
-irb -Ilib -r inochi
-</code></pre>
-
-<p>Or by setting the <code>$RUBYLIB</code> environment variable:</p>
-
-<pre><code>export RUBYLIB=lib   # bash, ksh, zsh
-setenv RUBYLIB lib   # csh
-set -x RUBYLIB lib   # fish
-
-ruby bin/inochi
-irb -r inochi
-</code></pre>
-
-<p>Or by running Ruby through the <a href="http://github.com/chneukirchen/rup/blob/master/ruby-wrapper">ruby-wrapper</a> tool.</p>
-
-<h3 id="RubyGems-setup">RubyGems setup</h3>
-
-<p>If you use Ruby 1.8 or older, then ensure that RubyGems is activated before
-you use any libraries in the <code>lib/</code> directory or run any executables in the
-<code>bin/</code> directory.</p>
-
-<p>This can be achieved by passing an option to Ruby:</p>
-
-<pre><code>ruby -rubygems bin/inochi
-irb -rubygems -r inochi
-</code></pre>
-
-<p>Or by setting the <code>$RUBYOPT</code> environment variable:</p>
-
-<pre><code>export RUBYOPT=-rubygems   # bash, ksh, zsh
-setenv RUBYOPT -rubygems   # csh
-set -x RUBYOPT -rubygems   # fish
-</code></pre>
-
-<h3 id="Running-tests">Running tests</h3>
-
-<p>Simply execute the included test runner, which sets up Ruby's <code>$LOAD_PATH</code> for
-testing, loads the <code>test/helper.rb</code> file, and then evaluates all
-<code>test/**/*_test.rb</code> files:</p>
-
-<pre><code>ruby test/runner
-</code></pre>
-
-<p>Its exit status will indicate whether all tests have passed.  It may also
-print additional pass/fail information depending on the testing library used
-in the <code>test/helper.rb</code> file.</p>
-
-<h3 id="Contributing">Contributing</h3>
-
-<p>Fork this project on GitHub (see <strong>Resources</strong> above) and send a pull request.</p>
-
-<h2 id="HISTORY">HISTORY</h2>
-
-<p>This section contains release notes of current and past releases.</p>
-
-<h3 id="Version-4-0-1-2010-07-28-">Version 4.0.1 (2010-07-28)</h3>
-
-<p>This release fixes a bug in gem version dependency establishment.</p>
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Gem version dependencies were not being established in Ruby 1.8.7 and
-1.9.2 because <code>Kernel#gem</code> <a href="http://redmine.ruby-lang.org/issues/show/3617">is a private method</a> in those Ruby versions.</p>
-
-<p>To propagate this fix into your projects, please reinitialize them with
-this version of Inochi.</p></li>
-</ul>
-
-
-<h3 id="Version-4-0-0-2010-07-25-">Version 4.0.0 (2010-07-25)</h3>
-
-<p>Incompatible changes:</p>
-
-<ul>
-<li>Rename the "VERSIONS" section in the HISTORY file to "HISTORY".</li>
-</ul>
-
-
-<p>Changes you will see in upgraded or newly generated projects:</p>
-
-<ul>
-<li><p>Rename the "FURTHER" file to "BEYOND".</p></li>
-<li><p>Rename <code>test/test_helper.rb</code> to just <code>test/helper.rb</code>.</p></li>
-<li><p>Store resource URLs in variables in MANUAL for reuse.</p></li>
-<li><p>Provide more precise link to ruby-wrapper tool in HACKING.</p></li>
-</ul>
-
-
-<p>New features:</p>
-
-<ul>
-<li><p>Ensure that project version matches release notes before building a gem.
-This helps to prevent the problem where you sometimes forget to update
-both the release notes and the project information file simultaneously.</p></li>
-<li><p>Display announcement message to user (and make them confirm it) before
-publishing to ruby-talk.  This helps to prevent you from appearing inept
-and having to apologize later for your publishing blunders.</p></li>
-<li><p>Add <code>-d</code> (to enable <code>$DEBUG</code>) and <code>-v</code> (to enable <code>$VERBOSE</code>)
-command-line options to the generated <code>test/runner</code> script.</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Various compatibility fixes for Ruby 1.9.2-rc2.</p></li>
-<li><p>Prefix <code>test/runner</code> command with "ruby" for Windows users.</p></li>
-<li><p>Ember::WEBSITE was always being emitted in README.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Add version constraints for YARD and Mechanize dependencies.</p></li>
-<li><p>Upgrade from Dfect 1.1.0 to Detest 3.1.0 for unit testing.</p></li>
-<li><p>Upgrade to Ronn 0.7.0 for generating this user manual.</p></li>
-</ul>
-
-
-<h3 id="Version-3-0-0-2010-04-27-">Version 3.0.0 (2010-04-27)</h3>
-
-<p>Incompatible changes:</p>
-
-<ul>
-<li><p>The <code>require()</code> class method is no longer emitted on your project's
-namespace.  Instead, gem version constraints are established up front when
-your project's Ruby library is first loaded.</p></li>
-<li><p>Author names are now fetched from the AUTHORS section, not CREDITS.</p></li>
-<li><p>Project information is now placed in the NAME section, not ABOUT.</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Reflect current Inochi version in gem constraint.</p></li>
-<li><p>Forgot to list <a href="http://snk.tuxfamily.org/lib/ember/">Ember</a> as a runtime gem dependency.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Move all task documentation into new <strong>TASKS</strong> section.</p></li>
-<li><p>Move TASKS &amp; PROJECTS information into separate files.</p></li>
-</ul>
-
-
-<h3 id="Version-2-0-1-2010-04-25-">Version 2.0.1 (2010-04-25)</h3>
-
-<p>This release fixes some bugs and adds a simple tutorial to the help manual.</p>
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Task files were not loaded in correct order.  As a result, certain Inochi
-tasks would fail (depending on the sorting order of your filesystem) with
-the following cryptic error:</p>
-
-<pre><code>inochi aborted!
-Don't know how to build task ''
-/usr/lib/ruby/gems/1.9.1/gems/rake-0.8.7/lib/rake.rb:1728:in `[]'
-(See full trace by running task with --trace)
-</code></pre></li>
-<li><p>LICENSE file template lacked a "TODO" marker.</p></li>
-<li><p>Forgot version number heading in announcement.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li>Restored the simple WordCount tutorial from version 1.1.1.
-See <strong>TUTORIAL</strong> above.</li>
-</ul>
-
-
-<h3 id="Version-2-0-0-2010-04-24-">Version 2.0.0 (2010-04-24)</h3>
-
-<p>This release makes Inochi a development-time dependency only, documents nearly
-everything in the help manual, renders the help manual as a UNIX manual page,
-simplifies the project infrastructure it provides, and removes needless cruft.</p>
-
-<p>Incompatible changes:</p>
-
-<ul>
-<li><p>Inochi is no longer a runtime dependency (gem or otherwise) for projects
-that use it.  It also no longer runs tests, creates project namespaces, or
-provides libraries for internationalization, combinatorics, command-line
-parsing, utility logic, or Rakefiles.</p>
-
-<p>See <strong>PROJECTS</strong> to learn about the new Inochi infrastructure.</p></li>
-<li><p>The help manual is now processed by <a href="http://github.com/rtomayko/ronn">Ronn</a> instead of <a href="http://snk.tuxfamily.org/lib/erbook/">ERBook</a>.  As a
-result, you may only use plain <a href="http://daringfireball.net/projects/markdown">Markdown</a> and <a href="http://en.wikipedia.org/wiki/ERuby">eRuby</a> when writing it.</p></li>
-<li><p>Announcement publishing tasks no longer read login information from the
-<code>~/.config/inochi/logins.yaml</code> file and prompt you to enter that
-information manually instead.  As a result, the forementioned file is no
-longer recognized or used by Inochi so you may safely delete it.</p></li>
-</ul>
-
-
-<p>New features:</p>
-
-<ul>
-<li><p>The help manual is now available as a UNIX manual page (thanks to <a href="http://github.com/rtomayko/ronn">Ronn</a>)
-and is now divided into smaller files that can be read directly without
-needing a special viewer, and are named according to open-source packaging
-conventions (such as README, HACKING, and LICENSE) so that they draw the
-attention of users unaccustomed to the organization of your project.</p></li>
-<li><p>A <code>require</code> class method is now added to the project's namespace.  This
-method verifies that the library or gem being required meets the
-dependency version constraints defined by the project.</p></li>
-<li><p>A <code>test/runner</code> script is now generated.  It provides a fast,
-self-contained way to run your project's test suite.</p></li>
-<li><p>Inochi is now a Rake application.  A <code>Rakefile</code> is not necessary.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Many KISS and YAGNI fueled iterations later, this is it! :-)</p></li>
-<li><p>Nearly every aspect of Inochi is now meticulously documented in the help
-manual to the best of my ability.  If I missed something important, please
-notify me or contribute the correction yourself!</p></li>
-</ul>
-
-
-<h3 id="Version-1-1-1-2009-10-03-">Version 1.1.1 (2009-10-03)</h3>
-
-<p>This release improves Ruby 1.9 support and upgrades gem dependencies.</p>
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p><code>require()</code> was unable to find project library in Ruby 1.9.2dev.</p></li>
-<li><p>Ruby 1.9 warning about "shadowing outer variable".</p></li>
-<li><p>Ruby 1.9 error about "incompatible encoding regexp match".</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>The "spicycode-rcov" project was officially renamed to "relevance-rcov".</p></li>
-<li><p>Upgrade to RubyForge 2.x library for publishing gems.</p></li>
-</ul>
-
-
-<h3 id="Version-1-1-0-2009-09-06-">Version 1.1.0 (2009-09-06)</h3>
-
-<p>This release improves the user manual and scaffold generator output, injects
-more metadata into gems, adds support for Microsoft web browsers, and fixes
-some bugs.</p>
-
-<p>New features:</p>
-
-<ul>
-<li><p>Add instructions for building gems without Inochi as a runtime dependency.</p></li>
-<li><p>Put release notes in "description" field of gemspec, as <a href="http://www.ruby-forum.com/topic/190220#830072">suggested by Eric
-Hodel</a>, so that subscribers
-of <a href="http://gems.rubyforge.org/index.rss">the RubyForge gems feed</a> are
-aware of the changes in a published gem.</p></li>
-<li><p>Set the "date" field in gemspec to project release date.</p></li>
-<li><p>Change file extension of generated user manuals from .xhtml to .html to
-accomodate Microsoft web browsers' inability to process the
-application/xhtml+xml mime type.</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>The sdoc library was necessary to run 'rake test'.</p></li>
-<li><p>Forgot to add <code>:develop</code> option to scaffold generator output.</p></li>
-<li><p>Make "rake lang:dump" unconditionally overwrite the dump file.</p></li>
-<li><p>Fix gem not being built and prevent Maruku errors for the dummy
-"WordCount" project in the user manual.</p></li>
-<li><p>Use /usr/bin/env instead of /usr/bin/ruby to launch Ruby for better
-portability.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Use simpler Copyright reminder at the top of every file.</p></li>
-<li><p>Open source is for fun, so <a href="http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html">be
-nice</a>:
-speak of "related works" instead of "competitors".</p></li>
-<li><p>Rename "Tutorial" to "General walkthrough" in user manual and add a
-"Specific topics" section for housing uncommon use cases.</p></li>
-<li><p>Remove "logistics" section and redistribute its contents in more
-suitable locations in the user manual.</p></li>
-</ul>
-
-
-<h3 id="Version-1-0-0-2009-05-03-">Version 1.0.0 (2009-05-03)</h3>
-
-<p>This release allows your gems to not depend on Inochi, lets you choose which
-unit testing library to use, adds new utility libraries and rake tasks, and
-fixes some bugs.</p>
-
-<p>Incompatible changes:</p>
-
-<ul>
-<li><p>Your program is no longer halted by <code>Inochi.init()</code> and <code>Inochi.rake()</code> if
-gem dependencies are not satified.  A warning is issued instead.</p></li>
-<li><p>The <code>project_summary</code> and <code>project_history</code> nodes, which are provided by
-<code>Inochi.book()</code> to the user manual, have been renamed to <code>project</code> and
-<code>history</code> respectively.</p></li>
-<li><p>ERBook 7.1.0 is now used for generating the user manual.  This is a major
-step up from the previous version, and so it has incompatible changes.
-See its release notes for details.</p></li>
-<li><p><a href="http://github.com/voloko/sdoc/tree/master">SDoc</a> is now used to generate
-API documentation instead of <a href="http://yard.rubyforge.org">YARD</a>.  If you
-link to particular classes or methods in the generated API documentation,
-be sure to update your link addresses!</p></li>
-<li><p>Minitest is no longer the default testing library.  You must specify which
-testing library you want to use via the <code>:test_with</code> option of the
-<code>Inochi.rake()</code> method.  See the "Test execution" section for details.</p></li>
-<li><p>The "pak" rake task, which is provided by <code>Inochi.rake()</code>, has been
-renamed to "gem".</p></li>
-</ul>
-
-
-<p>New features:</p>
-
-<ul>
-<li><p>Add <code>:inochi_consumer</code> and <code>:inochi_producer</code> options to <code>Inochi.rake()</code>
-which allows you to <em>avoid</em> having Inochi as a runtime and development
-dependency, respectively, for your project's gem.</p>
-
-<p>This is useful if you just want to use Inochi facilities for building a
-gem for a pure Ruby library that does not have any need for Inochi's
-runtime convenience facilities.</p></li>
-<li><p>Add <code>:develop</code> option for <code>Inochi.init()</code> which lets you specify RubyGems
-as development dependencies in the same way as the <code>:require</code> option.</p></li>
-<li><p>Add "lint" rake task which reports <a href="http://www.infoq.com/news/2008/11/static-analysis-tool-roundup">code quality
-statistics</a>.</p></li>
-<li><p>Add "test:cov" rake task which reports code coverage statistics.</p></li>
-<li><p>Add "test:ruby" task which runs all tests with
-<a href="http://www.infoq.com/news/2008/02/multiruby-testing">multiruby</a>.</p></li>
-<li><p>Add 'rake opts=' environment variable, which lets you specify command-line
-arguments directly to the Ruby interpreter, for all test* rake tasks.</p></li>
-<li><p>Add inochi/util/combo combinatorics library for enumerations,
-permutations, and combinations which are all useful in exhaustive
-brute-force unit testing.</p></li>
-<li><p>Add inochi/util/tempdir library which really should be in the Ruby
-standard library.</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>The "enable email notification" checkbox was not activated properly when
-posting announcement to ruby-talk mailing list via Ruby-Forum.</p></li>
-<li><p>Mark gems needed by <code>Inochi.rake()</code> as <em>development</em> dependencies.</p>
-
-<p>Users must now run <code>gem install Inochi --development</code> to install these
-dependencies.  This also solves the recursive dependency problem between
-Inochi and ERBook.</p></li>
-<li><p>Set executable in gem specification only if it exists.</p></li>
-<li><p>Fix parsing of stack trace in Ruby 1.9.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Write contributor names in CREDITS file instead of in the user manual.</p></li>
-<li><p>Use completely lowercase name for Rakefile.</p></li>
-<li><p>Add copyright statement at the top of every source file.</p></li>
-</ul>
-
-
-<h3 id="Version-0-3-0-2009-02-12-">Version 0.3.0 (2009-02-12)</h3>
-
-<p>This release adds support for language translations, improves the user
-interface, and fixes a show-stopper bug for Windows users.</p>
-
-<p>New features:</p>
-
-<ul>
-<li><p>Add support for language translations of phrases used in a project.</p>
-
-<ul>
-<li><p>Add "lang:dump" Rake task for extracting language phrases from project.</p></li>
-<li><p>Add "lang:conv" Rake task for translating dumped phrases into various
-languages using the BabelFish translation service.</p></li>
-<li><p>Add <code>--locale</code> option to a project's main executable for setting user's
-preferred language in spite of the user's locale environment.</p></li>
-</ul>
-</li>
-<li><p>Notify user when attempting to publish announcements in the "pub" Rake
-tasks.</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>In Windows, <code>ENV['USERPROFILE']</code> gives the path to the user's home
-directory and <code>ENV['HOME']</code> is not defined.</p></li>
-<li><p>The only real solution to the circular gem dependency problem is:</p>
-
-<pre><code>gem install --force
-</code></pre>
-
-<p>You should update the "Setup" section in your projects' user manuals
-accordingly.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li><p>Break the huge lib/inochi/inochi.rb library into smaller files.</p></li>
-<li><p>Instead of adding methods to singleton classes directly, define modules
-and extend to them so that YARDoc documents the methods appropriately.</p></li>
-<li><p>List all project contributors globally in the "Credits" section.</p></li>
-<li><p>Remove "Contributor kudos" paragraph in release notes in favor of
-crediting contributors inline with each item in the release notes.</p></li>
-<li><p>Mention that the project license is ISC for the reader's convenience.</p></li>
-</ul>
-
-
-<h3 id="Version-0-2-0-2009-01-25-">Version 0.2.0 (2009-01-25)</h3>
-
-<p>This release adds support for unit testing, improves the portability of
-<strong>Inochi</strong> and configurability of your projects, adds new content to the user
-manual, and fixes some bugs.</p>
-
-<p>New features:</p>
-
-<ul>
-<li><p>Added support for unit testing via the
-<a href="http://rubyforge.org/projects/bfts/">minitest</a> library.</p>
-
-<ul>
-<li>The scaffold generator now emits a default unit test for the main
-project library.</li>
-</ul>
-</li>
-<li><p>Added optional ProgramName parameter to the scaffold generator.  This
-allows you to specify reasonable program names when your project module
-has a strange capitalization:</p>
-
-<pre><code>$ inochi ERBook
-create er_book/LICENSE
-
-$ inochi ERBook erbook
-create erbook/LICENSE
-
-$ inochi ERBook foobar
-create foobar/LICENSE
-</code></pre></li>
-<li><p>Allow project authors to be specified via
-<code>Inochi.init :YourProject, :authors =&gt; [['name', 'mail']]</code>
-(thanks to Florian Gilcher)</p></li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Run on both JRuby and normal Ruby in multiple versions and with different
-executable names on Windows.  (thanks to Florian Gilcher)</p></li>
-<li><p>Use <code>Gem::RubyGemsVersion</code> instead of a shell command to determine
-rubygems version for generation of setup.erb.  (thanks to Florian Gilcher)</p></li>
-<li><p>Add blank lines between all list items, not just multi-line ones, in the
-plain-text version of the release announcement for improved readability.</p></li>
-<li><p>Omit LaTeX-style heading numbers from release announcements.  They caused
-confusion, especially in plain-text announcements, when trying to
-determine which version of a project was released.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<dl>
-<dt>Added unit tests for utility methods provided by the <strong>Inochi</strong> module</dt><dd>project name calculation and CamelCase to snake_case conversion.</dd>
-</dl>
-
-
-<h3 id="Version-0-1-0-2009-01-13-">Version 0.1.0 (2009-01-13)</h3>
-
-<p>This release reattempts to fix the <a href="http://www.ruby-forum.com/topic/176173#771281">circular dependency
-problem</a> that occurred when
-installing either Inochi or ERBook.</p>
-
-<p>New features:</p>
-
-<ul>
-<li><code>Inochi.init()</code> now adds <code>#major()</code>, <code>#series()</code>, and <code>#requirement()</code>
-instance methods to a project's <code>VERSION</code> constant.</li>
-</ul>
-
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>Solved circular dependency problem by making inochi gem not dependent on
-erbook gem. However, ERBook is still required during runtime and is
-supplied on the <code>gem install</code> command for <strong>Inochi</strong>.</p>
-
-<p>The "Installing" section has been updated accordingly.</p></li>
-<li><p>Add forgotten Rake dependency for <strong>Inochi</strong> gem.</p></li>
-</ul>
-
-
-<h3 id="Version-0-0-1-2009-01-13-">Version 0.0.1 (2009-01-13)</h3>
-
-<p>This release fixes some show-stopper bugs.</p>
-
-<p>Bug fixes:</p>
-
-<ul>
-<li><p>The name of the project library was <a href="http://www.ruby-forum.com/topic/176173#771351">being determined
-incorrectly</a>.
-(thanks to Florian Gilcher)</p></li>
-<li><p>There was a <a href="http://www.ruby-forum.com/topic/176173#771281">circular dependency problem</a> when installing the <strong>Inochi</strong> gem.  (thanks to Florian Gilcher)</p>
-
-<p>The solution is to specify the <code>--force</code> option when installing the gem.
-The "Installing" section has been updated accordingly.</p></li>
-<li><p>Generated project scaffolds now check against the major version of the
-<strong>Inochi</strong> gem, to avoid runtime version conflicts.</p></li>
-</ul>
-
-
-<p>Housekeeping:</p>
-
-<ul>
-<li>Only add project libraries to <code>$LOAD_PATH</code> if not already there.</li>
-</ul>
-
-
-<h3 id="Version-0-0-0-2009-01-13-">Version 0.0.0 (2009-01-13)</h3>
-
-<p>This is the first release of Inochi.  Enjoy!</p>
-
-<h2 id="AUTHORS">AUTHORS</h2>
-
-<p>Suraj N. Kurapati</p>
-
-<h2 id="CREDITS">CREDITS</h2>
-
-<p>Florian Gilcher,
-Peileppe Production</p>
-
-<p>The "inochi.png" image and its "inochi.svg" source utilize the
-<a href="http://www.openclipart.org/detail/17456">"3 flowers"</a> graphic, which was created and released into
-the public domain by <a href="http://www.openclipart.org/user-detail/Peileppe">Peileppe Production</a> on June 25, 2008.</p>
-
-<h2 id="LICENSE">LICENSE</h2>
-
-<p>(the ISC license)</p>
-
-<p>Copyright 2008 Suraj N. Kurapati <a href="&#109;&#97;&#x69;&#x6c;&#x74;&#x6f;&#x3a;&#115;&#x75;&#110;&#x61;&#107;&#117;&#x40;&#x67;&#109;&#x61;&#105;&#108;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x73;&#117;&#110;&#97;&#107;&#x75;&#x40;&#x67;&#x6d;&#x61;&#105;&#108;&#46;&#99;&#111;&#109;</a></p>
-
-<p>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.</p>
-
-<p>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.</p>
-
-<h2 id="SEE-ALSO">SEE ALSO</h2>
-
-<p><span class="man-ref">rake<span class="s">(1)</span></span>,
-<span class="man-ref">rsync<span class="s">(1)</span></span>,
-<a href="http://github.com/rtomayko/ronn">Ronn</a>,
-<a href="http://snk.tuxfamily.org/lib/ember/">Ember</a></p>
-
-
-  <ol class='man-decor man-foot man foot'>
-    <li class='tl'></li>
-    <li class='tc'>July 2010</li>
-    <li class='tr'>inochi(1)</li>
-  </ol>
-
-  </div>
-</body>
-</html>