Rechercher une page de manuel
stg-new
Langue: en
Version: 04/04/2008 (debian - 07/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
stg-new - stgdesc:new[]SYNOPSIS
-
stg new [OPTIONS] [name]
DESCRIPTION
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 stgrefresh 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:
- 1.the stgit.editor GIT configuration variable
- 2.the EDITOR environment variable
AUTHOR AND COMMITTER INFORMATION
The author name (resp. email) to record in the StGIT patch is taken from the first of the following sources for the information:- 1.the --authname (resp. --authemail) or --author flag on command-line
- 2.the GIT_AUTHOR_NAME (resp. GIT_AUTHOR_EMAIL) environment variable
- 3.the user.name (resp. user.email) GIT configuration variable
- 1.the --commname (resp. --commemail) flag on command-line
- 2.the GIT_COMMITTER_NAME (resp. GIT_COMMITTER_EMAIL) environment variable
- 3.the user.name (resp. user.email) GIT configuration variable
OPTIONS
--message=<message>, -m <message>
- Use <message> as the patch description.
--showpatch, -s
- Show the patch content in the editor buffer. This flag does nothing if -m is also specified.
--author="Name <email@company>", -a "Name <email@company>"
- Use "Name <email@company>" as the author details. This form sets both authname and authemail.
--authname=<name>
- Use <name> as the author name
--authemail=<email>
- Use <email> as the author e-mail
--authdate=<date>
- Use <date> as the author date
--commname=<name>
- Use <name> as the committer name
--commemail=<email>
- Use <email> as the committer e-mail
FILES
-
<templates>/patchdescr.tmpl
ENVIRONMENT VARIABLES
-
GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_AUTHOR_DATE GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL EDITOR
GIT CONFIGURATION VARIABLES
-
user.name user.email stgit.editor
STGIT
Part of the StGIT suite - see git1[2].NOTES
- 1.
- 1
- git-commit-tree
- 2.
- 1
- stg
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre