binman 3.3.2 → 3.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 75fcddccca1ce504dbcf6b7547527313514b5682
-  data.tar.gz: 36b5252d0c6d6692ab40c3048cf5612dbf8c2a2c
+  metadata.gz: 25bbee995392523cf64aadd135db92cd22ade470
+  data.tar.gz: 343bb4ab6fb0e9856b6a06b9d829a026287b84e8
 SHA512:
-  metadata.gz: a3cbb532462421636ccbd9b7699288c923625dea5dd1a29f8ef768f6cbff76a91abcb051b21e70e448ecf57846d64da4719a6dc7729364d292dcb2ef6bb018cf
-  data.tar.gz: 23371bae5d3d33c2c6535e85aba8acc9c29b5ba1e301396a5e5fd52e996f9b99c5f0033050a2ca657809f4c66358e32b4e50d81a9b85fc4067e35dd7bbf40184
+  metadata.gz: 4492b09a30bab9b6b608a691720b554a4c9af34bc2d77c502da19a264b3f4ff80628284417cd932c96e4f3082d5b351aeff0708add2a662c9738f1a0df3680ba
+  data.tar.gz: baf68d5e678bd5e90057976f97cdb865f67e58df4c8471161b611d2f291e9d1db389bb4745bf56cd6f3b357b0e9774eb52f7e321f9358d876a7fbf113ab25bcc

data/README.markdown

@@ -2,6 +2,11 @@
 
 [binman] produces UNIX manual pages for executable scripts using [md2man].
 
+* Package: <https://rubygems.org/gems/binman>
+* Manuals: <https://sunaku.github.io/binman>
+* Sources: <https://github.com/sunaku/binman>
+* Support: <https://github.com/sunaku/binman/issues>
+
 ## Features
 
   * Supports any scripting language that has multi-line
@@ -16,8 +21,7 @@
 
 ### Demonstration
 
-![Obligatory screen-shot of binman(1) in action!](
-https://raw.github.com/sunaku/binman/master/EXAMPLE.png)
+![Obligatory screen-shot of binman(1) in action!](EXAMPLE.png)
 
 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!
@@ -30,7 +34,7 @@ If you only want to view pre-built manual pages:
 
 If you also want to build your own manual pages:
 
-    gem install md2man -v '~> 2.0'
+    gem install md2man -v '~> 3.0'
 
 ### Prerequisites
 
@@ -227,7 +231,7 @@ Add this snippet to your gemspec file:
 
     s.files += Dir['man/man?/*.?']            # UNIX man pages
     s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
-    s.add_development_dependency 'md2man', '~> 2.0'
+    s.add_development_dependency 'md2man', '~> 3.0'
 
 Add the following line to your Rakefile:
 

data/VERSION.markdown

@@ -1,3 +1,17 @@
+## Version 3.3.3 (2014-06-22)
+
+This release upgrades to md2man 3.0 for improved HTML manuals.
+
+### Other:
+
+  * README: add links to package, manuals, and GitHub.
+
+  * GitHub now supports relative links from the README:
+
+    https://help.github.com/articles/relative-links-in-readmes
+
+  * Upgrade to md2man 3.0 for improved HTML manuals.
+
 ## Version 3.3.2 (2013-08-30)
 
 Patch:

data/bin/binman

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
 
-# BINMAN 1 2013-08-30 3.3.2
+# BINMAN 1 2014-06-22 3.3.3
 
 ## NAME
 

data/bin/binman-rake

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
 
-# BINMAN-RAKE 1 2013-08-30 3.3.2
+# BINMAN-RAKE 1 2014-06-22 3.3.3
 
 ## NAME
 

data/binman.gemspec

@@ -18,8 +18,8 @@ Gem::Specification.new do |s|
 
   s.files += Dir['man/man?/*.?']            # UNIX man pages
   s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
-  s.add_development_dependency 'md2man', '~> 2.0'
+  s.add_development_dependency 'md2man', '~> 3.0'
 
   s.add_dependency 'opener', '>= 0.1.0', '< 1'
-  s.add_development_dependency 'rake', '>= 0.9.2.2', '< 1'
+  s.add_development_dependency 'rake', '~> 10.1'
 end

data/lib/binman.rb

@@ -97,10 +97,10 @@ module BinMan
   # Requires that the correct version of Md2Man is available on this system.
   def require_md2man
     require 'rubygems' unless respond_to? :gem
-    gem 'md2man', '~> 2.0' if respond_to? :gem
+    gem 'md2man', '~> 3.0' if respond_to? :gem
     require 'md2man/version'
   rescue LoadError
-    raise 'Run `gem install md2man --version "~> 2.0"` to use BinMan::conv().'
+    raise 'Run `gem install md2man --version "~> 3.0"` to use BinMan::conv().'
   end
 
 private

data/lib/binman/version.rb

@@ -1,3 +1,3 @@
 module BinMan
-  VERSION = "3.3.2"
+  VERSION = "3.3.3"
 end

data/man/index.html

@@ -2,7 +2,7 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 2.0.1 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
   <title>man/index</title>
   <link rel="stylesheet" href="style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->

data/man/man0/README.html

@@ -2,12 +2,19 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 2.0.1 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
   <title>README</title>
   <link rel="stylesheet" href="../style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
 </head>
-<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/README</span></div></div><div class="container-fluid"><h1 id="binman-man-pages-for-bin-scripts">binman - man pages for bin scripts</h1><p><a href="https://github.com/sunaku/binman">binman</a> produces UNIX manual pages for executable scripts using <a href="https://github.com/sunaku/md2man">md2man</a>.</p><h2 id="Features">Features</h2>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/README</span></div></div><div class="container-fluid"><h1 id="binman-man-pages-for"><a name="binman-man-pages-for" href="#binman-man-pages-for" class="md2man-permalink" title="permalink"></a><span class="md2man-title">binman</span> <span class="md2man-section">-</span> <span class="md2man-date">man</span> <span class="md2man-source">pages</span> <span class="md2man-manual">for</span></h1><p><a href="https://github.com/sunaku/binman">binman</a> produces UNIX manual pages for executable scripts using <a href="https://github.com/sunaku/md2man">md2man</a>.</p>
+<ul>
+<li>Package: <a href="https://rubygems.org/gems/binman">https://rubygems.org/gems/binman</a></li>
+<li>Manuals: <a href="https://sunaku.github.io/binman">https://sunaku.github.io/binman</a></li>
+<li>Sources: <a href="https://github.com/sunaku/binman">https://github.com/sunaku/binman</a></li>
+<li>Support: <a href="https://github.com/sunaku/binman/issues">https://github.com/sunaku/binman/issues</a></li>
+</ul>
+<h2 id="features"><a name="features" href="#features" class="md2man-permalink" title="permalink"></a>Features</h2>
 <ul>
 <li><p>Supports any scripting language that has multi-line
 comments or uses <code>#</code> for single-line comments: Ruby,
@@ -16,28 +23,28 @@ Perl, Python, Node.js, Tcl, AWK, UNIX shell, and more!</p></li>
 <li><p>Individual extraction, conversion, and display commands.</p></li>
 <li><p>Implemented in roughly 130 lines of pure Ruby code! :-)</p></li>
 </ul>
