@@ -43,28 +43,28 @@ There are two ways to specify which commits to operate on.
43
43
44
44
The first rule takes precedence in the case of a single <commit>. To
45
45
apply the second rule, i.e., format everything since the beginning of
46
- history up until <commit>, use the '\--root' option: " git format-patch
47
- \--root <commit>" . If you want to format only <commit> itself, you
48
- can do this with " git format-patch -1 <commit>" .
46
+ history up until <commit>, use the '\--root' option: ` git format-patch
47
+ \--root <commit>` . If you want to format only <commit> itself, you
48
+ can do this with ` git format-patch -1 <commit>` .
49
49
50
50
By default, each output file is numbered sequentially from 1, and uses the
51
51
first line of the commit message (massaged for pathname safety) as
52
- the filename. With the --numbered-files option, the output file names
52
+ the filename. With the ` --numbered-files` option, the output file names
53
53
will only be numbers, without the first line of the commit appended.
54
54
The names of the output files are printed to standard
55
- output, unless the --stdout option is specified.
55
+ output, unless the ` --stdout` option is specified.
56
56
57
- If -o is specified, output files are created in <dir>. Otherwise
57
+ If `-o` is specified, output files are created in <dir>. Otherwise
58
58
they are created in the current working directory.
59
59
60
60
By default, the subject of a single patch is "[PATCH] First Line" and
61
61
the subject when multiple patches are output is "[PATCH n/m] First
62
- Line". To force 1/1 to be added for a single patch, use -n . To omit
63
- patch numbers from the subject, use -N
62
+ Line". To force 1/1 to be added for a single patch, use `-n` . To omit
63
+ patch numbers from the subject, use `-N`.
64
64
65
- If given --thread, ' git-format-patch' will generate In-Reply-To and
66
- References headers to make the second and subsequent patch mails appear
67
- as replies to the first mail; this also generates a Message-Id header to
65
+ If given ` --thread`, ` git-format-patch` will generate ` In-Reply-To` and
66
+ ` References` headers to make the second and subsequent patch mails appear
67
+ as replies to the first mail; this also generates a ` Message-Id` header to
68
68
reference.
69
69
70
70
OPTIONS
@@ -112,7 +112,7 @@ include::diff-options.txt[]
112
112
--attach[=<boundary>]::
113
113
Create multipart/mixed attachment, the first part of
114
114
which is the commit message and the patch itself in the
115
- second part, with " Content-Disposition: attachment" .
115
+ second part, with ` Content-Disposition: attachment` .
116
116
117
117
--no-attach::
118
118
Disable the creation of an attachment, overriding the
@@ -121,13 +121,13 @@ include::diff-options.txt[]
121
121
--inline[=<boundary>]::
122
122
Create multipart/mixed attachment, the first part of
123
123
which is the commit message and the patch itself in the
124
- second part, with " Content-Disposition: inline" .
124
+ second part, with ` Content-Disposition: inline` .
125
125
126
126
--thread[=<style>]::
127
127
--no-thread::
128
- Controls addition of In-Reply-To and References headers to
128
+ Controls addition of ` In-Reply-To` and ` References` headers to
129
129
make the second and subsequent mails appear as replies to the
130
- first. Also controls generation of the Message-Id header to
130
+ first. Also controls generation of the ` Message-Id` header to
131
131
reference.
132
132
+
133
133
The optional <style> argument can be either `shallow` or `deep`.
@@ -136,16 +136,16 @@ series, where the head is chosen from the cover letter, the
136
136
`\--in-reply-to`, and the first patch mail, in this order. 'deep'
137
137
threading makes every mail a reply to the previous one.
138
138
+
139
- The default is --no-thread, unless the 'format.thread' configuration
140
- is set. If --thread is specified without a style, it defaults to the
139
+ The default is ` --no-thread` , unless the 'format.thread' configuration
140
+ is set. If ` --thread` is specified without a style, it defaults to the
141
141
style specified by 'format.thread' if any, or else `shallow`.
142
142
+
143
143
Beware that the default for 'git send-email' is to thread emails
144
- itself. If you want ' git format-patch' to take care of hreading , you
145
- will want to ensure that threading is disabled for ' git send-email' .
144
+ itself. If you want ` git format-patch` to take care of threading , you
145
+ will want to ensure that threading is disabled for ` git send-email` .
146
146
147
147
--in-reply-to=Message-Id::
148
- Make the first mail (or all the mails with --no-thread) appear as a
148
+ Make the first mail (or all the mails with ` --no-thread` ) appear as a
149
149
reply to the given Message-Id, which avoids breaking threads to
150
150
provide a new patch series.
151
151
@@ -160,16 +160,16 @@ will want to ensure that threading is disabled for 'git send-email'.
160
160
Instead of the standard '[PATCH]' prefix in the subject
161
161
line, instead use '[<Subject-Prefix>]'. This
162
162
allows for useful naming of a patch series, and can be
163
- combined with the --numbered option.
163
+ combined with the ` --numbered` option.
164
164
165
165
--cc=<email>::
166
- Add a " Cc:" header to the email headers. This is in addition
166
+ Add a ` Cc:` header to the email headers. This is in addition
167
167
to any configured headers, and may be used multiple times.
168
168
169
169
--add-header=<header>::
170
170
Add an arbitrary header to the email headers. This is in addition
171
171
to any configured headers, and may be used multiple times.
172
- For example, --add-header="Organization: git-foo"
172
+ For example, ` --add-header="Organization: git-foo"`
173
173
174
174
--cover-letter::
175
175
In addition to the patches, generate a cover letter file
0 commit comments