binman 3.0.1 → 3.1.0

data/HISTORY.markdown

@@ -1,6 +1,20 @@
-------------------------------------------------------------------------------
-Version 3.0.1 (2012-02-02)
-------------------------------------------------------------------------------
+## Version 3.1.0 (2012-02-06)
+
+Minor:
+
+  * Added `binman help` command for use by non-Ruby bin scripts.  See README
+    for usage examples from Perl, Python, Node.js, Tcl, AWK, and UNIX shell!
+
+Patch:
+
+  * Replace `gem install binman --development` tip in `BinMan::conv()` with
+    `gem install md2man` tip because the former just hangs in RubyGems 1.8.
+
+Other:
+
+  * Shorten markdown headings; improve documentation; clean up.
+
+## Version 3.0.1 (2012-02-02)
 
 Patch:
 
@@ -18,9 +32,7 @@ Other:
 
   * bundler suggests moving all dev deps into gemspec.
 
-------------------------------------------------------------------------------
-Version 3.0.0 (2012-01-09)
-------------------------------------------------------------------------------
+## Version 3.0.0 (2012-01-09)
 
 Major:
 
@@ -35,9 +47,7 @@ Minor:
 
 [1]: https://github.com/sunaku/md2man/commit/75d7a0064fa86f1c98dd01391ad82245fd387c20
 
-------------------------------------------------------------------------------
-Version 2.0.0 (2011-12-06)
-------------------------------------------------------------------------------
+## Version 2.0.0 (2011-12-06)
 
 Major:
 
@@ -54,9 +64,7 @@ Other:
 
   * Do not hard-code the version number in `binman/gemspec` helper.
 
-------------------------------------------------------------------------------
-Version 1.1.0 (2011-11-05)
-------------------------------------------------------------------------------
+## Version 1.1.0 (2011-11-05)
 
 Alert:
 
@@ -70,9 +78,7 @@ Minor:
     builds and includes your UNIX man page files in your gem packages and also
     adds binman as a runtime and development gem dependency.
 
-------------------------------------------------------------------------------
-Version 1.0.0 (2011-10-13)
-------------------------------------------------------------------------------
+## Version 1.0.0 (2011-10-13)
 
 Major:
 
@@ -98,9 +104,7 @@ Other:
 
   * README: explain dev deps and `man/` dir packaging.
 
-------------------------------------------------------------------------------
-Version 0.1.2 (2011-10-13)
-------------------------------------------------------------------------------
+## Version 0.1.2 (2011-10-13)
 
 Minor:
 
@@ -115,9 +119,7 @@ Other:
 [Redcarpet2]: https://github.com/tanoku/redcarpet
 [redcarpet-manpage]: http://rdoc.info/github/sunaku/redcarpet-manpage
 
-------------------------------------------------------------------------------
-Version 0.1.1 (2011-10-13)
-------------------------------------------------------------------------------
+## Version 0.1.1 (2011-10-13)
 
 Minor:
 
@@ -140,8 +142,6 @@ Other:
 
   * README: add obligatory screenshot! >:-)
 
-------------------------------------------------------------------------------
-Version 0.0.1 (2011-10-12)
-------------------------------------------------------------------------------
+## Version 0.0.1 (2011-10-12)
 
 First release!  Happy birthday!  Woohoo!  :-)

data/README.markdown

@@ -1,45 +1,39 @@
-binman - UNIX man pages for Ruby bin/ scripts
-==============================================================================
+# binman - man pages for bin scripts
 
-[binman] produces UNIX man pages for your Ruby `bin/` scripts using
-markdown(7), roff(7), [md2man] for conversion thereof, and man(1).
+[binman] produces UNIX manual pages for executable scripts using [md2man].
 