-<h3 id="Demonstration">Demonstration</h3><p><img src="https://raw.github.com/sunaku/binman/master/EXAMPLE.png" alt="Obligatory screen-shot of binman(1) in action!"></p><p>Here is <a href="https://raw.github.com/sunaku/binman/master/bin/binman">a complete example in Ruby</a> to help you get started.
-For examples in other scripting languages, see the &quot;Usage&quot; section below!</p><h2 id="Installation">Installation</h2><p>If you only want to view pre-built manual pages:</p>
+<h3 id="demonstration"><a name="demonstration" href="#demonstration" class="md2man-permalink" title="permalink"></a>Demonstration</h3><p><img src="EXAMPLE.png" alt="Obligatory screen-shot of binman(1) in action!"></p><p>Here is <a href="https://raw.github.com/sunaku/binman/master/bin/binman">a complete example in Ruby</a> to help you get started.
+For examples in other scripting languages, see the &quot;Usage&quot; section below!</p><h2 id="installation"><a name="installation" href="#installation" class="md2man-permalink" title="permalink"></a>Installation</h2><p>If you only want to view pre-built manual pages:</p>
 <pre><code>gem install binman
 </code></pre>
 <p>If you also want to build your own manual pages:</p>
-<pre><code>gem install md2man -v &#39;~&gt; 2.0&#39;
+<pre><code>gem install md2man -v &#39;~&gt; 3.0&#39;
 </code></pre>
-<h3 id="Prerequisites">Prerequisites</h3>
+<h3 id="prerequisites"><a name="prerequisites" href="#prerequisites" class="md2man-permalink" title="permalink"></a>Prerequisites</h3>
 <ul>
 <li>Ruby 1.8.7 or 1.9.2 or newer.</li>
 </ul>
-<h3 id="Development">Development</h3>
+<h3 id="development"><a name="development" href="#development" class="md2man-permalink" title="permalink"></a>Development</h3>
 <pre><code>git clone git://github.com/sunaku/binman
 cd binman
 bundle install
 bundle exec binman --help # run it directly
 bundle exec rake --tasks  # packaging tasks
 </code></pre>
-<h2 id="Usage">Usage</h2><h3 id="At-the-command-line">At the command line</h3><p>See <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a> manual:</p>
+<h2 id="usage"><a name="usage" href="#usage" class="md2man-permalink" title="permalink"></a>Usage</h2><h3 id="at-the-command-line"><a name="at-the-command-line" href="#at-the-command-line" class="md2man-permalink" title="permalink"></a>At the command line</h3><p>See <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a> manual:</p>
 <pre><code>binman --help
 </code></pre>
-<h3 id="Inside-a-Ruby-script">Inside a Ruby script</h3>
+<h3 id="inside-a-ruby-script"><a name="inside-a-ruby-script" href="#inside-a-ruby-script" class="md2man-permalink" title="permalink"></a>Inside a Ruby script</h3>
 <pre><code>#!/usr/bin/env ruby
 # your program&#39;s manual page goes here
 
@@ -67,7 +74,7 @@ your program&#39;s manual page goes here
 your program&#39;s manual page goes here
 =end
 </code></pre>
-<p>See the <a href="http://rubydoc.info/gems/binman/frames">API documentation</a> for even more possibilities!</p><h3 id="Inside-a-shell-script">Inside a shell script</h3>
+<p>See the <a href="http://rubydoc.info/gems/binman/frames">API documentation</a> for even more possibilities!</p><h3 id="inside-a-shell-script"><a name="inside-a-shell-script" href="#inside-a-shell-script" class="md2man-permalink" title="permalink"></a>Inside a shell script</h3>
 <pre><code>#!/usr/bin/sh
 # your program&#39;s manual page goes here
 
@@ -77,7 +84,7 @@ binman help &quot;$0&quot; &quot;$@&quot; &amp;&amp; exit
 # OPTION 2: show manual unconditionally
 binman show &quot;$0&quot;
 </code></pre>
-<h3 id="Inside-a-Perl-script">Inside a Perl script</h3>
+<h3 id="inside-a-perl-script"><a name="inside-a-perl-script" href="#inside-a-perl-script" class="md2man-permalink" title="permalink"></a>Inside a Perl script</h3>
 <pre><code>#!/usr/bin/env perl
 # your program&#39;s manual page goes here
 
@@ -95,7 +102,7 @@ __END__
 your program&#39;s manual page goes here
 =end
 </code></pre>
-<h3 id="Inside-a-Python-script">Inside a Python script</h3>
+<h3 id="inside-a-python-script"><a name="inside-a-python-script" href="#inside-a-python-script" class="md2man-permalink" title="permalink"></a>Inside a Python script</h3>
 <pre><code>#!/usr/bin/env python
 # your program&#39;s manual page goes here
 
@@ -129,7 +136,7 @@ your program&#39;s manual page goes here
 =end
 &quot;&quot;&quot;
 </code></pre>
-<h3 id="Inside-an-AWK-script">Inside an AWK script</h3><p>The technique for determining current AWK script file name <a href="http://www.mombu.com/programming/programming/t-the-name-of-script-itself-2040784-print.html">comes from here</a>.</p>
+<h3 id="inside-an-awk-script"><a name="inside-an-awk-script" href="#inside-an-awk-script" class="md2man-permalink" title="permalink"></a>Inside an AWK script</h3><p>The technique for determining current AWK script file name <a href="http://www.mombu.com/programming/programming/t-the-name-of-script-itself-2040784-print.html">comes from here</a>.</p>
 <pre><code>#!/usr/bin/awk -f
 # your program&#39;s manual page goes here
 
