inochi 1.1.1 → 2.0.0

data/lib/inochi/templates/HISTORY.rbs

@@ -0,0 +1,55 @@
+%#----------------------------------------------------------------------------
+## VERSIONS
+%#----------------------------------------------------------------------------
+
+This section contains release notes of current and past releases.
+
+%#----------------------------------------------------------------------------
+### Version #{project_version} (#{project_release})
+%#----------------------------------------------------------------------------
+
+> TODO: write a short summary of the changes in this release
+
+This release changes TODO, adds TODO, and fixes TODO.
+
+Incompatible changes:
+
+  > TODO: list all backward-incompatible changes in this release
+
+  * TODO has been TODO to TODO --- contributor name
+
+  * TODO --- contributor name
+
+  * TODO --- contributor name
+
+New features:
+
+  > TODO: list new features added in this release
+
+  * TODO --- contributor name
+
+  * TODO --- contributor name
+
+  * TODO --- contributor name
+
+Bug fixes:
+
+  > TODO: describe all bugs that are fixed in this release
+
+  * TODO was TODO --- contributor name
+
+  * TODO were TODO --- contributor name
+
+  * TODO did TODO --- contributor name
+
+Housekeeping:
+
+  > TODO: list the refactorings, clean ups, and other
+  >       improvements that were done for this release
+
+  * TODO --- contributor name
+
+  * TODO --- contributor name
+
+  * TODO --- contributor name
+

data/lib/inochi/templates/LICENSE.rbs

