inochi 4.0.1 → 5.0.0

data/lib/inochi/templates/SYNOPSIS.rbs

@@ -0,0 +1,21 @@
+== SYNOPSIS
+
+*#{package_name}* ['OPTIONS'] 'PARAM1' 'PARAM2' 'PARAM3' ...
+
+=== Command
+
+// 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.
+
+=== Examples
+
+// TODO: add examples of using the above command here

data/lib/inochi/templates/USAGE.rbs

@@ -1,23 +1,11 @@
-%#----------------------------------------------------------------------------
-## SYNOPSIS
-%#----------------------------------------------------------------------------
+== USAGE
 
-`#{package_name}` [<OPTIONS>] <PARAM1> <PARAM2> <PARAM3> ...
+Begin by loading the #{project_name} library into your program:
 
-%#----------------------------------------------------------------------------
-## DESCRIPTION
-%#----------------------------------------------------------------------------
+[source,ruby]
+------------------------------------------------------------------------------
+require 'rubygems' # might not be necessary; see HACKING
+require '#{package_name}'
+------------------------------------------------------------------------------
 
-> 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.
+// TODO: explain what things you can do with the library

data/lib/inochi/templates/command.rbs

@@ -3,16 +3,8 @@
 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
+  system 'man', '-M', File.join(#{library_name}::INSTDIR, 'man'), '#{package_name}' or
+  warn "Could not display the help manual.\\nSee \#{#{library_name}::WEBSITE} instead."
   exit
 elsif ARGV.delete('-v') or ARGV.delete('--version')
   puts #{library_name}::VERSION

data/lib/inochi/templates/{inochi.opts.rbs → inochi.conf.rbs}

@@ -1,3 +1,11 @@
+##
+# Attributes to pass to AsciiDoc when rendering the HTML manual page.  See
+# "Backend Attributes" in the AsciiDoc manual for a list of all attributes:
+#
+#   http://www.methods.co.nz/asciidoc/chunked/aph.html
+#
+:man_asciidoc_attributes:
+
 ##
 # Location where `inochi pub:web` will upload files.  This value
 # can use any local/remote/protocol syntax supported by rsync(1).

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

@@ -3,27 +3,27 @@ module #{library_name}
   ##
   # Official name of this project.
   #
-  PROJECT = #{project_name.inspect}
+  PROJECT = '#{project_name}'
 
   ##
   # Short single-line description of this project.
   #
-  TAGLINE = "TODO: the tagline of this project"
+  TAGLINE = 'TODO: the tagline of this project'
 
   ##
   # Address of this project's official home page.
   #
-  WEBSITE = "http://#{package_name}.rubyforge.org"
+  WEBSITE = 'http://#{package_name}.rubyforge.org'
 
   ##
   # Number of this release of this project.
   #
-  VERSION = #{project_version.inspect}
+  VERSION = '#{project_version}'
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = #{project_release.inspect}
+  RELDATE = '#{project_release}'
 
   ##
   # Description of this release of this project.
@@ -44,14 +44,14 @@ module #{library_name}
   #
   #   RUNTIME = {
   #     # this project needs exactly version 1.2.3 of the "an_example" gem
-  #     "an_example" => [ "1.2.3" ],
+  #     '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" ],
+  #     'another_example' => [ '>= 1.2' , '< 1.2.4' ],
   #
   #     # this project needs any version of the "yet_another_example" gem
-  #     "yet_another_example" => [],
+  #     'yet_another_example' => [],
   #   }
   #
   RUNTIME = {}
@@ -63,18 +63,18 @@ module #{library_name}
   #
   #   DEVTIME = {
   #     # this project needs exactly version 1.2.3 of the "an_example" gem
-  #     "an_example" => [ "1.2.3" ],
+  #     '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" ],
+  #     '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}", "< #{Inochi::VERSION.to_i.next}" ],
+    'inochi' => [ '>= #{Inochi::VERSION}', '< #{Inochi::VERSION.to_i.next}' ],
   }
 
   # establish gem version dependencies

data/man/man1/inochi.1

