md2man 1.5.1 → 1.6.0

data/README.markdown

@@ -112,27 +112,6 @@ Mix-in your own renderer:
     engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
     your_roff_output = engine.render(your_markdown_input)
 
-#### Pre-building man pages
-
-Add the following lines to your gemspec:
-
-    s.files += Dir['man/man?/*.?']
-    s.add_development_dependency 'md2man', '~> 1.4'
-
-Add the following 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/man
-
 ### For HTML output
 
 #### At the command line
@@ -177,6 +156,34 @@ Mix-in your own renderer:
     engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
     your_html_output = engine.render(your_markdown_input)
 
+### Building man pages
+
+#### At the command line
+
+    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', '~> 1.4'
+
+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.

data/VERSION.markdown

@@ -1,3 +1,27 @@
+## 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:

data/bin/md2man

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
 
-# MD2MAN 1 2013-03-06 1.5.1
+# MD2MAN 1 2013-03-10 1.6.0
 
 ## NAME
 
@@ -53,7 +53,7 @@ The following [Redcarpet] extensions are enabled while processing markdown(7):
 
 ## SEE ALSO
 
-md2man-html(1)
+md2man-html(1), md2man-rake(1)
 
 [md2man]: https://github.com/sunaku/md2man
 [Redcarpet]: https://github.com/vmg/redcarpet

data/bin/md2man-html

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 =begin =======================================================================
 
-# MD2MAN-HTML 1 2013-03-06 1.5.1
+# MD2MAN-HTML 1 2013-03-10 1.6.0
 
 ## NAME
 

data/bin/md2man-rake

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+=begin =======================================================================
+
+# MD2MAN-RAKE 1 2013-03-10 1.6.0
+
+## NAME
+
+md2man-rake - run rake(1) tasks from md2man(1)
+
+## SYNOPSIS
+
+`md2man-rake` [*OPTION*]... [*TASK*]...
+
+## DESCRIPTION
+
+This program lets you run rake(1) tasks provided by md2man(1) without having
+to create a special file named `Rakefile` that contains the following snippet:
+
+    require 'md2man/rakefile'
+
+If no *TASK* is specified, then the `md2man` task is run by default.
+
+## TASKS
+
+`md2man`
+  Runs the `md2man:man` and `md2man:web` tasks, in that order.
+
+`md2man:man`
+  Builds UNIX manual pages from `*.markdown`, `*.mkd`, and `*.md` files
+  found in or beneath the `man/` subdirectory in your working directory.
+
+`md2man:web`
+  Builds HTML manual pages from `*.markdown`, `*.mkd`, and `*.md` files
+  found in or beneath the `man/` subdirectory in your working directory.
+
+## OPTIONS
+
+`-h`, `--help`
+  Show this help manual.
+
+Run `rake --help` to see more options.
+
+## SEE ALSO
+
+rake(1), md2man(1), markdown(7)
+
+=end =========================================================================
+
+require 'binman'
+BinMan.help
+
+require 'rake'
+Rake.application.init File.basename(__FILE__)
+
+require 'md2man/rakefile'
+task :default => :md2man
+
+Rake.application.top_level

data/lib/md2man/rakefile/style.css

@@ -0,0 +1,74 @@
+@import url('http://twitter.github.com/bootstrap/assets/css/bootstrap.css');
+
+@media all {
+  .manpage h1,
+  .manpage h2,
+  .manpage h3,
+  .manpage h4,
+  .manpage h5,
+  .manpage h6 {
+    margin-top: 1em;
+  }
+
+  /* deactivate external manual page cross-references */
+  a.manpage-reference:not([href]) {
+    color: inherit;
+    text-decoration: none;
+  }
+}
+
+@media screen {
+  body {
+            column-count: auto;
+       -moz-column-count: auto;
+    -webkit-column-count: auto;
+
+            column-width: 78ex;
+       -moz-column-width: 78ex;
+    -webkit-column-width: 78ex;
+
+            column-gap:   none;
+       -moz-column-gap:   none;
+    -webkit-column-gap:   none;
+
+            column-rule:  thin solid Gainsboro;
+       -moz-column-rule:  thin solid Gainsboro;
+    -webkit-column-rule:  thin solid Gainsboro;
+  }
+
+  .manpage {
+    font-family: monospace;
+    max-width: 78ex;
+    margin: auto;
+  }
+
+  .manpage > h1:first-child {
+    margin-top: -5em;
+    font-weight: normal;
+    font-size: smaller;
+    text-align: right;
+  }
+}
+
+@media print {
+  .navbar {
+    display: none;
+  }
+
+  /* improve readability of revealed hyperlink URLs */
+  a:after {
+    font-family: monospace;
+  }
+
+  /* internal links and manual page cross-references */
+  a[href^='#'], a[href^='../man'] {
+    color: inherit;
+    font-weight: bolder;
+    text-decoration: none;
+  }
+
+  /* undo bootstrap's revealing of those hyperlinks */
+  a[href^='#']:after, a[href^='../man']:after {
+    content: none;
+  }
+}

