inochi 3.0.0 → 4.0.0

data/lib/inochi/engine.rb

@@ -58,7 +58,7 @@ module Inochi
     # path.  If the given path already exists, then a
     # backup is created before invoking the merging tool.
     #
-    def create path, body, merger = ENV[:merger]
+    def create path, body, merger = ENV['merger']
       generate path, body do |*files|
         system "#{merger} #{Shellwords.join files}" if merger
       end

data/lib/inochi/inochi.rb

@@ -18,12 +18,12 @@ module Inochi
   ##
   # Number of this release of this project.
   #
-  VERSION = '3.0.0'
+  VERSION = '4.0.0'
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = '2010-04-27'
+  RELDATE = '2010-07-25'
 
   ##
   # Description of this release of this project.
@@ -57,11 +57,11 @@ module Inochi
   RUNTIME = {
     'ember'       => [ '>= 0.3.0' , '< 1' ], # for eRuby templates
     'highline'    => [ '>= 1.5'   , '< 2' ], # for echoless password entry
-    'mechanize'   => [ '~> 1'             ], # for publishing announcements
+    'mechanize'   => [ '~> 1'     , '< 2' ], # for publishing announcements
     'nokogiri'    => [ '>= 1.4'   , '< 2' ], # for parsing HTML and XML
     'rake'        => [ '>= 0.8.4' , '< 1' ], # for Inochi::Engine
-    'ronn'        => [ '>= 0.5'   , '< 1' ], # for making UNIX man pages
-    'yard'        => [                    ], # for making API documentation
+    'ronn'        => [ '>= 0.7.0' , '< 1' ], # for making UNIX man pages
+    'yard'        => [ '>= 0.5.8' , '< 1' ], # for making API documentation
   }
 
   ##
@@ -82,7 +82,7 @@ module Inochi
   #   }
   #
   DEVTIME = {
-    'dfect' => [ '>= 1.1.0', '< 2' ], # for unit testing
+    'detest' => [ '>= 3.1.0', '< 4' ], # for unit testing
   }
 
   # establish gem version dependencies

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

@@ -1,12 +1,12 @@
 desc 'Instill Inochi into current directory.'
 task :init do
 
-  unless project_name = ENV[:project]
+  unless project_name = ENV['project']
     raise ArgumentError, 'project name not specified'
   end
 
   library_name = Engine.calc_library_name(project_name)
-  package_name = ENV[:package] || Engine.calc_package_name(library_name)
+  package_name = ENV['package'] || Engine.calc_package_name(library_name)
 
   project_version = '0.0.0'
   project_release = Time.now.strftime('%F')
@@ -22,7 +22,7 @@ task :init do
 
   create_from_rbs binding, 'test/runner', 'test_runner'
   chmod 0755, 'test/runner'
-  create_from_rbs binding, 'test/test_helper.rb', 'test_helper.rb'
+  create_from_rbs binding, 'test/helper.rb', 'test_helper.rb'
   create_from_rbs binding, "test/#{package_name}_test.rb", 'library_test.rb'
 
   create_from_rbs binding, 'LICENSE'
@@ -33,6 +33,6 @@ task :init do
   create_from_rbs binding, 'HACKING'
   create_from_rbs binding, 'HISTORY'
   create_from_rbs binding, 'CREDITS'
-  create_from_rbs binding, 'FURTHER'
+  create_from_rbs binding, 'BEYOND'
 
 end

data/lib/inochi/tasks/3-man.rake

@@ -52,6 +52,7 @@ task :@man_doc => @man_src do
     ronn_opts = {
       :date => Date.parse(@project_module::RELDATE),
       :manual => "Version #{@project_module::VERSION}",
+      :styles => %w[ man toc 80c ]
     }
     ronn_file = "#{@project_package_name}.1.ronn"
 

data/lib/inochi/tasks/4-ann.rake

@@ -39,10 +39,10 @@ end
 task :@ann_rel_html_body_nodes do
   unless @ann_rel_html_body_nodes
     begin
-      head, body = fetch_nodes_between('h2#VERSIONS ~ h3', 'h1,h2,h3')
+      head, body = fetch_nodes_between('h2#HISTORY ~ h3', 'h1,h2,h3')
     rescue => error
       error.message.insert 0,
