stg-new(1)
NAME
stg-new - Create a new patch at top of the stack
SYNOPSIS
stg new [OPTIONS] [patchname] [-- <path>…]
DESCRIPTION
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.
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
- -r
- --refresh
-
Refresh the new patch with changes from work tree. New patches are empty by default, but with this option the new patch will capture outstanding changes in the work tree as if "stg refresh" was run. Use "--index" to refresh from the index instead of the work tree.
- -i
- --index
-
Instead of refreshing the patch with the current contents of the worktree, use the current contents of the index.
- -F
- --force
-
Force refresh with staged and unstaged changes.
By default, if there are staged changes in the index along with unstaged changes in the work tree, the command will abort. This option forces the command to proceed using both the staged and unstaged changes.
- -s
- --submodules
-
Include submodules in patch content
- --no-submodules
-
Exclude submodules in patch content
- -e
- --edit
-
Invoke editor for patch description
- -d
- --diff
-
Show diff when editing patch description
- -m <message>
- --message=<message>
-
Use message instead of invoking the editor
- -f <path>
- --file=<path>
-
Use the contents of file instead of invoking the editor. Use "-" to read from stdin.
- --no-verify
-
Disable commit-msg hook
- --signoff[=<value>]
-
Add "Signed-off-by" message trailer.
The value is optional and defaults to the committer name and email. This option may be provided multiple times.
- --ack[=<value>]
-
Add "Acked-by" message trailer.
The value is optional and defaults to the committer’s name and email. This option may be provided multiple times.
- --review[=<value>]
-
Add "Reviewed-by" message trailer.
The value is optional and defaults to the committer’s name and email. This option may be provided multiple times.
- --author=<name-and-email>
-
Set the author "name <email>"
- --authname=<name>
-
Set the author name
- --authemail=<email>
-
Set the author email
- --authdate=<date>
-
Set the date the patch was authored.
Use "now" to use the current time and date.
- --save-template=<file>
-
Instead of running the command, just write the patch description to FILE, and exit. (If FILE is "-", write to stdout.)
When driving StGit from another program, it may be useful to first call a command with --save-template, then let the user edit the message, and then call the same command with --file.
StGit
Part of the StGit suite - see stg(1)