stg-coalesce(1)
===============

NAME
----
stg-coalesce - Coalesce two or more patches into one

SYNOPSIS
--------
[verse]
'stg' coalesce [options] <patches>

DESCRIPTION
-----------

Coalesce two or more patches, creating one big patch that contains all
their changes.

If there are conflicts when reordering the patches to match the order
you specify, you will have to resolve them manually just as if you had
done a sequence of pushes and pops yourself.

OPTIONS
-------
-n NAME::
--name NAME::
        Name of coalesced patch.

-m MESSAGE::
--message MESSAGE::
        Use MESSAGE instead of invoking the editor.

-f FILE::
--file FILE::
        Use the contents of FILE instead of invoking the editor.
        (If FILE is "-", write to stdout.)

--save-template FILE::
        Instead of running the command, just write the message
        template to FILE, and exit. (If FILE is "-", write to
        stdout.)
+
When driving StGit from another program, it is often
useful to first call a command with '--save-template',
then let the user edit the message, and then call the
same command with '--file'.

StGit
-----
Part of the StGit suite - see manlink:stg[1]
