RubyGems - md2man - Versions diffs - 4.0.0 → 4.0.1 - Mend

md2man 4.0.0 → 4.0.1

Files changed (27) hide show

checksums.yaml +4 -4
data/VERSION.markdown +10 -0
data/bin/md2man-html +1 -1
data/bin/md2man-rake +1 -1
data/bin/md2man-roff +1 -1
data/lib/md2man/rakefile/style.css +7 -2
data/lib/md2man/version.rb +1 -1
data/man/index.html +1 -1
data/man/man0/EXAMPLE.png +1 -0
data/man/man0/README.html +4 -4
data/man/man0/README.markdown +1 -0
data/man/man0/VERSION.html +23 -17
data/man/man0/VERSION.markdown +1 -0
data/man/man1/md2man-html.1 +1 -1
data/man/man1/md2man-html.1.html +2 -2
data/man/man1/md2man-rake.1 +1 -1
data/man/man1/md2man-rake.1.html +2 -2
data/man/man1/md2man-roff.1 +1 -1
data/man/man1/md2man-roff.1.html +2 -2
data/man/man5/md2man.5 +1 -1
data/man/man5/md2man.5.html +3 -3
data/man/man5/md2man.5.markdown +1 -1
data/man/style.css +7 -2
metadata +3 -3
data/man/man0/EXAMPLE.png +0 -0
data/man/man0/README.markdown +0 -180
data/man/man0/VERSION.markdown +0 -489

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e1026a3ecb6617c017afb7464fcec8c272cc5115
-  data.tar.gz: ee2bda46cd3fb7c38db2d4b737d38a722c72f3e8
+  metadata.gz: 4e608d1fa05ea7af010e4e0d4a985dff2727fde2
+  data.tar.gz: cb1284576cbc795c92b1dba97c8a07b2abb69727
 SHA512:
-  metadata.gz: 6c1769063f893c8b7af6f57ea9c9a3d0c286e58233dbfa29dc98f6bbbb7443d7b4a85377ff1ba8f0e4485c59b2b5cb25010439e1f29bcbc46a1d75a94794b09d
-  data.tar.gz: d82c9bdf46d4a8344560ce3d589bacd26261d3a5ec96d36411120534b9a387661ff01d8125433cb1d73afefb4e3a8763f2df3dae9a5d8bfee9d67cbdfc1093ab
+  metadata.gz: 5f9cf9d465dceba7e17d9722b2d0ce1b257ba25437185fdb832597403422000d851abd03404b3afe018cd6944775f6e7d8b08580f9dd7edd2b74f4f271d916da
+  data.tar.gz: b8d9edbbe164b36d8bbbebdd8246a3ce3386092d97a15c5bb19a3b6e577e2a91bcb6a42fbd17dd1f9755728fdd268f380536b32de2fe1412d3fecfea2b7e7770

data/VERSION.markdown CHANGED Viewed

@@ -1,3 +1,13 @@
+## Version 4.0.1 (2016-02-10)
+### Other:
+  * Make all permalinks appear in the same size.
+  * Change permalink symbols from hearts to stars.
+  * Indicate target heading with a red permalink.
 ## Version 4.0.0 (2014-10-26)
 ### Major:

data/bin/md2man-html CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
-# MD2MAN-HTML 1 2014-10-26 4.0.0
+# MD2MAN-HTML 1 2016-02-10 4.0.1
 ## NAME

data/bin/md2man-rake CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
-# MD2MAN-RAKE 1 2014-10-26 4.0.0
+# MD2MAN-RAKE 1 2016-02-10 4.0.1
 ## NAME

data/bin/md2man-roff CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
-# MD2MAN-ROFF 1 2014-10-26 4.0.0
+# MD2MAN-ROFF 1 2016-02-10 4.0.1
 ## NAME

data/lib/md2man/rakefile/style.css CHANGED Viewed

@@ -40,15 +40,20 @@
     float: left;
     margin-left: -1em;
     opacity: 0.25;
+    font-size: xx-large;
   }
   a.md2man-permalink:before {
-    content: '\2665'; /* &hearts; */
+    content: '\2605'; /* &starf; */
   }
   a.md2man-permalink:hover,
   *:target > a.md2man-permalink {
-    opacity: initial
+    opacity: inherit;
+  }
+  *:target > a.md2man-permalink {
+    color: red;
   }
 }

data/lib/md2man/version.rb CHANGED Viewed

@@ -1,3 +1,3 @@
 module Md2Man
-  VERSION = "4.0.0"
+  VERSION = "4.0.1"
 end

data/man/index.html CHANGED Viewed

@@ -2,7 +2,7 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 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/EXAMPLE.png ADDED Viewed

	@@ -0,0 +1 @@
1	+ ../../EXAMPLE.png

data/man/man0/README.html CHANGED Viewed

@@ -2,7 +2,7 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 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]-->
@@ -37,7 +37,7 @@ bundle exec rake --tasks        # packaging tasks
 bundle exec md2man-roff --help  # run it directly
 bundle exec md2man-html --help  # run it directly
 </code></pre>
-<h2 id="usage"><a name="usage" href="#usage" class="md2man-permalink" title="permalink"></a>Usage</h2><h3 id="for-roff-output"><a name="for-roff-output" href="#for-roff-output" class="md2man-permalink" title="permalink"></a>For <a href="http://troff.org">roff</a> output</h3><h4 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</h4><p>See <a class="md2man-reference" href="../man1/md2man-roff.1.html">md2man-roff(1)</a> manual:</p><pre><code>md2man-roff --help
+<h2 id="usage"><a name="usage" href="#usage" class="md2man-permalink" title="permalink"></a>Usage</h2><h3 id="for-roff-output"><a name="for-roff-output" href="#for-roff-output" class="md2man-permalink" title="permalink"></a>For <a href="http://troff.org">roff</a> output</h3><h4 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</h4><p>See <a class="md2man-reference">md2man-roff(1)</a> manual:</p><pre><code>md2man-roff --help
 </code></pre>
 <h4 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</h4><p>Use the default renderer:</p><pre><code>require &#39;md2man/roff/engine&#39;
@@ -67,7 +67,7 @@ end
 engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
 your_roff_output = engine.render(your_markdown_input)
 </code></pre>
