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

[RFC/NOPATCHv3 3/4] doc: use XML-style escapes only for HTML and XML

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
Jun 18, 2021, 20:30 UTC
Message-ID
<20210618203057.790320-4-felipe.contreras@gmail.com>
In-Reply-To
<20210618203057.790320-1-felipe.contreras@gmail.com>
From: "brian m. carlson" <sandals@crustytoothpaste.net>

Additionally, we don't want to use XML-style escapes for the litdd and plus macros, so let's only use the XML-style escapes in HTML and XML and use something different for our man pages.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
---
 Documentation/Makefile | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/Documentation/Makefile b/Documentation/Makefile
index d3103c3dde..53ef100a7a 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -183,12 +183,15 @@ ASCIIDOC_HTML = xhtml5
 ASCIIDOC_DOCBOOK = docbook5
 ASCIIDOC_EXTRA += -acompat-mode -atabsize=8
 ASCIIDOC_EXTRA += -I. -rasciidoctor-extensions
-ASCIIDOC_EXTRA += -alitdd='&\#x2d;&\#x2d;'
+TXT_TO_HTML += -alitdd='&\#x2d;&\#x2d;'
+TXT_TO_XML  += -alitdd='&\#x2d;&\#x2d;'
 DBLATEX_COMMON =
 XMLTO_EXTRA += --skip-validation
 XMLTO_EXTRA += -x manpage.xsl
 ifdef USE_ASCIIDOCTOR_MANPAGE
 TXT_TO_MAN = $(ASCIIDOC_COMMON) -b manpage
+TXT_TO_MAN += -aplus='+'
+TXT_TO_MAN += -alitdd='\--'
 endif
 endif
 
-- 
2.32.0
Previous: Felipe ContrerasNext: Felipe Contreras
Message 6 of 9 in “[RFC/NOPATCHv3 0/4] doc: asciidoctor: direct man page creation and fixes (brian's version)”
  1. Felipe ContrerasJun 18, 2021
  2. 2/4 doc: add linkgit macros for asciidoctorFelipe Contreras, Jun 18, 2021
  3. Felipe ContrerasJun 18, 2021
  4. 1/4 doc: add an option to have Asciidoctor build man pages directlyFelipe Contreras, Jun 18, 2021
  5. Felipe ContrerasJun 18, 2021
  6. 3/4 doc: use XML-style escapes only for HTML and XMLFelipe Contreras, Jun 18, 2021
  7. Felipe ContrerasJun 18, 2021
  8. 4/4 doc: remove GNU_ROFF optionFelipe Contreras, Jun 18, 2021
  9. Felipe ContrerasJun 18, 2021

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.