STG-UNCOMMIT(1)                 StGit Manual                 STG-UNCOMMIT(1)

NAME         top

       stg-uncommit - Turn regular git commits into StGit patches

SYNOPSIS         top

       stg uncommit [--] <patch-name-1> [<patch-name-2> ...]
       stg uncommit -n NUM [--] [<prefix>]
       stg uncommit -t <committish> [-x]

DESCRIPTION         top

       Take one or more git commits at the base of the current stack and
       turn them into StGIT patches. The new patches are created as applied
       patches at the bottom of the stack. This is the opposite of stg

       By default, the number of patches to uncommit is determined by the
       number of patch names provided on the command line. First name is
       used for the first patch to uncommit, i.e. for the newest patch.

       The -n/--number option specifies the number of patches to uncommit.
       In this case, at most one patch name may be specified. It is used as
       prefix to which the patch number is appended. If no patch names are
       provided on the command line, StGIT automatically generates them
       based on the first line of the patch description.

       The -t/--to option specifies that all commits up to and including the
       given commit should be uncommitted.

       Only commits with exactly one parent can be uncommitted; in other
       words, you can’t uncommit a merge.

OPTIONS         top

       -n NUMBER, --number NUMBER
           Uncommit the specified number of commits.

       -t TO, --to TO
           Uncommit to the specified commit.

       -x, --exclusive
           Exclude the commit specified by the --to option.

STGIT         top

       Part of the StGit suite - see stg(1)

COLOPHON         top

       This page is part of the stgit (Stacked Git) project.  Information
       about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, see
       ⟨⟩.  This page was obtained from the
       project's upstream Git repository ⟨⟩ on
       2018-10-29.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-02-22.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

StGit                            10/29/2018                  STG-UNCOMMIT(1)