inochi 5.0.1 → 5.0.2

data/CREDITS

@@ -6,6 +6,7 @@ Suraj N. Kurapati
 
 Florian Gilcher,
 Peileppe Production
+Rainer Müller
 
 %< 'logo/README'
 

data/lib/inochi/inochi.rb

@@ -18,12 +18,12 @@ module Inochi
   ##
   # Number of this release of this project.
   #
-  VERSION = '5.0.1'
+  VERSION = '5.0.2'
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = '2010-08-09'
+  RELDATE = '2010-08-10'
 
   ##
   # Description of this release of this project.

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

@@ -3,6 +3,7 @@
 
 @man_html_dst = 'man.html'
 @man_roff_dst = "man/man1/#{@project_package_name}.1"
+@man_docbook_dst = @man_roff_dst + '.xml'
 
 desc 'Build the help manual.'
 task :man => [@man_html_dst, @man_roff_dst]
@@ -37,26 +38,37 @@ CLEAN.include @man_asciidoc_dst
 
 #-----------------------------------------------------------------------------
 
-build_asciidoc_args = lambda do
-  [('-v' if Rake.application.options.trace), @man_asciidoc_dst].compact
-end
+build_asciidoc_args = proc do |*atts|
+  atts.concat Array(@project_config[:man_asciidoc_attributes])
+  args = atts.map {|a| ['-a', a] }.flatten
 
-file @man_html_dst => @man_asciidoc_dst do
-  atts = %W[data-uri toc stylesheet=#{__FILE__}.css] +
-    Array(@project_config[:man_asciidoc_attributes])
+  args.push '-v' if Rake.application.options.trace
+  args.push @man_asciidoc_dst
 
-  opts = atts.map {|a| ['-a', a] }.flatten
-  args = opts + build_asciidoc_args.call
+  args
+end
 
+file @man_html_dst => @man_asciidoc_dst do
+  args = build_asciidoc_args.call(
+    'data-uri', 'toc', 'stylesheet=' + __FILE__.ext('css')
+  )
   sh 'asciidoc', '-o', @man_html_dst, *args
 end
 
 CLOBBER.include @man_html_dst
 
-file @man_roff_dst => @man_asciidoc_dst do
+file @man_docbook_dst => @man_asciidoc_dst do
   args = build_asciidoc_args.call
-  mkdir_p dir = File.dirname(@man_roff_dst)
-  sh 'a2x', '-f', 'manpage', '-D', dir, *args
+  mkdir_p File.dirname(@man_docbook_dst)
+  sh 'asciidoc', '-o', @man_docbook_dst, '-d', 'manpage', '-b', 'docbook', *args
+end
+
+CLOBBER.include @man_docbook_dst
+
+file @man_roff_dst => @man_docbook_dst do
+  sh 'xsltproc', '-o', @man_roff_dst, '--nonet',
+    'http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl',
+    @man_docbook_dst
 end
 
 CLOBBER.include @man_roff_dst

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

@@ -213,9 +213,9 @@ def convert_html_to_text html
   begin
     File.write tmp_file, html.to_s.
     #
-    # add space between subsections and list items to improve readability
+    # add space between list items to improve readability
     #
-    gsub(/(?=<div class="title">|<li>)/, '<p>&nbsp;</p>')
+    gsub(/(?=<li>)/, '<p>&nbsp;</p>')
 
     `lynx -dump #{tmp_file} -width 70`
   ensure

data/lib/inochi/templates/BEYOND.rbs

@@ -1,6 +1,6 @@
 == SEE ALSO
 
-// TODO: list related UNIX man pages and links here
+// TODO: list related UNIX man pages here
 
 some_command(1), another_command(5), yet_another_command(7)
 
@@ -8,11 +8,8 @@ some_command(1), another_command(5), yet_another_command(7)
 === References
 
 [horizontal]
-
-// NOTE: keep these sorted alphabetically
-
-[[Inochi]] Inochi:: <%= Inochi::WEBSITE %>
-[[RubyGems]] RubyGems:: http://rubygems.org
-[[Ruby]] Ruby:: http://ruby-lang.org
+[[[Inochi]]]:: <%= Inochi::WEBSITE %>
+[[[RubyGems]]]:: http://rubygems.org
+[[[Ruby]]]:: http://ruby-lang.org
 
 // TODO: list additional links here

data/man/man1/inochi.1

@@ -2,12 +2,12 @@
 .\"     Title: inochi
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 08/09/2010
+.\"      Date: 08/10/2010
 .\"    Manual: \ \&
-.\"    Source: \ \& 5.0.1
+.\"    Source: \ \& 5.0.2
 .\"  Language: English
 .\"
-.TH "INOCHI" "1" "08/09/2010" "\ \& 5\&.0\&.1" "\ \&"
+.TH "INOCHI" "1" "08/10/2010" "\ \& 5\&.0\&.2" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -106,31 +106,31 @@ Stores project information in a single Ruby source file\&.
 Project website
 .RS 4
 
-http://snk\&.tuxfamily\&.org/lib/inochi/
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/\fR\m[]
 .RE
 .PP
 Announcements feed
 .RS 4
 
-http://snk\&.tuxfamily\&.org/lib/inochi/ann\&.xml
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/ann\&.xml\fR\m[]
 .RE
 .PP
 API documentation
 .RS 4
 
-http://snk\&.tuxfamily\&.org/lib/inochi/api/
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/api/\fR\m[]
 .RE
 .PP
 Source code (browse online, download, or checkout)
 .RS 4
 
-http://github\&.com/sunaku/inochi
+\m[blue]\fBhttp://github\&.com/sunaku/inochi\fR\m[]
 .RE
 .PP
 Issue tracker (report bugs, request features, get help)
 .RS 4
 
-http://github\&.com/sunaku/inochi/issues
+\m[blue]\fBhttp://github\&.com/sunaku/inochi/issues\fR\m[]
 .RE
 .SH "INSTALL"
 .SS "Prerequisites"
@@ -811,7 +811,7 @@ A project\(cqs configuration file is a [YAML] document named inochi\&.conf that
 :man_asciidoc_attributes
 .RS 4
 Attributes to pass to AsciiDoc when rendering the HTML manual page\&. See
-"Backend Attributes" in the AsciiDoc manual
+\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
@@ -1051,7 +1051,7 @@ irb \-r inochi
 .RE
 .\}
 .sp
-Or by running Ruby through the ruby\-wrapper tool\&.
+Or by running Ruby through the \m[blue]\fBruby\-wrapper\fR\m[]\&\s-2\u[2]\d\s+2 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\&.
@@ -1099,9 +1099,68 @@ 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/helper\&.rb file\&.
 .SS "Contributing"
 .sp
-Fork this project on GitHub and send a pull request\&.
+\m[blue]\fBFork this project on GitHub\fR\m[] and send a pull request\&.
 .SH "HISTORY"
+.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
@@ -1291,7 +1350,7 @@ This release fixes a bug in gem version dependency establishment\&.
 .\}
 Gem version dependencies were not being established in Ruby 1\&.8\&.7 and 1\&.9\&.2 because
 Kernel#gem
-is a private method
+\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\&.
@@ -1859,8 +1918,8 @@ Add instructions for building gems without Inochi as a runtime dependency\&.
 .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
+\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
@@ -2053,9 +2112,9 @@ ERBook 7\&.1\&.0 is now used for generating the user manual\&. This is a major s
 .IP \(bu 2.3
 .\}
 
-SDoc
+\m[blue]\fBSDoc\fR\m[]\&\s-2\u[7]\d\s+2
 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!
+\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
@@ -2134,7 +2193,7 @@ option\&.
 .IP \(bu 2.3
 .\}
 Add "lint" rake task which reports
-code quality statistics\&.
+\m[blue]\fBcode quality statistics\fR\m[]\&\s-2\u[9]\d\s+2\&.
 .RE
 .sp
 .RS 4