-![Obligatory Screen-shot of binman(1) in action!](http://ompldr.org/vYm5mcg)
+## Features
 
-Here is [an example bin/ script][binman-bin] to help you get started!
+  * Supports any scripting language that has multi-line
+    comments or uses `#` for single-line comments: Ruby,
+    Perl, Python, Node.js, Tcl, AWK, UNIX shell, and more!
 
-[binman]: https://github.com/sunaku/binman
-[binman-api]: http://rdoc.info/github/sunaku/binman
-[binman-bin]: https://raw.github.com/sunaku/binman/master/bin/binman
-[md2man]: https://github.com/sunaku/md2man
-
-------------------------------------------------------------------------------
-Features
-------------------------------------------------------------------------------
+  * Provides a Ruby library and a command-line client too.
 
-* Includes both a Ruby library and a command-line client.
+  * Individual extraction, conversion, and display commands.
 
-* Individual extraction, conversion, and display commands.
+  * Implemented in roughly 100 lines of pure Ruby code! :-)
 
-* Implemented in roughly 100 lines of pure Ruby code! :-)
+### Demonstration
 
-------------------------------------------------------------------------------
-Prerequisites
-------------------------------------------------------------------------------
+![Obligatory screen-shot of binman(1) in action!](http://ompldr.org/vYm5mcg)
 
-* Ruby 1.9.2 or newer.  It might work with 1.8.7 but I haven't tried. :-P
+Here is [a complete example in Ruby][binman-bin] to help you get started.
+For examples in other scripting languages, see the "Usage" section below!
 
-------------------------------------------------------------------------------
-Installation
-------------------------------------------------------------------------------
+## Installation
 
-As a Ruby gem (without markdown to roff converter):
+If you only want to view pre-built manual pages:
 
     gem install binman
 
-As a Ruby gem (with extra cheese and everything please):
+If you also want to build your own manual pages:
 
-    gem install binman --development
+    gem install md2man -v '~> 1'
+
+### Prerequisites
+
+  * Ruby 1.8.7 or 1.9.2 or newer.
 
 ### Development
 
@@ -49,51 +43,199 @@ As a Ruby gem (with extra cheese and everything please):
     bundle_bin/binman --help  # run it directly
     bundle exec rake -T       # packaging tasks
 
-------------------------------------------------------------------------------
-Usage
-------------------------------------------------------------------------------
+## Usage
 
 ### At the command line
 
     binman --help
 
-### In your bin/ scripts
+### Inside a Ruby script
 
-Add the following lines to your bin/ script and you've got `--help` options!
+    #!/usr/bin/env ruby
+    # your program's manual page goes here
 
     require 'binman'
-    BinMan.help # show man page and exit if ARGV has -h or --help
 
-Or, if you're on a diet:
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    BinMan.help
 
-    require 'binman'
-    BinMan.show # just show the man page; no fancy extras, please!
+    # OPTION 2: show manual unconditionally
+    BinMan.show
+
+You can also specify your program's source file encoding above the manual:
+
+    #!/usr/bin/env ruby
+    # -*- coding: utf-8 -*-
+    # your program's manual page goes here
+
+You can also write the manual as a multi-line Ruby comment:
+
+    #!/usr/bin/env ruby
+    =begin
+    your program's manual page goes here
+    =end
+
+You can also specify your program's source file encoding above the manual:
+
+    #!/usr/bin/env ruby
+    # -*- coding: utf-8 -*-
+    =begin
+    your program's manual page goes here
+    =end
+
+See the [API documentation][binman-api] for even more possibilities!
+
+### Inside a shell script
+
+    #!/usr/bin/sh
+    # your program's manual page goes here
+
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    binman help "$0" "$@" && exit
+
+    # OPTION 2: show manual unconditionally
+    binman show "$0"
+
+### Inside a Perl script
+
+    #!/usr/bin/env perl
+    # your program's manual page goes here
+
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    system('binman', 'help', __FILE__, @ARGV) == 0 and exit;
+
+    # OPTION 2: show manual unconditionally
+    system('binman', 'show', __FILE__);
+
+You can also write the manual as a multi-line Ruby comment after `__END__`:
+
+    #!/usr/bin/env perl
+    print "your program's code goes here";
+    __END__
+    =begin
+    your program's manual page goes here
+    =end
+
+### Inside a Python script
+
+    #!/usr/bin/env python
+    # your program's manual page goes here
+
+    import sys, subprocess
+
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    subprocess.call(['binman', 'help', __file__] + sys.argv) == 0 and sys.exit()
 
-See the [API documentation][binman-api] for more delicious recipes.
+    # OPTION 2: show manual unconditionally
+    subprocess.call(['binman', 'show', __file__])
+
+You can also specify your program's source file encoding above the manual:
+
+    #!/usr/bin/env python
+    # -*- coding: utf-8 -*-
+    # your program's manual page goes here
+
+You can also write the manual as a multi-line Ruby comment inside a docstring:
+
+    #!/usr/bin/env python
+    """
+    =begin
+    your program's manual page goes here
+    =end
+    """
+
+You can also specify your program's source file encoding above the manual:
+
+    #!/usr/bin/env python
+    # -*- coding: utf-8 -*-
+    """
+    =begin
+    your program's manual page goes here
+    =end
+    """
+
+### Inside an AWK script
+
+The technique for determining current AWK script file name [comes from here](
+http://www.mombu.com/programming/programming/t-the-name-of-script-itself-2040784-print.html
+).
+
+    #!/usr/bin/awk -f
+    # your program's manual page goes here
+
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    BEGIN {getline c <"/proc/self/cmdline"; sub(".*-f\0"," ",c); gsub("\0"," ",c);
+           if(system("binman help" c) == 0){ exit }}
+
+    # OPTION 2: show manual unconditionally
+    BEGIN {getline c <"/proc/self/cmdline"; sub(".*-f\0"," ",c); sub("\0.*","",c);
+           system("binman show" c)}
+
+### Inside a Tcl script
+
+    #!/usr/bin/env tclsh
+    # your program's manual page goes here
+
+    # OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    if {![catch {exec -- >/dev/tty binman help $argv0 {*}$argv}]} {exit}
+
+    # OPTION 2: show manual unconditionally
+    exec >/dev/tty binman show $argv0
+
+You can also write the manual as a multi-line Ruby comment inside an `if 0`:
+
+    #!/usr/bin/env tclsh
+    if 0 {
+    =begin
+    your program's manual page goes here
+    =end
+    }
+
+### Inside a Node.js script
+
+    /*
+    =begin
+    your program's manual page goes here
+    =end
+    */
+
+    var exec = require('child_process').exec;
+
+    // OPTION 1: show manual and exit if ARGV has -h or --help except after --
+    exec(['>/dev/tty', 'binman', 'help', __filename].concat(process.argv).
+    join(' '), function(error){ if (error === null){ process.exit(); } });
+
+    // OPTION 2: show manual unconditionally
+    exec(['>/dev/tty', 'binman', 'show', __filename].join(' '));
+
+## Packaging
 
 ### Pre-building man pages
 
 Add the following lines to your gemspec:
 
-    s.files += Dir["man/**/*"]
+    s.files += Dir['man/**/*']
     s.add_development_dependency 'md2man', '~> 1'
 
 Add the following line to your Rakefile:
 
     require 'binman/rakefile'
 
-You now have a `rake binman` task that pre-builds UNIX man page files for your
-`bin/` scripts into a `man/` directory so that your end-users do not need
-[md2man] installed in order to view the man pages you've embedded therein!
+You now have a `rake binman` task that pre-builds UNIX manual page files for
+your `bin/` scripts into a `man/` directory so that your end-users do not need
+[md2man] installed in order to view the manual pages you've embedded therein!
 
 If you're using Bundler, this task also hooks into its gem packaging tasks and
-ensures that your UNIX man page files are pre-built and included in your gem:
+ensures that your UNIX manual pages are pre-built and packaged into your gem:
 
     bundle exec rake build
     gem spec pkg/*.gem | fgrep man/man
 
-------------------------------------------------------------------------------
-License
-------------------------------------------------------------------------------
+## License
 
 Released under the ISC license.  See the LICENSE file for details.
+
+[binman]: https://github.com/sunaku/binman
+[binman-api]: http://rubydoc.info/gems/binman/frames
+[binman-bin]: https://raw.github.com/sunaku/binman/master/bin/binman
+[md2man]: https://github.com/sunaku/md2man

data/bin/binman

@@ -1,44 +1,43 @@
 #!/usr/bin/env ruby
-# encoding: utf-8
-=begin
+=begin =======================================================================
 
-BINMAN 1 "2012-02-02" "3.0.1"
-=============================
+# BINMAN 1 2012-02-06 3.1.0
 
-NAME
-----
+## NAME
 
-binman - UNIX man pages for Ruby `bin/` scripts
+binman - man pages for bin scripts
 
-SYNOPSIS
---------
+## SYNOPSIS
 
 `binman` [*OPTION*]... *COMMAND*
 
-DESCRIPTION
------------
+## DESCRIPTION
 
-[binman] produces UNIX man pages for your Ruby `bin/` scripts.  It can extract
-their leading comment headers (defined below), convert them from markdown(7)
-into roff(7) using [md2man], and display them using man(1).
+[binman] produces UNIX manual pages for your executable scripts. It can
+extract their leading comment headers (defined below), convert them from
+markdown(7) into roff(7) using [md2man], and display them using man(1).
 
-### Leading Comment Headers
+### Leading comment headers
 
 A leading comment header can be one of the following two things:
 
-1. A contiguous sequence of single-line comments starting at the
-   beginning of the file (after shebang and encoding comments plus
-   optional blank lines) and ending at the first single blank line.
+1.  A contiguous sequence of single-line comments (which begin with `#`
+    and optionally continue with a single space followed by any number of
+    characters until the end of the line) starting at the beginning of the
+    file (after shebang and encoding comments plus optional blank lines) and
+    ending at the first single blank line.
 
-2. First embedded document delimited by `=begin` and `=end` lines.
+2.  The first embedded document delimited by `=begin` and `=end` lines, which
+    begin with the respective delimiters and optionally continue with a single
+    space followed by any number of characters until the end of the line.
 
-### Markdown Processing Divergence
+### Markdown processing divergence
 
 Although your leading comment headers are written in markdown(7), `binman
-conv` introduces the following additions to markdown(7) syntax via [md2man]:
+conv` inherits the following additions to markdown(7) syntax from [md2man]:
 
   * There can be at most one top-level heading (H1).  It is emitted as `.TH`
-    in the roff(7) output, specifying the UNIX man page's header and footer.
+    in the roff(7) output to define the UNIX manual page's header and footer.
 
   * Paragraphs whose lines are all uniformly indented by two spaces are
     considered to be "indented paragraphs".  They are unindented accordingly
@@ -48,25 +47,29 @@ conv` introduces the following additions to markdown(7) syntax via [md2man]:
     indented by two spaces are considered to be a "tagged paragraphs".  They
     are unindented accordingly before emission as `.TP` in the roff(7) output.
 
-### Markdown Processing Extensions
+### Markdown processing extensions
 
-The following [Redcarpet2] extensions for markdown(7) are enabled:
+The following [Redcarpet] extensions are enabled while processing markdown(7):
 
-* tables
-* autolink
-* superscript
-* strikethrough
-* no_intra_emphasis
-* fenced_code_blocks
+  * tables
+  * autolink
+  * superscript
+  * strikethrough
+  * no_intra_emphasis
+  * fenced_code_blocks
 
-OPTIONS
--------
+## OPTIONS
 
 `-h`, `--help`
-  Display this help manual using man(1).
+  Show this help manual.
 
-COMMANDS
---------
+## COMMANDS
+
+`help` *FILE* [*ARGUMENT*]...
+  If the given *ARGUMENT* sequence contains `-h` or `--help` except after
+  `--`, then this program extracts the given *FILE*'s leading comment header,
+  converts it into roff(7), and displays it using man(1) before exiting with
+  status code `0`.  Otherwise, this program exits with status code `111`.
 
 `show` [*FILE*]
   Use man(1) to display the roff(7) conversion of the leading comment header
@@ -83,29 +86,33 @@ COMMANDS
   Print the roff(7) conversion of the markdown(7) document read from the given
   *FILE* or STDIN.
 
-SEE ALSO
---------
+## SEE ALSO
 
 man(1), roff(7), markdown(7)
 
 [binman]: https://github.com/sunaku/binman
 [md2man]: https://github.com/sunaku/md2man
-[Redcarpet2]: https://github.com/tanoku/redcarpet
+[Redcarpet]: https://github.com/tanoku/redcarpet
 
 =end =========================================================================
 
 require 'binman'
-BinMan.help
 
 command, source = ARGV
-source ||= STDIN
 
-case command
-when 'show'
-  BinMan.show source
-when 'load', 'dump', 'conv'
-  puts BinMan.send(command, source)
+if command == 'help'
+  BinMan.help source, ARGV[2..-1]
+  exit 111
 else
-  warn 'binman: bad command; try --help'
-  exit!
+  BinMan.help
+  source ||= STDIN
+  case command
+  when 'show'
+    BinMan.send(command, source)
+  when 'load', 'dump', 'conv'
+    puts BinMan.send(command, source)
+  else
+    warn 'binman: invalid command; try --help'
+    exit 1
+  end
 end

data/binman.gemspec

@@ -1,21 +1,21 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "binman/version"
+$:.push File.expand_path('../lib', __FILE__)
+require 'binman/version'
 
 Gem::Specification.new do |s|
-  s.name          = "binman"
+  s.name          = 'binman'
   s.version       = BinMan::VERSION
   s.authors,
   s.email         = File.read('LICENSE').scan(/Copyright \d+ (.+) <(.+?)>/).transpose
-  s.homepage      = "http://github.com/sunaku/binman"
-  s.summary       = "UNIX man pages for Ruby bin/ scripts"
-  s.description   = nil
+  s.homepage      = 'http://github.com/sunaku/binman'
+  s.summary       = 'man pages for bin scripts'
+  s.description   = 'Produces UNIX manual pages for executable scripts.'
 
-  s.files         = `git ls-files`.split("\n") + Dir["man/**/*"]
+  s.files         = `git ls-files`.split("\n") + Dir['man/**/*']
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
+  s.require_paths = ['lib']
 
-  s.add_development_dependency "md2man", "~> 1"
-  s.add_development_dependency "rake", ">= 0.9.2.2", "< 1"
+  s.add_development_dependency 'md2man', '~> 1'
+  s.add_development_dependency 'rake', '>= 0.9.2.2', '< 1'
 end

data/lib/binman.rb

@@ -34,7 +34,7 @@ module BinMan
     require 'md2man'
     Md2Man::ENGINE.render(read(source))
   rescue LoadError
-    raise 'Run `gem install binman --development` to use BinMan::conv().'
+    raise 'Run `gem install md2man -v "~>1"` to use BinMan::conv().'
   end
 
   # Extracts leading comment header content from given

data/lib/binman/rakefile.rb

@@ -4,7 +4,7 @@ directory path = 'man/man1'
 bins = FileList['bin/*']
 mans = bins.pathmap("#{path}/%n.1")
 
-desc 'Build UNIX man pages for bin/ scripts.'
+desc 'Build UNIX manual pages for bin/ scripts.'
 task :binman => mans
 
 bins.zip(mans).each do |bin, man|

data/lib/binman/version.rb

@@ -1,3 +1,3 @@
 module BinMan
-  VERSION = "3.0.1"
+  VERSION = "3.1.0"
 end

data/man/man1/binman.1

@@ -1,7 +1,7 @@
-.TH BINMAN 1 "2012\-02\-02" "3.0.1"
+.TH BINMAN 1 2012\-02\-06 3.1.0
 .SH NAME
 .PP
-binman \- UNIX man pages for Ruby \fB\fCbin/\fR scripts
+binman \- man pages for bin scripts
 .SH SYNOPSIS
 .PP
 \fB\fCbinman\fR [\fIOPTION\fP]... \fICOMMAND\fP
@@ -10,35 +10,39 @@ binman \- UNIX man pages for Ruby \fB\fCbin/\fR scripts
 binman
 .UR https://github.com/sunaku/binman
 .UE
-produces UNIX man pages for your Ruby \fB\fCbin/\fR scripts.  It can extract
-their leading comment headers (defined below), convert them from 
-.BR markdown (7)
+produces UNIX manual pages for your executable scripts. It can
+extract their leading comment headers (defined below), convert them from
+.BR markdown (7) 
 into 
 .BR roff (7) 
 using md2man
 .UR https://github.com/sunaku/md2man
 .UE , and display them using 
 .BR man (1).
-.SS Leading Comment Headers
+.SS Leading comment headers
 .PP
 A leading comment header can be one of the following two things:
 .nr step0 0 1
 .RS
 .IP \n+[step0]
-A contiguous sequence of single\-line comments starting at the
-beginning of the file (after shebang and encoding comments plus
-optional blank lines) and ending at the first single blank line.
+A contiguous sequence of single\-line comments (which begin with \fB\fC#\fR
+and optionally continue with a single space followed by any number of
+characters until the end of the line) starting at the beginning of the
+file (after shebang and encoding comments plus optional blank lines) and
+ending at the first single blank line.
 .IP \n+[step0]
-First embedded document delimited by \fB\fC=begin\fR and \fB\fC=end\fR lines.
+The first embedded document delimited by \fB\fC=begin\fR and \fB\fC=end\fR lines, which
+begin with the respective delimiters and optionally continue with a single
+space followed by any number of characters until the end of the line.
 .RE
-.SS Markdown Processing Divergence
+.SS Markdown processing divergence
 .PP
 Although your leading comment headers are written in 
 .BR markdown (7), 
 \fB\fCbinman
-conv\fR introduces the following additions to 
+conv\fR inherits the following additions to 
 .BR markdown (7) 
-syntax via md2man
+syntax from md2man
 .UR https://github.com/sunaku/md2man
 .UE :
 .RS
@@ -46,7 +50,7 @@ syntax via md2man
 There can be at most one top\-level heading (H1).  It is emitted as \fB\fC.TH\fR
 in the 
 .BR roff (7) 
-output, specifying the UNIX man page's header and footer.
+output to define the UNIX manual page's header and footer.
 .IP \(bu 2
 Paragraphs whose lines are all uniformly indented by two spaces are
 considered to be "indented paragraphs".  They are unindented accordingly
@@ -60,14 +64,13 @@ are unindented accordingly before emission as \fB\fC.TP\fR in the
 .BR roff (7) 
 output.
 .RE
-.SS Markdown Processing Extensions
+.SS Markdown processing extensions
 .PP
-The following Redcarpet2
+The following Redcarpet
 .UR https://github.com/tanoku/redcarpet
 .UE
-extensions for 
-.BR markdown (7) 
-are enabled:
+extensions are enabled while processing 
+.BR markdown (7):
 .RS
 .IP \(bu 2
 tables
@@ -85,10 +88,19 @@ fenced_code_blocks
 .SH OPTIONS
 .TP
 \fB\fC-h\fR, \fB\fC--help\fR
-Display this help manual using 
-.BR man (1).
+Show this help manual.
 .SH COMMANDS
 .TP
+\fB\fChelp\fR \fIFILE\fP [\fIARGUMENT\fP]...
+If the given \fIARGUMENT\fP sequence contains \fB\fC-h\fR or \fB\fC--help\fR except after
+\fB\fC--\fR, then this program extracts the given \fIFILE\fP's leading comment header,
+converts it into 
+.BR roff (7), 
+and displays it using 
+.BR man (1) 
+before exiting with
+status code \fB\fC0\fR.  Otherwise, this program exits with status code \fB\fC111\fR.
+.TP
 \fB\fCshow\fR [\fIFILE\fP]
 Use 
 .BR man (1) 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: binman
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-03 00:00:00.000000000 Z
+date: 2012-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: md2man
-  requirement: &18830780 !ruby/object:Gem::Requirement
+  requirement: &16648520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '1'
   type: :development
   prerelease: false
-  version_requirements: *18830780
+  version_requirements: *16648520
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &18829640 !ruby/object:Gem::Requirement
+  requirement: &16906320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -35,8 +35,8 @@ dependencies:
         version: '1'
   type: :development
   prerelease: false
-  version_requirements: *18829640
-description: ''
+  version_requirements: *16906320
+description: Produces UNIX manual pages for executable scripts.
 email:
 - sunaku@gmail.com
 executables:
@@ -70,7 +70,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3512884628236364112
+      hash: 1200769804944669574
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -79,11 +79,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3512884628236364112
+      hash: 1200769804944669574
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
-summary: UNIX man pages for Ruby bin/ scripts
+summary: man pages for bin scripts
 test_files: []