I'm sending this stub series because 1. it's still in 'seen' [1], 2. my conflicting version is not in 'seen' [2], and 3. brian has not responded to my constructive criticism of his version [3]. This is exactly the same as what brian sent and is in bc/doc-asciidoctor-to-man-wo-xmlto, except I have split the first patch into three logically separate changes, which I did suggest him to do, but he didn't. To be crystal clear: I am *NOT* proposing these patches to be merged, that's why I'm marking them RFC/NOPATCH so there's no confusion. I think these should be dropped, as my series contains these changes already, but split logically, with better commit messages, more fixes which reduce the doc-diff, and contains patches from both Martin Ågren and Jeff King, as well as many cleanups. My version has 837 less lines of doc-diff (plus has the --to-asciidoctor-direct option), and also applies cleanly to master. On top of these patches I'm going to comment all my objections (again). [1] https://lore.kernel.org/git/YMvhoXVBoO08ziI1@xxxxxxxxxxxxxxxxxxxxxxxxx/ [2] https://lore.kernel.org/git/20210608090026.1737348-1-felipe.contreras@xxxxxxxxx/ [3] https://lore.kernel.org/git/609ed529e2306_431272087@natae.notmuch/ brian m. carlson (4): doc: add an option to have Asciidoctor build man pages directly doc: add linkgit macros for asciidoctor doc: use XML-style escapes only for HTML and XML doc: remove GNU_ROFF option Documentation/Makefile | 25 +++++++++++++++---------- Documentation/asciidoctor-extensions.rb | 2 ++ Documentation/manpage-quote-apos.xsl | 16 ---------------- Makefile | 8 ++++---- 4 files changed, 21 insertions(+), 30 deletions(-) delete mode 100644 Documentation/manpage-quote-apos.xsl -- 2.32.0