1STG-MAIL(1) StGit Manual STG-MAIL(1)
2
6 stg-mail - Send a patch or series of patches by e-mail
7
9 stg mail [options] [--] [<patch1>] [<patch2>] [<patch3>..<patch4>]
10
12 Send a patch or a range of patches by e-mail using the SMTP server
13 specified by the stgit.smtpserver configuration option, or the
14 --smtp-server command line option. This option can also be an absolute
15 path to sendmail followed by command line arguments.
16 The From address and the e-mail format are generated from the template
18 file passed as argument to --template (defaulting to
19 .git/patchmail.tmpl or ~/.stgit/templates/patchmail.tmpl or
20 /usr/share/stgit/templates/patchmail.tmpl). A patch can be sent as
21 attachment using the --attach option in which case the mailattch.tmpl
22 template will be used instead of patchmail.tmpl.
23 The To/Cc/Bcc addresses can either be added to the template file or
25 passed via the corresponding command line options. They can be e-mail
26 addresses or aliases which are automatically expanded to the values
27 stored in the [mail "alias"] section of GIT configuration files.
28 A preamble e-mail can be sent using the --cover and/or --edit-cover
30 options. The first allows the user to specify a file to be used as a
31 template. The latter option will invoke the editor on the specified
32 file (defaulting to .git/covermail.tmpl or
33 ~/.stgit/templates/covermail.tmpl or
34 /usr/share/stgit/templates/covermail.tmpl).
35 All the subsequent e-mails appear as replies to the first e-mail sent
37 (either the preamble or the first patch). E-mails can be seen as
38 replies to a different e-mail by using the --in-reply-to option.
39 SMTP authentication is also possible with --smtp-user and
41 --smtp-password options, also available as configuration settings:
42 smtpuser and smtppassword. TLS encryption can be enabled by --smtp-tls
43 option and smtptls setting.
44 The following variables are accepted by both the preamble and the patch
46 e-mail templates:
47 %(diffstat)s - diff statistics
50 %(number)s - empty if only one patch is sent or 'patchnr/totalnr'
51 %(snumber)s - stripped version of '%(number)s'
52 %(nspace)s - ' ' if %(number)s is non-empty, otherwise empty string
53 %(patchnr)s - patch number
54 %(sender)s - 'sender' or 'authname <authemail>' as per the config file
55 %(totalnr)s - total number of patches to be sent
56 %(version)s - 'version' string passed on the command line (or empty)
57 %(vspace)s - ' ' if %(version)s is non-empty, otherwise empty string
58 In addition to the common variables, the preamble e-mail template
60 accepts the following:
61 %(shortlog)s - first line of each patch description, listed by author
64 In addition to the common variables, the patch e-mail template accepts
66 the following:
67 %(authdate)s - patch creation date
70 %(authemail)s - author's email
71 %(authname)s - author's name
72 %(commemail)s - committer's e-mail
73 %(commname)s - committer's name
74 %(diff)s - unified diff of the patch
75 %(fromauth)s - 'From: author\n\n' if different from sender
76 %(longdescr)s - the rest of the patch description, after the first line
77 %(patch)s - patch name
78 %(prefix)s - 'prefix' string passed on the command line
79 %(pspace)s - ' ' if %(prefix)s is non-empty, otherwise empty string
80 %(shortdescr)s - the first line of the patch description
81
83 -a, --all
84 E-mail all the applied patches.
85 --to TO
87 Add TO to the To: list.
88 --cc CC
90 Add CC to the Cc: list.
91 --bcc BCC
93 Add BCC to the Bcc: list.
94 --auto
96 Automatically cc the patch signers.
97 --no-thread
99 Do not send subsequent messages as replies.
100 --unrelated
102 Send patches without sequence numbering.
103 --attach
105 Send a patch as attachment.
106 --attach-inline
108 Send a patch inline and as an attachment.
109 -v VERSION, --version VERSION
111 Add VERSION to the [PATCH ...] prefix.
112 --prefix PREFIX
114 Add PREFIX to the [... PATCH ...] prefix.
115 -t FILE, --template FILE
117 Use FILE as the message template.
118 -c FILE, --cover FILE
120 Send FILE as the cover message.
121 -e, --edit-cover
123 Edit the cover message before sending.
124 -E, --edit-patches
126 Edit each patch before sending.
127 -s SECONDS, --sleep SECONDS
129 Sleep for SECONDS between e-mails sending.
130 --in-reply-to REFID
132 Use REFID as the reference id.
133 --smtp-server HOST[:PORT] or "/path/to/sendmail -t -i"
135 SMTP server or command to use for sending mail.
136 -u USER, --smtp-user USER
138 Username for SMTP authentication.
139 -p PASSWORD, --smtp-password PASSWORD
141 Password for SMTP authentication.
142 -T, --smtp-tls
144 Use SMTP with TLS encryption.
145 -b BRANCH, --branch BRANCH
147 Use BRANCH instead of the default branch.
148 -m, --mbox
150 Generate an mbox file instead of sending.
151 --domain DOMAIN
153 Use DOMAIN when generating message IDs (instead of the system
154 hostname).
155 --git
157 Use git send-email (EXPERIMENTAL).
158 -O OPTIONS, --diff-opts OPTIONS
160 Extra options to pass to "git diff".
161
163 Part of the StGit suite - see stg(1)
164StGit 01/31/2020 STG-MAIL(1)