-<h3 id="for-html-output"><a name="for-html-output" href="#for-html-output" class="md2man-permalink" title="permalink"></a>For HTML output</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/md2man-html.1.html">md2man-html(1)</a> manual:</p><pre><code>md2man-html --help
+<h3 id="for-html-output"><a name="for-html-output" href="#for-html-output" class="md2man-permalink" title="permalink"></a>For HTML output</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">md2man-html(1)</a> manual:</p><pre><code>md2man-html --help
 </code></pre>
 <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>Use the default renderer:</p><pre><code>require &#39;md2man/html/engine&#39;
@@ -97,7 +97,7 @@ end
 engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
 your_html_output = engine.render(your_markdown_input)
 </code></pre>
-<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-2"><a name="at-the-command-line-2" href="#at-the-command-line-2" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference" href="../man1/md2man-rake.1.html">md2man-rake(1)</a> manual:</p><pre><code>md2man-rake --help
+<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-2"><a name="at-the-command-line-2" href="#at-the-command-line-2" class="md2man-permalink" title="permalink"></a>At the command line</h4><p>See <a class="md2man-reference">md2man-rake(1)</a> manual:</p><pre><code>md2man-rake --help
 </code></pre>
 <h4 id="inside-a-ruby-script-2"><a name="inside-a-ruby-script-2" href="#inside-a-ruby-script-2" 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

data/man/man0/README.markdown ADDED Viewed

	@@ -0,0 +1 @@
1	+ ../../README.markdown

data/man/man0/VERSION.html CHANGED Viewed

@@ -2,12 +2,18 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 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-4-0-0-2014-10-26"><a name="version-4-0-0-2014-10-26" href="#version-4-0-0-2014-10-26" class="md2man-permalink" title="permalink"></a>Version 4.0.0 (2014-10-26)</h2><h3 id="major"><a name="major" href="#major" class="md2man-permalink" title="permalink"></a>Major:</h3>
+<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-4-0-1-2016-02-10"><a name="version-4-0-1-2016-02-10" href="#version-4-0-1-2016-02-10" class="md2man-permalink" title="permalink"></a>Version 4.0.1 (2016-02-10)</h2><h3 id="other"><a name="other" href="#other" class="md2man-permalink" title="permalink"></a>Other:</h3>
+<ul>
+<li><p>Make all permalinks appear in the same size.</p></li>
+<li><p>Change permalink symbols from hearts to stars.</p></li>
+<li><p>Indicate target heading with a red permalink.</p></li>
+</ul>
+<h2 id="version-4-0-0-2014-10-26"><a name="version-4-0-0-2014-10-26" href="#version-4-0-0-2014-10-26" class="md2man-permalink" title="permalink"></a>Version 4.0.0 (2014-10-26)</h2><h3 id="major"><a name="major" href="#major" class="md2man-permalink" title="permalink"></a>Major:</h3>
 <ul>
 <li><p>Cross references are no longer expanded inside code spans and code blocks.</p><p>Thanks to Mathias Panzenböck for reporting this issue in GH-19:
 <a href="https://github.com/sunaku/md2man/issues/19">https://github.com/sunaku/md2man/issues/19</a></p></li>
@@ -33,17 +39,17 @@ GNU troff (groff) version 1.19.2
 </code></pre>
 <p>This patch drops those URL macros in favor of simpler angled brackets.</p><p>Thanks to Sorin Ionescu for reporting this issue in GH-13:
 <a href="https://github.com/sunaku/md2man/issues/13">https://github.com/sunaku/md2man/issues/13</a></p></li>
-<li><p><a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>: cross references were escaped in heading permalink IDs.</p></li>
+<li><p><a class="md2man-reference">md2man-html(1)</a>: cross references were escaped in heading permalink IDs.</p></li>
 </ul>
-<h2 id="version-3-0-0-2014-06-22"><a name="version-3-0-0-2014-06-22" href="#version-3-0-0-2014-06-22" class="md2man-permalink" title="permalink"></a>Version 3.0.0 (2014-06-22)</h2><p>This release changes <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> heading permalinks to follow GitHub style:
+<h2 id="version-3-0-0-2014-06-22"><a name="version-3-0-0-2014-06-22" href="#version-3-0-0-2014-06-22" class="md2man-permalink" title="permalink"></a>Version 3.0.0 (2014-06-22)</h2><p>This release changes <a class="md2man-reference">md2man-html(1)</a> heading permalinks to follow GitHub style:
 unique, lowercase, and squeezed and stripped of HTML tags and non-word chars.
 In addition, it renames the <code>md2man-xref</code> CSS class to <code>md2man-reference</code>.</p><p>Please make sure to update any existing bookmarks and/or hyperlinks you may
 have for jumping to specific locations in your HTML manuals after upgrading.</p><h3 id="major-1"><a name="major-1" href="#major-1" class="md2man-permalink" title="permalink"></a>Major:</h3>
 <ul>
-<li><p>Make permalink anchors on headings fully lowercase in <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>.</p></li>
-<li><p>Put permalinks on left &amp; indicate target permalink in <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>.</p></li>
-<li><p>Make permalink anchors unique by appending a count in <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>.</p></li>
-<li><p>Rename <code>md2man-xref</code> CSS class to <code>md2man-reference</code> in <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>.</p></li>
+<li><p>Make permalink anchors on headings fully lowercase in <a class="md2man-reference">md2man-html(1)</a>.</p></li>
+<li><p>Put permalinks on left &amp; indicate target permalink in <a class="md2man-reference">md2man-html(1)</a>.</p></li>
+<li><p>Make permalink anchors unique by appending a count in <a class="md2man-reference">md2man-html(1)</a>.</p></li>
+<li><p>Rename <code>md2man-xref</code> CSS class to <code>md2man-reference</code> in <a class="md2man-reference">md2man-html(1)</a>.</p></li>
 </ul>
 <h2 id="version-2-1-1-2014-06-21"><a name="version-2-1-1-2014-06-21" href="#version-2-1-1-2014-06-21" class="md2man-permalink" title="permalink"></a>Version 2.1.1 (2014-06-21)</h2><h3 id="patch-2"><a name="patch-2" href="#patch-2" class="md2man-permalink" title="permalink"></a>Patch:</h3>
 <ul>
@@ -51,17 +57,17 @@ have for jumping to specific locations in your HTML manuals after upgrading.</p>
 See <a href="https://github.com/sunaku/readably/pull/3">https://github.com/sunaku/readably/pull/3</a> for the details.</p></li>
 <li><p>Drop redundant nil check in <code>Md2Man::Roff::Engine.escape()</code>.</p></li>
 </ul>
