Building man-pages for sub-sub-commands

17 views
Skip to first unread message

Hartmut Goebel

unread,
Oct 28, 2012, 6:36:38 AM10/28/12
to sphin...@googlegroups.com
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.go...@crazy-compilers.com               |
| www.crazy-compilers.com | compilers which you thought are impossible |
Reply all
Reply to author
Forward
0 new messages