From: Felipe Contreras <felipe.contreras@gmail.com>
To: git@vger.kernel.org
Cc: "Junio C Hamano" <gitster@pobox.com>,
"Martin Ågren" <martin.agren@gmail.com>,
"brian m . carlson" <sandals@crustytoothpaste.net>,
"Felipe Contreras" <felipe.contreras@gmail.com>
Subject: [PATCH v2 00/12] doc: cleanup old cruft and asciidoctor revamp
Date: Fri, 21 May 2021 17:36:49 -0500 [thread overview]
Message-ID: <20210521223701.526547-1-felipe.contreras@gmail.com> (raw)
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].
Since v2 there's only one small fix that introduced an extra space after linkgit.
[2] https://lore.kernel.org/git/20210521222941.525901-1-felipe.contreras@gmail.com/
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 v1:
1: 371b0ababd = 1: f9fe40224d doc: remove GNU troff workaround
2: 0d55f9dd09 = 2: eed7d77e1e doc: use --stringparam in xmlto
3: 2c2af6bade = 3: d8bebb37e4 doc: simplify version passing
4: eef11180d2 = 4: 2df412bce6 doc: asciidoc: remove unnecessary attribute
5: 573b0995b2 = 5: 3abdeada0c doc: asciidoctor: remove unnecessary require
6: 35fceb27ea = 6: 685cd824ea doc: asciidoctor: remove cruft
7: 2b4f696ad6 = 7: 7f1fb74a04 doc: asciidoctor: reorganize extensions
8: 1860058908 = 8: bede3d2294 doc: asciidoctor: use html-prefix only for html
9: 5fc0a42cec = 9: 2ecd19e4e3 doc: asciidoctor: refactor macro registration
10: c09718f046 ! 10: 6c5e9142c8 doc: asciidoctor: improve string handling
@@ Documentation/asciidoctor-extensions.rb: Asciidoctor::Extensions.register do
- "<refentrytitle>#{target}</refentrytitle>" \
- "<manvolnum>#{attrs[1]}</manvolnum>\n" \
- "</citerefentry>"
-+ <<~EOF % [target, attrs[1]]
++ <<~EOF.chomp % [target, attrs[1]]
+ <citerefentry>
+ <refentrytitle>%s</refentrytitle><manvolnum>%s</manvolnum>
+ </citerefentry>
11: f4c5c7d593 ! 11: 820bc01e49 doc: asciidoctor: split the format from the code
@@ Documentation/asciidoctor-extensions.rb: Asciidoctor::Extensions.register do
+ format = %(<a href="#{prefix}%1$s.html">%1$s(%2$s)</a>)
elsif doc.basebackend? 'docbook'
- process do |parent, target, attrs|
-- <<~EOF % [target, attrs[1]]
+- <<~EOF.chomp % [target, attrs[1]]
- <citerefentry>
- <refentrytitle>%s</refentrytitle><manvolnum>%s</manvolnum>
- </citerefentry>
- EOF
- end
-+ format = <<~EOF
++ format = <<~EOF.chomp
+ <citerefentry>
+ <refentrytitle>%s</refentrytitle><manvolnum>%s</manvolnum>
+ </citerefentry>
12: 96e981b97f = 12: 69de00c9ee doc: asciidoctor: specify name of our group
--
2.32.0.rc0
next reply other threads:[~2021-05-21 22:37 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-05-21 22:36 Felipe Contreras [this message]
2021-05-21 22:36 ` [PATCH v2 01/12] doc: remove GNU troff workaround Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 02/12] doc: use --stringparam in xmlto Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 03/12] doc: simplify version passing Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 04/12] doc: asciidoc: remove unnecessary attribute Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 05/12] doc: asciidoctor: remove unnecessary require Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 06/12] doc: asciidoctor: remove cruft Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 07/12] doc: asciidoctor: reorganize extensions Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 08/12] doc: asciidoctor: use html-prefix only for html Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 09/12] doc: asciidoctor: refactor macro registration Felipe Contreras
2021-05-21 22:36 ` [PATCH v2 10/12] doc: asciidoctor: improve string handling Felipe Contreras
2021-05-21 22:37 ` [PATCH v2 11/12] doc: asciidoctor: split the format from the code Felipe Contreras
2021-05-21 22:37 ` [PATCH v2 12/12] doc: asciidoctor: specify name of our group Felipe Contreras
2021-05-24 18:01 ` [PATCH v2 00/12] doc: cleanup old cruft and asciidoctor revamp Junio C Hamano
2021-05-24 19:23 ` Felipe Contreras
2021-05-25 6:59 ` Junio C Hamano
2021-05-25 7:14 ` Junio C Hamano
2021-05-25 10:44 ` Felipe Contreras
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210521223701.526547-1-felipe.contreras@gmail.com \
--to=felipe.contreras@gmail.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=martin.agren@gmail.com \
--cc=sandals@crustytoothpaste.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.