stg-new - stgdesc:new[]
Create a new, empty patch with the given <name> 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. The local changes in the working tree are not included in the patch. A stg refresh(1) command is needed for this.
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 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 is used if available to pre-fill the editor. The editor to use is taken from the first of the following sources of information, and defaults to vi:
the stgit.editor GIT configuration variable
the EDITOR environment variable
The message and other GIT commit attributes can be modified later using stg refresh(1).
The author name (resp. email) to record in the StGIT patch is taken from the first of the following sources for the information:
the --authname (resp. --authemail) or --author flag on command-line
the GIT_AUTHOR_NAME (resp. GIT_AUTHOR_EMAIL) environment variable
the user.name (resp. user.email) GIT configuration variable
Similarly, the committer name (resp. email) is taken from the first of the following sources:
the --commname (resp. --commemail) flag on command-line
the GIT_COMMITTER_NAME (resp. GIT_COMMITTER_EMAIL) environment variable
the user.name (resp. user.email) GIT configuration variable
The GIT commit generated by stg refresh(1) will use these informations when available. If one of them is not available, GIT will pick the value from your machine's configuration at that time, as described in git-commit-tree(1).
Use <message> as the patch description.
Show the patch content in the editor buffer. This flag does nothing if -m is also specified.
Use "Name <email@company>" as the author details. This form sets both authname and authemail.
Use <name> as the author name
Use <email> as the author e-mail
Use <date> as the author date
Use <name> as the committer name
Use <email> as the committer e-mail
<templates>/patchdescr.tmpl
GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_AUTHOR_DATE GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL EDITOR
user.name user.email stgit.editor
Part of the StGIT suite - see stg(1).