git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 7/7] doc: add markup for characters in Guidelines

From
Jean-Noël Avila via GitGitGadget <gitgitgadget@gmail.com>
Date
Apr 12, 2025, 12:20 UTC
Message-ID
<2690f84602b89f1b10652a6381aa96b2e126d6eb.1744460450.git.gitgitgadget@gmail.com>
In-Reply-To
<pull.1896.v2.git.1744460450.gitgitgadget@gmail.com>
From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= <jn.avila@free.fr>

This rule was already implicitely applied in the converted man pages, so let's state it loudly.

Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
---
 Documentation/CodingGuidelines | 3 +++
 1 file changed, 3 insertions(+)
diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines
index a0e7041c54b..c1046abfb7d 100644
--- a/Documentation/CodingGuidelines
+++ b/Documentation/CodingGuidelines
@@ -861,6 +861,9 @@ Markup:
    _<git-dir>_
    _<key-id>_
 
+Characters are also surrounded by underscores:
+   _LF_, _CR_, _CR_/_LF_, _NUL_, _EOF_
+
  Git's Asciidoc processor has been tailored to treat backticked text
  as complex synopsis. When literal and placeholders are mixed, you can
  use the backtick notation which will take care of correctly typesetting
-- 
gitgitgadget
Previous: Jean-Noël Avila via GitGitGadgetNext: Junio C Hamano
Message 18 of 19 in “doc: convert git-reset, git-rm and git-mv to new documentation format”
  1. 0/5 doc: convert git-reset, git-rm and git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  2. 1/5 doc: convert git-reset to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  3. Martin ÅgrenApr 4, 2025
  4. 2/5 doc: fix synopsis analysis logicJean-Noël Avila via GitGitGadget, Mar 30, 2025
  5. Martin ÅgrenApr 4, 2025
  6. Jean-Noël AvilaApr 12, 2025
  7. 3/5 doc: convert git-rm to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  8. 4/5 doc: move synopsis git-mv commands in the synopsis sectionJean-Noël Avila via GitGitGadget, Mar 30, 2025
  9. Martin ÅgrenApr 5, 2025
  10. 5/5 doc: convert git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  11. 0/7 doc: convert git-reset, git-rm and git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  12. 1/7 doc: convert git-reset to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  13. 2/7 doc: fix synopsis analysis logicJean-Noël Avila via GitGitGadget, Apr 12, 2025
  14. 3/7 doc: convert git-rm to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  15. 4/7 doc: move synopsis git-mv commands in the synopsis sectionJean-Noël Avila via GitGitGadget, Apr 12, 2025
  16. 5/7 doc: convert git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  17. 6/7 doc: fix asciidoctor synopsis processing of triple-dotsJean-Noël Avila via GitGitGadget, Apr 12, 2025
  18. 7/7 doc: add markup for characters in GuidelinesJean-Noël Avila via GitGitGadget, Apr 12, 2025
  19. Junio C HamanoApr 14, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.