stg-edit(1) [debian man page]

STG-EDIT(1)							   StGit Manual 						       STG-EDIT(1)

NAME

       stg-edit - edit a patch description or diff

SYNOPSIS

       stg edit [options] [<patch>]

DESCRIPTION

       Edit the description and author information of the given patch (or the current patch if no patch name was given). With --diff, also edit
       the diff.

       The editor is invoked with the following contents:

	   From: A U Thor <author@example.com>
	   Date: creation date

	   Patch description

       If --diff was specified, the diff appears at the bottom, after a separator:

	   ---

	   Diff text

       Command-line options can be used to modify specific information without invoking the editor. (With the --edit option, the editor is invoked
       even if such command-line options are given.)

       If the patch diff is edited but does not apply, no changes are made to the patch at all. The edited patch is saved to a file which you can
       feed to "stg edit --file", once you have made sure it does apply.

OPTIONS

       -d, --diff
	   Edit the patch diff.

       -e, --edit
	   Invoke interactive editor.

       --sign
	   Add a "Signed-off-by:" to the end of the patch.

       --ack
	   Add an "Acked-by:" line to the end of the patch.

       -m MESSAGE, --message MESSAGE
	   Use MESSAGE instead of invoking the editor.

       -f FILE, --file FILE
	   Use the contents of FILE instead of invoking the editor. (If FILE is "-", write to stdout.)

       --save-template FILE
	   Instead of running the command, just write the message template to FILE, and exit. (If FILE is "-", write to stdout.)

	   When driving StGit from another program, it is often useful to first call a command with --save-template, then let the user edit the
	   message, and then call the same command with --file.

       --author "NAME <EMAIL>"
	   Set the author details.

       --authname NAME
	   Set the author name.

       --authemail EMAIL
	   Set the author email.

       --authdate DATE
	   Set the author date.

       -O OPTIONS, --diff-opts OPTIONS
	   Extra options to pass to "git diff".

STGIT

       Part of the StGit suite - see linkman:stg[1]

StGit								    03/13/2012							       STG-EDIT(1)

STG-MAIL(1)							   StGit Manual 						       STG-MAIL(1)

NAME

       stg-mail - Send a patch or series of patches by e-mail

SYNOPSIS

       stg mail  [options] [<patch1>] [<patch2>] [<patch3>..<patch4>]

DESCRIPTION

       Send a patch or a range of patches by e-mail using the SMTP server specified by the stgit.smtpserver configuration option, or the
       --smtp-server command line option. This option can also be an absolute path to sendmail followed by command line arguments.

       The From address and the e-mail format are generated from the template file passed as argument to --template (defaulting to
       .git/patchmail.tmpl or ~/.stgit/templates/patchmail.tmpl or /usr/share/stgit/templates/patchmail.tmpl). A patch can be sent as attachment
       using the --attach option in which case the mailattch.tmpl template will be used instead of patchmail.tmpl.

       The To/Cc/Bcc addresses can either be added to the template file or passed via the corresponding command line options. They can be e-mail
       addresses or aliases which are automatically expanded to the values stored in the [mail "alias"] section of GIT configuration files.

       A preamble e-mail can be sent using the --cover and/or --edit-cover options. The first allows the user to specify a file to be used as a
       template. The latter option will invoke the editor on the specified file (defaulting to .git/covermail.tmpl or
       ~/.stgit/templates/covermail.tmpl or /usr/share/stgit/templates/covermail.tmpl).

       All the subsequent e-mails appear as replies to the first e-mail sent (either the preamble or the first patch). E-mails can be seen as
       replies to a different e-mail by using the --refid option.

       SMTP authentication is also possible with --smtp-user and --smtp-password options, also available as configuration settings: smtpuser and
       smtppassword. TLS encryption can be enabled by --smtp-tls option and smtptls setting.

       The following variables are accepted by both the preamble and the patch e-mail templates:

	   %(diffstat)s     - diff statistics
	   %(number)s	    - empty if only one patch is sent or ' patchnr/totalnr'
	   %(patchnr)s	    - patch number
	   %(sender)s	    - 'sender'	or 'authname <authemail>' as per the config file
	   %(totalnr)s	    - total number of patches to be sent
	   %(version)s	    - ' version' string passed on the command line (or empty)

       In addition to the common variables, the preamble e-mail template accepts the following:

	   %(shortlog)s     - first line of each patch description, listed by author

       In addition to the common variables, the patch e-mail template accepts the following:

	   %(authdate)s     - patch creation date
	   %(authemail)s    - author's email
	   %(authname)s     - author's name
	   %(commemail)s    - committer's e-mail
	   %(commname)s     - committer's name
	   %(diff)s	    - unified diff of the patch
	   %(fromauth)s     - 'From: author

' if different from sender
	   %(longdescr)s    - the rest of the patch description, after the first line
	   %(patch)s	    - patch name
	   %(prefix)s	    - 'prefix ' string passed on the command line
	   %(shortdescr)s   - the first line of the patch description

OPTIONS

       -a, --all
	   E-mail all the applied patches.

       --to TO
	   Add TO to the To: list.

       --cc CC
	   Add CC to the Cc: list.

       --bcc BCC
	   Add BCC to the Bcc: list.

       --auto
	   Automatically cc the patch signers.

       --noreply
	   Do not send subsequent messages as replies.

       --unrelated
	   Send patches without sequence numbering.

       --attach
	   Send a patch as attachment.

       -v VERSION, --version VERSION
	   Add VERSION to the [PATCH ...] prefix.

       --prefix PREFIX
	   Add PREFIX to the [... PATCH ...] prefix.

       -t FILE, --template FILE
	   Use FILE as the message template.

       -c FILE, --cover FILE
	   Send FILE as the cover message.

       -e, --edit-cover
	   Edit the cover message before sending.

       -E, --edit-patches
	   Edit each patch before sending.

       -s SECONDS, --sleep SECONDS
	   Sleep for SECONDS between e-mails sending.

       --refid REFID
	   Use REFID as the reference id.

       --smtp-server HOST[:PORT] or "/path/to/sendmail -t -i"
	   SMTP server or command to use for sending mail.

       -u USER, --smtp-user USER
	   Username for SMTP authentication.

       -p PASSWORD, --smtp-password PASSWORD
	   Password for SMTP authentication.

       -T, --smtp-tls
	   Use SMTP with TLS encryption.

       -b BRANCH, --branch BRANCH
	   Use BRANCH instead of the default branch.

       -m, --mbox
	   Generate an mbox file instead of sending.

       -O OPTIONS, --diff-opts OPTIONS
	   Extra options to pass to "git diff".

STGIT

       Part of the StGit suite - see linkman:stg[1]

StGit								    03/13/2012							       STG-MAIL(1)