[v4,00/12] doc: cleanup old cruft and asciidoctor revamp

Message

Felipe Contreras June 8, 2021, 9 a.m. UTC

This patch series gets rid of old unnecessary workarounds and convoluted solutions.

Additionally it cleanups the asciidoctor-specific code so it ends up much more simpler.

This goes on top of my other cleanup patches [1] (already in seen), but conflicts with
bc/doc-asciidoctor-to-man-wo-xmlto which in my opinion should be dropped since I have better
proposal.

No changes since last version.

[1] https://lore.kernel.org/git/[e-mail]/

Felipe Contreras (12):
  doc: remove GNU troff workaround
  doc: use --stringparam in xmlto
  doc: simplify version passing
  doc: asciidoc: remove unnecessary attribute
  doc: asciidoctor: remove unnecessary require
  doc: asciidoctor: remove cruft
  doc: asciidoctor: reorganize extensions
  doc: asciidoctor: use html-prefix only for html
  doc: asciidoctor: refactor macro registration
  doc: asciidoctor: improve string handling
  doc: asciidoctor: split the format from the code
  doc: asciidoctor: specify name of our group

 Documentation/.gitignore                |  1 -
 Documentation/Makefile                  | 19 ++-------
 Documentation/asciidoc.conf             | 20 ---------
 Documentation/asciidoctor-extensions.rb | 56 ++++++++-----------------
 Documentation/manpage-base-url.xsl.in   | 10 -----
 Documentation/manpage-quote-apos.xsl    | 16 -------
 Makefile                                |  4 --
 7 files changed, 21 insertions(+), 105 deletions(-)
 delete mode 100644 Documentation/manpage-base-url.xsl.in
 delete mode 100644 Documentation/manpage-quote-apos.xsl

Range-diff against v3:
 1:  f9fe40224d =  1:  2a93d8774a doc: remove GNU troff workaround
 2:  eed7d77e1e =  2:  774603b50c doc: use --stringparam in xmlto
 3:  d8bebb37e4 =  3:  8e92e10b10 doc: simplify version passing
 4:  2df412bce6 =  4:  230b5c8ae0 doc: asciidoc: remove unnecessary attribute
 5:  3abdeada0c =  5:  2d1f79d642 doc: asciidoctor: remove unnecessary require
 6:  685cd824ea =  6:  e0b662986a doc: asciidoctor: remove cruft
 7:  7f1fb74a04 =  7:  1bdf72a856 doc: asciidoctor: reorganize extensions
 8:  bede3d2294 =  8:  8612b428ce doc: asciidoctor: use html-prefix only for html
 9:  2ecd19e4e3 =  9:  9cd9f3f317 doc: asciidoctor: refactor macro registration
10:  6c5e9142c8 = 10:  96bd66784f doc: asciidoctor: improve string handling
11:  820bc01e49 = 11:  5e293a15fc doc: asciidoctor: split the format from the code
12:  69de00c9ee = 12:  7fd97fc089 doc: asciidoctor: specify name of our group