From: Suraj Kurapati Date: 2011-10-15T07:01:59+09:00 Subject: Re: [ANN] binman 1.0.0 ------=_Part_26_30670401.1318629715760 Content-Type: multipart/alternative; boundary="----=_Part_27_13360519.1318629715760" ------=_Part_27_13360519.1318629715760 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On Friday, October 14, 2011 1:42:07 AM UTC-7, botp wrote: > > On Fri, Oct 14, 2011 at 1:21 PM, Suraj N. Kurapati wrote: > > binman - UNIX man pages for Ruby bin/ scripts > > hmm, interesting. now, if only i could combine this w ara's main... > You could write a Rake task to mimic binman's Rake task which pre-compiles man page files from bin/ scripts. Instead of parsing the leading comment header from your bin/ scripts, like binman does, run your main-using bin/ scripts to grab their help output, convert that to Markdown, and then use BinMan::conv() to convert them into Roff and save them in the man/ directory. The idea is that, if you can ship a man/ directory containing pre-built man page files in your gem or release package, then binman can show them directly to the user when they ask for --help. ------=_Part_27_13360519.1318629715760 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Friday, October 14, 2011 1:42:07 AM UTC-7, botp wrote:
On Fri, Oct 14, 2011 at 1:21 PM, Suraj N. Kurap= ati wrote:
>          binman - UNIX man page= s for Ruby bin/ scripts

hmm, interesting. now, if only i could combine th= is w ara's main...

You could write a Rake task to mimi= c binman's Rake task which pre-compiles man page files from bin/ scripts. &= nbsp;Instead of parsing the leading comment header from your bin/ scripts, = like binman does, run your main-using bin/ scripts to grab their help outpu= t, convert that to Markdown, and then use BinMan::conv() to convert them in= to Roff and save them in the man/ directory. 

The idea is that, if you can ship a man/ directory containing pre-built ma= n page files in your gem or release package, then binman can show them dire= ctly to the user when they ask for --help. ------=_Part_27_13360519.1318629715760-- ------=_Part_26_30670401.1318629715760--