[PATCH v2 1/2] SubmittingPatches: replace numbered attributes with names

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Use names instead of numbers for the AsciiDoc attributes that are used
for the footnotes.  We will add more footnotes in subsequent commits,
and attributes should ideally all be unique.  Having named attributes
will help ensure uniqueness, and we won't have to re-number the
attributes if we add a footnote earlier in the document.

In addition it also clarifies that the attribute name/number is not
related to the number the footnote will get in the output.

Signed-off-by: Thomas Gummerer <t.gummerer@xxxxxxxxx>
---

Thanks Junio, Jonathan and brian for the comments on the previous
round at <20180527140433.32277-1-t.gummerer@xxxxxxxxx>.  This round
squashes the two patches I sent previously adding the mentions of the
security mailing list into one, and adds this preparatory patch.

The security mailing list is now mentioned twice in SubmittingPatches,
to make sure people don't miss it, and the wording was adjusted to
match the document better.

 Documentation/SubmittingPatches | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index 945f8edb46..27553128f5 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -264,12 +264,12 @@ people who are involved in the area you are touching (the `git
 contacts` command in `contrib/contacts/` can help to
 identify them), to solicit comments and reviews.
 
-:1: footnote:[The current maintainer: gitster@xxxxxxxxx]
-:2: footnote:[The mailing list: git@xxxxxxxxxxxxxxx]
+:current-maintainer: footnote:[The current maintainer: gitster@xxxxxxxxx]
+:git-ml: footnote:[The mailing list: git@xxxxxxxxxxxxxxx]
 
 After the list reached a consensus that it is a good idea to apply the
-patch, re-send it with "To:" set to the maintainer{1} and "cc:" the
-list{2} for inclusion.
+patch, re-send it with "To:" set to the maintainer{current-maintainer} and "cc:" the
+list{git-ml} for inclusion.
 
 Do not forget to add trailers such as `Acked-by:`, `Reviewed-by:` and
 `Tested-by:` lines as necessary to credit people who helped your
-- 
2.17.0.1181.g093e983b0




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux