'\" t
.\"     Title: inochi
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 2011-06-29
.\"    Manual: \ \&
.\"    Source: \ \& 6.1.0
.\"  Language: English
.\"
.TH "INOCHI" "1" "2011\-06\-29" "\ \& 6\&.1\&.0" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * 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 an infrastructure that gives life to open\-source [Ruby] projects and helps you document, test, package, publish, announce, and maintain them\&.
.SS "Features"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Produces a comprehensive help manual that is written in
[eRuby]
over
[AsciiDoc]
and is rendered into a Web page (with RSS feed) as well as a UNIX manual page\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Produces beautiful plain\-text release announcements that are ready to be published on news outlets such as the
[ruby-talk]
mailing list\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Stores project information in constants in a single Ruby source file\&.
.RE
.SS "Resources"
.PP
Project website
.RS 4

\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/\fR\m[]
.RE
.PP
Announcements feed
.RS 4

\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/ann\&.xml\fR\m[]
.RE
.PP
API documentation
.RS 4

\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/api/\fR\m[]
.RE
.PP
Source code (browse online, download, or checkout)
.RS 4

\m[blue]\fBhttp://github\&.com/sunaku/inochi\fR\m[]
.RE
.PP
Issue tracker (report bugs, request features, get help)
.RS 4

\m[blue]\fBhttp://github\&.com/sunaku/inochi/issues\fR\m[]
.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\&.6\&.5 or newer\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}

