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

[PATCH v2 1/2] Documentation: enable compat-mode for Asciidoctor

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
Nov 12, 2017, 22:07 UTC
Message-ID
<20171112220718.792129-2-sandals@crustytoothpaste.net>
In-Reply-To
<20171112220718.792129-1-sandals@crustytoothpaste.net>

Asciidoctor 1.5.0 and later have a compatibility mode that makes it more compatible with some Asciidoc syntax, notably the single and double quote handling. While this doesn't affect any of our current documentation, it would be beneficial to enable this mode to reduce the differences between AsciiDoc and Asciidoctor if we make use of those features in the future.

Since this mode is specified as an attribute, if a version of Asciidoctor doesn't understand it, it will simply be ignored.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
---
 Documentation/Makefile | 1 +
 1 file changed, 1 insertion(+)
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 471bb29725..d5ad85459e 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -181,6 +181,7 @@ ASCIIDOC = asciidoctor
 ASCIIDOC_CONF =
 ASCIIDOC_HTML = xhtml5
 ASCIIDOC_DOCBOOK = docbook45
+ASCIIDOC_EXTRA += -acompat-mode
 ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions
 ASCIIDOC_EXTRA += -alitdd='&\#x2d;&\#x2d;'
 DBLATEX_COMMON =
Previous: brian m. carlsonNext: brian m. carlson
Message 2 of 3 in “Convert SubmittingPatches to AsciiDoc”
  1. 0/2 Convert SubmittingPatches to AsciiDocbrian m. carlson, Nov 12, 2017
  2. 1/2 Documentation: enable compat-mode for Asciidoctorbrian m. carlson, Nov 12, 2017
  3. 2/2 Documentation: convert SubmittingPatches to AsciiDocbrian m. carlson, Nov 12, 2017

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.