1STG-NEW(1)                       StGit Manual                       STG-NEW(1)
2
3
4

NAME

6       stg-new - Create a new, empty patch
7

SYNOPSIS

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

DESCRIPTION

12       Create a new, empty patch on the current stack. The new patch is
13       created on top of the currently applied patches, and is made the new
14       top of the stack. Uncommitted changes in the work tree are not included
15       in the patch — that is handled by stg-refresh(1).
16
17       The given name must be unique in the stack, and may only contain
18       alphanumeric characters, dashes and underscores. If no name is given,
19       one is generated from the first line of the patch’s commit message.
20
21       An editor will be launched to edit the commit message to be used for
22       the patch, unless the --message flag already specified one. The
23       patchdescr.tmpl template file (if available) is used to pre-fill the
24       editor.
25

OPTIONS

27       -v, --verbose
28           In addition to the names of files that have been changed, also show
29           a diff of staged and unstaged changes.
30
31       --author "NAME <EMAIL>"
32           Set the author details.
33
34       --authname NAME
35           Set the author name.
36
37       --authemail EMAIL
38           Set the author email.
39
40       --authdate DATE
41           Set the author date.
42
43       -m MESSAGE, --message MESSAGE
44           Use MESSAGE instead of invoking the editor.
45
46       -f FILE, --file FILE
47           Use the contents of FILE instead of invoking the editor. (If FILE
48           is "-", write to stdout.)
49
50       --save-template FILE
51           Instead of running the command, just write the message template to
52           FILE, and exit. (If FILE is "-", write to stdout.)
53
54           When driving StGit from another program, it is often useful to
55           first call a command with --save-template, then let the user edit
56           the message, and then call the same command with --file.
57
58       --sign
59           Add a "Signed-off-by:" trailer to the end of the message using the
60           committer name and email for the trailer value.
61
62       --sign-by VALUE
63           Add a "Signed-off-by:" trailer with a custom VALUE to the end of
64           the message.
65
66       --ack
67           Add an "Acked-by:" trailer to the end of the message using the
68           commiter name and email for the trailer value.
69
70       --ack-by VALUE
71           Add an "Acked-by:" trailer with a custom VALUE to the end of the
72           message.
73
74       --review
75           Add a "Reviewed-by:" trailer to the end of the message using the
76           commiter name and email for the trailer value.
77
78       --review-by VALUE
79           Add a "Reviewed-by:" trailer with custom VALUE to the end of the
80           message.
81
82       --no-verify
83           This option bypasses the commit-msg hook.
84

STGIT

86       Part of the StGit suite - see stg(1)
87
88
89
90StGit 1.5                         01/21/2023                        STG-NEW(1)
Impressum