git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 0/6] Doc: drop support for docbook-xsl before 1.74

From
MÅMartin Ågren <martin.agren@gmail.com>
Date
Mar 29, 2020, 13:18 UTC
Message-ID
<cover.1585486103.git.martin.agren@gmail.com>

In the documentation Makefile and a few helper conf and xsl files, we carry various workarounds to make the docs build at all or to look better with older docbook-xsl versions. Let's see if we can't just drop that support. All of this seems to have been useful at one point, but I doubt that anyone needs this nowadays. This was also suggested in [1].

The final commit in this series bumps the minimum required version of docbook-xsl to 1.74.0, which is from June 2008. The whole series should be a no-op unless you're on an older release than that. That said, I've only tested this with the version that comes with my OS, 1.79.1.

After this series, user-manual.conf still refers to older docbook-xsl versions. The proper fix there might be to actually be a bit more aggressive and drop that hunk, making the rendered docs prettier. There's some history there, including mentions of texinfo, which is outside my comfort zone. I've got work in progress there, but I'd rather submit that separately from these "expected no-op" patches.

Martin
[1] https://lore.kernel.org/git/20191030212422.GE29013@sigill.intra.peff.net/
Martin Ågren (6):
  Doc: drop support for docbook-xsl before 1.71.1
  Doc: drop support for docbook-xsl before 1.72.0
  Doc: drop support for docbook-xsl before 1.73.0
  manpage-bold-literal.xsl: stop using git.docbook.backslash
  manpage-normal.xsl: fold in manpage-base.xsl
  INSTALL: drop support for docbook-xsl before 1.74
 Documentation/Makefile                 | 23 -----------------
 Documentation/asciidoc.conf            | 19 --------------
 Documentation/manpage-1.72.xsl         | 14 -----------
 Documentation/manpage-base.xsl         | 35 --------------------------
 Documentation/manpage-bold-literal.xsl |  6 ++---
 Documentation/manpage-normal.xsl       | 25 +++++++++++++-----
 Documentation/manpage-suppress-sp.xsl  | 21 ----------------
 Makefile                               |  6 -----
 INSTALL                                |  4 +--
 9 files changed, 22 insertions(+), 131 deletions(-)
 delete mode 100644 Documentation/manpage-1.72.xsl
 delete mode 100644 Documentation/manpage-base.xsl
 delete mode 100644 Documentation/manpage-suppress-sp.xsl
-- 
2.26.0
Next: Martin Ågren
Message 1 of 16 in “Doc: drop support for docbook-xsl before 1.74”
  1. 0/6 Doc: drop support for docbook-xsl before 1.74Martin Ågren, Mar 29, 2020
  2. 1/6 Doc: drop support for docbook-xsl before 1.71.1Martin Ågren, Mar 29, 2020
  3. 2/6 Doc: drop support for docbook-xsl before 1.72.0Martin Ågren, Mar 29, 2020
  4. 3/6 Doc: drop support for docbook-xsl before 1.73.0Martin Ågren, Mar 29, 2020
  5. 4/6 manpage-bold-literal.xsl: stop using git.docbook.backslashMartin Ågren, Mar 29, 2020
  6. 5/6 manpage-normal.xsl: fold in manpage-base.xslMartin Ågren, Mar 29, 2020
  7. 6/6 INSTALL: drop support for docbook-xsl before 1.74Martin Ågren, Mar 29, 2020
  8. Jeff KingMar 30, 2020
  9. Junio C HamanoMar 29, 2020
  10. Jeff KingMar 30, 2020
  11. Martin ÅgrenMar 31, 2020
  12. Jeff KingApr 1, 2020
  13. Junio C HamanoApr 1, 2020
  14. brian m. carlsonApr 2, 2020
  15. Junio C HamanoApr 2, 2020
  16. brian m. carlsonMar 30, 2020

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.