@@ -141,7 +148,7 @@ BEGIN {getline c &lt;&quot;/proc/self/cmdline&quot;; sub(&quot;.*-f\0&quot;,&quo
 BEGIN {getline c &lt;&quot;/proc/self/cmdline&quot;; sub(&quot;.*-f\0&quot;,&quot; &quot;,c); sub(&quot;\0.*&quot;,&quot;&quot;,c);
        system(&quot;binman show&quot; c)}
 </code></pre>
-<h3 id="Inside-a-Tcl-script">Inside a Tcl script</h3>
+<h3 id="inside-a-tcl-script"><a name="inside-a-tcl-script" href="#inside-a-tcl-script" class="md2man-permalink" title="permalink"></a>Inside a Tcl script</h3>
 <pre><code>#!/usr/bin/env tclsh
 # your program&#39;s manual page goes here
 
@@ -159,7 +166,7 @@ your program&#39;s manual page goes here
 =end
 }
 </code></pre>
-<h3 id="Inside-a-Node-js-script">Inside a Node.js script</h3>
+<h3 id="inside-a-node-js-script"><a name="inside-a-node-js-script" href="#inside-a-node-js-script" class="md2man-permalink" title="permalink"></a>Inside a Node.js script</h3>
 <pre><code>/*
 =begin
 your program&#39;s manual page goes here
@@ -170,18 +177,18 @@ var exec = require(&#39;child_process&#39;).exec;
 
 // OPTION 1: show manual and exit if ARGV has -h or --help except after --
 exec([&#39;&gt;/dev/tty&#39;, &#39;binman&#39;, &#39;help&#39;, __filename].concat(process.argv).
-join(&#39; &#39;), <a class="md2man-xref">function(error)</a>{ if (error === null){ process.exit(); } });
+join(&#39; &#39;), <a class="md2man-reference">function(error)</a>{ if (error === null){ process.exit(); } });
 
 // OPTION 2: show manual unconditionally
 exec([&#39;&gt;/dev/tty&#39;, &#39;binman&#39;, &#39;show&#39;, __filename].join(&#39; &#39;));
 </code></pre>
-<h2 id="Packaging">Packaging</h2><h3 id="Building-man-pages">Building man pages</h3><h4 id="At-the-command-line">At the command line</h4><p>See <a class="md2man-xref" href="../man1/binman-rake.1.html">binman-rake(1)</a> manual:</p>
+<h2 id="packaging"><a name="packaging" href="#packaging" class="md2man-permalink" title="permalink"></a>Packaging</h2><h3 id="building-man-pages"><a name="building-man-pages" href="#building-man-pages" class="md2man-permalink" title="permalink"></a>Building man pages</h3><h4 id="at-the-command-line-1"><a name="at-the-command-line-1" href="#at-the-command-line-1" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference" href="../man1/binman-rake.1.html">binman-rake(1)</a> manual:</p>
 <pre><code>binman-rake --help
 </code></pre>
-<h4 id="Inside-a-Ruby-script">Inside a Ruby script</h4><p>Add this snippet to your gemspec file:</p>
+<h4 id="inside-a-ruby-script-1"><a name="inside-a-ruby-script-1" href="#inside-a-ruby-script-1" class="md2man-permalink" title="permalink"></a>Inside a Ruby script</h4><p>Add this snippet to your gemspec file:</p>
 <pre><code>s.files += Dir[&#39;man/man?/*.?&#39;]            # UNIX man pages
 s.files += Dir[&#39;man/**/*.{html,css,js}&#39;]  # HTML man pages
-s.add_development_dependency &#39;md2man&#39;, &#39;~&gt; 2.0&#39;
+s.add_development_dependency &#39;md2man&#39;, &#39;~&gt; 3.0&#39;
 </code></pre>
 <p>Add the following line to your Rakefile:</p>
 <pre><code>require &#39;binman/rakefile&#39;
@@ -194,5 +201,5 @@ ensures that your UNIX manual pages are pre-built and packaged into your gem:</p
 <pre><code>bundle exec rake build
 gem spec pkg/*.gem | fgrep man/man
 </code></pre>
-<h2 id="License">License</h2><p>Released under the ISC license.  See the LICENSE file for details.</p></div></body>
+<h2 id="license"><a name="license" href="#license" class="md2man-permalink" title="permalink"></a>License</h2><p>Released under the ISC license.  See the LICENSE file for details.</p></div></body>
 </html>

data/man/man0/README.markdown

@@ -2,6 +2,11 @@
 
 [binman] produces UNIX manual pages for executable scripts using [md2man].
 
+* Package: <https://rubygems.org/gems/binman>
+* Manuals: <https://sunaku.github.io/binman>
+* Sources: <https://github.com/sunaku/binman>
+* Support: <https://github.com/sunaku/binman/issues>
+
 ## Features
 
   * Supports any scripting language that has multi-line
@@ -16,8 +21,7 @@
 
 ### Demonstration
 
-![Obligatory screen-shot of binman(1) in action!](
-https://raw.github.com/sunaku/binman/master/EXAMPLE.png)
+![Obligatory screen-shot of binman(1) in action!](EXAMPLE.png)
 
 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!
@@ -30,7 +34,7 @@ If you only want to view pre-built manual pages:
 
 If you also want to build your own manual pages:
 
-    gem install md2man -v '~> 2.0'
+    gem install md2man -v '~> 3.0'
 
 ### Prerequisites
 
@@ -227,7 +231,7 @@ Add this snippet to your gemspec file:
 
     s.files += Dir['man/man?/*.?']            # UNIX man pages
     s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
-    s.add_development_dependency 'md2man', '~> 2.0'
+    s.add_development_dependency 'md2man', '~> 3.0'
 
 Add the following line to your Rakefile:
 

data/man/man0/VERSION.html

@@ -2,12 +2,18 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 2.0.1 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
   <title>VERSION</title>
   <link rel="stylesheet" href="../style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
 </head>
-<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/VERSION</span></div></div><div class="container-fluid"><h2 id="Version-3-3-2-2013-08-30">Version 3.3.2 (2013-08-30)</h2><p>Patch:</p>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man0">man0</a>/VERSION</span></div></div><div class="container-fluid"><h2 id="version-3-3-3-2014-06-22"><a name="version-3-3-3-2014-06-22" href="#version-3-3-3-2014-06-22" class="md2man-permalink" title="permalink"></a>Version 3.3.3 (2014-06-22)</h2><p>This release upgrades to md2man 3.0 for improved HTML manuals.</p><h3 id="other"><a name="other" href="#other" class="md2man-permalink" title="permalink"></a>Other:</h3>
+<ul>
+<li><p>README: add links to package, manuals, and GitHub.</p></li>
+<li><p>GitHub now supports relative links from the README:</p><p><a href="https://help.github.com/articles/relative-links-in-readmes">https://help.github.com/articles/relative-links-in-readmes</a></p></li>
+<li><p>Upgrade to md2man 3.0 for improved HTML manuals.</p></li>
+</ul>
+<h2 id="version-3-3-2-2013-08-30"><a name="version-3-3-2-2013-08-30" href="#version-3-3-2-2013-08-30" class="md2man-permalink" title="permalink"></a>Version 3.3.2 (2013-08-30)</h2><p>Patch:</p>
 <ul>
 <li><p>Rescue error when designated opener is not found:</p>
 <pre><code>$ binman -h
@@ -29,13 +35,13 @@
 <ul>
 <li>Add screenshot to git repo since OmpLoader is dead.</li>
 </ul>
-<h2 id="Version-3-3-1-2013-06-01">Version 3.3.1 (2013-06-01)</h2><p>Patch:</p>
+<h2 id="version-3-3-1-2013-06-01"><a name="version-3-3-1-2013-06-01" href="#version-3-3-1-2013-06-01" class="md2man-permalink" title="permalink"></a>Version 3.3.1 (2013-06-01)</h2><p>Patch:</p>
 <ul>
 <li>Ensure that md2man 2.0 is loaded before running any BinMan rake tasks.</li>
 </ul>
-<h2 id="Version-3-3-0-2013-05-08">Version 3.3.0 (2013-05-08)</h2><p>Minor:</p>
+<h2 id="version-3-3-0-2013-05-08"><a name="version-3-3-0-2013-05-08" href="#version-3-3-0-2013-05-08" class="md2man-permalink" title="permalink"></a>Version 3.3.0 (2013-05-08)</h2><p>Minor:</p>
 <ul>
-<li><p>Add <a class="md2man-xref" href="../man1/binman-rake.1.html">binman-rake(1)</a> script to provide access to <code>binman/rakefile</code> tasks.</p></li>
+<li><p>Add <a class="md2man-reference" href="../man1/binman-rake.1.html">binman-rake(1)</a> script to provide access to <code>binman/rakefile</code> tasks.</p></li>
 <li><p>Always try showing HTML manual page in web browser from <code>BinMan.show()</code>.</p></li>
 </ul>
 <p>Other:</p>
@@ -44,13 +50,13 @@
 <li><p>Rename HISTORY to VERSION so it sorts after README.</p></li>
 <li><p>Add man/man0/ subdir containing README and VERSION.</p></li>
 </ul>
-<h2 id="Version-3-2-1-2013-05-04">Version 3.2.1 (2013-05-04)</h2><p>Patch:</p>
+<h2 id="version-3-2-1-2013-05-04"><a name="version-3-2-1-2013-05-04" href="#version-3-2-1-2013-05-04" class="md2man-permalink" title="permalink"></a>Version 3.2.1 (2013-05-04)</h2><p>Patch:</p>
 <ul>
 <li><p>Ensure that the <code>binman:web</code> Rake task works the first time through.</p></li>
 <li><p>Fix &quot;uninitialized constant Md2Man::VERSION&quot; errors in <code>binman/rakefile</code>.</p></li>
 <li><p>Hook into the <code>build</code> Rake task only if Bundler&#39;s Rake tasks are loaded:</p><p><a href="https://github.com/sunaku/md2man/pull/7#issuecomment-9467621">https://github.com/sunaku/md2man/pull/7#issuecomment-9467621</a></p><p>Thanks to Postmodern for raising this issue.</p></li>
 </ul>
-<h2 id="Version-3-2-0-2012-10-14">Version 3.2.0 (2012-10-14)</h2><p>Minor:</p>
+<h2 id="version-3-2-0-2012-10-14"><a name="version-3-2-0-2012-10-14" href="#version-3-2-0-2012-10-14" class="md2man-permalink" title="permalink"></a>Version 3.2.0 (2012-10-14)</h2><p>Minor:</p>
 <ul>
 <li>add binman:web task to produce man pages in HTML</li>
 </ul>
@@ -58,7 +64,7 @@
 <ul>
 <li>gemspec: package only roff files from inside man/</li>
 </ul>
-<h2 id="Version-3-1-1-2012-10-13">Version 3.1.1 (2012-10-13)</h2><p>Patch:</p>
+<h2 id="version-3-1-1-2012-10-13"><a name="version-3-1-1-2012-10-13" href="#version-3-1-1-2012-10-13" class="md2man-permalink" title="permalink"></a>Version 3.1.1 (2012-10-13)</h2><p>Patch:</p>
 <ul>
 <li><p>load() failed when leading comment header missing</p></li>
 <li><p>lstrip() is too powerful; consume lines carefully</p></li>
@@ -67,7 +73,7 @@
 <ul>
 <li>fix broken link to redcarpet library home page</li>
 </ul>
-<h2 id="Version-3-1-0-2012-02-06">Version 3.1.0 (2012-02-06)</h2><p>Minor:</p>
+<h2 id="version-3-1-0-2012-02-06"><a name="version-3-1-0-2012-02-06" href="#version-3-1-0-2012-02-06" class="md2man-permalink" title="permalink"></a>Version 3.1.0 (2012-02-06)</h2><p>Minor:</p>
 <ul>
 <li>Added <code>binman help</code> command for use by non-Ruby bin scripts.  See README
 for usage examples from Perl, Python, Node.js, Tcl, AWK, and UNIX shell!</li>
@@ -81,7 +87,7 @@ for usage examples from Perl, Python, Node.js, Tcl, AWK, and UNIX shell!</li>
 <ul>
 <li>Shorten markdown headings; improve documentation; clean up.</li>
 </ul>
-<h2 id="Version-3-0-1-2012-02-02">Version 3.0.1 (2012-02-02)</h2><p>Patch:</p>
+<h2 id="version-3-0-1-2012-02-02"><a name="version-3-0-1-2012-02-02" href="#version-3-0-1-2012-02-02" class="md2man-permalink" title="permalink"></a>Version 3.0.1 (2012-02-02)</h2><p>Patch:</p>
 <ul>
 <li><p>BinMan.help(): ignore <code>-h</code> and <code>--help</code> options after standard <code>--</code> flag.</p></li>
 <li><p>BinMan.show(): write temp file because not all systems support <code>man -l</code>.</p></li>
@@ -93,7 +99,7 @@ for usage examples from Perl, Python, Node.js, Tcl, AWK, and UNIX shell!</li>
 <li><p>README: fix installation commands for development.</p></li>
 <li><p>bundler suggests moving all dev deps into gemspec.</p></li>
 </ul>
-<h2 id="Version-3-0-0-2012-01-09">Version 3.0.0 (2012-01-09)</h2><p>Major:</p>
+<h2 id="version-3-0-0-2012-01-09"><a name="version-3-0-0-2012-01-09" href="#version-3-0-0-2012-01-09" class="md2man-permalink" title="permalink"></a>Version 3.0.0 (2012-01-09)</h2><p>Major:</p>
 <ul>
 <li>Removed the <code>binman/gemspec</code> helper library because it did not play well
 with Bundler.  Use the standard <code>add_runtime_dependency</code> method instead.
@@ -104,7 +110,7 @@ with Bundler.  Use the standard <code>add_runtime_dependency</code> method inste
 <li>The <code>binman/Rakefile</code> helper library now hooks into Bundler&#39;s Rake tasks.
 Be sure to add the <code>man/**/*</code> files to your gemspec <a href="https://github.com/sunaku/md2man/commit/75d7a0064fa86f1c98dd01391ad82245fd387c20">accordingly</a>.</li>
 </ul>
-<h2 id="Version-2-0-0-2011-12-06">Version 2.0.0 (2011-12-06)</h2><p>Major:</p>
+<h2 id="version-2-0-0-2011-12-06"><a name="version-2-0-0-2011-12-06" href="#version-2-0-0-2011-12-06" class="md2man-permalink" title="permalink"></a>Version 2.0.0 (2011-12-06)</h2><p>Major:</p>
 <ul>
 <li>Removed the deprecated <code>binman/rake_tasks</code> helper library.  Use
 <code>binman/rakefile</code> instead.</li>
@@ -118,7 +124,7 @@ Be sure to add the <code>man/**/*</code> files to your gemspec <a href="https://
 <li><p>Upgraded to md2man v1 for Markdown to UNIX man page conversion.</p></li>
 <li><p>Do not hard-code the version number in <code>binman/gemspec</code> helper.</p></li>
 </ul>
-<h2 id="Version-1-1-0-2011-11-05">Version 1.1.0 (2011-11-05)</h2><p>Alert:</p>
+<h2 id="version-1-1-0-2011-11-05"><a name="version-1-1-0-2011-11-05" href="#version-1-1-0-2011-11-05" class="md2man-permalink" title="permalink"></a>Version 1.1.0 (2011-11-05)</h2><p>Alert:</p>
 <ul>
 <li>The <code>binman/rake_tasks</code> library has been renamed (with deprecation) to
 <code>binman/rakefile</code>.  The deprecation warning will be removed in the next
@@ -130,7 +136,7 @@ major release.</li>
 builds and includes your UNIX man page files in your gem packages and also
 adds binman as a runtime and development gem dependency.</li>
 </ul>
-<h2 id="Version-1-0-0-2011-10-13">Version 1.0.0 (2011-10-13)</h2><p>Major:</p>
+<h2 id="version-1-0-0-2011-10-13"><a name="version-1-0-0-2011-10-13" href="#version-1-0-0-2011-10-13" class="md2man-permalink" title="permalink"></a>Version 1.0.0 (2011-10-13)</h2><p>Major:</p>
 <ul>
 <li><p>The <code>BinMan::dump()</code> method and corresponding <code>binman dump</code> command now
 extract the leading comment header from their input before returning the
@@ -153,19 +159,19 @@ comment header from the <code>bin/</code> script into a UNIX man page for displa
 <ul>
 <li>README: explain dev deps and <code>man/</code> dir packaging.</li>
 </ul>
-<h2 id="Version-0-1-2-2011-10-13">Version 0.1.2 (2011-10-13)</h2><p>Minor:</p>
+<h2 id="version-0-1-2-2011-10-13"><a name="version-0-1-2-2011-10-13" href="#version-0-1-2-2011-10-13" class="md2man-permalink" title="permalink"></a>Version 0.1.2 (2011-10-13)</h2><p>Minor:</p>
 <ul>
 <li>The <a href="https://github.com/tanoku/redcarpet">Redcarpet2</a> library is not a runtime gem dependency anymore.</li>
 </ul>
 <p>Other:</p>
 <ul>
 <li><p>Extracted <code>BinMan::Renderer</code> into <a href="http://rdoc.info/github/sunaku/redcarpet-manpage">redcarpet-manpage</a> library.</p></li>
-<li><p>Forgot to introduce leading comment headers in <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a> man page.</p></li>
+<li><p>Forgot to introduce leading comment headers in <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a> man page.</p></li>
 </ul>
-<h2 id="Version-0-1-1-2011-10-13">Version 0.1.1 (2011-10-13)</h2><p>Minor:</p>
+<h2 id="version-0-1-1-2011-10-13"><a name="version-0-1-1-2011-10-13" href="#version-0-1-1-2011-10-13" class="md2man-permalink" title="permalink"></a>Version 0.1.1 (2011-10-13)</h2><p>Minor:</p>
 <ul>
 <li><code>BinMan.read()</code> now supports embedded document (=begin/=end) comments
-also.  See <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a> for the new description of leading comment headers.</li>
+also.  See <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a> for the new description of leading comment headers.</li>
 </ul>
 <p>Patch:</p>
 <ul>
@@ -179,5 +185,5 @@ also.  See <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a> for
 <li><p>README: add link to example of binman markdown.</p></li>
 <li><p>README: add obligatory screenshot! &gt;:-)</p></li>
 </ul>
