hc
2023-12-11 d2ccde1c8e90d38cee87a1b0309ad2827f3fd30d
kernel/Documentation/process/5.Posting.rst
....@@ -9,9 +9,10 @@
99 of conventions and procedures which are used in the posting of patches;
1010 following them will make life much easier for everybody involved. This
1111 document will attempt to cover these expectations in reasonable detail;
12
-more information can also be found in the files process/submitting-patches.rst,
13
-process/submitting-drivers.rst, and process/submit-checklist.rst in the kernel
14
-documentation directory.
12
+more information can also be found in the files
13
+:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`,
14
+:ref:`Documentation/process/submitting-drivers.rst <submittingdrivers>`
15
+and :ref:`Documentation/process/submit-checklist.rst <submitchecklist>`.
1516
1617
1718 When to post
....@@ -198,8 +199,10 @@
198199
199200 The tags mentioned above are used to describe how various developers have
200201 been associated with the development of this patch. They are described in
201
-detail in the process/submitting-patches.rst document; what follows here is a
202
-brief summary. Each of these lines has the format:
202
+detail in
203
+the :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
204
+document; what follows here is a brief summary. Each of these lines has
205
+the format:
203206
204207 ::
205208
....@@ -210,13 +213,15 @@
210213 - Signed-off-by: this is a developer's certification that he or she has
211214 the right to submit the patch for inclusion into the kernel. It is an
212215 agreement to the Developer's Certificate of Origin, the full text of
213
- which can be found in Documentation/process/submitting-patches.rst. Code
214
- without a proper signoff cannot be merged into the mainline.
216
+ which can be found in :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
217
+ Code without a proper signoff cannot be merged into the mainline.
215218
216
- - Co-developed-by: states that the patch was also created by another developer
217
- along with the original author. This is useful at times when multiple
218
- people work on a single patch. Note, this person also needs to have a
219
- Signed-off-by: line in the patch as well.
219
+ - Co-developed-by: states that the patch was co-created by several developers;
220
+ it is a used to give attribution to co-authors (in addition to the author
221
+ attributed by the From: tag) when multiple people work on a single patch.
222
+ Every Co-developed-by: must be immediately followed by a Signed-off-by: of
223
+ the associated co-author. Details and examples can be found in
224
+ :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`.
220225
221226 - Acked-by: indicates an agreement by another developer (often a
222227 maintainer of the relevant code) that the patch is appropriate for
....@@ -226,7 +231,7 @@
226231 it to work.
227232
228233 - Reviewed-by: the named developer has reviewed the patch for correctness;
229
- see the reviewer's statement in Documentation/process/submitting-patches.rst
234
+ see the reviewer's statement in :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
230235 for more detail.
231236
232237 - Reported-by: names a user who reported a problem which is fixed by this
....@@ -253,8 +258,8 @@
253258 be examined in any detail. If there is any doubt at all, mail the patch
254259 to yourself and convince yourself that it shows up intact.
255260
256
- Documentation/process/email-clients.rst has some helpful hints on making
257
- specific mail clients work for sending patches.
261
+ :ref:`Documentation/process/email-clients.rst <email_clients>` has some
262
+ helpful hints on making specific mail clients work for sending patches.
258263
259264 - Are you sure your patch is free of silly mistakes? You should always
260265 run patches through scripts/checkpatch.pl and address the complaints it