RE: [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, 21:07 UTC
Message-ID: <60cd0b255b8b0_c0ff920870@natae.notmuch>
In-Reply-To: <20210618203057.790320-4-felipe.contreras@gmail.com>

Felipe Contreras wrote:

> From: "brian m. carlson" <sandals@crustytoothpaste.net>

Show 19 quoted lines

> --- 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
>

My version of the workaround [1] is much cleaner, and doesn't mess with the build system:

  if doc.backend == 'manpage'
    doc.attributes.merge!({ 'litdd' => '\--', 'plus' => '+' })
  end

Once asciidoctor issue #4059 is fixed [2] and in widespread use the above workaround can be removed.

[1] https://lore.kernel.org/git/20210521224452.530852-7-felipe.contreras@gmail.com/ [2] https://github.com/asciidoctor/asciidoctor/issues/4059

-- 
Felipe Contreras