'\" t
.\"     Title: stg-sink
.\"    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\-SINK" "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-sink \- Send patches deeper down the stack
.SH "SYNOPSIS"
.sp
.nf
\fIstg\fR sink [\-t <target patch>] [\-n] [\-\-] [<patches>]
.fi
.SH "DESCRIPTION"
This is the opposite operation of \fBstg-float\fR(1): move the specified patches down the stack\&. It is for example useful to group stable patches near the bottom of the stack, where they are less likely to be impacted by the push of another patch, and from where they can be more easily committed or pushed\&.

If no patch is specified on command\-line, the current patch gets sunk\&. By default patches are sunk to the bottom of the stack, but the \fI\-\-to\fR option allows one to place them under any applied patch\&.

Sinking internally involves popping all patches (or all patches including <target patch>), then pushing the patches to sink, and then (unless \fI\-\-nopush\fR is also given) pushing back into place the formerly\-applied patches\&.
.SH "OPTIONS"
.PP
\-n, \-\-nopush
.RS 4
Do not push back on the stack the formerly\-applied patches\&. Only the patches to sink are pushed\&.
.RE
.PP
\-t TARGET, \-\-to TARGET
.RS 4
Specify a target patch to place the patches below, instead of sinking them to the bottom of the stack\&.
.RE
.PP
\-k, \-\-keep
.RS 4
Keep the local changes\&.
.RE
.SH "STGIT"
Part of the StGit suite \- see \fBstg\fR(1)