STG-SINK(1)

πŸ’… STG-SINK(1) β€” the StGit Manual, but make it cute ✨

okay so bestie, welcome to stg-sink, which is the StGit manual page for sink β€” like, the whole StGit suite's manual, page 1, section 1 πŸ’–


✨ NAME ✨

stg-sink β€” move patches deeper in the stack 🫢


πŸŽ€ SYNOPSIS πŸŽ€

stg sink [OPTIONS] [patch]...

πŸ¦‹ DESCRIPTION πŸ¦‹

Move the specified patches down the stack. That's it, that's the vibe πŸ’…

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 patch.

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. Like, it's doing the most so you don't have to 😭

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. lowkey iconic organizational behavior fr fr πŸ‘‘


🌸 OPTIONS 🌸

  • -n, --nopush β€” Do not push any formerly applied patches after sinking. Only the patches to sink are pushed. no tagalongs, periodt πŸ™ˆ
  • -t <target>, --below=<target>, --to=<target> β€” Sink patches below <target> patch.
  • -T <target>, --above=<target> β€” Sink patches above <target> patch.
  • -k, --keep β€” Keep the local changes πŸ’œ
  • --committer-date-is-author-date β€” Instead of using the current time as the committer date, use the author date of the commit as the committer date. it's giving consistency ✨
wait, the -t one has a whole extra paragraph bestie, don't scroll past it: Specified patches are placed below <target> instead of at the bottom of the stack.
and -T gets one too πŸŽ€: Specified patches are placed above <target> instead of at the bottom of the stack.

🌈 STGIT 🌈

Part of the StGit suite β€” see stg(1) 🧚


and that's the whole page, bestie!! you ate that πŸ’…

cute lil sign-off: this was StGit 2.7.0, dated 10/17/2026 β€” catch you in the next manpage πŸ“πŸ’–

πŸ“¦ where this page comes from