@@ -0,0 +1,2807 @@
+'\" t
+.\"     Title: inochi
+.\"    Author: [see the "AUTHORS" section]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 08/07/2010
+.\"    Manual: \ \&
+.\"    Source: \ \& 5.0.0
+.\"  Language: English
+.\"
+.TH "INOCHI" "1" "08/07/2010" "\ \& 5\&.0\&.0" "\ \&"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+inochi \- Gives life to Ruby projects
+.SH "SYNOPSIS"
+.sp
+\fBinochi\fR [\fIOPTIONS\fR] [\fITASK\fR] [\fIRAKE_OPTIONS\fR]
+.sp
+\fBinochi init\fR project=\fIPROJECT\fR [package=\fIPACKAGE\fR] [merger=\fIMERGER\fR]
+.SS "Command"
+.sp
+Runs the given \fITASK\fR while passing the given \fIRAKE_OPTIONS\fR to rake(1)\&. Otherwise, if \fITASK\fR is not given, displays a list of available tasks\&.
+.SS "Options"
+.PP
+\fB\-h\fR, \fB\-\-help\fR
+.RS 4
+Display this manual and exit\&.
+.RE
+.PP
+\fB\-v\fR, \fB\-\-version\fR
+.RS 4
+Print version number and exit\&.
+.RE
+.SS "Examples"
+.sp
+See list of available tasks:
+.sp
+.nf
+inochi
+.fi
+.sp
+Set up a project named "Foo Bar Baz 123":
+.sp
+.nf
+inochi init project="Foo Bar Baz 123"
+.fi
+.sp
+Set up a project that is named "Foo Bar Baz 123" but packaged as "fbb123":
+.sp
+.nf
+inochi init project="Foo Bar Baz 123" package="fbb123"
+.fi
+.SH "DESCRIPTION"
+.sp
+Inochi is a software project infrastructure for the Ruby programming language\&. It helps you test, document, package, publish, and announce your projects while encouraging excellent documentation and reducing administrivia\&.
+.SS "Features"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Provides a comprehensive help manual that is written in
+[eRuby]
+over
+[AsciiDoc]
+and is rendered into a Web page and a UNIX manual page\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Announces project releases on
+[RAA],
+[ruby-talk], and via RSS feed\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Stores project information in a single Ruby source file\&.
+.RE
+.SS "Resources"
+.PP
+Project website
+.RS 4
+
+http://snk\&.tuxfamily\&.org/lib/inochi/
+.RE
+.PP
+Announcements feed
+.RS 4
+
+http://snk\&.tuxfamily\&.org/lib/inochi/ann\&.xml
+.RE
+.PP
+API documentation
+.RS 4
+
+http://snk\&.tuxfamily\&.org/lib/inochi/api/
+.RE
+.PP
+Source code (browse online, download, or checkout)
+.RS 4
+
+http://github\&.com/sunaku/inochi
+.RE
+.PP
+Issue tracker (report bugs, request features, get help)
+.RS 4
+
+http://github\&.com/sunaku/inochi/issues
+.RE
+.SH "INSTALL"
+.SS "Prerequisites"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[Ruby]
+1\&.8\&.6 or newer\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[RubyGems]
+1\&.3\&.6 or newer\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[AsciiDoc]
+8\&.5\&.3 or newer\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[Lynx]
+2\&.8\&.6 or newer\&.
+.RE
+.SS "Installing"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem install inochi
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Upgrading"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem update inochi
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Removing"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem uninstall inochi
+.fi
+.if n \{\
+.RE
+.\}
+.SH "USAGE"
+.sp
+This tutorial shows how to set up an Inochi project for a "WordCount" tool that counts the number of words in the text given to it\&.
+.SS "Creating a new project"
+.sp
+Create a directory for the project:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+mkdir word_count
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Instill Inochi into the directory:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+cd word_count
+inochi init project="WordCount"
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Review pending work marked as "TODO":
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+grep TODO \-nR \&.
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Running the shell command"
+.sp
+Run the project\(cqs shell command:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/word_count
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+View the project version number:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/word_count \-\-version
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+View the project help manual:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/word_count \-\-help
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Building the help manual"
+.sp
+Build the help manual:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+inochi man
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+View the help manual in a terminal:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+man \-l man/man1/word_count\&.1
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+View the help manual in a Web browser:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+firefox man\&.html
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Implementing the library"
+.sp
+Append the following code to the test/word_count_test\&.rb file:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+class TestWordCount < 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
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Run the test suite and observe that all tests fail:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby test/runner
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Append the following code to the lib/word_count\&.rb file:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+module WordCount
+  # Returns the number of words in the given input\&.
+  def WordCount\&.count input
+    input\&.to_s\&.split(/\eW+/)\&.length
+  end
+end
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Run the test suite again and observe that all tests pass:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby test/runner
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Implementing the shell command"
+.sp
+Append the following code to the bin/word_count file:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+input = ARGF\&.read
+total = WordCount\&.count(input)
+puts "There are #{total} words in the input\&."
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Run the project\(cqs shell command on the README file:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/word_count README
+.fi
+.if n \{\
+.RE
+.\}
+.SH "TASKS"
+.sp
+Inochi provides the following tasks\&. Some of these are explained below\&.
+.TS
+tab(:);
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt.
+T{
+.sp
+ann
+T}:T{
+.sp
+Build all release announcements\&.
+T}
+T{
+.sp
+ann:feed
+T}:T{
+.sp
+Build RSS feed announcement\&.
+T}
+T{
+.sp
+ann:html
+T}:T{
+.sp
+Build HTML announcement\&.
+T}
+T{
+.sp
+ann:text
+T}:T{
+.sp
+Build plain text announcement\&.
+T}
+T{
+.sp
+api
+T}:T{
+.sp
+Build API documentation\&.
+T}
+T{
+.sp
+clean
+T}:T{
+.sp
+Remove any temporary products\&.
+T}
+T{
+.sp
+clobber
+T}:T{
+.sp
+Remove any generated file\&.
+T}
+T{
+.sp
+gem
+T}:T{
+.sp
+Build release package for RubyGems\&.
+T}
+T{
+.sp
+init
+T}:T{
+.sp
+Instill Inochi into current directory\&.
+T}
+T{
+.sp
+man
+T}:T{
+.sp
+Build the help manual\&.
+T}
+T{
+.sp
+pub
+T}:T{
+.sp
+Publish a release of this project\&.
+T}
+T{
+.sp
+pub:ann
+T}:T{
+.sp
+Announce release on all news outlets\&.
+T}
+T{
+.sp
+pub:ann:raa
+T}:T{
+.sp
+Announce release on RAA (Ruby Application Archive)\&.
+T}
+T{
+.sp
+pub:ann:ruby\-talk
+T}:T{
+.sp
+Announce release on ruby\-talk mailing list\&.
+T}
+T{
+.sp
+pub:gem
+T}:T{
+.sp
+Publish gem release package to RubyGems\&.org\&.
+T}
+T{
+.sp
+pub:web
+T}:T{
+.sp
+Publish help manual, API docs, and RSS feed to project website\&.
+T}
+.TE
+.sp 1
+.SS "inochi init"
+.sp
+Installs the Inochi infrastructure for the project in the current working directory or upgrades a previous installation thereof\&.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBSynopsis\fR
+.RS 4
+.sp
+\fBinochi init\fR project=\fIPROJECT\fR [package=\fIPACKAGE\fR] [merger=\fIMERGER\fR]
+.RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBParameters\fR
+.RS 4
+.PP
+\fIPROJECT\fR
+.RS 4
+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\&.
+.RE
+.PP
+\fIPACKAGE\fR
+.RS 4
+Name of the project\(cqs package directory, shell command, and basename of the project library file\&.
+.RE
+.PP
+\fIMERGER\fR
+.RS 4
+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
+\fBmust not\fR
+modify the old file or the new file\&.
+.RE
+.RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBDescription\fR
+.RS 4
+.sp
+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 [meld], [tkdiff], or [kdiff3] by following these steps:
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 1.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  1." 4.2
+.\}
+Create a file named
+merge2
+containing the following text:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+#!/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
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 2.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  2." 4.2
+.\}
+Uncomment the line corresponding to the tool you wish to use\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 3.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  3." 4.2
+.\}
+Make the file executable:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+chmod +x merge2
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 4.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  4." 4.2
+.\}
+Pass the file\(cqs path as the value of
+\fIMERGER\fR:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+inochi init merger=path/to/merge2
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.sp
+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 \fBwithout saving\fR any changes to the merged file!
+.RE
+.SS "inochi api"
+.sp
+Builds API documentation for the project\(cqs Ruby library using [YARD]\&. Ruby constructs marked with @private are omitted from the API documentation\&.
+.SS "inochi man"
+.sp
+Renders the help manual\(cqs source files into:
+.PP
+man\&.txt
+.RS 4
+Input for
+[AsciiDoc], rendered by
+[Ember]\&.
+.RE
+.PP
+man\&.html
+.RS 4
+HTML web page, rendered by
+[AsciiDoc]\&.
+.RE
+.PP
+man/man1/\fIPACKAGE\fR\&.1
+.RS 4
+UNIX manual page, rendered by
+[AsciiDoc]\&.
+.RE
+.SS "inochi gem"
+.sp
+Builds a \fBgem\fR, which is a release package in [RubyGems] format:
+.PP
+\fIPACKAGE\fR\-\fIVERSION\fR\&.gem
+.RS 4
+The gem itself\&.
+.RE
+.PP
+\fIPACKAGE\fR\-\fIVERSION\fR\&.gemspec
+.RS 4
+Ruby representation of the gem\(cqs specification\&.
+.RE
+.sp
+The gem specification is pre\-initialized with information from the project\(cqs Ruby library and help manual\&. In particular:
+.PP
+gem\&.description
+.RS 4
+Plain text version of all content between the "ABOUT" heading and any subsequent heading\&.
+.RE
+.PP
+gem\&.authors
+.RS 4
+Plain text version of all content between the "AUTHORS" heading and any subsequent heading\&.
+.RE
+.PP
+gem\&.files
+.RS 4
+Only contains the project\(cqs
+LICENSE
+and
+CREDITS
+files, rendered help manual, Ruby library, shell command, and C extension\&.
+.sp
+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\&.
+.RE
+.sp
+The gem specification can be further customized through the :gem_spec_logic parameter defined in the project\(cqs configuration file\&.
+.SS "inochi ann"
+.sp
+Builds release announcements which can be edited by hand before publishing:
+.PP
+ann\&.html
+.RS 4
+Web page version of the release announcement\&.
+.RE
+.PP
+ann\&.txt
+.RS 4
+Plain text version of the release announcement; converted from the Web page version by
+[Lynx]\&.
+.RE
+.PP
+ann\&.xml
+.RS 4
+RSS feed version of the release announcement\&.
+.RE
+.SS "inochi pub:ann:ruby\-talk"
+.sp
+Announces the release on the [ruby-talk] mailing list\&.
+.sp
+It is recommended that you build, review, and edit the ann\&.txt file \fIby hand\fR 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\&.
+.SS "inochi pub:web"
+.sp
+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\(cqs configuration file\&.
+.SH "PROJECTS"
+.sp
+A project instilled with Inochi is composed of a configuration file, a license, source code, documentation, and a Web presence; which are all explained below\&.
+.SS "Configuration file"
+.sp
+A project\(cqs configuration file is a [YAML] document named inochi\&.conf that defines the following optional parameters used by some Inochi tasks:
+.PP
+:man_asciidoc_attributes
+.RS 4
+Attributes to pass to AsciiDoc when rendering the HTML manual page\&. See
+"Backend Attributes" in the AsciiDoc manual
+for a list of all attributes\&.
+.RE
+.PP
+:pub_web_target
+.RS 4
+Location where the
+\fBinochi pub:web\fR
+command will upload files\&. This value can use any local/remote/protocol syntax supported by rsync(1)\&.
+.RE
+.PP
+:pub_web_options
+.RS 4
+Options for rsync(1), which uploads files for the
+\fBinochi pub:web\fR
+command\&.
+.RE
+.PP
+:pub_web_extras
+.RS 4
+Additional files for the
+\fBinochi pub:web\fR
+command to upload\&. The values listed here can use any local/remote/protocol syntax supported by rsync(1)\&.
+.sp
+Example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+:pub_web_extras:
+  \- some/file
+  \- some_user@some_host:some/path
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.PP
+:gem_spec_logic
+.RS 4
+Ruby code that will configure this project\(cqs RubyGem before it is built by the
+\fBinochi gem\fR
+command\&. This code has access to a local variable named
+\fIgem\fR
+which holds a
+Gem::Specification
+object representing this project\&.
+.sp
+Example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+: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!
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.SS "License file"
+.sp
+A project\(cqs 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\&.
+.SS "Ruby library"
+.sp
+A project\(cqs Ruby library is composed of the following files:
+.PP
+lib/\fIPACKAGE\fR\&.rb
+.RS 4
+Defines the project\(cqs namespace (Ruby module or class) and registers sub\-libraries to be automatically loaded on demand (Kernel#autoload)\&.
+.RE
+.PP
+lib/\fIPACKAGE\fR/inochi\&.rb
+.RS 4
+Defines project information in Ruby constants within the project\(cqs namespace (Ruby module or class) and establishes version constraints for gems this project depends on if RubyGems is available in the user\(cqs environment\&. Unsatisfied constraints are simply printed to the standard error stream; they do not raise a
+Gem::LoadError
+exception\&.
+.RE
+.SS "Test suite"
+.sp
+A project\(cqs test suite is composed of the following files:
+.PP
+test/runner
+.RS 4
+Executable Ruby script that hides the details of running the test suite\&.
+.RE
+.PP
+test/helper\&.rb
+.RS 4
+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\&.
+.RE
+.PP
+test/**/*_test\&.rb
+.RS 4
+Ruby source files that perform the actual testing\&.
+.RE
+.SS "Shell command"
+.sp
+A project\(cqs shell command is an executable Ruby source file in the bin/ directory named \fIPACKAGE\fR\&. It expects that the project\(cqs lib/ directory is already present in Ruby\(cqs $LOAD_PATH (see [HACKING] below)\&. Thankfully, this expectation is automatically met when the project is installed via RubyGems\&.
+.SS "Help manual"
+.sp
+A project\(cqs help manual is a monolithic [eRuby] template that is (1) processed by [Ember] with its shorthand notation, hierarchical unindentation, and missing <% end %> inference features enabled, and (2) composed of the following source files:
+.PP
+MANUAL
+.RS 4
+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\&.
+.RE
+.PP
+SYNOPSIS
+.RS 4
+Describes how the project\(cqs shell command can be invoked\&.
+.RE
+.PP
+README
+.RS 4
+Introduces the project and its Web presence\&.
+.RE
+.PP
+INSTALL
+.RS 4
+Instructions on installing, upgrading, and removing the project\&.
+.RE
+.PP
+USAGE
+.RS 4
+Explains how to use the project in detail\&.
+.RE
+.PP
+HACKING
+.RS 4
+Instructs fellow software developers on running, testing, and hacking the project\(cqs source code\&.
+.RE
+.PP
+HISTORY
+.RS 4
+Records notes about current and past releases of the project in terms of incompatible changes, new features, bug fixes, and housekeeping activities\&.
+.RE
+.PP
+CREDITS
+.RS 4
+Attributes all developers and contributors whose efforts have made the project what it is today\&.
+.RE
+.PP
+BEYOND
+.RS 4
+Refers to related commands, help manuals, and topics beyond this project\&.
+.RE
+.SS "Web presence"
+.sp
+A project\(cqs a Web presence is composed, at minimum, of the following:
+.PP
+Project website
+.RS 4
+Where the help manual, API documentation, and RSS feed can be accessed (hopefully) permanently\&.
+.RE
+.PP
+Code repository
+.RS 4
+Where fellow software developers can obtain the latest source code\&.
+.RE
+.PP
+Issue tracker
+.RS 4
+Where users can contribute patches, request features, and get help\&.
+.RE
+.sp
+You may choose to omit some or all of these components by simply not mentioning them in the "Resources" section of the help manual\(cqs README source file\&.
+.SH "HACKING"
+.SS "Prerequisites"
+.sp
+Install Ruby libraries necessary for development:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem install inochi \-\-development
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Infrastructure"
+.sp
+[Inochi] 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:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+inochi \-\-help     # display help manual
+inochi \-\-tasks    # list available tasks
+.fi
+.if n \{\
+.RE
+.\}
+.SS "$LOAD_PATH setup"
+.sp
+Ensure that the lib/ directory is listed in Ruby\(cqs $LOAD_PATH before you use any libraries therein or run any executables in the bin/ directory\&.
+.sp
+This can be achieved by passing an option to Ruby:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/inochi
+irb \-Ilib \-r inochi
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by setting the $RUBYLIB environment variable:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+export RUBYLIB=lib   # bash, ksh, zsh
+setenv RUBYLIB lib   # csh
+set \-x RUBYLIB lib   # fish
+
+ruby bin/inochi
+irb \-r inochi
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by running Ruby through the ruby\-wrapper tool\&.
+.SS "RubyGems setup"
+.sp
+If you use Ruby 1\&.8 or older, then ensure that RubyGems is activated before you use any libraries in the lib/ directory or run any executables in the bin/ directory\&.
+.sp
+This can be achieved by passing an option to Ruby:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-rubygems bin/inochi
+irb \-rubygems \-r inochi
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by setting the $RUBYOPT environment variable:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+export RUBYOPT=\-rubygems   # bash, ksh, zsh
+setenv RUBYOPT \-rubygems   # csh
+set \-x RUBYOPT \-rubygems   # fish
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Running tests"
+.sp
+Simply execute the included test runner, which sets up Ruby\(cqs $LOAD_PATH for testing, loads the test/helper\&.rb file, and then evaluates all test/**/*_test\&.rb files:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby test/runner
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+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 test/helper\&.rb file\&.
+.SS "Contributing"
+.sp
+Fork this project on GitHub and send a pull request\&.
+.SH "HISTORY"
+.SS "Version 5\&.0\&.0 (2010\-08\-07)"
+.sp
+This release switches from [Ronn] to [AsciiDoc] for writing the help manual, reduces the file size of generated gem packages, and fixes some bugs\&.
+.PP
+\fBIncompatible changes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use
+[AsciiDoc]
+instead of
+[Ronn]
+to render the help manual\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename the
+inochi\&.opts
+file to
+inochi\&.conf\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Do not include HTML manual in gem package\&. This reduces the gem file size and makes the project website the only official place to obtain the HTML manual\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Always load project info before non\-init tasks\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Another Ruby 1\&.9\&.2\-rc2 fix for Nokogiri usage\&.
+.RE
+.sp
+Housekeeping
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use single quotes for string values in
+inochi\&.rb
+template\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+fetch_nodes_between(): report errors and refactor\&.
+.RE
+.SS "Version 4\&.0\&.1 (2010\-07\-28)"
+.sp
+This release fixes a bug in gem version dependency establishment\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Gem version dependencies were not being established in Ruby 1\&.8\&.7 and 1\&.9\&.2 because
+Kernel#gem
+is a private method
+in those Ruby versions\&.
+.sp
+To propagate this fix into your projects, please reinitialize them with this version of Inochi\&.
+.RE
+.SS "Version 4\&.0\&.0 (2010\-07\-25)"
+.PP
+\fBIncompatible changes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename the "VERSIONS" section in the
+HISTORY
+file to "HISTORY"\&.
+.RE
+.PP
+\fBChanges you will see in upgraded or newly generated projects\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename the
+FURTHER
+file to
+BEYOND\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename
+test/test_helper\&.rb
+to just
+test/helper\&.rb\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Store resource URLs in variables in
+MANUAL
+file for reuse\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Provide more precise link to ruby\-wrapper tool in
+HACKING
+file\&.
+.RE
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+\-d
+(to enable
+$DEBUG) and
+\-v
+(to enable
+$VERBOSE) command\-line options to the generated
+test/runner
+script\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Various compatibility fixes for Ruby 1\&.9\&.2\-rc2\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Prefix
+test/runner
+command with "ruby" for Windows users\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Ember::WEBSITE
+was always being emitted in
+README
+file\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add version constraints for YARD and Mechanize dependencies\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade from Dfect 1\&.1\&.0 to Detest 3\&.1\&.0 for unit testing\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade to Ronn 0\&.7\&.0 for generating this user manual\&.
+.RE
+.SS "Version 3\&.0\&.0 (2010\-04\-27)"
+.PP
+\fBIncompatible changes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The
+require()
+class method is no longer emitted on your project\(cqs namespace\&. Instead, gem version constraints are established up front when your project\(cqs Ruby library is first loaded\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Author names are now fetched from the "AUTHORS" section, not "CREDITS"\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Project information is now placed in the "NAME" section, not "ABOUT"\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Reflect current Inochi version in gem constraint\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Forgot to list
+[Ember]
+as a runtime gem dependency\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Move all task documentation into new "TASKS" section\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Move TASKS & PROJECTS information into separate files\&.
+.RE
+.SS "Version 2\&.0\&.1 (2010\-04\-25)"
+.sp
+This release fixes some bugs and adds a simple tutorial to the help manual\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+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)
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+LICENSE
+file template lacked a "TODO" marker\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Forgot version number heading in announcement\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Restored the simple WordCount tutorial from version 1\&.1\&.1\&.
+.RE
+.SS "Version 2\&.0\&.0 (2010\-04\-24)"
+.sp
+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\&.
+.PP
+\fBIncompatible changes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.sp
+See
+[PROJECTS]
+to learn about the new Inochi infrastructure\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The help manual is now processed by
+[Ronn]
+instead of
+[ERBook]\&. As a result, you may only use plain
+[Markdown]
+and
+[eRuby]
+when writing it\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Announcement publishing tasks no longer read login information from the
+~/\&.config/inochi/logins\&.yaml
+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\&.
+.RE
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The help manual is now available as a UNIX manual page (thanks to
+[Ronn]) 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\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+A
+require
+class method is now added to the project\(cqs namespace\&. This method verifies that the library or gem being required meets the dependency version constraints defined by the project\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+A
+test/runner
+script is now generated\&. It provides a fast, self\-contained way to run your project\(cqs test suite\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Inochi is now a Rake application\&. A
+Rakefile
+is not necessary\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Many KISS and YAGNI fueled iterations later, this is it! :\-)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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!
+.RE
+.SS "Version 1\&.1\&.1 (2009\-10\-03)"
+.sp
+This release improves Ruby 1\&.9 support and upgrades gem dependencies\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+require()
+was unable to find project library in Ruby 1\&.9\&.2dev\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Ruby 1\&.9 warning about "shadowing outer variable"\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Ruby 1\&.9 error about "incompatible encoding regexp match"\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The "spicycode\-rcov" project was officially renamed to "relevance\-rcov"\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade to RubyForge 2\&.x library for publishing gems\&.
+.RE
+.SS "Version 1\&.1\&.0 (2009\-09\-06)"
+.sp
+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\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add instructions for building gems without Inochi as a runtime dependency\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Put release notes in "description" field of gemspec, as
+suggested by Eric Hodel, so that subscribers of
+the RubyForge gems feed
+are aware of the changes in a published gem\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Set the "date" field in gemspec to project release date\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The sdoc library was necessary to run
+\fIrake test\fR\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Forgot to add
+:develop
+option to scaffold generator output\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Make "rake lang:dump" unconditionally overwrite the dump file\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Fix gem not being built and prevent Maruku errors for the dummy "WordCount" project in the user manual\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use /usr/bin/env instead of /usr/bin/ruby to launch Ruby for better portability\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use simpler Copyright reminder at the top of every file\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Open source is for fun, so speak of "related works", not "competitors"\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename "Tutorial" to "General walkthrough" in user manual and add a "Specific topics" section for housing uncommon use cases\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Remove "logistics" section and redistribute its contents in more suitable locations in the user manual\&.
+.RE
+.SS "Version 1\&.0\&.0 (2009\-05\-03)"
+.sp
+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\&.
+.PP
+\fBIncompatible changes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Your program is no longer halted by
+Inochi\&.init()
+and
+Inochi\&.rake()
+if gem dependencies are not satified\&. A warning is issued instead\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The
+project_summary
+and
+project_history
+nodes, which are provided by
+Inochi\&.book()
+to the user manual, have been renamed to
+project
+and
+history
+respectively\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+SDoc
+is now used to generate API documentation instead of
+YARD\&. If you link to particular classes or methods in the generated API documentation, be sure to update your link addresses!
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Minitest is no longer the default testing library\&. You must specify which testing library you want to use via the
+:test_with
+option of the
+Inochi\&.rake()
+method\&. See the "Test execution" section for details\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The "pak" rake task, which is provided by
+Inochi\&.rake(), has been renamed to "gem"\&.
+.RE
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+:inochi_consumer
+and
+:inochi_producer
+options to
+Inochi\&.rake()
+which allows you to
+\fIavoid\fR
+having Inochi as a runtime and development dependency, respectively, for your project\(cqs gem\&.
+.sp
+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\(cqs runtime convenience facilities\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+:develop
+option for
+Inochi\&.init()
+which lets you specify RubyGems as development dependencies in the same way as the
+:require
+option\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add "lint" rake task which reports
+code quality statistics\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add "test:cov" rake task which reports code coverage statistics\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add "test:ruby" task which runs all tests with
+multiruby\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+rake opts=
+environment variable, which lets you specify command\-line arguments directly to the Ruby interpreter, for all test* rake tasks\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+inochi/util/combo
+combinatorics library for enumerations, permutations, and combinations which are all useful in exhaustive brute\-force unit testing\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+inochi/util/tempdir
+library which really should be in the Ruby standard library\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The "enable email notification" checkbox was not activated properly when posting announcement to ruby\-talk mailing list via Ruby\-Forum\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Mark gems needed by
+Inochi\&.rake()
+as
+\fIdevelopment\fR
+dependencies\&.
+.sp
+Users must now run
+gem install Inochi \-\-development
+to install these dependencies\&. This also solves the recursive dependency problem between Inochi and ERBook\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Set executable in gem specification only if it exists\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Fix parsing of stack trace in Ruby 1\&.9\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Write contributor names in CREDITS file instead of in the user manual\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use completely lowercase name for Rakefile\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add copyright statement at the top of every source file\&.
+.RE
+.SS "Version 0\&.3\&.0 (2009\-02\-12)"
+.sp
+This release adds support for language translations, improves the user interface, and fixes a show\-stopper bug for Windows users\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add support for language translations of phrases used in a project\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add "lang:dump" Rake task for extracting language phrases from project\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add "lang:conv" Rake task for translating dumped phrases into various languages using the BabelFish translation service\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add
+\-\-locale
+option to a project\(cqs main executable for setting user\(cqs preferred language in spite of the user\(cqs locale environment\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Notify user when attempting to publish announcements in the "pub" Rake tasks\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+In Windows,
+ENV[\'USERPROFILE\']
+gives the path to the user\(cqs home directory and
+ENV[\'HOME\']
+is not defined\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The only real solution to the circular gem dependency problem is:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem install \-\-force
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+You should update the "Setup" section in your projects\' user manuals accordingly\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Break the huge lib/inochi/inochi\&.rb library into smaller files\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Instead of adding methods to singleton classes directly, define modules and extend to them so that YARDoc documents the methods appropriately\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+List all project contributors globally in the "Credits" section\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Remove "Contributor kudos" paragraph in release notes in favor of crediting contributors inline with each item in the release notes\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Mention that the project license is ISC for the reader\(cqs convenience\&.
+.RE
+.SS "Version 0\&.2\&.0 (2009\-01\-25)"
+.sp
+This release adds support for unit testing, improves the portability of Inochi and configurability of your projects, adds new content to the user manual, and fixes some bugs\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Added support for unit testing via the
+minitest
+library\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The scaffold generator now emits a default unit test for the main project library\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Added optional ProgramName parameter to the scaffold generator\&. This allows you to specify reasonable program names when your project module has a strange capitalization:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+$ inochi ERBook
+create er_book/LICENSE
+
+$ inochi ERBook erbook
+create erbook/LICENSE
+
+$ inochi ERBook foobar
+create foobar/LICENSE
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Allow project authors to be specified via
+Inochi\&.init :YourProject, :authors => [[\'name\', \'mail\']]
+(thanks to Florian Gilcher)
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Run on both JRuby and normal Ruby in multiple versions and with different executable names on Windows\&. (thanks to Florian Gilcher)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use
+Gem::RubyGemsVersion
+instead of a shell command to determine rubygems version for generation of setup\&.erb\&. (thanks to Florian Gilcher)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add blank lines between all list items, not just multi\-line ones, in the plain\-text version of the release announcement for improved readability\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Added unit tests for utility methods provided by the
+Inochi
+module: project name calculation and CamelCase to snake_case conversion\&.
+.RE
+.SS "Version 0\&.1\&.0 (2009\-01\-13)"
+.sp
+This release reattempts to fix the circular dependency problem that occurred when installing either Inochi or ERBook\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Inochi\&.init()
+now adds
+#major(),
+#series(), and
+#requirement()
+instance methods to a project\(cqs
+VERSION
+constant\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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
+gem install
+command for
+Inochi\&.
+.sp
+The "Installing" section has been updated accordingly\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add forgotten Rake dependency for
+Inochi
+gem\&.
+.RE
+.SS "Version 0\&.0\&.1 (2009\-01\-13)"
+.sp
+This release fixes some show\-stopper bugs\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+The name of the project library was
+being determined incorrectly\&. (thanks to Florian Gilcher)
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+There was a
+circular dependency problem
+when installing the
+Inochi
+gem\&. (thanks to Florian Gilcher)
+.sp
+The solution is to specify the
+\-\-force
+option when installing the gem\&. The "Installing" section has been updated accordingly\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Generated project scaffolds now check against the major version of the yInochi` gem, to avoid runtime version conflicts\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Only add project libraries to
+$LOAD_PATH
+if not already there\&.
+.RE
+.SS "Version 0\&.0\&.0 (2009\-01\-13)"
+.sp
+This is the first release of Inochi\&. Enjoy!
+.SH "AUTHORS"
+.sp
+Suraj N\&. Kurapati
+.SS "Credits"
+.sp
+Florian Gilcher, Peileppe Production
+.sp
+The "inochi\&.png" image and its "inochi\&.svg" source utilize the "3 flowers" graphic[1], which was created and released into the public domain by Peileppe Production[2] on June 25, 2008\&.
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 1.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  1." 4.2
+.\}
+
+http://www\&.openclipart\&.org/detail/17456
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04' 2.\h'+01'\c
+.\}
+.el \{\
+.sp -1
+.IP "  2." 4.2
+.\}
+
+http://www\&.openclipart\&.org/user\-detail/Peileppe
+.RE
+.SS "License"
+.sp
+(the ISC license)
+.sp
+Copyright 2008 Suraj N\&. Kurapati <sunaku@gmail\&.com>
+.sp
+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\&.
+.sp
+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\&.
+.SH "SEE ALSO"
+.sp
+rake(1), rsync(1), asciidoc(1), a2x(1), [Ember]
+.SS "References"
+.TS
+tab(:);
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt.
+T{
+.sp
+AsciiDoc
+T}:T{
+.sp
+http://www\&.methods\&.co\&.nz/asciidoc/
+T}
+T{
+.sp
+Ember
+T}:T{
+.sp
+http://snk\&.tuxfamily\&.org/lib/ember/
+T}
+T{
+.sp
+ERBook
+T}:T{
+.sp
+http://snk\&.tuxfamily\&.org/lib/erbook/
+T}
+T{
+.sp
+eRuby
+T}:T{
+.sp
+http://en\&.wikipedia\&.org/wiki/ERuby
+T}
+T{
+.sp
+Inochi
+T}:T{
+.sp
+http://snk\&.tuxfamily\&.org/lib/inochi/
+T}
+T{
+.sp
+kdiff3
+T}:T{
+.sp
+http://kdiff3\&.sourceforge\&.net
+T}
+T{
+.sp
+Lynx
+T}:T{
+.sp
+http://lynx\&.isc\&.org
+T}
+T{
+.sp
+Markdown
+T}:T{
+.sp
+http://daringfireball\&.net/projects/markdown
+T}
+T{
+.sp
+meld
+T}:T{
+.sp
+http://meld\&.sourceforge\&.net
+T}
+T{
+.sp
+RAA
+T}:T{
+.sp
+http://raa\&.ruby\-lang\&.org
+T}
+T{
+.sp
+Ronn
+T}:T{
+.sp
+http://github\&.com/rtomayko/ronn
+T}
+T{
+.sp
+RubyGems
+T}:T{
+.sp
+http://rubygems\&.org
+T}
+T{
+.sp
+Ruby
+T}:T{
+.sp
+http://ruby\-lang\&.org
+T}
+T{
+.sp
+ruby\-talk
+T}:T{
+.sp
+http://www\&.ruby\-lang\&.org/en/community/mailing\-lists/
+T}
+T{
+.sp
+tkdiff
+T}:T{
+.sp
+http://tkdiff\&.sourceforge\&.net
+T}
+T{
+.sp
+YAML
+T}:T{
+.sp
+http://www\&.yaml\&.org/YAML_for_ruby\&.html
+T}
+T{
+.sp
+YARD
+T}:T{
+.sp
+http://yardoc\&.org/more
+T}
+.TE
+.sp 1