'\" t
.\"     Title: stg-uncommit
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 03/26/2014
.\"    Manual: StGit Manual
.\"    Source: StGit
.\"  Language: English
.\"
.TH "STG\-UNCOMMIT" "1" "03/26/2014" "StGit" "StGit Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
stg-uncommit \- Turn regular git commits into StGit patches
.SH "SYNOPSIS"
.sp
.nf
\fIstg\fR uncommit [\-\-] <patch\-name\-1> [<patch\-name\-2> \&...]
\fIstg\fR uncommit \-n NUM [\-\-] [<prefix>]
\fIstg\fR uncommit \-t <committish> [\-x]
.fi
.SH "DESCRIPTION"
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 \fIstg commit\fR\&.

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\(cqt uncommit a merge\&.
.SH "OPTIONS"
.PP
\-n NUMBER, \-\-number NUMBER
.RS 4
Uncommit the specified number of commits\&.
.RE
.PP
\-t TO, \-\-to TO
.RS 4
Uncommit to the specified commit\&.
.RE
.PP
\-x, \-\-exclusive
.RS 4
Exclude the commit specified by the \-\-to option\&.
.RE
.SH "STGIT"
Part of the StGit suite \- see \fBstg\fR(1)