This patch series enables direct man page creation with asciidoctor, but in addition tries to minimize the difference with asciidoc+docbook. I fixed as many issues as I could, and now the doc-diff looks very sensible. I could not find any major issues, however, some minor issues still remain. On the other hand the asciidoc method has issues as well, so it's not clear which method is superior at this point; both have advantages and disadvantages. At the very least the man pages with pure asciidoctor should be quite usable now. This series builds on top of my cleanups [1]. It's probably not worth the effort to split the two. [1] https://lore.kernel.org/git/20210514115631.503276-1-felipe.contreras@xxxxxxxxx Felipe Contreras (11): doc: allow the user to provide ASCIIDOC_EXTRA doc: doc-diff: allow more than one flag doc: doc-diff: set docdate manually doc: use asciidoctor to build man pages directly doc: asciidoctor: add linkgit macros in man pages doc: join mansource and manversion doc: add man pages workaround for asciidoctor doc: asciidoctor: add hack for xrefs doc: asciidoctor: add hack to improve links doc: asciidoctor: add support for baseurl doc: asciidoctor: cleanup man page hack Documentation/Makefile | 24 ++++++++----- Documentation/asciidoctor-extensions.rb | 46 +++++++++++++++++++++++++ Documentation/doc-diff | 8 ++--- 3 files changed, 65 insertions(+), 13 deletions(-) -- 2.31.1
