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

[PATCH v2 1/2] Documentation/git-show-branch: avoid literal {apostrophe}

From
Todd Zullinger <tmz@pobox.com>
Date
Apr 10, 2019, 00:37 UTC
Message-ID
<20190410003734.17124-2-tmz@pobox.com>
In-Reply-To
<CAN0heSrPx+_dB+NZzRzidZFpfLMpQUHk-Wi8rTaer+stam0NPA@mail.gmail.com>

The {apostrophe} was needed at the time of a521845800 ("Documentation: remove stray backslash in show-branch discussion", 2010-08-20). All other uses of {apostrophe} were removed in 6cf378f0cb ("docs: stop using asciidoc no-inline-literal", 2012-04-26).

Unfortunately, the {apostrophe} is rendered literally with Asciidoctor (at least with 1.5.5-2.0.3). Avoid this by using single-quotes.

Escaping the leading single-quote allows the content to render properly in AsciiDoc and Asciidoctor.

Signed-off-by: Todd Zullinger <tmz@pobox.com>
---
 Documentation/git-show-branch.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt
index 4a01371227..5cc2fcefba 100644
--- a/Documentation/git-show-branch.txt
+++ b/Documentation/git-show-branch.txt
@@ -167,7 +167,7 @@ $ git show-branch master fixes mhf
 ------------------------------------------------
 
 These three branches all forked from a common commit, [master],
-whose commit message is "Add {apostrophe}git show-branch{apostrophe}".
+whose commit message is "Add \'git show-branch'".
 The "fixes" branch adds one commit "Introduce "reset type" flag to
 "git reset"". The "mhf" branch adds many other commits.
 The current branch is "master".
Previous: Martin ÅgrenNext: Todd Zullinger
Message 15 of 23 in “minor asciidoc/tor formatting fixes”
  1. 0/2 minor asciidoc/tor formatting fixesTodd Zullinger, Mar 30, 2019
  2. 2/2 Documentation/git-status: fix titles in porcelain v2 sectionTodd Zullinger, Mar 30, 2019
  3. Jeff KingApr 1, 2019
  4. Todd ZullingerApr 5, 2019
  5. Jeff HostetlerApr 3, 2019
  6. Todd ZullingerApr 5, 2019
  7. 1/2 Documentation/rev-list-options: wrap --date=<format> block with "--"Todd Zullinger, Mar 30, 2019
  8. Jeff KingApr 1, 2019
  9. Todd ZullingerApr 5, 2019
  10. Martin ÅgrenApr 3, 2019
  11. Todd ZullingerApr 5, 2019
  12. Martin ÅgrenApr 5, 2019
  13. 0/2 a few more minor asciidoc/tor formatting fixesTodd Zullinger, Apr 5, 2019
  14. Martin ÅgrenApr 6, 2019
  15. 1/2 Documentation/git-show-branch: avoid literal {apostrophe}Todd Zullinger, Apr 10, 2019
  16. 2/2 Documentation/git-svn: improve asciidoctor compatibilityTodd Zullinger, Apr 10, 2019
  17. 0/2 a few more minor asciidoc/tor formatting fixesTodd Zullinger, Apr 10, 2019
  18. Junio C HamanoApr 10, 2019
  19. 1/2 Documentation/git-show-branch: drop last use of {apostrophe}Todd Zullinger, Apr 5, 2019
  20. Martin ÅgrenApr 6, 2019
  21. 2/2 Documentation/git-svn: improve asciidoctor compatibilityTodd Zullinger, Apr 5, 2019
  22. Martin ÅgrenApr 6, 2019
  23. Todd ZullingerApr 10, 2019

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.