95350e223dcfee0bad425d80d5fe5e668ab1d675
[git.git] / man1 / git-send-email.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-SEND-EMAIL" 1 "" "" ""
21 .SH NAME
22 git-send-email \- Send a collection of patches as emails
23 .SH "SYNOPSIS"
24
25
26 \fIgit\-send\-email\fR [options] <file|directory> [... file|directory]
27
28 .SH "DESCRIPTION"
29
30
31 Takes the patches given on the command line and emails them out\&.
32
33
34 The header of the email is configurable by command line options\&. If not specified on the command line, the user will be prompted with a ReadLine enabled interface to provide the necessary information\&.
35
36 .SH "OPTIONS"
37
38
39 The options available are:
40
41 .TP
42 \-\-cc
43 Specify a starting "Cc:" value for each email\&.
44
45 .TP
46 \-\-chain\-reply\-to, \-\-no\-chain\-reply\-to
47 If this is set, each email will be sent as a reply to the previous email sent\&. If disabled with "\-\-no\-chain\-reply\-to", all emails after the first will be sent as replies to the first email sent\&. When using this, it is recommended that the first file given be an overview of the entire patch series\&. Default is \-\-chain\-reply\-to
48
49 .TP
50 \-\-compose
51 Use $EDITOR to edit an introductory message for the patch series\&.
52
53 .TP
54 \-\-from
55 Specify the sender of the emails\&. This will default to the value GIT_COMMITTER_IDENT, as returned by "git\-var \-l"\&. The user will still be prompted to confirm this entry\&.
56
57 .TP
58 \-\-in\-reply\-to
59 Specify the contents of the first In\-Reply\-To header\&. Subsequent emails will refer to the previous email instead of this if \-\-chain\-reply\-to is set (the default) Only necessary if \-\-compose is also set\&. If \-\-compose is not set, this will be prompted for\&.
60
61 .TP
62 \-\-no\-signed\-off\-by\-cc
63 Do not add emails foudn in Signed\-off\-by: lines to the cc list\&.
64
65 .TP
66 \-\-quiet
67 Make git\-send\-email less verbose\&. One line per email should be all that is output\&.
68
69 .TP
70 \-\-smtp\-server
71 If set, specifies the outgoing SMTP server to use\&. Defaults to localhost\&.
72
73 .TP
74 \-\-subject
75 Specify the initial subject of the email thread\&. Only necessary if \-\-compose is also set\&. If \-\-compose is not set, this will be prompted for\&.
76
77 .TP
78 \-\-suppress\-from
79 Do not add the From: address to the cc: list, if it shows up in a From: line\&.
80
81 .TP
82 \-\-to
83 Specify the primary recipient of the emails generated\&. Generally, this will be the upstream maintainer of the project involved\&.
84
85 .SH "AUTHOR"
86
87
88 Written by Ryan Anderson <ryan@michonline\&.com>
89
90
91 git\-send\-email is originally based upon send_lots_of_email\&.pl by Greg Kroah\-Hartman\&.
92
93 .SH "DOCUMENTATION"
94
95
96 Documentation by Ryan Anderson
97
98 .SH "GIT"
99
100
101 Part of the \fBgit\fR(7) suite
102