Hi Richard, On Mon, Sep 22, 2025 at 11:05:18AM +0200, Richard Biener wrote: > On Sun, Sep 21, 2025 at 5:20 PM Mark Wielaard <[email protected]> wrote: > > On Mon, Sep 08, 2025 at 06:07:48PM +0200, Arsen Arsenović wrote: > > > Mark Wielaard <[email protected]> writes: > > > > > > > I think it is a good thing to make it easier for users to regenerate > > > > the documentation locally for offline usage. And it would be helpful > > > > to check documentation generation work by using is as a snapshot > > > > builder and/or an Action that could be run on a merge request in the > > > > forge. > > > > > > > > We don't have to change the workflow to generate the online docs, it > > > > could still be done through a cron job. But if we can use the same > > > > script to generate them also locally, through a snapshots builder and > > > > maybe a merge request Action on the forge that would be great. Then > > > > when that works, we can decide whether to change the actual mechanism. > > > > > > To my understanding, no automation exists for release documentation. > > > This is what I mean. > > > > It would be good to at least document what the release managers do to > > create the release documentation. I assumed they ran > > maintainer-scripts/update_web_docs_git and > > maintainer-scripts/update_web_docs_libstdcxx_git after a release to > > create the version specific onlinedocs. > > > > If they would be able to use this new script instead that would be > > good. > > Never change a running system ;) > > maintainer-scripts/update_web_docs_libstdcxx_git isn't run by us but > by Jonathan as it cannot be run on sourceware. > > An improvement would be to have documentation build (and its requirements) > containerized somehow.
That is indeed the idea, we take this new script and wrap it into a container which has all the right versions of the requirements: https://sourceware.org/cgit/builder/tree/builder/master.cfg#n4166 https://sourceware.org/cgit/builder/tree/builder/containers/Containerfile-fedora-latest Which runs every hour if there are new commits to produce the docs: https://snapshots.sourceware.org/gcc/docs/ https://builder.sourceware.org/buildbot/#/builders/gcc-snapshots And sents out warning emails if the doc generation breaks. Cheers, Mark