@@ -2157,7 +2216,7 @@ Add "test:cov" rake task which reports code coverage statistics\&.
 .IP \(bu 2.3
 .\}
 Add "test:ruby" task which runs all tests with
-multiruby\&.
+\m[blue]\fBmultiruby\fR\m[]\&\s-2\u[10]\d\s+2\&.
 .RE
 .sp
 .RS 4
@@ -2461,7 +2520,7 @@ This release adds support for unit testing, improves the portability of Inochi a
 .IP \(bu 2.3
 .\}
 Added support for unit testing via the
-minitest
+\m[blue]\fBminitest\fR\m[]\&\s-2\u[11]\d\s+2
 library\&.
 .RE
 .sp
@@ -2581,7 +2640,7 @@ 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\&.
+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
@@ -2649,7 +2708,7 @@ This release fixes some show\-stopper bugs\&.
 .IP \(bu 2.3
 .\}
 The name of the project library was
-being determined incorrectly\&. (thanks to Florian Gilcher)
+\m[blue]\fBbeing determined incorrectly\fR\m[]\&\s-2\u[13]\d\s+2\&. (thanks to Florian Gilcher)
 .RE
 .sp
 .RS 4
@@ -2661,7 +2720,7 @@ being determined incorrectly\&. (thanks to Florian Gilcher)
 .IP \(bu 2.3
 .\}
 There was a
-circular dependency problem
+\m[blue]\fBcircular dependency problem\fR\m[]\&\s-2\u[12]\d\s+2
 when installing the
 Inochi
 gem\&. (thanks to Florian Gilcher)
@@ -2704,7 +2763,7 @@ This is the first release of Inochi\&. Enjoy!
 Suraj N\&. Kurapati
 .SS "Credits"
 .sp
-Florian Gilcher, Peileppe Production
+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
@@ -2717,7 +2776,7 @@ The "inochi\&.png" image and its "inochi\&.svg" source utilize the "3 flowers" g
 .IP "  1." 4.2
 .\}
 
-http://www\&.openclipart\&.org/detail/17456
+\m[blue]\fBhttp://www\&.openclipart\&.org/detail/17456\fR\m[]
 .RE
 .sp
 .RS 4
@@ -2729,20 +2788,20 @@ http://www\&.openclipart\&.org/detail/17456
 .IP "  2." 4.2
 .\}
 
-http://www\&.openclipart\&.org/user\-detail/Peileppe
+\m[blue]\fBhttp://www\&.openclipart\&.org/user\-detail/Peileppe\fR\m[]
 .RE
 .SS "License"
 .sp
 (the ISC license)
 .sp
-Copyright 2008 Suraj N\&. Kurapati <sunaku@gmail\&.com>
+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
-rake(1), rsync(1), asciidoc(1), a2x(1), [Ember]
+rsync(1), asciidoc(1), xsltproc(1), lynx(1)
 .SS "References"
 .TS
 tab(:);
