]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-send-email.txt
git-ls-files: Fix, document, and add test for --error-unmatch option.
[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
da140f8b
RA
27--cc::
28 Specify a starting "Cc:" value for each email.
29
2718435b
RA
30--chain-reply-to, --no-chain-reply-to::
31 If this is set, each email will be sent as a reply to the previous
32 email sent. If disabled with "--no-chain-reply-to", all emails after
33 the first will be sent as replies to the first email sent. When using
34 this, it is recommended that the first file given be an overview of the
35 entire patch series.
36 Default is --chain-reply-to
37
38--compose::
39 Use $EDITOR to edit an introductory message for the
40 patch series.
479cec96 41
df8baa42 42--from::
479cec96
RA
43 Specify the sender of the emails. This will default to
44 the value GIT_COMMITTER_IDENT, as returned by "git-var -l".
45 The user will still be prompted to confirm this entry.
46
df8baa42 47--in-reply-to::
479cec96
RA
48 Specify the contents of the first In-Reply-To header.
49 Subsequent emails will refer to the previous email
f9e320c3
RA
50 instead of this if --chain-reply-to is set (the default)
51 Only necessary if --compose is also set. If --compose
52 is not set, this will be prompted for.
479cec96 53
a985d595
RA
54--no-signed-off-by-cc::
55 Do not add emails foudn in Signed-off-by: lines to the cc list.
56
2718435b
RA
57--quiet::
58 Make git-send-email less verbose. One line per email should be
59 all that is output.
a6d62cdd 60
df8baa42 61--smtp-server::
a6d62cdd
RA
62 If set, specifies the outgoing SMTP server to use. Defaults to
63 localhost.
64
2718435b
RA
65--subject::
66 Specify the initial subject of the email thread.
67 Only necessary if --compose is also set. If --compose
68 is not set, this will be prompted for.
69
a985d595
RA
70--suppress-from::
71 Do not add the From: address to the cc: list, if it shows up in a From:
72 line.
73
2718435b
RA
74--to::
75 Specify the primary recipient of the emails generated.
76 Generally, this will be the upstream maintainer of the
77 project involved.
78
a6d62cdd 79
479cec96
RA
80Author
81------
82Written by Ryan Anderson <ryan@michonline.com>
83
215a7ad1 84git-send-email is originally based upon
479cec96
RA
85send_lots_of_email.pl by Greg Kroah-Hartman.
86
87Documentation
88--------------
89Documentation by Ryan Anderson
90
91GIT
92---
a7154e91 93Part of the gitlink:git[7] suite
479cec96 94