mbox series

[RFC/NOPATCHv3,0/4] doc: asciidoctor: direct man page creation and fixes (brian's version)

Message ID 20210618203057.790320-1-felipe.contreras@gmail.com (mailing list archive)
Headers show
Series doc: asciidoctor: direct man page creation and fixes (brian's version) | expand


Felipe Contreras June 18, 2021, 8:30 p.m. UTC
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@camp.crustytoothpaste.net/
[2] https://lore.kernel.org/git/20210608090026.1737348-1-felipe.contreras@gmail.com/
[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