We have traditionally bundled pre-built documentation in the tarballs, namely the man pages and API manual, in order to avoid the pandoc and doxygen build dependencies. This was acceptable in the autotools era since the dist tarballs had to be *built* anyway.
Having moved to cmake and now also to scdoc for the man pages (replacing pandoc), we can finally drop these non-reproducible bits altogether, so do that. The API docs aren't needed for bootstrapping anyway and doxygen is a widely available tool, so folks (e.g. distros) can just build them normally as part of the project with "make" (when configured with -DWITH_DOXYGEN=ON). This makes our release tarballs pristine and fully reproducible since they are now nothing more than a git-archive(1) of the source tree and the po/ submodule, plus a ChangeLog file generated with git-log(1). The ChangeLog file is useful as it acts as a "stamp" carrying the git commit ID that the archive was made from. Fixes: #3565 You can view, comment on, or merge this pull request online at: https://github.com/rpm-software-management/rpm/pull/3701 -- Commit Summary -- * Make our dist tarballs pristine and reproducible -- File Changes -- M CMakeLists.txt (14) M docs/CMakeLists.txt (5) -- Patch Links -- https://github.com/rpm-software-management/rpm/pull/3701.patch https://github.com/rpm-software-management/rpm/pull/3701.diff -- Reply to this email directly or view it on GitHub: https://github.com/rpm-software-management/rpm/pull/3701 You are receiving this because you are subscribed to this thread. Message ID: <rpm-software-management/rpm/pull/[email protected]>
_______________________________________________ Rpm-maint mailing list [email protected] https://lists.rpm.org/mailman/listinfo/rpm-maint
