Re: [PATCH] INSTALL: note about make man with Asciidoctor backend

Martin Ågren wrote:

On Wed, 12 May 2021 at 10:13, Felipe Contreras
[off-list ref] wrote:

quoted

Junio C Hamano wrote:

quoted

Bagas Sanjaya [off-list ref] writes:

quoted

+   You can also do "make man" using Asciidoctor's manpage backend in
+   place of xmlto by passing USE_ASCIIDOCTOR_MANPAGE=YesPlease. Version
+   2.0 or later is highly recommended, as these version properly handle
+   apostrophes.
+

Hmph, I wasn't closely following the previous discussion, but is the
apostrophes the primary reason why anything below 2.0 is not usable?

"Not usable"?

I haven't been able to reproduce the original supposed problem, but even
if true, the man pages would be quite usable.

Even early 2.0.x had some issues [1].
[1] https://lore.kernel.org/git/20190325190041.GM4047@pobox.com/ (local)

That issue affects only the docbook generation, not direct man pages.

So far nobody has mentioned any issues with USE_ASCIIDOCTOR_MANPAGE=1 in
older asciidoctor, especially not regarding apostrophes.

-- 
Felipe Contreras