@@ -2765,122 +2824,193 @@ lt lt
 lt lt.
 T{
 .sp
-AsciiDoc
+[AsciiDoc]
 T}:T{
 .sp
-http://www\&.methods\&.co\&.nz/asciidoc/
+\m[blue]\fBhttp://www\&.methods\&.co\&.nz/asciidoc/\fR\m[]
 T}
 T{
 .sp
-Ember
+[Ember]
 T}:T{
 .sp
-http://snk\&.tuxfamily\&.org/lib/ember/
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/ember/\fR\m[]
 T}
 T{
 .sp
-ERBook
+[ERBook]
 T}:T{
 .sp
-http://snk\&.tuxfamily\&.org/lib/erbook/
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/erbook/\fR\m[]
 T}
 T{
 .sp
-eRuby
+[eRuby]
 T}:T{
 .sp
-http://en\&.wikipedia\&.org/wiki/ERuby
+\m[blue]\fBhttp://en\&.wikipedia\&.org/wiki/ERuby\fR\m[]
 T}
 T{
 .sp
-Inochi
+[Inochi]
 T}:T{
 .sp
-http://snk\&.tuxfamily\&.org/lib/inochi/
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/\fR\m[]
 T}
 T{
 .sp
-kdiff3
+[kdiff3]
 T}:T{
 .sp
-http://kdiff3\&.sourceforge\&.net
+\m[blue]\fBhttp://kdiff3\&.sourceforge\&.net\fR\m[]
 T}
 T{
 .sp
-Lynx
+[Lynx]
 T}:T{
 .sp
-http://lynx\&.isc\&.org
+\m[blue]\fBhttp://lynx\&.isc\&.org\fR\m[]
 T}
 T{
 .sp
-Markdown
+[Markdown]
 T}:T{
 .sp
-http://daringfireball\&.net/projects/markdown
+\m[blue]\fBhttp://daringfireball\&.net/projects/markdown\fR\m[]
 T}
 T{
 .sp
-meld
+[meld]
 T}:T{
 .sp
-http://meld\&.sourceforge\&.net
+\m[blue]\fBhttp://meld\&.sourceforge\&.net\fR\m[]
 T}
 T{
 .sp
-RAA
+[RAA]
 T}:T{
 .sp
-http://raa\&.ruby\-lang\&.org
+\m[blue]\fBhttp://raa\&.ruby\-lang\&.org\fR\m[]
 T}
 T{
 .sp
-Ronn
+[Ronn]
 T}:T{
 .sp
-http://github\&.com/rtomayko/ronn
+\m[blue]\fBhttp://github\&.com/rtomayko/ronn\fR\m[]
 T}
 T{
 .sp
-RubyGems
+[RubyGems]
 T}:T{
 .sp
-http://rubygems\&.org
+\m[blue]\fBhttp://rubygems\&.org\fR\m[]
 T}
 T{
 .sp
-Ruby
+[Ruby]
 T}:T{
 .sp
-http://ruby\-lang\&.org
+\m[blue]\fBhttp://ruby\-lang\&.org\fR\m[]
 T}
 T{
 .sp
-ruby\-talk
+[ruby\-talk]
 T}:T{
 .sp
-http://www\&.ruby\-lang\&.org/en/community/mailing\-lists/
+\m[blue]\fBhttp://www\&.ruby\-lang\&.org/en/community/mailing\-lists/\fR\m[]
 T}
 T{
 .sp
-tkdiff
+[tkdiff]
 T}:T{
 .sp
-http://tkdiff\&.sourceforge\&.net
+\m[blue]\fBhttp://tkdiff\&.sourceforge\&.net\fR\m[]
 T}
 T{
 .sp
-YAML
+[YAML]
 T}:T{
 .sp
-http://www\&.yaml\&.org/YAML_for_ruby\&.html
+\m[blue]\fBhttp://www\&.yaml\&.org/YAML_for_ruby\&.html\fR\m[]
 T}
 T{
 .sp
-YARD
+[YARD]
 T}:T{
 .sp
-http://yardoc\&.org/more
+\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
+ruby-wrapper
+.RS 4
+\%http://github.com/chneukirchen/rup/blob/master/ruby-wrapper
+.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

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 5
   - 0
-  - 1
-  version: 5.0.1
+  - 2
+  version: 5.0.2
 platform: ruby
 authors: 
 - Suraj N. Kurapati
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-09 00:00:00 -07:00
+date: 2010-08-10 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -184,11 +184,11 @@ files:
 - lib/inochi/templates/library_test.rb.rbs
 - lib/inochi/templates/BEYOND.rbs
 - lib/inochi/templates/MANUAL.rbs
+- lib/inochi/tasks/2-man.css
 - lib/inochi/tasks/1-api.rake
 - lib/inochi/tasks/5-pub.rake
 - lib/inochi/tasks/3-ann.rake
 - lib/inochi/tasks/2-man.rake
-- lib/inochi/tasks/2-man.rake.css
 - lib/inochi/tasks/4-gem.rake
 - LICENSE
 - CREDITS