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

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

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
Oct 29, 2017, 21:13 UTC
Message-ID
<20171029211308.272673-2-sandals@crustytoothpaste.net>
In-Reply-To
<20171029211308.272673-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 10 in “Convert SubmittingPatches to AsciiDoc”
  1. 0/2 Convert SubmittingPatches to AsciiDocbrian m. carlson, Oct 29, 2017
  2. 1/2 Documentation: enable compat-mode for Asciidoctorbrian m. carlson, Oct 29, 2017
  3. 2/2 Documentation: convert SubmittingPatches to AsciiDocbrian m. carlson, Oct 29, 2017
  4. Junio C HamanoOct 30, 2017
  5. Johannes SchindelinOct 30, 2017
  6. Paolo CiarrocchiOct 30, 2017
  7. Johannes SchindelinOct 31, 2017
  8. Paolo CiarrocchiOct 31, 2017
  9. brian m. carlsonOct 30, 2017
  10. brian m. carlsonOct 31, 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.