Re: Suggestion: "man git clone"
- From
- H. Peter Anvin <hpa@zytor.com>
- Date
- Aug 21, 2008, 23:07 UTC
- Message-ID
- <48ADF542.9010105@zytor.com>
- In-Reply-To
- <48ADE2FF.4080704@acm.org>
Federico Lucifredi wrote:
Show 18 quoted lines
> Hello HP, > I have seen this in (funnily enough) a project I manage myself, which > has subcommands structured similarly to Git. > > I have looked at options, but so far the current behavior (man foo-bar) > seems the best option for foo's subcommand bar. The alternative, also > acceptable, is a large page with subsections for each command. Sections > (man 1) are used for chapter-like page groupings, not for subsections on > a single command - those would have to be implemented as an additional > layer. > > But, as another participant in the thread has commented, that would not > port to other platforms very quickly (although it would get to Linux and > OS-X promptly, and may eventually make its way into other platforms). > > I am open to ideas, but so far the two options above are better than > anything else that has been so far suggested... >
One option would be to support "man foo bar" showing the page labelled foo-bar. That way you'd get at least a modicum of bass-ackwards compatibility.
However, at some point we have to be willing to do things other platforms won't, or we'll never do anything new...
-hpa