Mesa (master): docs/submittingpatches: flesh out "how to nominate" methods

[Emil Velikov]

Module: Mesa
Branch: master
Commit: 07384468afdbf6eb2ce43072452a6a87c261b56a
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=07384468afdbf6eb2ce43072452a6a87c261b56a

Author: Emil Velikov <emil.velikov at collabora.com>
Date:   Wed Nov 16 11:51:50 2016 +0000

docs/submittingpatches: flesh out "how to nominate" methods

Currently they are buried within the text, making it hard to find.
Move them to the top and be clear what is _not_ a good idea.

v2: Minor commit polish, use only "resending" as suggested by Matt.

Reviewed-by: Marek Olšák <marek.olsak at amd.com>
Signed-off-by: Emil Velikov <emil.velikov at collabora.com>
Reviewed-by: Brian Paul <brianp at vmware.com>

---

 docs/submittingpatches.html | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index 77b870a..39b615b 100644
--- a/docs/submittingpatches.html
+++ b/docs/submittingpatches.html
@@ -184,6 +184,24 @@ as the issues are resolved first.
 <h2 id="nominations">Nominating a commit for a stable branch</h2>
 
 <p>
+There are three ways to nominate patch for inclusion of the stable branch and
+release.
+</p>
+<ul>
+<li> By adding the Cc: mesa-stable@ tag as described below.
+<li> Sending the commit ID (as seen in master branch) to the mesa-stable@ mailing list.
+<li> Forwarding the patch from the mesa-dev@ mailing list.
+</li>
+</ul>
+<p>
+Note: resending patch identical to one on mesa-dev@ or one that differs only
+by the extra mesa-stable@ tag is <strong>not</strong> recommended.
+</p>
+
+
+<h3 id="thetag">The stable tag</h3>
+
+<p>
 If you want a commit to be applied to a stable branch,
 you should add an appropriate note to the commit message.
 </p>
@@ -207,16 +225,8 @@ exclusively for the older branch.
 
 This "CC" syntax for patch nomination will cause patches to automatically be
 copied to the mesa-stable@ mailing list when you use "git send-email" to send
-patches to the mesa-dev@ mailing list. Also, if you realize that a commit
-should be nominated for the stable branch after it has already been committed,
-you can send a note directly to the mesa-stable at lists.freedesktop.org where
-the Mesa stable-branch maintainers will receive it. Be sure to mention the
-commit ID of the commit of interest (as it appears in the mesa master branch).
-
-The latest set of patches that have been nominated, accepted, or rejected for
-the upcoming stable release can always be seen on the
-<a href="http://cworth.org/~cworth/mesa-stable-queue/">Mesa Stable Queue</a>
-page.
+patches to the mesa-dev@ mailing list. If you prefer using --suppress-cc that
+won't have any effect negative effect on the patch nomination.
 
 <h2 id="criteria">Criteria for accepting patches to the stable branch</h2>