STG-NEW(1)                      StGit Manual                      STG-NEW(1)

NAME         top

       stg-new - Create a new, empty patch

SYNOPSIS         top

       stg new [options] [--] [<name>]

DESCRIPTION         top

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

       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

OPTIONS         top

       --author "NAME <EMAIL>"
           Set the author details.

       --authname NAME
           Set the author name.

       --authemail EMAIL
           Set the author email.

       --authdate DATE
           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.)

       --save-template FILE
           Instead of running the command, just write the message template
           to FILE, and exit. (If FILE is "-", write to stdout.)

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

           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.

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
       2018-10-29.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-02-22.)  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                            10/29/2018                       STG-NEW(1)