[PATCH 11/17] SubmittingPatches.rst: Add some cross-references

From: Mauro Carvalho Chehab
Date: Wed Sep 14 2016 - 19:06:27 EST


This file mentions some other documents already converted
to ReST format. Add cross-references for them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>
---
.../development-process/SubmitChecklist.rst | 2 ++
.../development-process/SubmittingPatches.rst | 24 ++++++++++++++--------
.../development-process/development-process.rst | 2 ++
.../development-process/email-clients.rst | 2 ++
4 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/Documentation/development-process/SubmitChecklist.rst b/Documentation/development-process/SubmitChecklist.rst
index 71ad93ffd9d6..6845a4e4d96e 100644
--- a/Documentation/development-process/SubmitChecklist.rst
+++ b/Documentation/development-process/SubmitChecklist.rst
@@ -1,3 +1,5 @@
+.. _submitchecklist:
+
Linux Kernel patch submission checklist
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/Documentation/development-process/SubmittingPatches.rst b/Documentation/development-process/SubmittingPatches.rst
index b1fbdf501168..ef3cb81de59b 100644
--- a/Documentation/development-process/SubmittingPatches.rst
+++ b/Documentation/development-process/SubmittingPatches.rst
@@ -10,10 +10,12 @@ can greatly increase the chances of your change being accepted.

This document contains a large number of suggestions in a relatively terse
format. For detailed information on how the kernel development process
-works, see Documentation/development-process. Also, read
-Documentation/SubmitChecklist for a list of items to check before
+works, see :ref:`Documentation/development-process <development_process_main>`.
+Also, read :ref:`Documentation/development-process/SubmitChecklist.rst <submitchecklist>`
+for a list of items to check before
submitting code. If you are submitting a driver, also read
-Documentation/development-process/SubmittingDrivers.rst; for device tree binding patches, read
+:ref:`Documentation/development-process/SubmittingDrivers.rst <submittingdrivers>`;
+for device tree binding patches, read
Documentation/devicetree/bindings/submitting-patches.txt.

Many of these steps describe the default behavior of the git version
@@ -246,7 +248,9 @@ Style-check your changes
------------------------

Check your patch for basic style violations, details of which can be
-found in Documentation/development-process/CodingStyle.rst. Failure to do so simply wastes
+found in
+:ref:`Documentation/development-process/CodingStyle.rst <codingstyle>`.
+Failure to do so simply wastes
the reviewers time and will get your patch rejected, probably
without even being read.

@@ -313,8 +317,9 @@ toward the stable maintainers by putting a line like this:
Cc: stable@xxxxxxxxxxxxxxx

into the sign-off area of your patch (note, NOT an email recipient). You
-should also read Documentation/development-process/stable_kernel_rules.rst in addition to this
-file.
+should also read
+:ref:`Documentation/development-process/stable_kernel_rules.rst <stable_kernel_rules>`
+in addition to this file.

Note, however, that some subsystem maintainers want to come to their own
conclusions on which patches should go to the stable trees. The networking
@@ -368,8 +373,9 @@ decreasing the likelihood of your MIME-attached change being accepted.
Exception: If your mailer is mangling patches then someone may ask
you to re-send them using MIME.

-See Documentation/development-process/email-clients.rst for hints about configuring
-your e-mail client so that it sends your patches untouched.
+See :ref:`Documentation/development-process/email-clients.rst <email_clients>`
+for hints about configuring your e-mail client so that it sends your patches
+untouched.

E-mail size
-----------
@@ -844,7 +850,7 @@ NO!!!! No more huge patch bombs to linux-kernel@xxxxxxxxxxxxxxx people!
<https://lkml.org/lkml/2005/7/11/336>

Kernel Documentation/development-process/CodingStyle.rst:
- <Documentation/development-process/CodingStyle.rst>
+ :ref:`Documentation/development-process/CodingStyle.rst <codingstyle>`

Linus Torvalds's mail on the canonical patch format:
<http://lkml.org/lkml/2005/4/7/183>
diff --git a/Documentation/development-process/development-process.rst b/Documentation/development-process/development-process.rst
index d431a1098875..bd1399f7202a 100644
--- a/Documentation/development-process/development-process.rst
+++ b/Documentation/development-process/development-process.rst
@@ -1,3 +1,5 @@
+.. _development_process_main:
+
A guide to the Kernel Development Process
=========================================

diff --git a/Documentation/development-process/email-clients.rst b/Documentation/development-process/email-clients.rst
index 0deb240bee56..d35f5fd05f29 100644
--- a/Documentation/development-process/email-clients.rst
+++ b/Documentation/development-process/email-clients.rst
@@ -1,3 +1,5 @@
+.. _email_clients:
+
Email clients info for Linux
============================

--
2.7.4