model-writtenrun 7260 - may be wrong, links go to the source messages. Commit-by-commit LLM analysis is in the Commits dialog.
- Andres Freund opened the discussion by asking how install-world should behave without documentation tools, proposing an automatic Meson documentation feature that would fail during configuration when explicitly enabled but unavailable, with separate detection for heavyweight PDF dependencies #1.
- Tom Lane argued that install-world should install documentation or fail, and questioned spending additional effort on missing-stylesheet diagnostics; Andres clarified that his proposal concerned configuration options rather than changing the meaning of the docs build target #2 #3.
- Peter Eisentraut supported grouping HTML and man pages under docs because both are installed, and accepted separate feature detection for PDF tools after Andres clarified the scope #4 #5 #6.
- Andres submitted six patches implementing docs and docs_pdf options alongside preparatory Meson cleanup, removal of incomplete htmlhelp support, XSLT-based image copying, stylesheet loading, and a simple-versus-website HTML style option #7.
- Justin Pryzby reviewed the option descriptions, proposing clearer wording for enabling documentation and explaining the HTML stylesheet choices; Andres subsequently accepted the wording with a refinement clarifying that website styling references the online stylesheet #8 #9.
- The preparatory cleanup landed separately as 0ba827ecfc, taking one patch from the submission with a small relocation of HTML flag initialization #7.
- The documentation feature options landed as ef07d351a1, taking another patch from the submission with Justin's wording corrections and an additional condition making INSTALL generation respect the docs feature; Andres then reported pushing the changes #7 #8 #9.
- After landing, Andres reported that crake failed because the buildfarm disabled all Meson features while still requesting HTML documentation, which now required enabling the docs feature #10.
- Andrew Dunstan fixed the buildfarm client to pass -Ddocs=enabled when documentation was required and also -Ddocs_pdf=enabled when PDF output was required; Andres accepted the fix and explained that existing build trees could change these options through meson configure without rebuilding binaries, leaving no further action requested in the thread #11 #12.