[PING][MERGE] help topics

[Goffredo Baroncelli]

Hi all,

the enclosed patch was written by me and John Arbash with some modifications 
suggested by Richard Wilbur.

The patch introduces the conecpts of "topic". A topic can be displayed passing 
the topic name to the "bzr help command"
A topic is an argument of the help; examples of topic are: revision specifier, 
command list, basic command. If the patch will be accepted, I will add 
the "transports topic" also...

The idea is to reuse the comment inside the code; a next step should be reuse 
the topics for generating the man page...

Please give me a +1...
Goffredo

You can pull the code from:
  http://goffredo-baroncelli.homelinux.net/bazaar/bzr.dev-repo/bzr-help-topics

You can browse the source from:
  http://goffredo-baroncelli.homelinux.net/bazaar/bazaar-help-topics

-------------------------

$ ./bzr help
Bazaar -- a free distributed version-control tool
http://bazaar-vcs.org/

Basic commands:

  bzr init           makes this directory a versioned branch
  bzr branch         make a copy of another branch

  bzr add            make files or directories versioned
  bzr ignore         ignore a file or pattern
  bzr mv             move or rename a versioned file

  bzr status         summarize changes in working copy
  bzr diff           show detailed diffs

  bzr merge          pull in changes from another branch
  bzr commit         save some or all changes

  bzr log            show history of changes
  bzr check          validate storage

  bzr help init      more help on e.g. init command
  bzr help commands  list all commands
  bzr help topics    list all help topics

$ ./bzr help topics
topics       Topics list
commands     Basic help for all commands
revisionspec Revisions specifier
basic        Basic commands

$ ./bzr help revisionspec

Revision prefix specifier:
--------------------------
  revno: Selects a revision using a number.

    Use an integer to specify a revision in the history of the branch.
    Optionally a branch can be specified. The 'revno:' prefix is optional.
    A negative number will count from the end of the branch (-1 is the
    last revision, -2 the previous one). If the negative number is larger
    than the branch's history, the first revision is returned.
    examples:
      revno:1                   -> return the first revision
      revno:3:/path/to/branch   -> return the 3rd revision of
                                   the branch '/path/to/branch'
      revno:-1                  -> The last revision in a branch.
      -2:http://other/branch    -> The second to last revision in the
                                   remote branch.
      -1000000                  -> Most likely the first revision, unless
                                   your history is very long.


  revid: Selects a revision using the revision id.

    Supply a specific revision id, that can be used to
[...]

-- 
gpg key@ keyserver.linux.it: Goffredo Baroncelli (ghigo) <kreijack at inwind.it>
Key fingerprint = CE3C 7E01 6782 30A3 5B87  87C0 BB86 505C 6B2A CFF9
-------------- next part --------------
A non-text attachment was scrubbed...
Name: help-topic.diff
Type: text/x-diff
Size: 17250 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20061106/89c99e9c/attachment.bin 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20061106/89c99e9c/attachment.pgp