On Mon, 22 Sept 2025 at 10:24, Jonathan Wakely <[email protected]> wrote: > > On Mon, 22 Sept 2025 at 10:05, Richard Biener > <[email protected]> wrote: > > > > On Sun, Sep 21, 2025 at 5:20 PM Mark Wielaard <[email protected]> wrote: > > > > > > Hi Aarsen, > > > > > > Added Jonathan to CC to get his opinion on the libstdc++ part of the > > > documentation (re)generation. > > > > > > 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. > > That script is run every night by cron on sourceware, but it only > updates the trunk snapshot. > > maintainer-scripts/generate_libstdcxx_web_docs is used to generate the > docs for a release. It might work on sourceware now, if we install the > right texlive packages, or maybe RHEL 8.10 is still too old. It used > to fail unless you used a very recent Doxygen and sometimes even had > to tweak the build to use LATEXCMD=lualatex. That isn't needed now.
Ah RHEL 8.10 has doxygen-1.8.14 which is quite old. A containerized build could solve that problem by using a working Doxygen release.
