[Python-ideas] Enabling man page structure for python

[Mark Hackett]

On Friday 26 Oct 2012, Andi Albrecht wrote:
> Hi,
> 
> On Thu, Oct 25, 2012 at 7:25 PM, Éric Araujo <merwok at netwok.org> wrote:
> > Hi,
> >
> > See http://bugs.python.org/issue14102 “argparse: add ability to create a
> > man page”
> 
> I've started to work on this issue some time ago. The starting point
> was a man page formatter based on optparse I wrote earlier. But I've
> encountered some problems since the output order of argparse
> formatters differ from what to expect on a man page. IIRC I saw the
> need to do some changes to the way how argparse formatters work but
> unfortunately got interrupted by other work.
> 
> IMO adding a argparse formatter would the probably the right way to
> add man page support. There would even be no need to add this to
> stdlib then.
> 
> Best regards,
> 
> Andi
> 
> > Cheers
> > _______________________________________________
> > Python-ideas mailing list
> > Python-ideas at python.org
> > http://mail.python.org/mailman/listinfo/python-ideas
> 
> _______________________________________________
> Python-ideas mailing list
> Python-ideas at python.org
> http://mail.python.org/mailman/listinfo/python-ideas
> 

I'd still like to see some of the functionality in the code I'd written to 
solve my problem in the parser, if not too much trouble, Andi.

I.e. at least a way to push more things to the man page (to be inserted in the 
page) so that you can add in more things (like external function calls).

It's not obvious to me whether argparse also gives you a synopsis (self-
written --help option).


Cheers.