@@ -0,0 +1,15 @@
+(the ISC 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.

data/lib/inochi/templates/MANUAL.rbs

@@ -0,0 +1,27 @@
+<%
+  ##
+  # Wraps the given content within <pre>
+  # tags in a way that is Markdown-safe.
+  #
+  def preformatted content
+    if content =~ /\\S/
+      content.gsub(/^/, ' ' * 4)
+    else
+      "<pre>\#{content}</pre>"
+    end
+  end
+%>
+
+%+ "README"
+
+%+ "USAGE"
+
+%+ "EXAMPLES"
+
+%+ "HACKING"
+
+%+ "HISTORY"
+
+%+ "CREDITS"
+
+%+ "FURTHER"

data/lib/inochi/templates/README.rbs

@@ -0,0 +1,60 @@
+%#----------------------------------------------------------------------------
+## ABOUT
+%#----------------------------------------------------------------------------
+
+#{project_name} is a TODO that TODO.
+
+%#----------------------------------------------------------------------------
+### Features
+%#----------------------------------------------------------------------------
+
+* Does TODO.
+
+* Reduces TODO.
+
+* Lets you TODO.
+
+* Composed of TODO lines of code.
+
+%#----------------------------------------------------------------------------
+### Resources
+%#----------------------------------------------------------------------------
+
+* Issue tracker (report bugs, request features, get help):
+  <http://github.com/TODO/#{package_name}/issues>
+
+* Source code (browse online or obtain with [Git](http://git-scm.com)):
+  <http://github.com/TODO/#{package_name}>
+
+* API documentation:
+  <<%= File.join(#{library_name}::WEBSITE, 'api/') %>>
+
+* Announcements feed:
+  <<%= File.join(#{library_name}::WEBSITE, 'ann.xml') %>>
+
+* Official website:
+  <<%= Ember::WEBSITE %>>
+
+%#----------------------------------------------------------------------------
+### Setup
+%#----------------------------------------------------------------------------
+
+Prerequisites:
+
+  > TODO: list all software necessary to run your project
+
+  * [Ruby] #{RUBY_VERSION} or newer.
+
+  * [RubyGems] #{Gem::RubyGemsVersion} or newer.
+
+Installing:
+
+    gem install #{package_name}
+
+Upgrading:
+
+    gem update #{package_name}
+
+Removing:
+
+    gem uninstall #{package_name}

data/lib/inochi/templates/USAGE.rbs

@@ -0,0 +1,23 @@
+%#----------------------------------------------------------------------------
+## SYNOPSIS
+%#----------------------------------------------------------------------------
+
+`#{package_name}` [<OPTIONS>] <PARAM1> <PARAM2> <PARAM3> ...
+
+%#----------------------------------------------------------------------------
+## DESCRIPTION
+%#----------------------------------------------------------------------------
+
+> TODO: explain the usage and behavior of the above command here
+
+%#----------------------------------------------------------------------------
+## OPTIONS
+%#----------------------------------------------------------------------------
+
+> TODO: list command-line options and explain them here
+
+* `-h`, `--help`:
+  Display this manual and exit.
+
+* `-v`, `--version`:
+  Print version number and exit.

data/lib/inochi/templates/command.rbs

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require '#{package_name}'
+
+if ARGV.delete('-h') or ARGV.delete('--help')
+  # try to display UNIX version of help manual
+  man_path = File.join(#{library_name}::INSTDIR, 'man')
+  unless system 'man', '-M', man_path, '-a', '#{package_name}'
+    # try to display HTML version of help manual
+    man_html = man_path + '.html'
+    unless %w[$BROWSER open start].any? {|b| system "\#{b} \#{man_html}" }
+      # no luck; direct user to project website
+      puts "See \#{#{library_name}::WEBSITE}"
+    end
+  end
+  exit
+elsif ARGV.delete('-v') or ARGV.delete('--version')
+  puts #{library_name}::VERSION
+  exit
+end
+
+# TODO: replace the following with the body of your program
+puts "\#{__FILE__} was executed with \#{ARGV.inspect} arguments"

data/lib/inochi/templates/inochi.opts.rbs

@@ -0,0 +1,43 @@
+##
+# Location where `inochi pub:web` will upload files.  This value
+# can use any local/remote/protocol syntax supported by rsync(1).
+#
+:pub_web_target: TODO@rubyforge.org:/var/www/gforge-projects/#{package_name}/
+
+##
+# Options for rsync(1), which uploads files for `inochi pub:web`.
+#
+:pub_web_options: --verbose --compress --archive --update
+
+##
+# Additional files for `inochi pub:web` to upload.  The values listed
+# here can use any local/remote/protocol syntax supported by rsync(1).
+#
+# @example
+#
+#   :pub_web_extras:
+#   - some/file
+#   - some_user@some_host:some/path
+#
+:pub_web_extras:
+
+##
+# Arbitrary Ruby code that will configure this project's RubyGem before it
+# is built by `inochi gem`.  This code has access to a local variable named
+# `gem` which holds a Gem::Specification object representing this project.
+#
+# @example
+#
+#   :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!
+#
+:gem_spec_logic: |

data/lib/inochi/templates/inochi.rb.rbs

@@ -0,0 +1,102 @@
+module #{library_name}
+
+  ##
+  # Official name of this project.
+  #
+  PROJECT = #{project_name.inspect}
+
+  ##
+  # Short single-line description of this project.
+  #
+  TAGLINE = "TODO: the tagline of this project"
+
+  ##
+  # Address of this project's official home page.
+  #
+  WEBSITE = "http://#{package_name}.rubyforge.org"
+
+  ##
+  # Number of this release of this project.
+  #
+  VERSION = #{project_version.inspect}
+
+  ##
+  # Date of this release of this project.
+  #
+  RELDATE = #{project_release.inspect}
+
+  ##
+  # Description of this release of this project.
+  #
+  def self.inspect
+    "\#{PROJECT} \#{VERSION} (\#{RELDATE})"
+  end
+
+  ##
+  # Location of this release of this project.
+  #
+  INSTDIR = File.expand_path('../../..', __FILE__)
+
+  ##
+  # RubyGems required by this project during runtime.
+  #
+  # @example
+  #
+  #   RUNTIME = {
+  #     # this project needs exactly version 1.2.3 of the "an_example" gem
+  #     "an_example" => [ "1.2.3" ],
+  #
+  #     # this project needs at least version 1.2 (but not
+  #     # version 1.2.4 or newer) of the "another_example" gem
+  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
+  #
+  #     # this project needs any version of the "yet_another_example" gem
+  #     "yet_another_example" => [],
+  #   }
+  #
+  RUNTIME = {}
+
+  ##
+  # RubyGems required by this project during development.
+  #
+  # @example
+  #
+  #   DEVTIME = {
+  #     # this project needs exactly version 1.2.3 of the "an_example" gem
+  #     "an_example" => [ "1.2.3" ],
+  #
+  #     # this project needs at least version 1.2 (but not
+  #     # version 1.2.4 or newer) of the "another_example" gem
+  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
+  #
+  #     # this project needs any version of the "yet_another_example" gem
+  #     "yet_another_example" => [],
+  #   }
+  #
+  DEVTIME = {
+    "inochi" => [ "~> #{Inochi::VERSION.to_i}" ], # for managing this project
+  }
+
+  ##
+  # Loads the correct version (as defined by the {RUNTIME} or {DEVTIME}
+  # constant in this module) of the given gem or the gem that contains
+  # the given library.
+  #
+  def self.require gem_name_or_library
+    # prepare the correct version of the gem for loading
+    if respond_to? :gem
+      gem_name = gem_name_or_library.to_s.sub(%r{/.*$}, '')
+      if gem_version = RUNTIME[gem_name] || DEVTIME[gem_name]
+        begin
+          gem gem_name, *gem_version
+        rescue LoadError => error
+          warn "\#{self.inspect}: \#{error}"
+        end
+      end
+    end
+
+    # do the loading
+    super
+  end
+
+end

data/lib/inochi/templates/library.rbs

@@ -0,0 +1,7 @@
+require '#{package_name}/inochi'
+
+module #{library_name}
+  # TODO: add your project functionality here
+  # autoload :SubLibrary, '#{package_name}/sub_library'
+  # autoload :AnotherSubLibrary, '#{package_name}/another_sub_library'
+end

data/lib/inochi/templates/library_test.rb.rbs

@@ -0,0 +1,3 @@
+require '#{package_name}'
+
+# TODO: test the #{library_name} module here

data/lib/inochi/templates/test_helper.rb.rbs

@@ -0,0 +1,3 @@
+# TODO: activate the testing framework of your choice and
+#       also set up the testing environment for your tests
+#{library_name}.require 'test/unit'

data/lib/inochi/templates/test_runner.rbs

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+#
+# Adds the project library directory
+# and this test directory to Ruby's
+# load path and runs the given tests.
+#
+# Usage:  ruby test/runner [TESTS_TO_RUN]
+#
+# Where:  TESTS_TO_RUN is a list of files
+#         or file globbing patterns that
+#         describe a set of files to run.
+#
+#         If this parameter is not given,
+#         all *_test.rb files within or
+#         beneath this directory are run.
+
+lib_dir = File.expand_path('../../lib', __FILE__)
+test_dir = File.expand_path('..', __FILE__)
+$LOAD_PATH.unshift lib_dir, test_dir
+
+require '#{package_name}/inochi'
+require 'test_helper'
+
+ARGV << "\#{test_dir}/**/*_test.rb" if ARGV.empty?
+ARGV.each {|glob| Dir[glob].each {|test| load test } }

data/man.html

@@ -0,0 +1,959 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ronn/v0.5'>
+  <title>inochi(1) - Gives life to Ruby projects</title>
+  <style type='text/css'>
+    body {margin:0}
+    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
+      font-family:consolas,monospace;
+      font-size:16px;
+      line-height:1.3;
+      color:#343331;
+      background:#fff; }
+    #man { max-width:87ex; margin:0 3ex 1ex 1ex; text-align:justify; }
+    #man div.man-navigation {
+      position:fixed;
+      top:0;
+      left:91ex;
+      height:100%;
+      width:100%;
+      padding:1ex 0 0 2ex;
+      border-left:0.5ex solid #DCDCDC;
+      background-color: #F5F5F5;
+    }
+    #man div.man-navigation a { display:block; margin-bottom:1.5ex }
+    #man h1, #man h2, #man h3 { color:#232221;clear:left }
+    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
+    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
+    #man h3 { font-size:16px; margin:0 0 0 4ex; }
+    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
+    #man pre {
+      color:#333231;
+      background:#edeceb;
+      padding:5px 7px;
+      margin:0px 0 20px 0;
+      border-left:2ex solid #ddd}
+    #man pre + h2, #man pre + h3 {
+      margin-top:22px;
+    }
+    #man h2 + pre, #man h3 + pre {
+      margin-top:5px;
+    }
+    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
+    #man dt { margin:0; clear:left }
+    #man dt.flush { float:left; width:8ex }
+    #man dd { margin:0 0 0 9ex }
+    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
+    #man pre code { font-weight:normal; color:#232221; background:inherit }
+    #man em, var, u {
+      font-style:normal; color:#333231; border-bottom:1px solid #999; }
+    #man h1.man-title { display:none; }
+    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
+      float:left; width:33%; list-style-type:none;
+      text-transform:uppercase; font-size:18px; color:#999;
+      letter-spacing:1px;}
+    #man ol.man { width:100%; }
+    #man ol.man li.tl { text-align:left }
+    #man ol.man li.tc { text-align:center;letter-spacing:4px }
+    #man ol.man li.tr { text-align:right; float: right }
+    #man ol.man a { color:#999 }
+    #man ol.man a:hover { color:#333231 }
+    #man img { display:block; margin:auto }
+  </style>
+  <style type='text/css' media='print'>
+    #man { max-width:none }
+    #man div.man-navigation { display:none }
+    #man a[href]:not([href^="#"]):not([data-bare-link]):after {
+      content:" " attr(href);
+    }
+  </style>
+</head>
+<body>
+<div id='man'>
+
+<div class='man-navigation'><a href='#NAME'>NAME</a> <a href='#ABOUT'>ABOUT</a> <a href='#SYNOPSIS'>SYNOPSIS</a> <a href='#DESCRIPTION'>DESCRIPTION</a> <a href='#OPTIONS'>OPTIONS</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='#PROJECTS'>PROJECTS</a> <a href='#HACKING'>HACKING</a> <a href='#VERSIONS'>VERSIONS</a> <a href='#CREDITS'>CREDITS</a> <a href='#LICENSE'>LICENSE</a> <a href='#SEE-ALSO'>SEE ALSO</a></div>
+
+<h1 class='man-title'>inochi(1)</h1>
+
+<ol class='head man'>
+  <li class='tl'>inochi(1)</li>
+  <li class='tc'>Version 2.0.0</li>
+  <li class='tr'>inochi(1)</li>
+</ol>
+
+<h2 id='NAME'>NAME</h2>
+<p><code>inochi</code> - Gives life to Ruby projects</p>
+
+<p><img src="logo/inochi.png" alt="Inochi Logo" /></p>
+
+<h2 id="ABOUT">ABOUT</h2>
+
+<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/ember/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/</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>
+
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>Runs <var>TASK</var> using rake(1), to which <var>RAKE_OPTIONS</var> (see <code>rake --help</code> output)
+are passed.  The following tasks are available for running:</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>
+
+
+<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="inochi-init">inochi init</h2>
+
+<p>Instill Inochi into current directory.</p>
+
+<h3 id="SYNOPSIS">SYNOPSIS</h3>
+
+<p><code>inochi</code> init <code>project</code>=<var>PROJECT</var> [<code>package</code>=<var>PACKAGE</var>] [<code>merger</code>=<var>MERGER</var>]</p>
+
+<h3 id="DESCRIPTION">DESCRIPTION</h3>
+
+<p>Installs the Inochi infrastructure for the project (see <strong>PROJECTS</strong> below)
+named <var>PROJECT</var> into the current working directory, or upgrades a previous
+installation thereof.</p>
+
+<p>Pre-existing files are not overwritten.  Instead, it is your responsibility to
+merge changes (hopefully with the aid of an automated text merging tool; see
+<var>MERGER</var> below) between pre-existing and newly generated files.</p>
+
+<h3 id="PARAMETERS">PARAMETERS</h3>
+
+<ul>
+<li><p><var>PROJECT</var>:
+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></li>
+<li><p><var>PACKAGE</var>:
+Name of the project's package directory, shell command, and basename of the
+project library file.</p></li>
+<li><p><var>MERGER</var>:
+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>
+
+<p><strong>TIP</strong>: Instead of merging files by hand, you can transfer wanted changes
+between files semi-automatically using a text merging tool such as <a href="http://meld.sourceforge.net">meld</a>,
+<a href="http://kdiff3.sourceforge.net">kdiff3</a>, or <a href="http://tkdiff.sourceforge.net">tkdiff</a> as follows:</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
+# kdiff3 --merge "$old" "$new" --output "$out"  # use kdiff3
+# tkdiff "$old" "$new" -o "$out"                # use tkdiff
+</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></li>
+</ul>
+
+
+<h3 id="NOTIFICATIONS">NOTIFICATIONS</h3>
+
+<dl>
+<dt>create <var>FILE</var></dt><dd><p>A file is being created because it does not exist.</p></dd>
+<dt>skip <var>FILE</var></dt><dd><p>A file is being skipped because it is already up to date.</p></dd>
+<dt>update <var>FILE</var></dt><dd><p>A file is being updated because it is out of date.  A text merging tool
+(see the <strong>merger</strong> parameter above) 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.</p></dd>
+</dl>
+
+
+<h2 id="inochi-api">inochi api</h2>
+
+<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>
+
+<h2 id="inochi-man">inochi man</h2>
+
+<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>
+
+
+<h2 id="inochi-gem">inochi gem</h2>
+
+<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> or <strong>CREDITS</strong>
+heading (whichever comes first) 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>
+
+<h2 id="inochi-ann">inochi ann</h2>
+
+<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>
+
+
+<h2 id="inochi-pub-ann-ruby-talk">inochi pub:ann:ruby-talk</h2>
+
+<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>
+
+<h2 id="inochi-pub-web">inochi pub:web</h2>
+
+<p>Publishes the help manual, API documentation, and RSS feed to project website
+using rsync(1) 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 inochi(1) 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 rsync(1).</p></dd>
+<dt>:pub_web_options</dt><dd><p>Options for rsync(1), 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 rsync(1).</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).  Also defines a <code>require</code> class method on the
+project's namespace that loads the correct version (as defined by the
+project's dependency information) of a given gem if RubyGems is available.</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/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="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 installing the <a href="http://github.com/chneukirchen/rup">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 included <code>test/test_helper.rb</code> file, and then evaluates all
+<code>test/**/*_test.rb</code> files:</p>
+
+<pre><code>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/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="VERSIONS">VERSIONS</h2>
+
+<p>This section contains release notes of current and past releases.</p>
+
+<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="CREDITS">CREDITS</h2>
+
+<p>Suraj N. Kurapati,
+Peileppe Production,
+Florian Gilcher</p>
+
+<h3 id="Logo">Logo</h3>
+
+<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;&#116;&#111;&#x3a;&#115;&#117;&#x6e;&#x61;&#107;&#117;&#x40;&#103;&#x6d;&#97;&#x69;&#x6c;&#x2e;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x73;&#x75;&#x6e;&#97;&#x6b;&#117;&#x40;&#103;&#109;&#x61;&#105;&#x6c;&#46;&#99;&#x6f;&#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>rake(1),
+rsync(1),
+<a href="http://github.com/rtomayko/ronn">Ronn</a>,
+<a href="http://snk.tuxfamily.org/lib/ember/">Ember</a></p>
+
+
+<ol class='foot man'>
+  <li class='tl'></li>
+  <li class='tc'>April 2010</li>
+  <li class='tr'>inochi(1)</li>
+</ol>
+
+</div>
+</body>
+</html>