-<h2 id="Version-0-0-1-2011-10-12">Version 0.0.1 (2011-10-12)</h2><p>First release!  Happy birthday!  Woohoo!  :-)</p></div></body>
+<h2 id="version-0-0-1-2011-10-12"><a name="version-0-0-1-2011-10-12" href="#version-0-0-1-2011-10-12" class="md2man-permalink" title="permalink"></a>Version 0.0.1 (2011-10-12)</h2><p>First release!  Happy birthday!  Woohoo!  :-)</p></div></body>
 </html>

data/man/man0/VERSION.markdown

@@ -1,3 +1,17 @@
+## Version 3.3.3 (2014-06-22)
+
+This release upgrades to md2man 3.0 for improved HTML manuals.
+
+### Other:
+
+  * README: add links to package, manuals, and GitHub.
+
+  * GitHub now supports relative links from the README:
+
+    https://help.github.com/articles/relative-links-in-readmes
+
+  * Upgrade to md2man 3.0 for improved HTML manuals.
+
 ## Version 3.3.2 (2013-08-30)
 
 Patch:

data/man/man1/binman-rake.1

@@ -1,4 +1,4 @@
-.TH BINMAN\-RAKE 1 2013\-08\-30 3.3.2
+.TH BINMAN\-RAKE 1 2014\-06\-22 3.3.3
 .SH NAME
 .PP
 binman\-rake \- run 
