On Mon, Feb 1, 2010 at 12:14, Alexis Layton <alex@...> wrote:
> David Goodger wrote:
>> On Fri, Jan 29, 2010 at 20:16, Alexis Layton <alex@...> wrote:
>>> I'm writing some documentation of a typical command-line application,
>>> and I was wondering how to get the
>>> option list to handle positional parameters.
>>> is there any way to extend the option list to do this?
>> No, option lists are just for options. Positional parameters must be
>> documented separately, using e.g. a definition list or a field list
> I guess this is an enhancement request then, since I strongly believe
> these should be documented together rather than separately. I realize
> you would need some sort of explicit marker which is maybe anathema to
> the ReST philosophy....
If you're serious about this, you'll have to champion it, get people
interested enough to make it happen. Gather and present some evidence.
Find examples in the wild (I know of none). File a feature request on
What should the input and output be? Are you a programmer? If so, work
up a patch. If not, you'll need to get a developer interested enough
to implement the change.
Right now, I have zero interest in pursuing this. So you have your
work cut out for you. :-)
David Goodger <http://python.net/~goodger>