-        "The manual lacks a <H3> heading under a <H2> VERSIONS heading.\n"
+        "The manual lacks a <H3> heading under a <H2> HISTORY heading.\n"
       raise error
     end
 
@@ -87,7 +87,7 @@ task :@ann_html do
       </center>
       #{@ann_nfo_html_nodes.join}
       #{@ann_rel_html_title_node}
-      #{@ann_rel_html_body_nodes.join}
+      #{@ann_rel_html_body_nodes.map(&:to_xml).join}
     }.strip
 
     @ann_html = resolve_html_links(@ann_html)
@@ -199,7 +199,7 @@ end
 def convert_html_to_text html
   # lynx's -dump option requires a .html file
   require 'tempfile'
-  tmp_file = Tempfile.new($$).path + '.html'
+  tmp_file = Tempfile.new('inochi').path + '.html'
 
   begin
     File.write tmp_file, html

data/lib/inochi/tasks/5-gem.rake

@@ -4,6 +4,18 @@ task :gem do
   Rake::Task[:@ann_nfo_text].invoke
   Rake::Task[:@project_authors_text].invoke
 
+  # ensure that project version matches release notes
+  Rake::Task[:@ann_rel_html_body_nodes].invoke
+
+  version_from_notes = @ann_rel_html_title_node.inner_text
+  version_from_project = "Version #{@project_module::VERSION} (#{@project_module::RELDATE})"
+
+  unless version_from_notes == version_from_project
+    raise "Project version #{version_from_project.inspect} does not match "\
+      "the #{version_from_notes.inspect} version listed in the release notes."
+  end
+
+  # build gemspec
   gem             = Gem::Specification.new
   gem.name        = @project_package_name
   gem.date        = @project_module::RELDATE

data/lib/inochi/tasks/6-pub.rake

@@ -37,51 +37,56 @@ desc 'Announce release on all news outlets.'
 task 'pub:ann' => %w[ pub:ann:raa pub:ann:ruby-talk ]
 
 desc 'Announce release on ruby-talk mailing list.'
-task 'pub:ann:ruby-talk' do
+task 'pub:ann:ruby-talk' => @ann_text_dst do
   site = 'http://ruby-forum.com'
 
-  require 'mechanize'
-  browser = Mechanize.new
+  # let user verify announcement before publishing
+  ann_text = File.read(@ann_text_dst)
+  puts ann_text, nil
 
-  # fetch login form
-  page = browser.get("#{site}/user/login")
-  form = page.forms_with(:action => '/user/login').first or
-    raise "cannot find login form on Web page: #{page.uri}"
-
-  # fill login information
   require 'highline'
   highline = HighLine.new
 
-  form['name'] = highline.ask("#{site} username: ")
-  form['password'] = highline.ask("#{site} password: ") {|q| q.echo = false }
+  if highline.agree "Really publish this announcement to #{site}?"
+    require 'mechanize'
+    browser = Mechanize.new
 
-  # submit login form
-  page = form.click_button
-  page.at('a[href="/user/logout"]') or
-    raise "invalid login for #{site}"
+    # fetch login form
+    page = browser.get("#{site}/user/login")
+    form = page.forms_with(:action => '/user/login').first or
+      raise "cannot find login form on Web page: #{page.uri}"
 
-  # make the announcement
-  page = browser.get("#{site}/topic/new?forum_id=4")
-  form = page.forms_with(:action => '/topic/new#postform').first or
-    raise "cannot find post creation form on Web page: #{page.uri}"
+    # fill login information
+    form['name'] = highline.ask("#{site} username: ")
+    form['password'] = highline.ask("#{site} password: ") {|q| q.echo = false }
 
-  # enable notification by email whenever
-  # someone replies to this announcement
-  form['post[subscribed_by_author]'] = '1'
+    # submit login form
+    page = form.click_button
+    page.at('a[href="/user/logout"]') or
+      raise "invalid login for #{site}"
 
-  Rake::Task[:@ann_subject].invoke
-  form['post[subject]'] = @ann_subject
+    # make the announcement
+    page = browser.get("#{site}/topic/new?forum_id=4")
+    form = page.forms_with(:action => '/topic/new#postform').first or
+      raise "cannot find post creation form on Web page: #{page.uri}"
 
