Re: [PATCH] doc: make HTML manual reproducible

From: brian m. carlson <sandals@crustytoothpaste.net>
Date: Dec 2, 2020, 23:45 UTC
Message-ID: <X8gnItjchqX4wwmt@camp.crustytoothpaste.net>
In-Reply-To: <20201202160755.GX748@pobox.com>

On 2020-12-02 at 16:07:55, Todd Zullinger wrote:

Show 14 quoted lines

> brian m. carlson wrote:
> > 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.
> 
> Indeed.  Is it worth mentioning this at all in INSTALL?
> Something like:
> 
>   -   The minimum supported version of docbook-xsl is 1.74.
>   +   The minimum supported version of docbook-xsl is 1.74.  For consistent
>   +   IDs in the HTML version of the user-manual, 1.79.1 or newer is
>   +   necessary.
> 
> perhaps?

I don't know that that's even necessary. Anyone doing reproducible builds is already aware of the required versions in order to do a reproducible build, and I don't think the average user is going to be super interested.

We can if you feel strongly about it, but I don't personally see it as a big deal.

-- 
brian m. carlson (he/him or they/them)
Houston, Texas, US