Hello.

I'm seeking support for building man-pages.

I have several sub-commands, sharing the same sub-sub-commands, eg. `git
flow feature start`, `git flow release start`. So the man-pages have
many overlapping parts, only differentiating in some words.

1) Is there some way to "template" the man-page? rst |WORD| substitution
does not help, since |WORD| is contained within ``...`` (inline literal).

2) Is there some best-practice guide for how-to set up the man-pages?
I'm currently using this pattern:

    ==========================
    git flow |BRANCH|
    ==========================

    .. contents::
        :depth: 1

    .. include:: _subcmd-list.rst
    .. include:: _subcmd-start.rst

Any hints?

-- 
Regards
Hartmut Goebel

| Hartmut Goebel          | h.goe...@crazy-compilers.com               |
| www.crazy-compilers.com | compilers which you thought are impossible |

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to