[Pygments]
1\&.3\&.1 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(\*(Aq\*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq \*(Aq))
  end

  def test_handles_single_words
    assert_equal(1, WordCount\&.count(\*(Aqa\*(Aq))
    assert_equal(1, WordCount\&.count(\*(Aqfoo\*(Aq))
    assert_equal(1, WordCount\&.count(\*(Aqbar\*(Aq))
  end

  def test_handles_multiple_words
    assert_equal(2, WordCount\&.count(\*(Aqa b\*(Aq))
    assert_equal(2, WordCount\&.count(\*(Aqa\-b\*(Aq))
    assert_equal(2, WordCount\&.count(\*(Aqa/b\*(Aq))
  end

  def test_ignores_punctuation_and_space
    assert_equal(0, WordCount\&.count(\*(Aq!\*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq! @ # % #!@#\*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq !\*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq! \*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq ! \*(Aq))
    assert_equal(0, WordCount\&.count(\*(Aq   !   \*(Aq))
  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.
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
gem:spec
T}:T{
.sp
Build RubyGems package specification\&.
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: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
# diffuse "$old" "$out" "$new"                  # use diffuse
.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: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
\m[blue]\fB"Backend Attributes" in the AsciiDoc manual\fR\m[]\&\s-2\u[1]\d\s+2
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\*(Aqs gem
  puts gem\&.to_ruby

  # add files that are outside this project directory to the gem
  gem\&.files += [\*(Aqsome\*(Aq, \*(Aqfiles\*(Aq, \*(Aqin\*(Aq, \*(Aqthis\*(Aq, \*(Aqdirectory\*(Aq]

  # omit some added files in this project\*(Aqs directory from the gem
  gem\&.files \-= [\*(Aqlib/top_secret\&.rb\*(Aq, \*(Aqbin/more_top_secret_stuff\*(Aq]

  # 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/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 using [Bundler]:
.sp
.if n \{\
.RS 4
.\}
.nf
bundle install
.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
bundle exec inochi \-\-help     # display help manual
bundle exec 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
bundle exec ruby \-Ilib bin/inochi
bundle exec irb \-Ilib \-r inochi
.fi
.if n \{\
.RE
.\}
.sp
Or by setting the $RUBYLIB environment variable:
.sp
.if n \{\
.RS 4
.\}
.nf
env RUBYLIB=lib bundle exec ruby bin/inochi
env RUBYLIB=lib bundle exec irb \-r inochi
.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 included test/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/test_helper\&.rb file\&.
.SS "Contributing"
.sp
\m[blue]\fBFork this project on GitHub\fR\m[] and send a pull request\&.
.SH "HISTORY"
.SS "Version 6\&.1\&.0 (2011\-06\-29)"
.PP
\fBPrerequisite changes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
AsciiDoc 8\&.6\&.5 is now required\&.
.RE
.PP
\fBNew features\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use AsciiDoc\(cqs HTML5 backend to build HTML manual\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use sans headings and serif content in print style\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Show target URL beside external hyperlinks in print style\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Show cross\-reference hyperlinks as normal text in print style\&.
.RE
.PP
\fBBug fixes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Admonition icons were not emitted in HTML manual\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Require Rake 0\&.8\&.x because 0\&.9 is incompatible\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Fix undefined method \(oqwrite\(cq for #<Syck::Emitter\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use
bundle exec
to run Ruby and IRB in HACKING\&.
.RE
.PP
\fBHousekeeping\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Emit AsciiDoc attributes in document itself, not on the command line\&.
\m[blue]\fBhttp://groups\&.google\&.com/group/asciidoc/msg/b4f47a8e1f960018\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Revert "Reduce font size to accomodate small screens in help manual"\&.
.RE
.SS "Version 6\&.0\&.2 (2011\-04\-21)"
.sp
This release adopts some common Rails testing and development conventions, drops runtime gem version dependency establishment in favor of [Bundler], produces a gemspec file for greater interoperability, and improves merging\&.
.PP
\fBIncompatible changes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Remove
pub:ann
tasks; users can manually announce where/if they want to\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Remove runtime gem version dependency establishment from
lib/*/inochi\&.rb\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Replace
DEVTIME
constant in
lib/*/inochi\&.rb
with
[Bundler]\*(Aqs Gemfile\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Rename
RUNTIME
constant to
GEMDEPS
in
lib/*/inochi\&.rb\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Rename
test/helper\&.rb
to
test/test_helper\&.rb
per Rails convention\&.
.RE
.PP
\fBNew features\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Add
gem:spec
task to generate a gemspec file for your project\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Allow gem package to be built via
gem build *\&.gemspec
as
\m[blue]\fBYehuda Katz suggests\fR\m[]\&\s-2\u[2]\d\s+2\&.
.RE
.PP
\fBBug fixes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Make old and new files read\-only before merging\&.
.RE
.PP
\fBHousekeeping\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Omit CREDITS file from gem because help manual contains it\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Add diffuse tool to the example merge2 script in help manual\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Reduce font size to accomodate small screens in help manual\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Revise project & manual version mismatch error\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Revise project introduction in help manual\&.
.RE
.SS "Version 5\&.1\&.0 (2010\-08\-14)"
.sp
This release uses [Pygments] for syntax highlighting, adds icons to admonitions, speeds up the \fBpub:web\fR task, and further refines the HTML version of your project\(cqs help manual\&.
.PP
\fBNew features\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use admonition icons that are installed with AsciiDoc\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use Pygments for syntax coloring in AsciiDoc 8\&.5\&.4\&.
.RE
.PP
\fBBug fixes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Only build what will be uploaded in
\fBpub:web\fR
task\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Do not display table of contents in print preview mode\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Increase body max\-width to 50em to show 80 characters\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Update DOM selectors for AsciiDoc 8\&.5\&.4 in
\fBann\fR
tasks\&.
.RE
.PP
\fBHousekeeping\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Get straight to the point when stating project purpose\&.
.RE
.SS "Version 5\&.0\&.2 (2010\-08\-10)"
.sp
This release emits hyperlink URLs in the generated UNIX manpage, beautifies the plain\-text release announcement, and fixes incorrect AsciiDoc usage\&.
.PP
\fBBug fixes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Emit hyperlink URLs when rendering the help manual into UNIX manpage format by using xsltproc(1) instead of a2x(1)\&. Thanks to Rainer Müller on the
[AsciiDoc]
mailing list for
\m[blue]\fBhelping me find the solution\fR\m[]\&\s-2\u[3]\d\s+2
to this problem\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Do not add space before paragraph titles in plain\-text announcement\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use proper AsciiDoc bibliography syntax in the
BEYOND
file\&.
.RE
.PP
\fBHousekeeping\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Only list related UNIX manpages in the "SEE ALSO" section\&.
.RE
.SS "Version 5\&.0\&.1 (2010\-08\-09)"
.sp
This release restores missing metadata in generated gem packages\&.
.PP
\fBBug fixes\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Project description and author names were not parsed correctly from the help manual when building gem packages\&.
.RE
.PP
\fBHousekeeping\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Redistribute load\-order indices in internal Rake task filenames\&.
.RE
.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
.\}
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
.\}
Use
[AsciiDoc]
instead of
[Ronn]
to render the help manual\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Move "SETUP" and "SYNOPSIS" sections into their own files\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Rename
SETUP
file to
INSTALL
per Linux convention\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Add
:man_asciidoc_attributes
option to inochi\&.conf
.RE
.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
.\}
Add workaround for
lynx \-dump
ignoring <base href="\&..."/>
.RE
.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
\m[blue]\fBis a private method\fR\m[]\&\s-2\u[4]\d\s+2
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\*(Aqt know how to build task \*(Aq\*(Aq
/usr/lib/ruby/gems/1\&.9\&.1/gems/rake\-0\&.8\&.7/lib/rake\&.rb:1728:in `[]\*(Aq
(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
\m[blue]\fBsuggested by Eric Hodel\fR\m[]\&\s-2\u[5]\d\s+2, so that subscribers of
\m[blue]\fBthe RubyForge gems feed\fR\m[]\&\s-2\u[6]\d\s+2
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\*(Aq 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
.\}

\m[blue]\fBSDoc\fR\m[]\&\s-2\u[7]\d\s+2
is now used to generate API documentation instead of
\m[blue]\fBYARD\fR\m[]\&\s-2\u[8]\d\s+2\&. 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
\m[blue]\fBcode quality statistics\fR\m[]\&\s-2\u[9]\d\s+2\&.
.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
\m[blue]\fBmultiruby\fR\m[]\&\s-2\u[10]\d\s+2\&.
.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[\*(AqUSERPROFILE\*(Aq]
gives the path to the user\(cqs home directory and
ENV[\*(AqHOME\*(Aq]
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\*(Aq 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
\m[blue]\fBminitest\fR\m[]\&\s-2\u[11]\d\s+2
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 => [[\*(Aqname\*(Aq, \*(Aqmail\*(Aq]]
(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 \m[blue]\fBcircular dependency problem\fR\m[]\&\s-2\u[12]\d\s+2 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
\m[blue]\fBbeing determined incorrectly\fR\m[]\&\s-2\u[13]\d\s+2\&. (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
\m[blue]\fBcircular dependency problem\fR\m[]\&\s-2\u[12]\d\s+2
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, Rainer Müller
.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
.\}

\m[blue]\fBhttp://www\&.openclipart\&.org/detail/17456\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}

\m[blue]\fBhttp://www\&.openclipart\&.org/user\-detail/Peileppe\fR\m[]
.RE
.SS "License"
.sp
(the ISC license)
.sp
Copyright 2008 Suraj N\&. Kurapati <\m[blue]\fBsunaku@gmail\&.com\fR\m[]\&\s-2\u[14]\d\s+2>
.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
rsync(1), asciidoc(1), xsltproc(1), lynx(1)
.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
lt lt
lt lt.
T{
.sp
[AsciiDoc]
T}:T{
.sp
\m[blue]\fBhttp://www\&.methods\&.co\&.nz/asciidoc/\fR\m[]
T}
T{
.sp
[Bundler]
T}:T{
.sp
\m[blue]\fBhttp://gembundler\&.com\fR\m[]
T}
T{
.sp
[Ember]
T}:T{
.sp
\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/ember/\fR\m[]
T}
T{
.sp
[ERBook]
T}:T{
.sp
\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/erbook/\fR\m[]
T}
T{
.sp
[eRuby]
T}:T{
.sp
\m[blue]\fBhttp://en\&.wikipedia\&.org/wiki/ERuby\fR\m[]
T}
T{
.sp
[Inochi]
T}:T{
.sp
\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/\fR\m[]
T}
T{
.sp
[kdiff3]
T}:T{
.sp
\m[blue]\fBhttp://kdiff3\&.sourceforge\&.net\fR\m[]
T}
T{
.sp
[Lynx]
T}:T{
.sp
\m[blue]\fBhttp://lynx\&.isc\&.org\fR\m[]
T}
T{
.sp
[Markdown]
T}:T{
.sp
\m[blue]\fBhttp://daringfireball\&.net/projects/markdown\fR\m[]
T}
T{
.sp
[meld]
T}:T{
.sp
\m[blue]\fBhttp://meld\&.sourceforge\&.net\fR\m[]
T}
T{
.sp
[Pygments]
T}:T{
.sp
\m[blue]\fBhttp://pygments\&.org\fR\m[]
T}
T{
.sp
[RAA]
T}:T{
.sp
\m[blue]\fBhttp://raa\&.ruby\-lang\&.org\fR\m[]
T}
T{
.sp
[Ronn]
T}:T{
.sp
\m[blue]\fBhttp://github\&.com/rtomayko/ronn\fR\m[]
T}
T{
.sp
[RubyGems]
T}:T{
.sp
\m[blue]\fBhttp://rubygems\&.org\fR\m[]
T}
T{
.sp
[Ruby]
T}:T{
.sp
\m[blue]\fBhttp://ruby\-lang\&.org\fR\m[]
T}
T{
.sp
[ruby\-talk]
T}:T{
.sp
\m[blue]\fBhttp://www\&.ruby\-lang\&.org/en/community/mailing\-lists/\fR\m[]
T}
T{
.sp
[tkdiff]
T}:T{
.sp
\m[blue]\fBhttp://tkdiff\&.sourceforge\&.net\fR\m[]
T}
T{
.sp
[YAML]
T}:T{
.sp
\m[blue]\fBhttp://www\&.yaml\&.org/YAML_for_ruby\&.html\fR\m[]
T}
T{
.sp
[YARD]
T}:T{
.sp
\m[blue]\fBhttp://yardoc\&.org/more\fR\m[]
T}
.TE
.sp 1
.SH "NOTES"
.IP " 1." 4
"Backend Attributes" in the AsciiDoc manual
.RS 4
\%http://www.methods.co.nz/asciidoc/chunked/aph.html
.RE
.IP " 2." 4
Yehuda Katz suggests
.RS 4
\%http://yehudakatz.com/2010/04/02/using-gemspecs-as-intended/
.RE
.IP " 3." 4
helping me find the solution
.RS 4
\%http://groups.google.com/group/asciidoc/msg/949fae9deb9f86b8
.RE
.IP " 4." 4
is a private method
.RS 4
\%http://redmine.ruby-lang.org/issues/show/3617
.RE
.IP " 5." 4
suggested by Eric Hodel
.RS 4
\%http://www.ruby-forum.com/topic/190220#830072
.RE
.IP " 6." 4
the RubyForge gems feed
.RS 4
\%http://gems.rubyforge.org/index.rss
.RE
.IP " 7." 4
SDoc
.RS 4
\%http://github.com/voloko/sdoc/tree/master
.RE
.IP " 8." 4
YARD
.RS 4
\%http://yard.rubyforge.org
.RE
.IP " 9." 4
code quality statistics
.RS 4
\%http://www.infoq.com/news/2008/11/static-analysis-tool-roundup
.RE
.IP "10." 4
multiruby
.RS 4
\%http://www.infoq.com/news/2008/02/multiruby-testing
.RE
.IP "11." 4
minitest
.RS 4
\%http://rubyforge.org/projects/bfts/
.RE
.IP "12." 4
circular dependency problem
.RS 4
\%http://www.ruby-forum.com/topic/176173#771281
.RE
.IP "13." 4
being determined incorrectly
.RS 4
\%http://www.ruby-forum.com/topic/176173#771351
.RE
.IP "14." 4
sunaku@gmail.com
.RS 4
\%mailto:sunaku@gmail.com
.RE