[PATCH] qseries: add --edit option for editing series file for current queue

Greg Ward greg-hg at gerg.ca
Wed Jun 16 21:20:42 CDT 2010


On Wed, Jun 16, 2010 at 12:10 PM, Mads Kiilerich <mads at kiilerich.com> wrote:
> +    """print the content of the series file
> +
> +    --edit is a shortcut for opening the series file for the current series in an
> +    editor. Changes must be made with great care but can for example be used to
> +    reorder patches - assuming that they are sufficiently commutative."""

How about:

  --edit is a shortcut for opening the series file for the current series in an
  editor. The main reason for this is to reorder patches, not to add or remove
  them.  (To add patches, use qimport or qnew; to delete patches, use qdelete.)
  Be sure to respect the dependencies between patches when you reorder: if
  patch B depends on patch A, then putting B first will most likely
result in a broken
  patch series that fails to apply.

It's a bit wordy, but a lot more explicit.  It's dead obvious to you
and me, but there are plenty of programmers out there who get very
befuddled by *.rej files.  They need all the help we can give them.
(Probably starting out with, "don't use MQ unless you really need it
and understand what you're getting into".  ;-)

Greg


More information about the Mercurial-devel mailing list