-<h3 id="other"><a name="other" href="#other" class="md2man-permalink" title="permalink"></a>Other:</h3>
+<h3 id="other-1"><a name="other-1" href="#other-1" class="md2man-permalink" title="permalink"></a>Other:</h3>
 <ul>
 <li><p>GitHub now supports relative links from the README.</p></li>
 <li><p>README: add links to package, manuals, and GitHub.</p></li>
 </ul>
 <h2 id="version-2-1-0-2014-05-04"><a name="version-2-1-0-2014-05-04" href="#version-2-1-0-2014-05-04" class="md2man-permalink" title="permalink"></a>Version 2.1.0 (2014-05-04)</h2><h3 id="minor"><a name="minor" href="#minor" class="md2man-permalink" title="permalink"></a>Minor:</h3>
 <ul>
-<li><p><a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> now adds anchors and permalinks to all headings.  This
+<li><p><a class="md2man-reference">md2man-html(1)</a> now adds anchors and permalinks to all headings.  This
 makes it easy for readers to bookmark and share direct links to specific
 sections of your HTML manual pages.</p></li>
-<li><p><a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> now wraps individual components of the special <code>.TH</code>
+<li><p><a class="md2man-reference">md2man-html(1)</a> now wraps individual components of the special <code>.TH</code>
 top-level heading in HTML <code>&lt;span&gt;</code> elements with stylable CSS classes:</p><pre><code>&lt;span class=&quot;md2man-title&quot;&gt;...&lt;/span&gt;
 &lt;span class=&quot;md2man-section&quot;&gt;...&lt;/span&gt;
 &lt;span class=&quot;md2man-date&quot;&gt;...&lt;/span&gt;
@@ -70,7 +76,7 @@ top-level heading in HTML <code>&lt;span&gt;</code> elements with stylable CSS c
 </code></pre>
 <p>Thanks to Nick Fagerlund for requesting this feature in <a href="https://github.com/sunaku/md2man/issues/15">GH-15</a>.</p></li>
 </ul>
-<h3 id="other-1"><a name="other-1" href="#other-1" class="md2man-permalink" title="permalink"></a>Other:</h3>
+<h3 id="other-2"><a name="other-2" href="#other-2" class="md2man-permalink" title="permalink"></a>Other:</h3>
 <ul>
 <li><p><a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> now documents the special <code>.TH</code> format of top-level headings.</p><p>Thanks to Nick Fagerlund for requesting this documentation in <a href="https://github.com/sunaku/md2man/issues/15">GH-15</a>.</p></li>
 </ul>
@@ -80,7 +86,7 @@ top-level heading in HTML <code>&lt;span&gt;</code> elements with stylable CSS c
 This raised an ArgumentError on &quot;wrong number of arguments (3 for 2)&quot;.</p><p>Thanks to zimbatm for contributing this patch.</p></li>
 <li><p>GH-17 and GH-18: Escape periods, quotes, and hyphens in code blocks.
 This fixes a bug where lines beginning with periods or single quotes
-did not appear when <a class="md2man-reference" href="../man1/md2man-roff.1.html">md2man-roff(1)</a> output was rendered using <a class="md2man-reference">man(1)</a>.</p><p>Thanks to zimbatm for reporting this bug and suggesting how to fix it.</p></li>
+did not appear when <a class="md2man-reference">md2man-roff(1)</a> output was rendered using <a class="md2man-reference">man(1)</a>.</p><p>Thanks to zimbatm for reporting this bug and suggesting how to fix it.</p></li>
 </ul>
 <h2 id="version-2-0-3-2014-01-16"><a name="version-2-0-3-2014-01-16" href="#version-2-0-3-2014-01-16" class="md2man-permalink" title="permalink"></a>Version 2.0.3 (2014-01-16)</h2><h3 id="patch-4"><a name="patch-4" href="#patch-4" class="md2man-permalink" title="permalink"></a>Patch:</h3>
 <ul>
@@ -112,7 +118,7 @@ did not appear when <a class="md2man-reference" href="../man1/md2man-roff.1.html
 <h2 id="version-2-0-0-2013-05-05"><a name="version-2-0-0-2013-05-05" href="#version-2-0-0-2013-05-05" class="md2man-permalink" title="permalink"></a>Version 2.0.0 (2013-05-05)</h2><p>This release renames md2man executables and libraries to highlight the fact
 that md2man provides two processing pathways: one for Roff and one for HTML.</p><p>Major:</p>
 <ul>
-<li><p>Rename <a class="md2man-reference">md2man(1)</a> executable to <a class="md2man-reference" href="../man1/md2man-roff.1.html">md2man-roff(1)</a>.</p></li>
+<li><p>Rename <a class="md2man-reference">md2man(1)</a> executable to <a class="md2man-reference">md2man-roff(1)</a>.</p></li>
 <li><p>Rename <code>Md2Man::Engine</code> to <code>Md2Man::Roff::Engine</code>.</p></li>
 <li><p>Rename &quot;manpage-reference&quot; CSS class to &quot;md2man-xref&quot; in HTML output.</p></li>
 <li><p>The <code>Md2Man::Document#reference()</code> method now takes only two parameters:</p>
@@ -157,7 +163,7 @@ the output document</li>
 </ul>
 <h2 id="version-1-6-0-2013-03-10"><a name="version-1-6-0-2013-03-10" href="#version-1-6-0-2013-03-10" class="md2man-permalink" title="permalink"></a>Version 1.6.0 (2013-03-10)</h2><p>Minor:</p>
 <ul>
-<li><p>Added an <a class="md2man-reference" href="../man1/md2man-rake.1.html">md2man-rake(1)</a> executable that lets you run md2man&#39;s <a class="md2man-reference">rake(1)</a>
+<li><p>Added an <a class="md2man-reference">md2man-rake(1)</a> executable that lets you run md2man&#39;s <a class="md2man-reference">rake(1)</a>
 tasks <em>directly</em> from the command line: without the need for a &quot;Rakefile&quot;
 in your working directory that loads the <code>md2man/rakefile</code> library.</p></li>
 <li><p>In web pages generated by the <code>md2man:web</code> Rake task:</p>
@@ -220,14 +226,14 @@ The documentation has been corrected and the option remains disabled.</p></li>
 </ul>
 <p>Other:</p>
 <ul>