data/lib/md2man/rakefile.rb

@@ -37,10 +37,10 @@ end
 
 #-----------------------------------------------------------------------------
 desc 'Build HTML manual pages from Markdown files in man/.'
-task 'md2man:web' => 'man/index.html'
+task 'md2man:web' => ['man/index.html', 'man/style.css']
 #-----------------------------------------------------------------------------
 
-wrap_html_template = lambda do |title, content|
+wrap_html_template = lambda do |title, content, ascent|
 <<WRAP_HTML_TEMPLATE
 <!DOCTYPE html>
 <html>
@@ -48,62 +48,8 @@ wrap_html_template = lambda do |title, content|
   <meta charset="utf-8" />
   <meta name="generator" content="md2man #{Md2Man::VERSION} https://github.com/sunaku/md2man" />
   <title>#{title}</title>
+  <link rel="stylesheet" href="#{ascent}style.css"/>
   <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
-  <link rel="stylesheet" href="http://twitter.github.com/bootstrap/assets/css/bootstrap.css" />
-  <style type="text/css">
-    @media all {
-      .manpage h1,
-      .manpage h2,
-      .manpage h3,
-      .manpage h4,
-      .manpage h5,
-      .manpage h6 {
-        margin-top: 1em;
-      }
-
-      /* deactivate external manual page cross-references */
-      a.manpage-reference:not([href]) {
-        color: inherit;
-        text-decoration: none;
-      }
-    }
-    @media screen {
-      .manpage {
-        font-family: monospace;
-        max-width: 78ex;
-      }
-
-      .manpage > h1:first-child {
-        margin-top: -5em;
-        font-weight: normal;
-        font-size: smaller;
-        text-align: right;
-      }
-    }
-
-    @media print {
-      .navbar {
-        display: none;
-      }
-
-      /* improve readability of revealed hyperlink URLs */
-      a:after {
-        font-family: monospace;
-      }
-
-      /* internal links and manual page cross-references */
-      a[href^='#'], a[href^='../man'] {
-        color: inherit;
-        font-weight: bolder;
-        text-decoration: none;
-      }
-
-      /* undo bootstrap's revealing of those hyperlinks */
-      a[href^='#']:after, a[href^='../man']:after {
-        content: none;
-      }
-    }
-  </style>
 </head>
 <body>#{content}</body>
 </html>
@@ -122,14 +68,12 @@ end
 
 file 'man/index.html' => webs do |t|
   buffer = ['<div class="container-fluid">']
