From 743e63f3ed22b206e9d9ba92f24e2b8503dec3ba Mon Sep 17 00:00:00 2001 From: "brian m. carlson" Date: Sun, 6 May 2018 20:42:25 +0000 Subject: Documentation: use 8-space tabs with Asciidoctor Asciidoctor expands tabs at the beginning of a line. However, it does not expand them into 8 spaces by default. Since we use 8-space tabs, tell Asciidoctor that we want 8 spaces by setting the tabsize attribute. This ensures that our ASCII art renders properly. Signed-off-by: brian m. carlson Signed-off-by: Junio C Hamano diff --git a/Documentation/Makefile b/Documentation/Makefile index 6232143..bcd216d 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -184,7 +184,7 @@ ASCIIDOC = asciidoctor ASCIIDOC_CONF = ASCIIDOC_HTML = xhtml5 ASCIIDOC_DOCBOOK = docbook45 -ASCIIDOC_EXTRA += -acompat-mode +ASCIIDOC_EXTRA += -acompat-mode -atabsize=8 ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions ASCIIDOC_EXTRA += -alitdd='&\#x2d;&\#x2d;' DBLATEX_COMMON = -- cgit v0.10.2-6-g49f6 From 379805051d3aae54f011eec429c07ce93daf8194 Mon Sep 17 00:00:00 2001 From: "brian m. carlson" Date: Sun, 6 May 2018 20:42:26 +0000 Subject: Documentation: render revisions correctly under Asciidoctor 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 Signed-off-by: Junio C Hamano diff --git a/Documentation/revisions.txt b/Documentation/revisions.txt index dfcc49c..8f60c9f 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 +.... -- cgit v0.10.2-6-g49f6