1STG-NEW(1) StGit Manual STG-NEW(1)
2
3
4
6 stg-new - Create a new, empty patch
7
9 stg new [options] [--] [<name>]
10
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
27 --author "NAME <EMAIL>"
28 Set the author details.
29
30 --authname NAME
31 Set the author name.
32
33 --authemail EMAIL
34 Set the author email.
35
36 --authdate DATE
37 Set the author date.
38
39 -m MESSAGE, --message MESSAGE
40 Use MESSAGE instead of invoking the editor.
41
42 -f FILE, --file FILE
43 Use the contents of FILE instead of invoking the editor. (If FILE
44 is "-", write to stdout.)
45
46 --save-template FILE
47 Instead of running the command, just write the message template to
48 FILE, and exit. (If FILE is "-", write to stdout.)
49
50 When driving StGit from another program, it is often useful to
51 first call a command with --save-template, then let the user edit
52 the message, and then call the same command with --file.
53
54 --sign
55 Add a "Signed-off-by:" to the end of the patch.
56
57 --ack
58 Add an "Acked-by:" line to the end of the patch.
59
60 --review
61 Add a "Reviewed-by:" line to the end of the patch.
62
63 --no-verify
64 This option bypasses the commit-msg hook.
65
67 Part of the StGit suite - see stg(1)
68
69
70
71StGit 0.23 01/27/2021 STG-NEW(1)