RFC: show the revision specifier on help

[Matthieu Moy]

Goffredo Baroncelli <kreijack at alice.it> writes:

> Hi all,
>
> with the enclosed patch, the "bzr help -l" command shows info about the 
> revision specifier.

Indeed, I'd prefer having some "help topics" than putting this at the
end of "help -l". Probably the revisionspec are not the only thing
which are not a command, and would deserve some doc in "bzr help".

So, I'd rather see stg like

$ bzr help revisionspec
[...]

with a pointer to it in "bzr help".

Help topics could also be groups of commands, like

$ bzr help basic-commands
$ bzr help branching
$ ...

At the moment, "bzr help" is too short (doesn't list pull, push and
remove for example), and "bzr help -l" is too long, so we need some
intermediate classifications of commands.
       
> The info is get from the comment of the RevisionSpec subclass.

See also http://bazaar-vcs.org/BzrRevisionSpec

-- 
Matthieu