-<li><p>README: add <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> and Md2Man::HTML usage</p></li>
+<li><p>README: add <a class="md2man-reference">md2man-html(1)</a> and Md2Man::HTML usage</p></li>
 <li><p>LICENSE: use GitHub profile URLs instead of e-mail</p></li>
 </ul>
 <h2 id="version-1-4-0-2012-10-14"><a name="version-1-4-0-2012-10-14" href="#version-1-4-0-2012-10-14" class="md2man-permalink" title="permalink"></a>Version 1.4.0 (2012-10-14)</h2><p>Minor:</p>
 <ul>
 <li><p>roff: emit non-first H1 headings as H2 headings</p></li>
 <li><p>html: add <code>Md2Man::HTML::Engine</code> class for HTML manual page generation</p></li>
-<li><p>html: add <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a> bin script for command line access to the above</p></li>
+<li><p>html: add <a class="md2man-reference">md2man-html(1)</a> bin script for command line access to the above</p></li>
 <li><p>html: add ID attributes on all headings for easy permalinking</p></li>
 <li><p>rake: add <code>md2man/rakefile</code> to process markdown files in man/</p><p>This library provides a <code>rake md2man</code> task that builds UNIX and HTML
 manual pages from Markdown files (with &quot;.markdown&quot;, &quot;.mkd&quot;, or &quot;.md&quot;

data/man/man0/VERSION.markdown ADDED Viewed

	@@ -0,0 +1 @@
1	+ ../../VERSION.markdown

data/man/man1/md2man-html.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH MD2MAN\-HTML 1 2014\-10\-26 4.0.0
+.TH MD2MAN\-HTML 1 2016\-02\-10 4.0.1
 .SH NAME
 .PP
 md2man\-html \- convert

data/man/man1/md2man-html.1.html CHANGED Viewed

@@ -2,12 +2,12 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 https://github.com/sunaku/md2man" />
   <title>md2man-html(1) &mdash; convert md2man(5) flavored markdown(7) into HTML</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>/md2man-html.1</span></div></div><div class="container-fluid"><h1 id="md2man-html-1-2014-10-26-4-0-0"><a name="md2man-html-1-2014-10-26-4-0-0" href="#md2man-html-1-2014-10-26-4-0-0" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-HTML</span> <span class="md2man-section">1</span> <span class="md2man-date">2014-10-26</span> <span class="md2man-source">4.0.0</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-html - convert <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> into HTML</p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-html</code> [<em>OPTION</em>]... [<em>FILE</em>]</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p>This program converts <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> input from the given
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/md2man-html.1</span></div></div><div class="container-fluid"><h1 id="md2man-html-1-2016-02-10-4-0-1"><a name="md2man-html-1-2016-02-10-4-0-1" href="#md2man-html-1-2016-02-10-4-0-1" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-HTML</span> <span class="md2man-section">1</span> <span class="md2man-date">2016-02-10</span> <span class="md2man-source">4.0.1</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-html - convert <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> into HTML</p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-html</code> [<em>OPTION</em>]... [<em>FILE</em>]</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p>This program converts <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> input from the given
 <em>FILE</em> into HTML and then prints the result to the standard output stream.
 If <em>FILE</em> is not given, then the standard input stream is read in its place.</p><h3 id="top-level-headings"><a name="top-level-headings" href="#top-level-headings" class="md2man-permalink" title="permalink"></a>Top-level headings</h3><p>Each component of the <code>.TH</code> directive in <a class="md2man-reference">roff(7)</a>, described under &quot;Top-level
 headings&quot; in <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a>, is wrapped in stylable <code>&lt;span&gt;</code> elements as follows:</p><pre><code>&lt;span class=&quot;md2man-title&quot;&gt;...&lt;/span&gt;

data/man/man1/md2man-rake.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH MD2MAN\-RAKE 1 2014\-10\-26 4.0.0
+.TH MD2MAN\-RAKE 1 2016\-02\-10 4.0.1
 .SH NAME
 .PP
 md2man\-rake \- run

data/man/man1/md2man-rake.1.html CHANGED Viewed

@@ -2,12 +2,12 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 https://github.com/sunaku/md2man" />
   <title>md2man-rake(1) &mdash; run rake(1) tasks from md2man(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>/md2man-rake.1</span></div></div><div class="container-fluid"><h1 id="md2man-rake-1-2014-10-26-4-0-0"><a name="md2man-rake-1-2014-10-26-4-0-0" href="#md2man-rake-1-2014-10-26-4-0-0" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-RAKE</span> <span class="md2man-section">1</span> <span class="md2man-date">2014-10-26</span> <span class="md2man-source">4.0.0</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-rake - run <a class="md2man-reference">rake(1)</a> tasks from <a class="md2man-reference">md2man(1)</a></p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-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">md2man(1)</a> without having
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/md2man-rake.1</span></div></div><div class="container-fluid"><h1 id="md2man-rake-1-2016-02-10-4-0-1"><a name="md2man-rake-1-2016-02-10-4-0-1" href="#md2man-rake-1-2016-02-10-4-0-1" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-RAKE</span> <span class="md2man-section">1</span> <span class="md2man-date">2016-02-10</span> <span class="md2man-source">4.0.1</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-rake - run <a class="md2man-reference">rake(1)</a> tasks from <a class="md2man-reference">md2man(1)</a></p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-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">md2man(1)</a> without having
 to create a special file named <code>Rakefile</code> that contains the following snippet:</p><pre><code>require &#39;md2man/rakefile&#39;
 </code></pre>
 <p>If no <em>TASK</em> is specified, then the <code>md2man</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>md2man</code></dt><dd>Runs the <code>md2man:man</code> and <code>md2man:web</code> tasks, in that order.</dd></dl><dl><dt><code>md2man:man</code></dt><dd>Builds UNIX manual pages from <code>*.markdown</code>, <code>*.mkd</code>, and <code>*.md</code> files

data/man/man1/md2man-roff.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH MD2MAN\-ROFF 1 2014\-10\-26 4.0.0
+.TH MD2MAN\-ROFF 1 2016\-02\-10 4.0.1
 .SH NAME
 .PP
 md2man\-roff \- convert

data/man/man1/md2man-roff.1.html CHANGED Viewed

@@ -2,12 +2,12 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 https://github.com/sunaku/md2man" />
   <title>md2man-roff(1) &mdash; convert md2man(5) flavored markdown(7) into roff(7)</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>/md2man-roff.1</span></div></div><div class="container-fluid"><h1 id="md2man-roff-1-2014-10-26-4-0-0"><a name="md2man-roff-1-2014-10-26-4-0-0" href="#md2man-roff-1-2014-10-26-4-0-0" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-ROFF</span> <span class="md2man-section">1</span> <span class="md2man-date">2014-10-26</span> <span class="md2man-source">4.0.0</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-roff - convert <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> into <a class="md2man-reference">roff(7)</a></p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-roff</code> [<em>OPTION</em>]... [<em>FILE</em>]</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p>This program converts <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> input from the given
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/md2man-roff.1</span></div></div><div class="container-fluid"><h1 id="md2man-roff-1-2016-02-10-4-0-1"><a name="md2man-roff-1-2016-02-10-4-0-1" href="#md2man-roff-1-2016-02-10-4-0-1" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN-ROFF</span> <span class="md2man-section">1</span> <span class="md2man-date">2016-02-10</span> <span class="md2man-source">4.0.1</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man-roff - convert <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> into <a class="md2man-reference">roff(7)</a></p><h2 id="synopsis"><a name="synopsis" href="#synopsis" class="md2man-permalink" title="permalink"></a>SYNOPSIS</h2><p><code>md2man-roff</code> [<em>OPTION</em>]... [<em>FILE</em>]</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p>This program converts <a class="md2man-reference" href="../man5/md2man.5.html">md2man(5)</a> flavored <a class="md2man-reference">markdown(7)</a> input from the given
 <em>FILE</em> into <a class="md2man-reference">roff(7)</a> and then prints the result to the standard output stream.
 If <em>FILE</em> is not given, then the standard input stream is read in its place.</p><h3 id="limitations"><a name="limitations" href="#limitations" class="md2man-permalink" title="permalink"></a>Limitations</h3><p>This program does not convert the following <a href="https://github.com/vmg/redcarpet">Redcarpet</a> nodes into <a class="md2man-reference">roff(7)</a>:</p>
 <ul>

data/man/man5/md2man.5 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH MD2MAN 5 2014\-10\-26 4.0.0
+.TH MD2MAN 5 2016\-02\-10 4.0.1
 .SH NAME
 .PP
 md2man \- manual page flavoring for the

data/man/man5/md2man.5.html CHANGED Viewed

@@ -2,12 +2,12 @@
 <html>
 <head>
   <meta charset="utf-8" />
-  <meta name="generator" content="md2man 4.0.0 https://github.com/sunaku/md2man" />
+  <meta name="generator" content="md2man 4.0.1 https://github.com/sunaku/md2man" />
   <title>md2man(5) &mdash; manual page flavoring for the markdown(7) file format</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#man5">man5</a>/md2man.5</span></div></div><div class="container-fluid"><h1 id="md2man-5-2014-10-26-4-0-0"><a name="md2man-5-2014-10-26-4-0-0" href="#md2man-5-2014-10-26-4-0-0" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN</span> <span class="md2man-section">5</span> <span class="md2man-date">2014-10-26</span> <span class="md2man-source">4.0.0</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man - manual page flavoring for the <a class="md2man-reference">markdown(7)</a> file format</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p><a href="https://github.com/sunaku/md2man">md2man</a> makes the <a class="md2man-reference">markdown(7)</a> file format friendly for writing UNIX manual
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man5">man5</a>/md2man.5</span></div></div><div class="container-fluid"><h1 id="md2man-5-2016-02-10-4-0-1"><a name="md2man-5-2016-02-10-4-0-1" href="#md2man-5-2016-02-10-4-0-1" class="md2man-permalink" title="permalink"></a><span class="md2man-title">MD2MAN</span> <span class="md2man-section">5</span> <span class="md2man-date">2016-02-10</span> <span class="md2man-source">4.0.1</span></h1><h2 id="name"><a name="name" href="#name" class="md2man-permalink" title="permalink"></a>NAME</h2><p>md2man - manual page flavoring for the <a class="md2man-reference">markdown(7)</a> file format</p><h2 id="description"><a name="description" href="#description" class="md2man-permalink" title="permalink"></a>DESCRIPTION</h2><p><a href="https://github.com/sunaku/md2man">md2man</a> makes the <a class="md2man-reference">markdown(7)</a> file format friendly for writing UNIX manual
 pages by extending its syntax, semantics, and assumed processing extensions.</p><h3 id="syntax"><a name="syntax" href="#syntax" class="md2man-permalink" title="permalink"></a>Syntax</h3><p>md2man extends <a class="md2man-reference">markdown(7)</a> syntax by defining three kinds of paragraphs.</p><pre><code>This is a
 normal
 paragraph.
@@ -60,5 +60,5 @@ spaces are considered to be &quot;indented paragraphs&quot;.  For example:</p><p
 <li>strikethrough</li>
 <li>fenced_code_blocks</li>
 </ul>
-<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">markdown(7)</a>, <a class="md2man-reference">man-pages(7)</a>, <a class="md2man-reference" href="../man1/md2man-roff.1.html">md2man-roff(1)</a>, <a class="md2man-reference" href="../man1/md2man-html.1.html">md2man-html(1)</a>, <a class="md2man-reference" href="../man1/md2man-rake.1.html">md2man-rake(1)</a></p></div></body>
+<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">markdown(7)</a>, <a class="md2man-reference">man-pages(7)</a>, <a class="md2man-reference">md2man-roff(1)</a>, <a class="md2man-reference">md2man-html(1)</a>, <a class="md2man-reference">md2man-rake(1)</a></p></div></body>
 </html>

data/man/man5/md2man.5.markdown CHANGED Viewed

@@ -1,4 +1,4 @@
-# MD2MAN 5 2014-10-26 4.0.0
+# MD2MAN 5 2016-02-10 4.0.1
 ## NAME

data/man/style.css CHANGED Viewed

@@ -40,15 +40,20 @@
     float: left;
     margin-left: -1em;
     opacity: 0.25;
+    font-size: xx-large;
   }
   a.md2man-permalink:before {
-    content: '\2665'; /* &hearts; */
+    content: '\2605'; /* &starf; */
   }
   a.md2man-permalink:hover,
   *:target > a.md2man-permalink {
-    opacity: initial
+    opacity: inherit;
+  }
+  *:target > a.md2man-permalink {
+    color: red;
   }
 }

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: md2man
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.1
 platform: ruby
 authors:
 - Suraj N. Kurapati
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-10-26 00:00:00.000000000 Z
+date: 2016-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: binman
@@ -136,7 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project:
-rubygems_version: 2.2.2
+rubygems_version: 2.5.1
 signing_key:
 specification_version: 4
 summary: markdown to manpage

