Version 5.1.2 (2018-02-04)

Patch:

• md2man-roff(1): fix ordered list numbering for nested list items.

  Thanks to thinca for contributing this patch in pull request #27:
  #27

Other:

• Upgrade to Rouge 3.0 for syntax highlighting.

• Upgrade to Rake 12.0 for build automation.

Version 5.1.1 (2016-03-04)

Patch:

• md2man-rake(1): "man" was both a folder name and a task name.

  rake/invocation_chain.rb:16:in `append': Circular dependency detected:
  TOP => md2man:man => man/test_markdown => man => md2man:man (RuntimeError)
  

  Thanks to David Dieulivol (@born4new) for reporting this issue:
  #22

Version 5.1.0 (2016-02-28)

Minor:

• md2man-html(1): add syntax highlighting to fenced code blocks.

• md2man-rake(1): add directory name to README and "man/index" title.

  Fallback to adding directory name for standalone titles, such as "README"
  and "man/index", so that users know what project those manuals belong to.

• md2man-rake(1): allow running task names without namespace.

  You can now run md2man-rake man instead of md2man-rake md2man:man,
  and similarly md2man-rake web instead of md2man-rake md2man:web.

Patch:

• Clarify optionalness of PATTERN in --help option.

• md2man(5): paragraph types reflect .PP, .TP, .IP.

• Link to Markdown website instead of markdown(7).

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.

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:

• Cross references are no longer expanded inside code spans and code blocks.

  Thanks to Mathias Panzenböck for reporting this issue in GH-19:
  #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:
  #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).