stg-sink(1) — Linux manual page


STG-SINK(1)                   StGit Manual                   STG-SINK(1)

NAME         top

       stg-sink - Move patches deeper in the stack

SYNOPSIS         top

       stg sink [OPTIONS] [patch]...

DESCRIPTION         top

       Move the specified patches down the stack.

       If no patch is specified on the command line, the current
       (topmost) patch is sunk. By default, patches are sunk to the
       bottom of the stack, but the --above or --below (alias --to)
       options may be used to place them above or below any applied

       Internally, sinking involves popping all patches to the bottom
       (or to the target patch if --above or --below is used), then
       pushing the patches to sink, and then, unless --nopush is
       specified, pushing back any other formerly applied patches.

       Sinking may be useful, for example, to group stable patches at
       the bottom of the stack where they less likely to be impacted by
       the push of another patch, and from where they can be more easily
       committed or pushed to another repository.

OPTIONS         top

       -n, --nopush
           Do not push any formerly applied patches after sinking. Only
           the patches to sink are pushed.

       -t <target>, --below=<target>, --to=<target>
           Sink patches below <target> patch.

           Specified patches are placed below <target> instead of at the
           bottom of the stack.

       -T <target>, --above=<target>
           Sink patches above <target> patch.

           Specified patches are placed above <target> instead of at the
           bottom of the stack.

       -k, --keep
           Keep the local changes

           Instead of using the current time as the committer date, use
           the author date of the commit as the committer date.

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 2023-12-22.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-12-17.)  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 2.4.1                    12/22/2023                    STG-SINK(1)

Pages that refer to this page: stg(1)