-  Rake::Task[@ann_text_dst].invoke
-  form['post[text]'] = File.read(@ann_text_dst)
+    # enable notification by email whenever
+    # someone replies to this announcement
+    form['post[subscribed_by_author]'] = '1'
 
-  # submit the announcement
-  page = form.submit
+    Rake::Task[:@ann_subject].invoke
+    form['post[subject]'] = @ann_subject
 
-  if error = page.at('.error')
-    raise "Announcement to #{site} failed:\n#{error.text}"
-  else
-    puts "Successfully announced to #{site}:", page.uri
+    form['post[text]'] = ann_text
+
+    # submit the announcement
+    page = form.submit
+
+    if error = page.at('.error')
+      raise "Announcement to #{site} failed:\n#{error.text}"
+    else
+      puts "Successfully announced to #{site}:", page.uri
+    end
   end
 end
 

data/lib/inochi/templates/HACKING.rbs

@@ -48,7 +48,8 @@ Or by setting the `$RUBYLIB` environment variable:
     ruby bin/#{package_name}
     irb -r #{package_name}
 
-Or by installing the [ruby-wrapper](http://github.com/chneukirchen/rup) tool.
+Or by running Ruby through the [ruby-wrapper](
+http://github.com/chneukirchen/rup/blob/master/ruby-wrapper ) tool.
 
 %#----------------------------------------------------------------------------
 ### RubyGems setup
@@ -74,14 +75,14 @@ Or by setting the `$RUBYOPT` environment variable:
 %#----------------------------------------------------------------------------
 
 Simply execute the included test runner, which sets up Ruby's `$LOAD_PATH` for
-testing, loads the included `test/test_helper.rb` file, and then evaluates all
+testing, loads the `test/helper.rb` file, and then evaluates all
 `test/**/*_test.rb` files:
 
-    test/runner
+    ruby test/runner
 
 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.
+in the `test/helper.rb` file.
 
 %#----------------------------------------------------------------------------
 ### Contributing

data/lib/inochi/templates/HISTORY.rbs

@@ -1,5 +1,5 @@
 %#----------------------------------------------------------------------------
-## VERSIONS
+## HISTORY
 %#----------------------------------------------------------------------------
 
 This section contains release notes of current and past releases.

data/lib/inochi/templates/MANUAL.rbs

@@ -1,7 +1,14 @@
 <%
+  proj_home_url = #{library_name}::WEBSITE
+  api_docs_url  = File.join(proj_home_url, 'api/')
+  ann_feed_url  = File.join(proj_home_url, 'ann.xml')
+
+  code_repo_scm = '[Git](http://git-scm.com)'
+  code_repo_url = 'http://github.com/TODO/#{package_name}'
+  bug_track_url = 'http://github.com/TODO/#{package_name}/issues'
+
   ##
-  # Wraps the given content within <pre>
-  # tags in a way that is Markdown-safe.
+  # Puts the given content inside <pre> tags in a Markdown-safe way.
   #
   def preformatted content
     if content =~ /\\S/
@@ -24,4 +31,4 @@
 
 %+ "CREDITS"
 
-%+ "FURTHER"
+%+ "BEYOND"

data/lib/inochi/templates/README.rbs

@@ -17,19 +17,19 @@
 %#----------------------------------------------------------------------------
 
 * Issue tracker (report bugs, request features, get help):
-  <http://github.com/TODO/#{package_name}/issues>
+  <<%= bug_track_url %>>
 
-* Source code (browse online or obtain with [Git](http://git-scm.com)):
-  <http://github.com/TODO/#{package_name}>
+* Source code (browse online or obtain with <%= code_repo_scm %>):
+  <<%= code_repo_url %>>
 
 * API documentation:
-  <<%= File.join(#{library_name}::WEBSITE, 'api/') %>>
+  <<%= api_docs_url %>>
 
 * Announcements feed:
-  <<%= File.join(#{library_name}::WEBSITE, 'ann.xml') %>>
+  <<%= ann_feed_url %>>
 
 * Official website:
-  <<%= Ember::WEBSITE %>>
+  <<%= proj_home_url %>>
 
 %#----------------------------------------------------------------------------
 ### Setup

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

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

data/lib/inochi/templates/test_runner.rbs

@@ -2,24 +2,29 @@
 #
 # Adds the project library directory
 # and this test directory to Ruby's
-# load path and runs the given tests.
+# load path, loads the test helper
+# and executes the given test files.
 #
-# Usage:  ruby test/runner [TESTS_TO_RUN]
+# ruby test/runner [-d] [-v] [TEST]...
 #
-# Where:  TESTS_TO_RUN is a list of files
-#         or file globbing patterns that
-#         describe a set of files to run.
+# -d    Enables $DEBUG mode in Ruby.
 #
-#         If this parameter is not given,
-#         all *_test.rb files within or
-#         beneath this directory are run.
+# -v    Enables $VERBOSE mode in Ruby.
+#
+# TEST  Path to a file, or a file globbing
+#       pattern describing a set of files.
+#
+#       The default value is all *_test.rb
+#       files beneath this test/ directory.
+
+$DEBUG   = true if ARGV.delete('-d')
+$VERBOSE = true if ARGV.delete('-v')
 
-lib_dir = File.expand_path('../../lib', __FILE__)
+lib_dir  = File.expand_path('../../lib', __FILE__)
 test_dir = File.expand_path('..', __FILE__)
 $LOAD_PATH.unshift lib_dir, test_dir
 
-require '#{package_name}/inochi'
-require 'test_helper'
+load File.join(test_dir, 'helper.rb')
 
 ARGV << "\#{test_dir}/**/*_test.rb" if ARGV.empty?
 ARGV.each {|glob| Dir[glob].each {|test| load test } }

data/man.html

@@ -2,89 +2,94 @@
 <html>
 <head>
   <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.5'>
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
   <title>inochi(1) - Gives life to Ruby projects</title>
-  <style type='text/css'>
-    body {margin:0}
-    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
-      font-family:consolas,monospace;
-      font-size:16px;
-      line-height:1.3;
-      color:#343331;
-      background:#fff; }
-    #man { max-width:87ex; margin:0 3ex 1ex 1ex; text-align:justify; }
-    #man div.man-navigation {
-      position:fixed;
-      top:0;
-      left:91ex;
-      height:100%;
-      width:100%;
-      padding:1ex 0 0 2ex;
-      border-left:0.5ex solid #DCDCDC;
-      background-color: #F5F5F5;
-    }
-    #man div.man-navigation a { display:block; margin-bottom:1.5ex }
-    #man h1, #man h2, #man h3 { color:#232221;clear:left }
-    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
-    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
-    #man h3 { font-size:16px; margin:0 0 0 4ex; }
-    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
-    #man pre {
-      color:#333231;
-      background:#edeceb;
-      padding:5px 7px;
-      margin:0px 0 20px 0;
-      border-left:2ex solid #ddd}
-    #man pre + h2, #man pre + h3 {
-      margin-top:22px;
-    }
-    #man h2 + pre, #man h3 + pre {
-      margin-top:5px;
-    }
-    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
-    #man dt { margin:0; clear:left }
-    #man dt.flush { float:left; width:8ex }
-    #man dd { margin:0 0 0 9ex }
-    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
-    #man pre code { font-weight:normal; color:#232221; background:inherit }
-    #man em, var, u {
-      font-style:normal; color:#333231; border-bottom:1px solid #999; }
-    #man h1.man-title { display:none; }
-    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
-      float:left; width:33%; list-style-type:none;
-      text-transform:uppercase; font-size:18px; color:#999;
-      letter-spacing:1px;}
-    #man ol.man { width:100%; }
-    #man ol.man li.tl { text-align:left }
-    #man ol.man li.tc { text-align:center;letter-spacing:4px }
-    #man ol.man li.tr { text-align:right; float: right }
-    #man ol.man a { color:#999 }
-    #man ol.man a:hover { color:#333231 }
-    #man img { display:block; margin:auto }
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:5px 1ex;background:#edeceb;border-left:1ex solid #ddd}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
   </style>
-  <style type='text/css' media='print'>
-    #man { max-width:none }
-    #man div.man-navigation { display:none }
-    #man a[href]:not([href^="#"]):not([data-bare-link]):after {
-      content:" " attr(href);
-    }
+  <style type='text/css' media='all'>
+  /* style: toc */
+  .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:36px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
+  .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 20px;color:#999;text-decoration:none}
+  .man-navigation a:hover {color:#111;text-decoration:underline}
+  </style>
+  <style type='text/css' media='all'>
+  /* style: 80c */
+  .mp {max-width:78ex}
+   
+  .man-navigation {left:91ex}
   </style>
 </head>
-<body>
-<div id='man'>
-
-<div class='man-navigation'><a href='#NAME'>NAME</a> <a href='#SYNOPSIS'>SYNOPSIS</a> <a href='#DESCRIPTION'>DESCRIPTION</a> <a href='#OPTIONS'>OPTIONS</a> <a href='#TASKS'>TASKS</a> <a href='#PROJECTS'>PROJECTS</a> <a href='#TUTORIAL'>TUTORIAL</a> <a href='#HACKING'>HACKING</a> <a href='#VERSIONS'>VERSIONS</a> <a href='#AUTHORS'>AUTHORS</a> <a href='#CREDITS'>CREDITS</a> <a href='#LICENSE'>LICENSE</a> <a href='#SEE-ALSO'>SEE ALSO</a></div>
-
-<h1 class='man-title'>inochi(1)</h1>
-
-<ol class='head man'>
-  <li class='tl'>inochi(1)</li>
-  <li class='tc'>Version 3.0.0</li>
-  <li class='tr'>inochi(1)</li>
-</ol>
-
-<h2 id='NAME'>NAME</h2>
-<p><code>inochi</code> - Gives life to Ruby projects</p>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#TASKS">TASKS</a>
+    <a href="#PROJECTS">PROJECTS</a>
+    <a href="#TUTORIAL">TUTORIAL</a>
+    <a href="#HACKING">HACKING</a>
+    <a href="#HISTORY">HISTORY</a>
+    <a href="#AUTHORS">AUTHORS</a>
+    <a href="#CREDITS">CREDITS</a>
+    <a href="#LICENSE">LICENSE</a>
+    <a href="#SEE-ALSO">SEE ALSO</a>
+    </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>inochi(1)</li>
+    <li class='tc'>Version 4.0.0</li>
+    <li class='tr'>inochi(1)</li>
+  </ol>
+
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>inochi</code> - <span class="man-whatis">Gives life to Ruby projects</span>
+</p>
 
 <p><img src="logo/inochi.png" alt="" /></p>
 
@@ -109,7 +114,7 @@ documentation and reduces project administrivia.</p>
 <dt>Source code (browse online or obtain with <a href="http://git-scm.com">Git</a>)</dt><dd><p><a href="http://github.com/sunaku/inochi" data-bare-link="true">http://github.com/sunaku/inochi</a></p></dd>
 <dt>API documentation</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/api/" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/api/</a></p></dd>
 <dt>Announcements feed</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/ann.xml" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/ann.xml</a></p></dd>
-<dt>Official website</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/</a></p></dd>
+<dt>Official website</dt><dd><p><a href="http://snk.tuxfamily.org/lib/inochi/" data-bare-link="true">http://snk.tuxfamily.org/lib/inochi/</a></p></dd>
 </dl>
 
 
@@ -148,7 +153,7 @@ documentation and reduces project administrivia.</p>
 <h2 id="DESCRIPTION">DESCRIPTION</h2>
 
 <p>Runs the given <var>TASK</var> (see <strong>TASKS</strong> below) while passing the given
-<var>RAKE_OPTIONS</var> to rake(1).</p>
+<var>RAKE_OPTIONS</var> to <span class="man-ref">rake<span class="s">(1)</span></span>.</p>
 
 <h2 id="OPTIONS">OPTIONS</h2>
 
@@ -303,7 +308,7 @@ conversion is not perfect.</p>
 <h3 id="inochi-pub-web">inochi pub:web</h3>
 
 <p>Publishes the help manual, API documentation, and RSS feed to project website
-using rsync(1) according to the :pub_web_* parameters defined in the
+using <span class="man-ref">rsync<span class="s">(1)</span></span> according to the :pub_web_* parameters defined in the
 project's options file (see <strong>Options file</strong> below).</p>
 
 <h2 id="PROJECTS">PROJECTS</h2>
@@ -314,14 +319,14 @@ source code, documentation, and a Web presence; which are all explained below.</
 <h3 id="Options-file">Options file</h3>
 
 <p>A project's options file is a <a href="http://www.yaml.org/YAML_for_ruby.html">YAML</a> document named <code>inochi.opts</code> that defines
-the following optional parameters for the various inochi(1) sub-commands:</p>
+the following optional parameters for the various <a class="man-ref" href="inochi.1.html">inochi<span class="s">(1)</span></a> sub-commands:</p>
 
 <dl>
 <dt>:pub_web_target</dt><dd><p>Location where <code>inochi pub:web</code> will upload files.  This value
-can use any local/remote/protocol syntax supported by rsync(1).</p></dd>
-<dt>:pub_web_options</dt><dd><p>Options for rsync(1), which uploads files for <code>inochi pub:web</code>.</p></dd>
+can use any local/remote/protocol syntax supported by <span class="man-ref">rsync<span class="s">(1)</span></span>.</p></dd>
+<dt>:pub_web_options</dt><dd><p>Options for <span class="man-ref">rsync<span class="s">(1)</span></span>, which uploads files for <code>inochi pub:web</code>.</p></dd>
 <dt>:pub_web_extras</dt><dd><p>Additional files for <code>inochi pub:web</code> to upload.  The values listed
-here can use any local/remote/protocol syntax supported by rsync(1).</p>
+here can use any local/remote/protocol syntax supported by <span class="man-ref">rsync<span class="s">(1)</span></span>.</p>
 
 <p>Example:</p>
 
@@ -377,7 +382,7 @@ they do not raise a <code>Gem::LoadError</code> exception.</p></dd>
 
 <dl>
 <dt>test/runner</dt><dd><p>Executable Ruby script that hides the details of running the test suite.</p></dd>
-<dt>test/test_helper.rb</dt><dd><p>Ruby source file that prepares the testing environment by loading a testing
+<dt>test/helper.rb</dt><dd><p>Ruby source file that prepares the testing environment by loading a testing
 library and defining common knowledge and utility logic shared by the actual
 tests.</p></dd>
 <dt>test/**/*_test.rb</dt><dd><p>Part of the test suite.  Performs the actual testing.</p></dd>
@@ -530,7 +535,7 @@ end
 
 <p>Run the test suite and observe that all tests fail:</p>
 
-<pre><code>test/runner
+<pre><code>ruby test/runner
 </code></pre>
 
 <p>Append the following code to the <code>lib/word_count.rb</code> file:</p>
@@ -545,7 +550,7 @@ end
 
 <p>Run the test suite again and observe that all tests pass:</p>
 
-<pre><code>test/runner
+<pre><code>ruby test/runner
 </code></pre>
 
 <p>Append the following code to the <code>bin/word_count</code> file:</p>
@@ -603,7 +608,7 @@ ruby bin/inochi
 irb -r inochi
 </code></pre>
 
-<p>Or by installing the <a href="http://github.com/chneukirchen/rup">ruby-wrapper</a> tool.</p>
+<p>Or by running Ruby through the <a href="http://github.com/chneukirchen/rup/blob/master/ruby-wrapper">ruby-wrapper</a> tool.</p>
 
 <h3 id="RubyGems-setup">RubyGems setup</h3>
 
@@ -627,24 +632,75 @@ set -x RUBYOPT -rubygems   # fish
 <h3 id="Running-tests">Running tests</h3>
 
 <p>Simply execute the included test runner, which sets up Ruby's <code>$LOAD_PATH</code> for
-testing, loads the included <code>test/test_helper.rb</code> file, and then evaluates all
+testing, loads the <code>test/helper.rb</code> file, and then evaluates all
 <code>test/**/*_test.rb</code> files:</p>
 
-<pre><code>test/runner
+<pre><code>ruby test/runner
 </code></pre>
 
 <p>Its exit status will indicate whether all tests have passed.  It may also
 print additional pass/fail information depending on the testing library used
-in the <code>test/test_helper.rb</code> file.</p>
+in the <code>test/helper.rb</code> file.</p>
 
 <h3 id="Contributing">Contributing</h3>
 
 <p>Fork this project on GitHub (see <strong>Resources</strong> above) and send a pull request.</p>
 
-<h2 id="VERSIONS">VERSIONS</h2>
+<h2 id="HISTORY">HISTORY</h2>
 
 <p>This section contains release notes of current and past releases.</p>
 
+<h3 id="Version-4-0-0-2010-07-25-">Version 4.0.0 (2010-07-25)</h3>
+
+<p>Incompatible changes:</p>
+
+<ul>
+<li>Rename the "VERSIONS" section in the HISTORY file to "HISTORY".</li>
+</ul>
+
+
+<p>Changes you will see in upgraded or newly generated projects:</p>
+
+<ul>
+<li><p>Rename the "FURTHER" file to "BEYOND".</p></li>
+<li><p>Rename <code>test/test_helper.rb</code> to just <code>test/helper.rb</code>.</p></li>
+<li><p>Store resource URLs in variables in MANUAL for reuse.</p></li>
+<li><p>Provide more precise link to ruby-wrapper tool in HACKING.</p></li>
+</ul>
+
+
+<p>New features:</p>
+
+<ul>
+<li><p>Ensure that project version matches release notes before building a gem.
+This helps to prevent the problem where you sometimes forget to update
+both the release notes and the project information file simultaneously.</p></li>
+<li><p>Display announcement message to user (and make them confirm it) before
+publishing to ruby-talk.  This helps to prevent you from appearing inept
+and having to apologize later for your publishing blunders.</p></li>
+<li><p>Add <code>-d</code> (to enable <code>$DEBUG</code>) and <code>-v</code> (to enable <code>$VERBOSE</code>)
+command-line options to the generated <code>test/runner</code> script.</p></li>
+</ul>
+
+
+<p>Bug fixes:</p>
+
+<ul>
+<li><p>Various compatibility fixes for Ruby 1.9.2-rc2.</p></li>
+<li><p>Prefix <code>test/runner</code> command with "ruby" for Windows users.</p></li>
+<li><p>Ember::WEBSITE was always being emitted in README.</p></li>
+</ul>
+
+
+<p>Housekeeping:</p>
+
+<ul>
+<li><p>Add version constraints for YARD and Mechanize dependencies.</p></li>
+<li><p>Upgrade from Dfect 1.1.0 to Detest 3.1.0 for unit testing.</p></li>
+<li><p>Upgrade to Ronn 0.7.0 for generating this user manual.</p></li>
+</ul>
+
+
 <h3 id="Version-3-0-0-2010-04-27-">Version 3.0.0 (2010-04-27)</h3>
 
 <p>Incompatible changes:</p>
@@ -662,7 +718,7 @@ your project's Ruby library is first loaded.</p></li>
 
 <ul>
 <li><p>Reflect current Inochi version in gem constraint.</p></li>
-<li><p>Forgot to list Ember as a runtime gem dependency.</p></li>
+<li><p>Forgot to list <a href="http://snk.tuxfamily.org/lib/ember/">Ember</a> as a runtime gem dependency.</p></li>
 </ul>
 
 
@@ -1085,7 +1141,7 @@ the public domain by <a href="http://www.openclipart.org/user-detail/Peileppe">P
 
 <p>(the ISC license)</p>
 
-<p>Copyright 2008 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#x74;&#111;&#58;&#x73;&#x75;&#x6e;&#x61;&#107;&#x75;&#x40;&#x67;&#x6d;&#x61;&#105;&#108;&#x2e;&#x63;&#111;&#x6d;" data-bare-link="true">&#x73;&#117;&#x6e;&#x61;&#x6b;&#117;&#64;&#103;&#109;&#97;&#x69;&#108;&#46;&#x63;&#111;&#x6d;</a></p>
+<p>Copyright 2008 Suraj N. Kurapati <a href="&#109;&#x61;&#x69;&#x6c;&#116;&#x6f;&#x3a;&#x73;&#117;&#x6e;&#97;&#107;&#117;&#x40;&#x67;&#x6d;&#97;&#105;&#108;&#46;&#99;&#x6f;&#109;" data-bare-link="true">&#x73;&#117;&#x6e;&#x61;&#x6b;&#x75;&#64;&#103;&#x6d;&#x61;&#x69;&#x6c;&#x2e;&#99;&#111;&#109;</a></p>
 
 <p>Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above
@@ -1101,18 +1157,18 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</p>
 
 <h2 id="SEE-ALSO">SEE ALSO</h2>
 
-<p>rake(1),
-rsync(1),
+<p><span class="man-ref">rake<span class="s">(1)</span></span>,
+<span class="man-ref">rsync<span class="s">(1)</span></span>,
 <a href="http://github.com/rtomayko/ronn">Ronn</a>,
 <a href="http://snk.tuxfamily.org/lib/ember/">Ember</a></p>
 
 
-<ol class='foot man'>
-  <li class='tl'></li>
-  <li class='tc'>April 2010</li>
-  <li class='tr'>inochi(1)</li>
-</ol>
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'></li>
+    <li class='tc'>July 2010</li>
+    <li class='tr'>inochi(1)</li>
+  </ol>
 
-</div>
+  </div>
 </body>
 </html>

metadata

@@ -3,10 +3,10 @@ name: inochi
 version: !ruby/object:Gem::Version 
   prerelease: false
   segments: 
-  - 3
+  - 4
   - 0
   - 0
-  version: 3.0.0
+  version: 4.0.0
 platform: ruby
 authors: 
 - Suraj N. Kurapati
@@ -14,32 +14,34 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-27 00:00:00 -07:00
+date: 2010-07-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: dfect
+  name: detest
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
         segments: 
-        - 1
+        - 3
         - 1
         - 0
-        version: 1.1.0
+        version: 3.1.0
     - - <
       - !ruby/object:Gem::Version 
         segments: 
-        - 2
-        version: "2"
+        - 4
+        version: "4"
   type: :development
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: ember
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -59,6 +61,7 @@ dependencies:
   name: highline
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -77,18 +80,25 @@ dependencies:
   name: mechanize
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
         segments: 
         - 1
         version: "1"
+    - - <
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        version: "2"
   type: :runtime
   version_requirements: *id004
 - !ruby/object:Gem::Dependency 
   name: nokogiri
   prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -107,6 +117,7 @@ dependencies:
   name: rake
   prerelease: false
   requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
@@ -126,13 +137,15 @@ dependencies:
   name: ronn
   prerelease: false
   requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
         segments: 
         - 0
-        - 5
-        version: "0.5"
+        - 7
+        - 0
+        version: 0.7.0
     - - <
       - !ruby/object:Gem::Version 
         segments: 
@@ -144,12 +157,20 @@ dependencies:
   name: yard
   prerelease: false
   requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
         segments: 
         - 0
-        version: "0"
+        - 5
+        - 8
+        version: 0.5.8
+    - - <
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        version: "1"
   type: :runtime
   version_requirements: *id008
 description: Inochi is an infrastructure for Ruby projects that helps you test, document, package, publish, and announce your projects. It encourages great documentation and reduces project administrivia.
@@ -168,7 +189,6 @@ files:
 - lib/inochi/generate.rb
 - lib/inochi/templates/test_helper.rb.rbs
 - lib/inochi/templates/CREDITS.rbs
-- lib/inochi/templates/FURTHER.rbs
 - lib/inochi/templates/inochi.rb.rbs
 - lib/inochi/templates/test_runner.rbs
 - lib/inochi/templates/LICENSE.rbs
@@ -180,6 +200,7 @@ files:
 - lib/inochi/templates/HISTORY.rbs
 - lib/inochi/templates/EXAMPLES.rbs
 - lib/inochi/templates/library_test.rb.rbs
+- lib/inochi/templates/BEYOND.rbs
 - lib/inochi/templates/MANUAL.rbs
 - lib/inochi/templates/inochi.opts.rbs
 - lib/inochi/tasks/2-api.rake
@@ -204,6 +225,7 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
@@ -211,6 +233,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
@@ -220,7 +243,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Gives life to Ruby projects