data/man/man0/EXAMPLE.png DELETED Viewed

Binary file

data/man/man0/README.markdown DELETED Viewed

@@ -1,180 +0,0 @@
-# md2man - markdown to manpage
-md2man is a Ruby library and a set of command-line programs that convert
-[Markdown] into UNIX manual pages (both [roff] and HTML) using [Redcarpet].
-* Manuals: <https://sunaku.github.io/md2man/man>
-* Sources: <https://github.com/sunaku/md2man>
-* Support: <https://github.com/sunaku/md2man/issues>
-* Package: <https://rubygems.org/gems/md2man>
-## Features
-  * Formats tagged and indented paragraphs (see "document format" below).
-  * Translates all HTML4 and XHTML1 entities into native [roff] equivalents.
-  * Supports markdown extensions such as [PHP Markdown Extra tables][tables].
-  * Usable from the command line as a filter in a UNIX command pipeline.
-### Demonstration
-Try converting [this example Markdown file][example] into a UNIX manual page:
-    md2man-roff EXAMPLE.markdown > EXAMPLE.1
-    man -l EXAMPLE.1
-![Obligatory screenshot of md2man(1) in action!](EXAMPLE.png)
-Also try converting [that example Markdown file][example] into a web page:
-    md2man-html EXAMPLE.markdown > EXAMPLE.html
-    open EXAMPLE.html
-## Installation
-    gem install md2man
-### Development
-    git clone git://github.com/sunaku/md2man
-    cd md2man
-    bundle install
-    bundle exec rake --tasks        # packaging tasks
-    bundle exec md2man-roff --help  # run it directly
-    bundle exec md2man-html --help  # run it directly
-## Usage
-### For [roff] output
-#### At the command line
-See md2man-roff(1) manual:
-    md2man-roff --help
-#### Inside a Ruby script
-Use the default renderer:
-    require 'md2man/roff/engine'
-    your_roff_output = Md2Man::Roff::ENGINE.render(your_markdown_input)
-Build your own renderer:
-    require 'md2man/roff/engine'
-    engine = Redcarpet::Markdown.new(Md2Man::Roff::Engine, your_options_hash)
-    your_roff_output = engine.render(your_markdown_input)
-Define your own renderer:
-    require 'md2man/roff/engine'
-    class YourManpageRenderer < Md2Man::Roff::Engine
-      # ... your stuff here ...
-    end
-    engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-    your_roff_output = engine.render(your_markdown_input)
-Mix-in your own renderer:
-    require 'md2man/roff'
-    class YourManpageRenderer < Redcarpet::Render::Base
-      include Md2Man::Roff
-      # ... your stuff here ...
-    end
-    engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-    your_roff_output = engine.render(your_markdown_input)
-### For HTML output
-#### At the command line
-See md2man-html(1) manual:
-    md2man-html --help
-#### Inside a Ruby script
-Use the default renderer:
-    require 'md2man/html/engine'
-    your_html_output = Md2Man::HTML::ENGINE.render(your_markdown_input)
-Build your own renderer:
-    require 'md2man/html/engine'
-    engine = Redcarpet::Markdown.new(Md2Man::HTML::Engine, your_options_hash)
-    your_html_output = engine.render(your_markdown_input)
-Define your own renderer:
-    require 'md2man/html/engine'
-    class YourManpageRenderer < Md2Man::HTML::Engine
-      # ... your stuff here ...
-    end
-    engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-    your_html_output = engine.render(your_markdown_input)
-Mix-in your own renderer:
-    require 'md2man/html'
-    class YourManpageRenderer < Redcarpet::Render::Base
-      include Md2Man::HTML
-      # ... your stuff here ...
-    end
-    engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
-    your_html_output = engine.render(your_markdown_input)
-### Building man pages
-#### At the command line
-See md2man-rake(1) manual:
-    md2man-rake --help
-#### Inside a Ruby script
-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', '~> 4.0'
-Add this line to your Rakefile:
-    require 'md2man/rakefile'
-You now have a `rake md2man` task that builds manual pages from Markdown files
-(with ".markdown", ".mkd", or ".md" extension) inside `man/man*/` directories.
-There are also sub-tasks to build manual pages individually as [roff] or HTML.
-If you're using Bundler, this task also hooks into Bundler's gem packaging
-tasks and ensures that your manual pages are built for packaging into a gem:
-    bundle exec rake build
-    gem spec pkg/*.gem | fgrep man/
-## License
-Released under the ISC license.  See the LICENSE file for details.
-[roff]: http://troff.org
-[Markdown]: http://daringfireball.net/projects/markdown/
-[Redcarpet]: https://github.com/vmg/redcarpet
-[example]: https://raw.github.com/sunaku/md2man/master/EXAMPLE.markdown
-[tables]: http://michelf.com/projects/php-markdown/extra/#table

data/man/man0/VERSION.markdown DELETED Viewed

@@ -1,489 +0,0 @@
-## Version 4.0.0 (2014-10-26)
-### Major:
-  * Cross references are no longer expanded inside code spans and code blocks.
-    Thanks to Mathias Panzenböck for reporting this issue in GH-19:
-    https://github.com/sunaku/md2man/issues/19
-  * The `Md2Man::Document` module now defines the following methods.  If you
-    redefine/override these methods in deriving classes, make sure that you
-    call `super()` therein to trigger these methods' original implementation!
-    * `Md2Man::Document#block_code(code, language)`
-    * `Md2Man::Document#codespan(code)`
-## Version 3.0.2 (2014-10-26)
-### Patch:
-  * Update bootstrap 2.3.2 CDN URL; previous one died.
-## Version 3.0.1 (2014-07-16)
-This release restores Mac OS X support and fixes a permalink generation bug.
-### Patch:
-  * GH-13: man(1) on Mac OS X could not display URLs.
-    The version of groff on Mac OS X is too old: it lacks the an-ext.tmac
-    macro package that defines styles for email addresses and general URLs.
-        $ groff --version
-        ...
-        GNU grops (groff) version 1.19.2
-        GNU troff (groff) version 1.19.2
-    This patch drops those URL macros in favor of simpler angled brackets.
-    Thanks to Sorin Ionescu for reporting this issue in GH-13:
-    https://github.com/sunaku/md2man/issues/13
-  * md2man-html(1): cross references were escaped in heading permalink IDs.
-## Version 3.0.0 (2014-06-22)
-This release changes md2man-html(1) heading permalinks to follow GitHub style:
-unique, lowercase, and squeezed and stripped of HTML tags and non-word chars.
-In addition, it renames the `md2man-xref` CSS class to `md2man-reference`.
-Please make sure to update any existing bookmarks and/or hyperlinks you may
-have for jumping to specific locations in your HTML manuals after upgrading.
-### Major:
-  * Make permalink anchors on headings fully lowercase in md2man-html(1).
-  * Put permalinks on left & indicate target permalink in md2man-html(1).
-  * Make permalink anchors unique by appending a count in md2man-html(1).
-  * Rename `md2man-xref` CSS class to `md2man-reference` in md2man-html(1).
-## Version 2.1.1 (2014-06-21)
-### Patch:
-  * Bootstrap CSS failed to load for HTML manuals served under HTTPS.
-    See <https://github.com/sunaku/readably/pull/3> for the details.
-  * Drop redundant nil check in `Md2Man::Roff::Engine.escape()`.
-### Other:
-  * GitHub now supports relative links from the README.
-  * README: add links to package, manuals, and GitHub.
-## Version 2.1.0 (2014-05-04)
-### Minor:
-  * md2man-html(1) now adds anchors and permalinks to all headings.  This
-    makes it easy for readers to bookmark and share direct links to specific
-    sections of your HTML manual pages.
-  * md2man-html(1) now wraps individual components of the special `.TH`
-    top-level heading in HTML `<span>` elements with stylable CSS classes:
-        <span class="md2man-title">...</span>
-        <span class="md2man-section">...</span>
-        <span class="md2man-date">...</span>
-        <span class="md2man-source">...</span>
-        <span class="md2man-manual">...</span>
-    Thanks to Nick Fagerlund for requesting this feature in [GH-15](
-    https://github.com/sunaku/md2man/issues/15 ).
-### Other:
-  * md2man(5) now documents the special `.TH` format of top-level headings.
-    Thanks to Nick Fagerlund for requesting this documentation in [GH-15](
-    https://github.com/sunaku/md2man/issues/15 ).
-## Version 2.0.4 (2014-04-26)
-### Patch:
-  * GH-16: Redcarpet 3.1 added a third parameter to its `header()` method.
-    This raised an ArgumentError on "wrong number of arguments (3 for 2)".
-    Thanks to zimbatm for contributing this patch.
-  * GH-17 and GH-18: Escape periods, quotes, and hyphens in code blocks.
-    This fixes a bug where lines beginning with periods or single quotes
-    did not appear when md2man-roff(1) output was rendered using man(1).
-    Thanks to zimbatm for reporting this bug and suggesting how to fix it.
-## Version 2.0.3 (2014-01-16)
-### Patch:
-  * Use CSS3 `-ch` suffix for accurate 80-character width in HTML output.
-    http://www.w3.org/TR/css3-values/#font-relative-lengths
-## Version 2.0.2 (2013-09-08)
-Patch:
-  * GH-14: escape single quotes at beginning of lines
-    See the "CONTROL CHARACTERS" section in the groff(7) manual for details.
-    Thanks to Nick Fagerlund for reporting this bug.
-  * escape periods at line beginnings with \& escape
-  * escape text line backslashes as "\e" per groff(7)
-  * better documentation for escaping in normal_text()
-  * it's better to escape backslashes as \[rs] than \e
-    See "Single-Character Escapes" section in groff(7).
-Other:
-  * switch from double-quoted strings to single quotes
-## Version 2.0.1 (2013-08-29)
-Patch:
-  * Use a proper CDN to access Bootstrap 2.3.2 styling in HTML output.
-  * Ensure that man/ directory exists for the `md2man:web` Rake task.
-  * Specify license in gemspec file to fix warning when building gem.
-    Thanks to Bastien Dejean for contributing this patch.
-Other:
-  * Upgrade dependent gems by running `bundle update`.
-  * minitest 4.7.5 provides spec library via autorun.
-## Version 2.0.0 (2013-05-05)
-This release renames md2man executables and libraries to highlight the fact
-that md2man provides two processing pathways: one for Roff and one for HTML.
-Major:
-  * Rename md2man(1) executable to md2man-roff(1).
-  * Rename `Md2Man::Engine` to `Md2Man::Roff::Engine`.
-  * Rename "manpage-reference" CSS class to "md2man-xref" in HTML output.
-  * The `Md2Man::Document#reference()` method now takes only two parameters:
-    * `input_match` - MatchData object for the reference in Markdown input
-      containing the following named capture groups:
-      * `:page` - name of the manual page
-      * `:section` - section number of the manual page
-    * `output_match` - MatchData object for the reference in output document
-      containing the following named capture groups:
-      * `:addendum` - non-space characters immediately after the reference in
-        the output document
-Patch:
-  * Prevent cross-references from being expanded inside HTML tags.
-Other:
-  * Add md2man(5) manual page detailing md2man's markdown file format.
-## Version 1.6.2 (2013-05-05)
-Patch:
-  * Fix "uninitialized constant Md2Man::VERSION" error in `md2man/rakefile`.
-  * HTML manual page CSS: justify the lines of text just like man(1) does.
-  * HTML manual page CSS: resize body to allot 78ex width for manpage text.
-## Version 1.6.1 (2013-05-04)
-Patch:
-  * Replace multi-column CSS with single centered body.
-Other:
-  * Fix manpage xrefs in README and VERSION documents.
-## Version 1.6.0 (2013-03-10)
-Minor:
-  * Added an md2man-rake(1) executable that lets you run md2man's rake(1)
-    tasks _directly_ from the command line: without the need for a "Rakefile"
-    in your working directory that loads the `md2man/rakefile` library.
-  * In web pages generated by the `md2man:web` Rake task:
-    * extract CSS into a separate `man/style.css` file
-    * center manpage on screen & auto-split into columns
-Patch:
-  * In web pages generated by the `md2man:web` Rake task:
-    * don't rely on being emitted into a `man/` directory
-Other:
-  * add README and VERSION to generated HTML man pages
-## Version 1.5.1 (2013-03-06)
-Patch:
-  * All this time, this project's documentation stated that Redcarpet's
-    `no_intra_emphasis` option was enabled, but in reality, it was not.
-    The documentation has been corrected and the option remains disabled.
-  * In web pages generated by the `md2man:web` Rake task:
-    * deactivate cross references to external manual pages
-    * don't assume that NAME section contains a tagline
-    * sort man/ subdirectories in the HTML index page
-    * fix link to index page from webs directly in man/
-    * add generator META tag to HTML output template
-    * only apply special styling to the first H1 child
-    * parse title from first paragraph containing hyphen
-Other:
-  * rename HISTORY to VERSION so it sorts after README
-  * tests should exercise engines with default options
-## Version 1.5.0 (2013-02-24)
-Minor:
-  * The `md2man:web` task from `md2man/rakefile` now:
-    * emits valid HTML5 with helpful HTML page titles
-    * uses Twitter Bootstrap styling for HTML man pages
-    * emits only ONE index page for all HTML man pages
-Other:
-  * README: better organize the subsections of "Usage"
-  * include md2man rake tasks in developer's rakefile
-## Version 1.4.1 (2013-02-23)
-Patch:
-  * rakefile: arbitrary directory structure under man/
-    https://github.com/sunaku/md2man/pull/3#issuecomment-9429077
-    Thanks to Postmodern for raising this issue.
-  * hook into 'build' task only if using Bundler tasks
-    https://github.com/sunaku/md2man/pull/7#issuecomment-9467621
-    Thanks to Postmodern for raising this issue.
-  * GH-8: Redcarpet requires Ruby 1.9 and so must we
-    https://github.com/sunaku/md2man/issues/8#issuecomment-9509240
-    Thanks to Postmodern for raising this issue.
-Other:
-  * README: add md2man-html(1) and Md2Man::HTML usage
-  * LICENSE: use GitHub profile URLs instead of e-mail
-## Version 1.4.0 (2012-10-14)
-Minor:
-  * roff: emit non-first H1 headings as H2 headings
-  * html: add `Md2Man::HTML::Engine` class for HTML manual page generation
-  * html: add md2man-html(1) bin script for command line access to the above
-  * html: add ID attributes on all headings for easy permalinking
-  * rake: add `md2man/rakefile` to process markdown files in man/
-    This library provides a `rake md2man` task that builds UNIX and HTML
-    manual pages from Markdown files (with ".markdown", ".mkd", or ".md"
-    extension) inside your `man/man*/` directories.  It also provides
-    sub-tasks to build *only* UNIX or HTML manual pages separately.
-    It also hooks into Bundler's gem packaging tasks to automatically build
-    your manual pages for packaging into a gem.  See the README for details.
-## Version 1.3.2 (2012-10-13)
-Patch:
-  * roff: escape backslashes inside codespan nodes too
-  * roff: escape backslashes inside block\_code nodes
-## Version 1.3.1 (2012-10-09)
-Patch:
-  * roff: do not render references inside code blocks.
-  * roff: do not render references inside code spans.
-  * roff: fix single-line indented paragraph detection.
-  * roff: also indent block\_code just like block\_quote.
-  * roff: add paragraph above block\_quote for spacing.
-  * roff: render code blocks as paragraphs for spacing.
-    Otherwise there's not enough space between the previous paragraph and
-    the code block: it appears on the next line and appears ugly in man(1).
-  * document: make reference regexp match more manpages.
-Other:
-  * document: stronger digest encoding using NUL bytes.
-  * document: super() can't reach Redcarpet's renderer classes.
-    See https://github.com/vmg/redcarpet/issues/51 for details.
-## Version 1.3.0 (2012-09-27)
-Minor:
-  * Intra-word emphasis is now enabled *by default* in `Md2Man::ENGINE`.
-    To not be affected by this change, you may still construct your own
-    Redcarpet::Markdown engine with your own set of processing options.
-## Version 1.2.1 (2012-07-05)
-Patch:
-  * GH-4: ruby 1.8.7 lacks negative lookbehind regexps.
-    Thanks to Postmodern for reporting this issue.
-Other:
-  * GH-1: use `~>` for gem version constraints.
-    See http://docs.rubygems.org/read/chapter/16
-    Thanks to Postmodern for this contribution.
-## Version 1.2.0 (2012-02-06)
-Minor:
-  * The `Md2Man::Document` module now handles paragraph() nodes and dispatches
-    their content accordingly to hook methods for indented, tagged, and normal
-    paragraphs.  A Redcarpet markdown parser need only include that module and
-    implement those hook methods in order to benefit from md2man's extensions
-    to markdown syntax programmatically.
-Other:
-  * README: mention features; revise markdown; cleanup.
-  * LICENSE: @tanoku created initial Manpage renderer.
-## Version 1.1.0 (2012-02-02)
-Minor:
-  * Add `Md2Man::Document` module for programmatic processing of
-    cross-references to other UNIX manual pages within Redcarpet.
-Other:
-  * README: not all systems support `man -l` option.
-  * gemspec: upgrade to redcarpet 2.1.0.
-  * bundler suggests moving all dev deps into gemspec.
-  * README: fix installation commands for development.
-  * README: simplify project slogan to be more memorable.
-## Version 1.0.2 (2012-01-09)
-Patch:
-  * Blockquote's leading paragraph regexp was not anchored.
-  * Freezing internal constants prevents monkey patching.
-Other:
-  * Upgraded to Binman 3 for better interoperability with Bundler.
-  * Added example input file from the Linux Man Page Howto.
-  * Forgot to change project slogan in the gem package.
-## Version 1.0.1 (2011-12-06)
-Major:
-  * Renamed the project from "redcarpet-manpage" to "md2man".
-    * `RedcarpetManpage::Renderer` is now `Md2Man::Engine`.
-    * `RedcarpetManpage::RENDERER` is now `Md2Man::ENGINE`.
-  * Tagged paragraphs no longer require the first line to begin with italic or
-    bold styling.  All that matters is that the subsequent lines are indented.
-Minor:
-  * Added md2man(1) executable for command-line usage.
-  * Added support for all HTML 4.0 and XHTML 1.0 entities.
-  * Added support for tables, horizontal rules, and more.
-  * Added `Md2Man::Roff` mixin for advanced Redcarpet2 usage.
-  * Improved README with some new and revised documentation.
-Other:
-  * Rewrote entire Markdown to Roff conversion from scratch while doing TDD.
-## Version 0.0.1 (2011-10-13)
-First release! Happy birthday! Woohoo! :-)