Binman 0.1.1

binman - UNIX man pages for Ruby bin/ scripts
GitHub - sunaku/binman: 🤓 Creates manual pages from header comments

What is it?

binman produces UNIX man pages for your Ruby bin/ scripts using
markdown(7), roff(7), Redcarpet2 for conversion thereof, and man(1).

Here is an obligatory screen-shot of binman in action:

Here is an example bin/ script to help you get started:

What is new?

New features:

  • now supports embedded document (=begin … =end)
    comments also. See binman(1) for the new, complete description
    of leading comment headers.

Bug fixes:

  • Ignore encoding comment line after shebang line.

  • roff: fix first paragraphs inside list items.


  • gemspec: build man page files before building gem.

  • binman: raise error and suggest --help option.

  • README: add link to example of binman markdown.

  • README: add obligatory screen-shot! >:-)