Skip to content

Move PhD auxiliary-file generation out to php/phd#318

Open
lacatoire wants to merge 2 commits into
php:masterfrom
lacatoire:drop-phd-generation
Open

Move PhD auxiliary-file generation out to php/phd#318
lacatoire wants to merge 2 commits into
php:masterfrom
lacatoire:drop-phd-generation

Conversation

@lacatoire

@lacatoire lacatoire commented Jul 8, 2026

Copy link
Copy Markdown
Member

Following php/phd#253 (comment). configure.php now only assembles and validates the XML.

Removes the generation of version.xml, sources.xml and fileModHistory.php (phd_acronym, php_history, phd_sources, phd_version), writing a doc-base/temp/phd-conf.json handoff instead. Also fixes the --history-file option, which set SOURCES_FILE instead of HISTORY_FILE.

Companion: php/phd#261 (adds genphdfiles.php).
Do not merge before the build pipeline calls php phd/genphdfiles.php doc-base/temp/phd-conf.json, otherwise the manual would build without version banners.

configure.php now only assembles and validates the XML. The generation of
version.xml, sources.xml and fileModHistory.php is removed (phd_acronym,
php_history, phd_sources, phd_version) and delegated to php/phd via a
doc-base/temp/phd-conf.json handoff.

Also fixes the --history-file option, which set SOURCES_FILE instead of
HISTORY_FILE.

Depends on php/phd (adds genphdfiles.php). The build pipeline must call
'php phd/genphdfiles.php doc-base/temp/phd-conf.json' before this lands.
@alfsb

alfsb commented Jul 8, 2026

Copy link
Copy Markdown
Member

Wow! That is exactly what I was thinking of. Paint me very impressed.

The moved files are mentioned in .gitignore, so they can also be removed here. My long term plan is to shrink this file to only temp/.

version.xml, sources.xml and fileModHistory.php are now generated by
PhD (genphdfiles.php), not by configure.php, so doc-base no longer
produces them.
@alfsb

alfsb commented Jul 8, 2026

Copy link
Copy Markdown
Member

I think the doc-base side is ok. You can merge here at your earliest convenience, and yet, let this open a few days, for comments and/or reviews. I will do a heads up no Discord, to be sure.

@alfsb alfsb mentioned this pull request Jul 8, 2026
42 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants