[PATCH] help for extensions

Vadim Gelfer vadim.gelfer at gmail.com
Wed May 10 00:58:50 CDT 2006


this patch adds new command called "hg extensions" that prints
information about extensions. with no args, it lists extensions. with
arg, it prints info about one extension.

also "hg help" tries to print help on extension if command name is not
found. so e.g. "hg ext mq" and "hg help mq" do same thing.

i added description to mq extension as example.

please let me know if this is ok to go in crew now.

here is some output:

 $ hg extensions
enabled extensions:
 hbisect     (no description provided)
 hct         (no description provided)
 hgk         (no description provided)
 mq          Mercurial Queues - patch queues for Mercurial
 patchbomb   (no description provided)

$ hg help mq
mq extension: Mercurial Queues - patch queues for Mercurial

description:

This extension allows you to manage a series of patches as a stack of
changesets.  To start using mq, use the qinit command, which creates a
.hg/patches directory where your patches will be stored.

You can apply (qpush) and unapply (qpop) patches within the stack,
which causes a changeset to be created or removed for each patch.  Mq
commands that operate on patches usually operate on the topmost
applied patch in the stack.

To add a new patch as the new top of stack, use the qnew command.
This creates a changeset to go along with the patch.  To refresh the
patch at the top of stack to include the changes in the working
directory, use the qrefresh command.  This also updates the changeset.
To add or remove files in the patch, use the normal add and remove
commands, then qrefresh.

To see the stack/series of patches you have created, use the qseries
command.  To see how many patches you currently have applied, use the
qstatus command.

If you want to merge changes from another branch into a repository
that has patches applied, you should first qpop all patches, then merge
or update, and finally qpush again.

list of commands:

 qapplied     print the patches already applied
 qcommit      (No help text available)
 qdelete      remove a patch from the series file
 qdiff        diff of the current patch
 qimport      import a patch
 qinit        init a new queue repository
 qnew         create a new patch
 qnext        print the name of the next patch
 qpop         pop the current patch off the stack
 qprev        print the name of the previous patch
 qpush        push the next patch onto the stack
 qrefresh     update the current patch
 qrestore     restore the queue state saved by a rev
 qsave        save current queue state
 qseries      print the entire series file
 qtop         print the name of the current patch
 qunapplied   print the patches not yet applied
 qversion     print the version number
 strip        strip a revision and all later revs on the same branch
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ext.patch
Type: text/x-patch
Size: 19174 bytes
Desc: not available
Url : http://www.selenic.com/pipermail/mercurial/attachments/20060509/00a9c0f1/ext-0001.bin


More information about the Mercurial mailing list