Create a new, empty patch on the current stack. The new patch is
created on top of the currently applied patches, and is made the
new top of the stack. Uncommitted changes in the work tree are
not included in the patch — that is handled by stg-refresh(1).
The given name must be unique in the stack, and may only contain
alphanumeric characters, dashes and underscores. If no name is
given, one is generated from the first line of the patch’s commit
An editor will be launched to edit the commit message to be used
for the patch, unless the --message flag already specified one.
The patchdescr.tmpl template file (if available) is used to
pre-fill the editor.
--author "NAME <EMAIL>"
Set the author details.
Set the author name.
Set the author email.
Set the author date.
-m MESSAGE, --message MESSAGE
Use MESSAGE instead of invoking the editor.
-f FILE, --file FILE
Use the contents of FILE instead of invoking the editor. (If
FILE is "-", write to stdout.)
Instead of running the command, just write the message
template to FILE, and exit. (If FILE is "-", write to
When driving StGit from another program, it is often useful
to first call a command with --save-template, then let the
user edit the message, and then call the same command with
Add a "Signed-off-by:" to the end of the patch.
Add an "Acked-by:" line to the end of the patch.
Add a "Reviewed-by:" line to the end of the patch.
This option bypasses the commit-msg hook.
This page is part of the stgit (Stacked Git) project.
Information about the project can be found at
⟨http://www.procode.org/stgit/⟩. If you have a bug report for
this manual page, see ⟨http://www.procode.org/stgit/⟩. This page
was obtained from the project's upstream Git repository
⟨http://repo.or.cz/stgit.git⟩ on 2021-04-01. (At that time, the
date of the most recent commit that was found in the repository
was 2021-02-15.) 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 04/01/2021 STG-NEW(1)