]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-send-email.txt
Documentation: show-branch.
[thirdparty/git.git] / Documentation / git-send-email.txt
CommitLineData
215a7ad1
JH
1git-send-email(1)
2=================
479cec96
RA
3
4NAME
5----
215a7ad1 6git-send-email - Send a collection of patches as emails
479cec96
RA
7
8
9SYNOPSIS
10--------
215a7ad1 11'git-send-email' [options] <file|directory> [... file|directory]
479cec96
RA
12
13
14
15DESCRIPTION
16-----------
17Takes the patches given on the command line and emails them out.
18
19The header of the email is configurable by command line options. If not
20specified on the command line, the user will be prompted with a ReadLine
21enabled interface to provide the necessary information.
22
df8baa42
JF
23OPTIONS
24-------
479cec96
RA
25The options available are:
26
df8baa42 27--to::
479cec96
RA
28 Specify the primary recipient of the emails generated.
29 Generally, this will be the upstream maintainer of the
30 project involved.
31
df8baa42 32--from::
479cec96
RA
33 Specify the sender of the emails. This will default to
34 the value GIT_COMMITTER_IDENT, as returned by "git-var -l".
35 The user will still be prompted to confirm this entry.
36
df8baa42 37--compose::
f9e320c3
RA
38 Use \$EDITOR to edit an introductory message for the
39 patch series.
40
df8baa42 41--subject::
479cec96 42 Specify the initial subject of the email thread.
f9e320c3
RA
43 Only necessary if --compose is also set. If --compose
44 is not set, this will be prompted for.
479cec96 45
df8baa42 46--in-reply-to::
479cec96
RA
47 Specify the contents of the first In-Reply-To header.
48 Subsequent emails will refer to the previous email
f9e320c3
RA
49 instead of this if --chain-reply-to is set (the default)
50 Only necessary if --compose is also set. If --compose
51 is not set, this will be prompted for.
479cec96 52
df8baa42 53--chain-reply-to, --no-chain-reply-to::
a6d62cdd
RA
54 If this is set, each email will be sent as a reply to the previous
55 email sent. If disabled with "--no-chain-reply-to", all emails after
56 the first will be sent as replies to the first email sent. When using
57 this, it is recommended that the first file given be an overview of the
58 entire patch series.
59 Default is --chain-reply-to
60
df8baa42 61--smtp-server::
a6d62cdd
RA
62 If set, specifies the outgoing SMTP server to use. Defaults to
63 localhost.
64
65
479cec96
RA
66Author
67------
68Written by Ryan Anderson <ryan@michonline.com>
69
215a7ad1 70git-send-email is originally based upon
479cec96
RA
71send_lots_of_email.pl by Greg Kroah-Hartman.
72
73Documentation
74--------------
75Documentation by Ryan Anderson
76
77GIT
78---
a7154e91 79Part of the gitlink:git[7] suite
479cec96 80