@@ -7,7 +7,7 @@ tasks from
 .BR binman (1)
 .SH SYNOPSIS
 .PP
-\fB\fCbinman-rake\fR [\fIOPTION\fP]... [\fITASK\fP]...
+\fB\fCbinman\-rake\fR [\fIOPTION\fP]... [\fITASK\fP]...
 .SH DESCRIPTION
 .PP
 This program lets you run 
@@ -46,10 +46,10 @@ builds HTML manual pages from \fB\fC*.markdown\fR, \fB\fC*.mkd\fR, and \fB\fC*.m
 found in or beneath the \fB\fCman/\fR subdirectory in your working directory.
 .SH OPTIONS
 .TP
-\fB\fC-h\fR, \fB\fC--help\fR
+\fB\fC\-h\fR, \fB\fC\-\-help\fR
 Show this help manual.
 .PP
-Run \fB\fCrake --help\fR to see more options.
+Run \fB\fCrake \-\-help\fR to see more options.
 .SH SEE ALSO
 .PP
 .BR rake (1), 

data/man/man1/binman-rake.1.html

@@ -2,20 +2,20 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 2.0.1 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
   <title>binman-rake(1) &mdash; run rake(1) tasks from binman(1)</title>
   <link rel="stylesheet" href="../style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
 </head>