-  webs.sort.group_by {|web| web.pathmap('%d') }.each do |dir, dir_webs|
-    subdir = dir.sub('man/', '')
+  webs.sort.group_by {|web| web.pathmap('%d').sub('man/', '') }.each do |subdir, dir_webs|
     buffer << %{<h2 id="#{subdir}">#{subdir}</h2>}
-
     dir_webs.each do |web|
       name = parse_manpage_name.call(web)
       info = parse_manpage_info.call(File.read(web))
-      link = %{<a href="../#{web}">#{name}</a>}
+      link = %{<a href="#{web.sub('man/', '')}">#{name}</a>}
       buffer << %{<dl class="dl-horizontal"><dt>#{link}</dt><dd>#{info}</dd></dl>}
     end
   end
@@ -137,10 +81,14 @@ file 'man/index.html' => webs do |t|
   content = buffer.join
 
   title = t.name.pathmap('%X')
-  output = wrap_html_template.call(title, content)
+  output = wrap_html_template.call(title, content, nil)
   File.open(t.name, 'w') {|f| f << output }
 end
 
+file 'man/style.css' => __FILE__.pathmap('%X/style.css') do |t|
+  cp t.prerequisites.first, t.name if t.needed?
+end
+
 mkds.zip(webs).each do |src, dst|
   render_file_task.call src, dst, lambda {|input|
     require 'md2man/html/engine'
@@ -173,6 +121,6 @@ mkds.zip(webs).each do |src, dst|
       '</div>',
     ].join
 
-    wrap_html_template.call title, content
+    wrap_html_template.call title, content, ascent
   }
 end

data/lib/md2man/version.rb

@@ -1,3 +1,3 @@
 module Md2Man
-  VERSION = "1.5.1"
+  VERSION = "1.6.0"
 end

data/man/README.html

@@ -0,0 +1,111 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 1.6.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#man">man</a>/README</span></div></div><div class="container-fluid"><div class="manpage"><h1 id="md2man-markdown-to-manpage">md2man - markdown to manpage</h1><p>md2man is a Ruby library and command-line program that converts <a href="http://daringfireball.net/projects/markdown/">Markdown</a>
+documents into UNIX manual pages (both <a href="http://troff.org">roff</a> and HTML) using <a href="https://github.com/vmg/redcarpet">Redcarpet</a>.</p><h2 id="Features">Features</h2>
+<ul>
+<li><p>Formats tagged and indented paragraphs (see &quot;document format&quot; below).</p></li>
+<li><p>Translates all HTML4 and XHTML1 entities into native <a href="http://troff.org">roff</a> equivalents.</p></li>
+<li><p>Supports markdown extensions such as <a href="http://michelf.com/projects/php-markdown/extra/#table">PHP Markdown Extra tables</a>.</p></li>
+<li><p>Usable from the command line as a filter in a UNIX pipeline.</p></li>
+</ul>
+<h3 id="Demonstration">Demonstration</h3><p>Try converting <a href="https://raw.github.com/sunaku/md2man/master/EXAMPLE.markdown">this example Markdown file</a> into a UNIX manual page:</p><pre><code>md2man EXAMPLE.markdown &gt; EXAMPLE.1
+man -l EXAMPLE.1
+</code></pre><p><img src="https://raw.github.com/sunaku/md2man/master/EXAMPLE.png" alt="Obligatory screenshot of <a class="manpage-reference">md2man(1)</a> in action!"></p><h3 id="Limitations">Limitations</h3><p>At present, md2man does not translate the following <a href="https://github.com/vmg/redcarpet">Redcarpet</a> node types:</p>
+<ul>
+<li><code>block_html</code></li>
+<li><code>strikethrough</code></li>
+<li><code>superscript</code></li>
+<li><code>image</code></li>
+<li><code>raw_html</code></li>
+</ul>
+<p>It issues a warning when it encounters these instead.  Patches are welcome!</p><h2 id="Installation">Installation</h2><pre><code>gem install md2man
+</code></pre><h3 id="Development">Development</h3><pre><code>git clone git://github.com/sunaku/md2man
+cd md2man
+bundle install
+bundle exec md2man --help  # run it directly
+bundle exec rake --tasks   # packaging tasks
+</code></pre><h2 id="Usage">Usage</h2><h3 id="Document-format">Document format</h3><p>md2man extends <a href="http://daringfireball.net/projects/markdown/">Markdown</a> syntax in the following ways, as provisioned in the
+<code>Md2Man::Document</code> module and defined in its derivative <code>Md2Man::Roff</code> module:</p>
+<ul>
+<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 href="http://troff.org">roff</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 href="http://troff.org">roff</a> output.</p></li>
+</ul>
+<p>md2man extends <a href="http://daringfireball.net/projects/markdown/">Markdown</a> semantics in the following ways:</p>
+<ul>
+<li>The first top-level heading (H1) found in the document is emitted as <code>.TH</code>
+in the <a class="manpage-reference">roff(7)</a> output to define the UNIX manual page&#39;s header and footer.
+Any subsequent top-level headings (H1) are treated as second-level (H2).</li>
+</ul>
+<h3 id="For-roff-output">For <a href="http://troff.org">roff</a> output</h3><h4 id="At-the-command-line">At the command line</h4><pre><code>md2man --help
+</code></pre><h4 id="Inside-a-Ruby-script">Inside a Ruby script</h4><p>Use the default renderer:</p><pre><code>require 'md2man'
+
+your_roff_output = Md2Man::ENGINE.render(your_markdown_input)
+</code></pre><p>Build your own renderer:</p><pre><code>require 'md2man'
+
+engine = Redcarpet::Markdown.new(Md2Man::Engine, your_options_hash)
+your_roff_output = engine.render(your_markdown_input)
+</code></pre><p>Define your own renderer:</p><pre><code>require 'md2man'
+
+class YourManpageRenderer &lt; Md2Man::Engine
+  # ... your stuff here ...
+end
+
+engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
+your_roff_output = engine.render(your_markdown_input)
+</code></pre><p>Mix-in your own renderer:</p><pre><code>require 'md2man'
+
+class YourManpageRenderer &lt; 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)
+</code></pre><h3 id="For-HTML-output">For HTML output</h3><h4 id="At-the-command-line">At the command line</h4><pre><code>md2man-html --help
+</code></pre><h4 id="Inside-a-Ruby-script">Inside a Ruby script</h4><p>Use the default renderer:</p><pre><code>require 'md2man/html/engine'
+
+your_html_output = Md2Man::HTML::ENGINE.render(your_markdown_input)
+</code></pre><p>Build your own renderer:</p><pre><code>require 'md2man/html/engine'
+
+engine = Redcarpet::Markdown.new(Md2Man::HTML::Engine, your_options_hash)
+your_html_output = engine.render(your_markdown_input)
+</code></pre><p>Define your own renderer:</p><pre><code>require 'md2man/html/engine'
+
+class YourManpageRenderer &lt; Md2Man::HTML::Engine
+  # ... your stuff here ...
+end
+
+engine = Redcarpet::Markdown.new(YourManpageRenderer, your_options_hash)
+your_html_output = engine.render(your_markdown_input)
+</code></pre><p>Mix-in your own renderer:</p><pre><code>require 'md2man/html'
+
+class YourManpageRenderer &lt; 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)
+</code></pre><h3 id="Building-man-pages">Building man pages</h3><h4 id="At-the-command-line">At the command line</h4><pre><code>md2man-rake --help
+</code></pre><h4 id="Inside-a-Ruby-script">Inside a Ruby script</h4><p>Add this snippet to your gemspec file:</p><pre><code>s.files += Dir['man/man?/*.?']            # UNIX man pages
+s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
+s.add_development_dependency 'md2man', '~&gt; 1.4'
+</code></pre><p>Add this line to your Rakefile:</p><pre><code>require 'md2man/rakefile'
+</code></pre><p>You now have a <code>rake md2man</code> task that builds manual pages from Markdown files
+(with &quot;.markdown&quot;, &quot;.mkd&quot;, or &quot;.md&quot; extension) inside <code>man/man*/</code> directories.
+There are also sub-tasks to build manual pages individually as <a href="http://troff.org">roff</a> or HTML.</p><p>If you&#39;re using Bundler, this task also hooks into Bundler&#39;s gem packaging
+tasks and ensures that your manual pages are built for packaging into a gem:</p><pre><code>bundle exec rake build
+gem spec pkg/*.gem | fgrep man/
+</code></pre><h2 id="License">License</h2><p>Released under the ISC license.  See the LICENSE file for details.</p></div></div></body>
+</html>

data/man/README.markdown

@@ -0,0 +1,195 @@
+# md2man - markdown to manpage
+
+md2man is a Ruby library and command-line program that converts [Markdown]
+documents into UNIX manual pages (both [roff] and HTML) using [Redcarpet].
+
+## 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 pipeline.
+
+### Demonstration
+
+Try converting [this example Markdown file][example] into a UNIX manual page:
+
+    md2man EXAMPLE.markdown > EXAMPLE.1
+    man -l EXAMPLE.1
+
+![Obligatory screenshot of md2man(1) in action!](
+https://raw.github.com/sunaku/md2man/master/EXAMPLE.png)
+
+### Limitations
+
+At present, md2man does not translate the following [Redcarpet] node types:
+
+  * `block_html`
+  * `strikethrough`
+  * `superscript`
+  * `image`
+  * `raw_html`
+
+It issues a warning when it encounters these instead.  Patches are welcome!
+
+## Installation
+
+    gem install md2man
+
+### Development
+
+    git clone git://github.com/sunaku/md2man
+    cd md2man
+    bundle install
+    bundle exec md2man --help  # run it directly
+    bundle exec rake --tasks   # packaging tasks
+
+## Usage
+
+### Document format
+
+md2man extends [Markdown] syntax in the following ways, as provisioned in the
+`Md2Man::Document` module and defined in its derivative `Md2Man::Roff` module:
+
+  * Paragraphs whose lines are all uniformly indented by two spaces are
+    considered to be "indented paragraphs".  They are unindented accordingly
+    before emission as `.IP` in the [roff] output.
+
+  * 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 `.TP` in the [roff] output.
+
+md2man extends [Markdown] semantics in the following ways:
+
+  * The first top-level heading (H1) found in the document is emitted as `.TH`
+    in the roff(7) output to define the UNIX manual page's header and footer.
+    Any subsequent top-level headings (H1) are treated as second-level (H2).
+
+### For [roff] output
+
+#### At the command line
+
+    md2man --help
+
+#### Inside a Ruby script
+
+Use the default renderer:
+
+    require 'md2man'
+
+    your_roff_output = Md2Man::ENGINE.render(your_markdown_input)
+
+Build your own renderer:
+
+    require 'md2man'
+
+    engine = Redcarpet::Markdown.new(Md2Man::Engine, your_options_hash)
+    your_roff_output = engine.render(your_markdown_input)
+
+Define your own renderer:
+
+    require 'md2man'
+
+    class YourManpageRenderer < Md2Man::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'
+
+    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
+
+    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
+
+    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', '~> 1.4'
+
+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