stg-new(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| STGIT \| COLOPHON

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

OPTIONS top

       -v, --verbose
           In addition to the names of files that have been changed,
           also show a diff of staged and unstaged changes.

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

       --sign
           Add a "Signed-off-by:" trailer to the end of the message
           using the committer name and email for the trailer value.

       --sign-by VALUE
           Add a "Signed-off-by:" trailer with a custom VALUE to the end
           of the message.

       --ack
           Add an "Acked-by:" trailer to the end of the message using
           the commiter name and email for the trailer value.

       --ack-by VALUE
           Add an "Acked-by:" trailer with a custom VALUE to the end of
           the message.

       --review
           Add a "Reviewed-by:" trailer to the end of the message using
           the commiter name and email for the trailer value.

       --review-by VALUE
           Add a "Reviewed-by:" trailer with custom VALUE to the end of
           the message.

       --no-verify
           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 
       ⟨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 2022-12-17.  (At that time, the
       date of the most recent commit that was found in the repository
       was 2022-01-07.)  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
       man-pages@man7.org

StGit 1.4.dev34+g8254ffb       12/17/2022                     STG-NEW(1)

Pages that refer to this page: stg(1)