Manpage: missing sections

[volans-]

I cannot find manpage sections listed in the source code at _construct_manpage_specific_structure() in the generated manpage. Am I missing some configuration by any chance?

The generated manpage has those sections:

NAME
POSITIONAL ARGUMENTS
NAMED ARGUMENTS
AUTHOR
COPYRIGHT

While from the source code and usual best practices in manpage generation I was expecting to have:

• a SYNOPSIS section with the synopsis of the command
• a DESCRIPTION section with the description taken from the argparse parser
• an OPTION section with what is now in the NAMED ARGUMENTS and maybe POSITIONAL ARGUMENTS too? I'm not sure if usually the positional arguments are documented inside the DESCRIPTION section.

I'm not familiar with docutils library, so I'm not sure if those were meant to be subtitles inside the section, but the final results doesn't seems to follow best practices and the docstring in the code.

Versions used:

Sphinx==1.6.4
sphinx-argparse==0.2.1
docutils==0.14
``

[hstock]

Did you add the :manpage: parameter?

I had to add it like so:

ots manpage
===========

.. argparse::
   :module: otsclient.args
   :func: make_common_options_arg_parser
   :prog: ots
   :manpage: 

Seems this is missing from the docs.

[rite2hhh]

@hstock, after adding the :manpage: sub directive, My arguments are not documented anymore.

[hstock]

Currently not working on the project that needed this - but I'll get back to this for debian packaging of opentimestamps. (I am not directly involved in sphinx-argparse)

[paravoid]

I bumped into this bug while trying to generate tox's manpage using sphinx-argparse. I suspect the culprit is the usage of action groups in combination with a bug in the code. I think in this section of the code:
https://github.com/ribozz/sphinx-argparse/blob/178672cd5c846440ff7ecd695e3708feea13e4b4/sphinxarg/ext.py#L310-L312
…the second line should read if 'options' in action_group instead, no?