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

[PATCH 2/2] Documentation: render revisions correctly under Asciidoctor

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
May 6, 2018, 20:42 UTC
Message-ID
<20180506204226.955739-2-sandals@crustytoothpaste.net>
In-Reply-To
<20180506204226.955739-1-sandals@crustytoothpaste.net>

When creating a literal block from an indented block without any sort of delimiters, Asciidoctor strips off all leading whitespace, resulting in a misrendered chart. Use an explicit literal block to indicate to Asciidoctor that we want to keep the leading whitespace.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
---
A future direction we could go here would actually be to turn this into
a table, which might render more acceptably in all forms.  But I think
this patch provides a useful improvement and we can switch to a table
later if desired.
 Documentation/revisions.txt | 2 ++
 1 file changed, 2 insertions(+)
diff --git a/Documentation/revisions.txt b/Documentation/revisions.txt
index dfcc49c72c..8f60c9f431 100644
--- a/Documentation/revisions.txt
+++ b/Documentation/revisions.txt
@@ -345,6 +345,7 @@ Here are a handful of examples using the Loeliger illustration above,
 with each step in the notation's expansion and selection carefully
 spelt out:
 
+....
    Args   Expanded arguments    Selected commits
    D                            G H D
    D F                          G H I J D F
@@ -367,3 +368,4 @@ spelt out:
 	  = B ^B^1 ^B^2 ^B^3
 	  = B ^D ^E ^F          B
    F^! D  = F ^I ^J D           G H D F
+....
Previous: brian m. carlsonNext: Martin Ågren
Message 7 of 12 in “revisions.txt: expand tabs to spaces in diagram”
  1. revisions.txt: expand tabs to spaces in diagramMartin Ågren, Apr 30, 2018
  2. Junio C HamanoMay 2, 2018
  3. Martin ÅgrenMay 2, 2018
  4. brian m. carlsonMay 4, 2018
  5. Junio C HamanoMay 4, 2018
  6. 1/2 Documentation: use 8-space tabs with Asciidoctorbrian m. carlson, May 6, 2018
  7. 2/2 Documentation: render revisions correctly under Asciidoctorbrian m. carlson, May 6, 2018
  8. Martin ÅgrenMay 7, 2018
  9. brian m. carlsonMay 8, 2018
  10. Martin ÅgrenMay 8, 2018
  11. brian m. carlsonMay 9, 2018
  12. Junio C HamanoMay 7, 2018

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.