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

Re: [PATCH] doc: make HTML manual reproducible

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
Dec 2, 2020, 00:36 UTC
Message-ID
<X8bhdyu/OlscI1ME@camp.crustytoothpaste.net>
In-Reply-To
<20201201154115.GP748@pobox.com>
On 2020-12-01 at 15:41:15, Todd Zullinger wrote:
Show 6 quoted lines
> I think this would raise the minimum supported version of
> docbook-xsl to 1.77.1.  That might be fine, but we'd
> probably want to make sure it doesn't negatively impact
> OS/distributions which build the docs as a likely group who
> care about reproducible builds.  And we'd want to update the
> requirement in INSTALL, of course.

I don't think that's necessarily the case. I just tested using a random name with another DocBook project I have and it seems to work fine, so there shouldn't be a problem with specifying a name undefined in the stylesheet using xsltproc.

If we want this to be effective, then yes, people will need to upgrade. But if they're happy with the old behavior on ancient systems, that shouldn't be a problem.

Regardless, I think this is a valuable change, since there's no good reason not to use consistent IDs and at least Debian is switching to all reproducible builds so vendors will appreciate this change.

Show 5 quoted lines
> AFAICT, the generate.consistent.ids param was added in
> docbook-xsl-1.77.1 which was released in June 2012.  The
> commit which added it is 74735098e (New param to support
> replacing generate-id() with xsl:number for more consistent
> id values., 2011-10-24).
If this was released in 2012, we should be fine.
Show 5 quoted lines
> In any case, a minimum of 1.77.1 is present in the supported
> releases of CentOS/RHEL and Debian/Ubuntu, at least (most
> have 1.79.x).  Those are certainly not the only systems Git
> cares about; they're simply the systems with which I am at
> least mildly familiar.

Yeah, CentOS 6 went EOL on November 30, which is very convenient. I'm pretty sure nobody else is using such an old version, and even so, I don't see a backwards compatibility problem with this change.

-- 
brian m. carlson (he/him or they/them)
Houston, Texas, US
Previous: Martin ÅgrenNext: Todd Zullinger
Message 7 of 15 in “doc: make HTML manual reproducible”
  1. doc: make HTML manual reproducibleArnout Engelen, Dec 1, 2020
  2. Todd ZullingerDec 1, 2020
  3. Martin ÅgrenDec 1, 2020
  4. Jeff KingDec 2, 2020
  5. Junio C HamanoDec 1, 2020
  6. Martin ÅgrenDec 1, 2020
  7. brian m. carlsonDec 2, 2020
  8. Todd ZullingerDec 2, 2020
  9. Junio C HamanoDec 2, 2020
  10. brian m. carlsonDec 2, 2020
  11. Junio C HamanoDec 3, 2020
  12. Todd ZullingerDec 3, 2020
  13. Re* [PATCH] doc: make HTML manual reproducibleJunio C Hamano, Dec 3, 2020
  14. Arnout EngelenDec 3, 2020
  15. brian m. carlsonDec 2, 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.