[ANN] md2man 5.0.3 - markdown to manpage

md2man is a Ruby library and a set of command-line programs that
convert Markdown into UNIX manual pages and also HTML web pages.

* Code: https://github.com/sunaku/md2man
* Docs: https://sunaku.github.io/md2man/man
* Bugs: https://github.com/sunaku/md2man/issues
* Gems: https://rubygems.org/gems/md2man

## Version 5.0.3 (2016-02-21)

This release fixes a crash, fixes roff bugs, improves CSS styling for
HTML output, and adds a complete manual page example in md2man(5)
documentation.

### Patch:

  * Fix crash upon encountering a sole space ` ` or tab ` ` in a
    codespan.

  * md2man-rake(1): fix sorting of manual pages in `man/index.html`
    listing. Previously, the manual page with longest filename ended up
    at the top.

  * md2man-html(1): emit extraneous top-level heading components that
    come after the known list of "title section date source manual"
    components. Previously, such extraneous components were omitted
    from the output.

  * md2man-html(1): " escaping broke shellwords splitting of .TH
    heading.

  * md2man-html(1): css: hide title, section, manual in top-level
    heading.

  * md2man-html(1): css: center top-level heading; float source right.

  * md2man-roff(1): don't chomp off the newline at end of output.

  * md2man-roff(1): newline before links broke tagged paragraphs.

  * md2man-roff(1): don't squeeze newlines inside code blocks.

### Other:

  * md2man(5): revise paragraph definitions and add complete manpage
    example.

  * Document optional regexp argument to `-h` and `--help` in all
    executables.

  * README: "document format" was moved into md2man(5).

  * README: shorten and move project links to the top.

  * README: add link to pre-rendered example HTML file.

  * md2man-roff(1): we don't emit `.UM` and `.UE` directives anymore.

  * md2man-roff(1): add tests for postprocess document lstrip().

  * README: rename "Demonstration" section to "Examples".

  * README: move EXAMPLE.png screenshot into gh-pages branch.

## Version 5.0.1 (2016-02-13)

### Major:

  * `md2man-html` now puts permalinks _after_ heading text to avoid
    unsightly gaps at the beginning of each heading in text-mode
    browsers like w3m(1).

  * Upgrade to binman version 5.x.x, which is also a major version bump.

### Other:

  * README: use fenced code blocks to get syntax highlighting on GitHub.