-<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/binman-rake.1</span></div></div><div class="container-fluid"><h1 id="BINMAN-RAKE-1-2013-08-30-3-3-2">BINMAN-RAKE 1 2013-08-30 3.3.2</h1><h2 id="NAME">NAME</h2><p>binman-rake - run <a class="md2man-xref">rake(1)</a> tasks from <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a></p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>binman-rake</code> [<em>OPTION</em>]... [<em>TASK</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program lets you run <a class="md2man-xref">rake(1)</a> tasks provided by <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a> without having
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/binman-rake.1</span></div></div><div class="container-fluid"><h1 id="binman-rake-1-2014-06-22-3-3-3"><a name="binman-rake-1-2014-06-22-3-3-3" href="#binman-rake-1-2014-06-22-3-3-3" class="md2man-permalink" title="permalink"></a><span class="md2man-title">BINMAN-RAKE</span> <span class="md2man-section">1</span> <span class="md2man-date">2014-06-22</span> <span class="md2man-source">3.3.3</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>binman-rake - run <a class="md2man-reference">rake(1)</a> tasks from <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a></p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>binman-rake</code> [<em>OPTION</em>]... [<em>TASK</em>]...</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p>This program lets you run <a class="md2man-reference">rake(1)</a> tasks provided by <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a> without having
 to create a special file named <code>Rakefile</code> that contains the following snippet:</p>
 <pre><code>require &#39;binman/rakefile&#39;
 </code></pre>
-<p>If no <em>TASK</em> is specified, then the <code>binman</code> task is run by default.</p><h2 id="TASKS">TASKS</h2><dl><dt><code>binman</code></dt><dd>Runs the <code>binman:man</code> and <code>binman:web</code> tasks, in that order.</dd></dl><dl><dt><code>binman:man</code></dt><dd>Builds UNIX manual pages from scripts found in your <code>bin/</code> directory.
-It also runs the <code>md2man:man</code> task, provided by <a class="md2man-xref">md2man-rake(1)</a>, which
+<p>If no <em>TASK</em> is specified, then the <code>binman</code> task is run by default.</p><h2 id="tasks"><a name="tasks" href="#tasks" class="md2man-permalink" title="permalink"></a>TASKS</h2><dl><dt><code>binman</code></dt><dd>Runs the <code>binman:man</code> and <code>binman:web</code> tasks, in that order.</dd></dl><dl><dt><code>binman:man</code></dt><dd>Builds UNIX manual pages from scripts found in your <code>bin/</code> directory.
+It also runs the <code>md2man:man</code> task, provided by <a class="md2man-reference">md2man-rake(1)</a>, which
 builds UNIX manual pages from <code>*.markdown</code>, <code>*.mkd</code>, and <code>*.md</code> files
 found in or beneath the <code>man/</code> subdirectory in your working directory.</dd></dl><dl><dt><code>binman:web</code></dt><dd>Builds HTML manual pages from scripts found in your <code>bin/</code> directory.
-It also runs the <code>md2man:web</code> task, provided by <a class="md2man-xref">md2man-rake(1)</a>, which
+It also runs the <code>md2man:web</code> task, provided by <a class="md2man-reference">md2man-rake(1)</a>, which
 builds HTML manual pages from <code>*.markdown</code>, <code>*.mkd</code>, and <code>*.md</code> files
-found in or beneath the <code>man/</code> subdirectory in your working directory.</dd></dl><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><p>Run <code>rake --help</code> to see more options.</p><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref">rake(1)</a>, <a class="md2man-xref" href="../man1/binman.1.html">binman(1)</a>, <a class="md2man-xref">md2man-rake(1)</a></p></div></body>
+found in or beneath the <code>man/</code> subdirectory in your working directory.</dd></dl><h2 id="options"><a name="options" href="#options" class="md2man-permalink" title="permalink"></a>OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><p>Run <code>rake --help</code> to see more options.</p><h2 id="see-also"><a name="see-also" href="#see-also" class="md2man-permalink" title="permalink"></a>SEE ALSO</h2><p><a class="md2man-reference">rake(1)</a>, <a class="md2man-reference" href="../man1/binman.1.html">binman(1)</a>, <a class="md2man-reference">md2man-rake(1)</a></p></div></body>
 </html>

data/man/man1/binman.1

@@ -1,4 +1,4 @@
-.TH BINMAN 1 2013\-08\-30 3.3.2
+.TH BINMAN 1 2014\-06\-22 3.3.3
 .SH NAME
 .PP
 binman \- man pages for bin scripts
@@ -46,20 +46,20 @@ syntax from
 .BR md2man (5):
 .RS
 .IP \(bu 2
-There can be at most one top\-level heading (H1).  It is emitted as \fB\fC.TH\fR
+There can be at most one top\-level heading (H1).  It is emitted as \fB\fC\&.TH\fR
 in the 
 .BR roff (7) 
 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
-before emission as \fB\fC.IP\fR in the 
+before emission as \fB\fC\&.IP\fR in the 
 .BR roff (7) 
 output.
 .IP \(bu 2
 Paragraphs whose subsequent lines (all except the first) are uniformly
 indented by two spaces are considered to be a "tagged paragraphs".  They
-are unindented accordingly before emission as \fB\fC.TP\fR in the 
+are unindented accordingly before emission as \fB\fC\&.TP\fR in the 
 .BR roff (7) 
 output.
 .RE
@@ -84,19 +84,19 @@ fenced_code_blocks
 .RE
 .SH OPTIONS
 .TP
-\fB\fC-h\fR, \fB\fC--help\fR
+\fB\fC\-h\fR, \fB\fC\-\-help\fR
 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,
+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.
+status code \fB\fC0\fR\&.  Otherwise, this program exits with status code \fB\fC111\fR\&.
 .TP
 \fB\fCshow\fR [\fIFILE\fP]
 Use 

data/man/man1/binman.1.html

@@ -2,14 +2,14 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 2.0.1 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 3.0.0 https://github.com/sunaku/md2man" />
   <title>binman(1) &mdash; man pages for bin scripts</title>
   <link rel="stylesheet" href="../style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
 </head>
-<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/binman.1</span></div></div><div class="container-fluid"><h1 id="BINMAN-1-2013-08-30-3-3-2">BINMAN 1 2013-08-30 3.3.2</h1><h2 id="NAME">NAME</h2><p>binman - man pages for bin scripts</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>binman</code> [<em>OPTION</em>]... <em>COMMAND</em></p><h2 id="DESCRIPTION">DESCRIPTION</h2><p><a href="https://github.com/sunaku/binman">binman</a> produces UNIX manual pages for your executable scripts. It can
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/binman.1</span></div></div><div class="container-fluid"><h1 id="binman-1-2014-06-22-3-3-3"><a name="binman-1-2014-06-22-3-3-3" href="#binman-1-2014-06-22-3-3-3" class="md2man-permalink" title="permalink"></a><span class="md2man-title">BINMAN</span> <span class="md2man-section">1</span> <span class="md2man-date">2014-06-22</span> <span class="md2man-source">3.3.3</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>binman - man pages for bin scripts</p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>binman</code> [<em>OPTION</em>]... <em>COMMAND</em></p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p><a href="https://github.com/sunaku/binman">binman</a> produces UNIX manual pages for your executable scripts. It can
 extract their leading comment headers (defined below), convert them from
-<a class="md2man-xref">markdown(7)</a> into <a class="md2man-xref">roff(7)</a> using <a href="https://github.com/sunaku/md2man">md2man</a>, and display them using <a class="md2man-xref">man(1)</a>.</p><h3 id="Leading-comment-headers">Leading comment headers</h3><p>A leading comment header can be one of the following two things:</p>
+<a class="md2man-reference">markdown(7)</a> into <a class="md2man-reference">roff(7)</a> using <a href="https://github.com/sunaku/md2man">md2man</a>, and display them using <a class="md2man-reference">man(1)</a>.</p><h3 id="leading-comment-headers"><a name="leading-comment-headers" href="#leading-comment-headers" class="md2man-permalink" title="permalink"></a>Leading comment headers</h3><p>A leading comment header can be one of the following two things:</p>
 <ol>
 <li><p> A contiguous sequence of single-line comments (which begin with <code>#</code>
 and optionally continue with a single space followed by any number of
@@ -20,19 +20,19 @@ ending at the first single blank line.</p></li>
 begin with the respective delimiters and optionally continue with a single
 space followed by any number of characters until the end of the line.</p></li>
 </ol>
-<h3 id="Markdown-processing-divergence">Markdown processing divergence</h3><p>Although your leading comment headers are written in <a class="md2man-xref">markdown(7)</a>, <code>binman
-conv</code> inherits the following additions to <a class="md2man-xref">markdown(7)</a> syntax from <a class="md2man-xref">md2man(5)</a>:</p>
+<h3 id="markdown-processing-divergence"><a name="markdown-processing-divergence" href="#markdown-processing-divergence" class="md2man-permalink" title="permalink"></a>Markdown processing divergence</h3><p>Although your leading comment headers are written in <a class="md2man-reference">markdown(7)</a>, <code>binman
+conv</code> inherits the following additions to <a class="md2man-reference">markdown(7)</a> syntax from <a class="md2man-reference">md2man(5)</a>:</p>
 <ul>
 <li><p>There can be at most one top-level heading (H1).  It is emitted as <code>.TH</code>
-in the <a class="md2man-xref">roff(7)</a> output to define the UNIX manual page&#39;s header and footer.</p></li>
+in the <a class="md2man-reference">roff(7)</a> output to define the UNIX manual page&#39;s header and footer.</p></li>
 <li><p>Paragraphs whose lines are all uniformly indented by two spaces are
 considered to be &quot;indented paragraphs&quot;.  They are unindented accordingly
-before emission as <code>.IP</code> in the <a class="md2man-xref">roff(7)</a> output.</p></li>
+before emission as <code>.IP</code> in the <a class="md2man-reference">roff(7)</a> output.</p></li>
 <li><p>Paragraphs whose subsequent lines (all except the first) are uniformly
 indented by two spaces are considered to be a &quot;tagged paragraphs&quot;.  They
-are unindented accordingly before emission as <code>.TP</code> in the <a class="md2man-xref">roff(7)</a> output.</p></li>
+are unindented accordingly before emission as <code>.TP</code> in the <a class="md2man-reference">roff(7)</a> output.</p></li>
 </ul>
-<h3 id="Markdown-processing-extensions">Markdown processing extensions</h3><p>The following <a href="https://github.com/vmg/redcarpet">Redcarpet</a> extensions are enabled while processing <a class="md2man-xref">markdown(7)</a>:</p>
+<h3 id="markdown-processing-extensions"><a name="markdown-processing-extensions" href="#markdown-processing-extensions" class="md2man-permalink" title="permalink"></a>Markdown processing extensions</h3><p>The following <a href="https://github.com/vmg/redcarpet">Redcarpet</a> extensions are enabled while processing <a class="md2man-reference">markdown(7)</a>:</p>
 <ul>
 <li>tables</li>
 <li>autolink</li>
@@ -40,11 +40,11 @@ are unindented accordingly before emission as <code>.TP</code> in the <a class="
 <li>strikethrough</li>
 <li>fenced_code_blocks</li>
 </ul>
-<h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="COMMANDS">COMMANDS</h2><dl><dt><code>help</code> <em>FILE</em> [<em>ARGUMENT</em>]...</dt><dd>If the given <em>ARGUMENT</em> sequence contains <code>-h</code> or <code>--help</code> except after
+<h2 id="options"><a name="options" href="#options" class="md2man-permalink" title="permalink"></a>OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="commands"><a name="commands" href="#commands" class="md2man-permalink" title="permalink"></a>COMMANDS</h2><dl><dt><code>help</code> <em>FILE</em> [<em>ARGUMENT</em>]...</dt><dd>If the given <em>ARGUMENT</em> sequence contains <code>-h</code> or <code>--help</code> except after
 <code>--</code>, then this program extracts the given <em>FILE</em>&#39;s leading comment header,
-converts it into <a class="md2man-xref">roff(7)</a>, and displays it using <a class="md2man-xref">man(1)</a> before exiting with
-status code <code>0</code>.  Otherwise, this program exits with status code <code>111</code>.</dd></dl><dl><dt><code>show</code> [<em>FILE</em>]</dt><dd>Use <a class="md2man-xref">man(1)</a> to display the <a class="md2man-xref">roff(7)</a> conversion of the leading comment header
-extracted from the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>load</code> [<em>FILE</em>]</dt><dd>Print the leading comment header extracted from the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>dump</code> [<em>FILE</em>]</dt><dd>Print the <a class="md2man-xref">roff(7)</a> conversion of the leading comment header extracted from
-the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>conv</code> [<em>FILE</em>]</dt><dd>Print the <a class="md2man-xref">roff(7)</a> conversion of the <a class="md2man-xref">markdown(7)</a> document read from the given
-<em>FILE</em> or STDIN.</dd></dl><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/binman-rake.1.html">binman-rake(1)</a>, <a class="md2man-xref">man(1)</a>, <a class="md2man-xref">roff(7)</a>, <a class="md2man-xref">markdown(7)</a></p></div></body>
+converts it into <a class="md2man-reference">roff(7)</a>, and displays it using <a class="md2man-reference">man(1)</a> before exiting with
+status code <code>0</code>.  Otherwise, this program exits with status code <code>111</code>.</dd></dl><dl><dt><code>show</code> [<em>FILE</em>]</dt><dd>Use <a class="md2man-reference">man(1)</a> to display the <a class="md2man-reference">roff(7)</a> conversion of the leading comment header
+extracted from the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>load</code> [<em>FILE</em>]</dt><dd>Print the leading comment header extracted from the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>dump</code> [<em>FILE</em>]</dt><dd>Print the <a class="md2man-reference">roff(7)</a> conversion of the leading comment header extracted from
+the given <em>FILE</em> or STDIN.</dd></dl><dl><dt><code>conv</code> [<em>FILE</em>]</dt><dd>Print the <a class="md2man-reference">roff(7)</a> conversion of the <a class="md2man-reference">markdown(7)</a> document read from the given
+<em>FILE</em> or STDIN.</dd></dl><h2 id="see-also"><a name="see-also" href="#see-also" class="md2man-permalink" title="permalink"></a>SEE ALSO</h2><p><a class="md2man-reference" href="../man1/binman-rake.1.html">binman-rake(1)</a>, <a class="md2man-reference">man(1)</a>, <a class="md2man-reference">roff(7)</a>, <a class="md2man-reference">markdown(7)</a></p></div></body>
 </html>

data/man/style.css

@@ -1,4 +1,4 @@
-@import url('http://netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/css/bootstrap-combined.no-icons.min.css');
+@import url('https://netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/css/bootstrap-combined.no-icons.min.css');
 
 @media all {
   h1,
@@ -11,7 +11,7 @@
   }
 
   /* deactivate external manual page cross-references */
-  a.md2man-xref:not([href]) {
+  a.md2man-reference:not([href]) {
     color: inherit;
     text-decoration: none;
   }
@@ -21,7 +21,7 @@
   body {
     font-family: monospace;
     text-align: justify;
-    max-width: 83ex; /* allots 78ex width for manpage */
+    max-width: 83ch; /* 80 chars, +3 for Bootstrap CSS */
     margin: auto;
   }
 
@@ -31,6 +31,25 @@
     font-size: smaller;
     text-align: right;
   }
+
+  h1:first-child > a.md2man-permalink {
+    display: none;
+  }
+
+  a.md2man-permalink {
+    float: left;
+    margin-left: -1em;
+    opacity: 0.25;
+  }
+
+  a.md2man-permalink:before {
+    content: '\2665'; /* ♥ */
+  }
+
+  a.md2man-permalink:hover,
+  *:target > a.md2man-permalink {
+    opacity: initial
+  }
 }
 
 @media print {

metadata

@@ -1,69 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: binman
 version: !ruby/object:Gem::Version
-  version: 3.3.2
+  version: 3.3.3
 platform: ruby
 authors:
 - Suraj N. Kurapati
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-31 00:00:00.000000000 Z
+date: 2014-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: md2man
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: opener
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.0
-    - - <
+    - - "<"
       - !ruby/object:Gem::Version
         version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.1.0
-    - - <
+    - - "<"
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.2.2
-    - - <
-      - !ruby/object:Gem::Version
-        version: '1'
+        version: '10.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: 0.9.2.2
-    - - <
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '10.1'
 description: Produces UNIX manual pages for executable scripts.
 email:
 - sunaku@gmail.com
@@ -73,7 +67,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - EXAMPLE.png
 - Gemfile
 - LICENSE
@@ -86,15 +80,16 @@ files:
 - lib/binman.rb
 - lib/binman/rakefile.rb
 - lib/binman/version.rb
+- man/index.html
+- man/man0/EXAMPLE.png
+- man/man0/README.html
 - man/man0/README.markdown
+- man/man0/VERSION.html
 - man/man0/VERSION.markdown
 - man/man1/binman-rake.1
+- man/man1/binman-rake.1.html
 - man/man1/binman.1
-- man/index.html
-- man/man0/VERSION.html
-- man/man0/README.html
 - man/man1/binman.1.html
-- man/man1/binman-rake.1.html
 - man/style.css
 homepage: http://github.com/sunaku/binman
 licenses: []
@@ -105,17 +100,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: man pages for bin scripts