Skip to content

Resolve the language checkouts through one variable - #3

Closed
lacatoire wants to merge 1 commit into
masterfrom
chore/generated-files-in-temp
Closed

lacatoire wants to merge 1 commit into
masterfrom
chore/generated-files-in-temp

Conversation

@lacatoire

@lacatoire lacatoire commented Aug 7, 2026 •

Copy link
Copy Markdown
Owner

doc-base is moving every file its build generates into a single ignored temp/ directory, the manual file included.

The three generated files it feeds PhD need no change: xmlRoot is dirname() of the path given to -d (phpdotnet/phd/Options/Handler.php:193), so pointing -d at doc-base/temp/.manual.xml resolves version.xml, sources.xml and fileModHistory.php inside temp/ on their own.

The acronym lookup does break, though. It walks up from xmlRoot to reach the language checkouts sitting next to doc-base, and that path gains one level:

today  xmlRoot = <root>/doc-base       dirname -> <root>          -> <root>/en/entities/...  ok
moved  xmlRoot = <root>/doc-base/temp  dirname -> <root>/doc-base -> <root>/doc-base/en/...  missing

The warning is Can't find acronym file (...), skipping, so acronym expansions would quietly disappear from the rendered manual.

The lookup now goes through a $docsRoot variable holding today's value. When the doc-base side is merged it becomes dirname(dirname($config->xmlRoot)) and nothing else moves. Verified both ways with a full -f php render: the warning appears with one and is gone with the other.

@lacatoire
lacatoire force-pushed the chore/generated-files-in-temp branch from 2609b9c to 5016f3e Compare August 7, 2026 12:28
@lacatoire lacatoire changed the title Read generated doc-base files from temp/, falling back to the root Document the new location of the generated manual file Aug 7, 2026
@lacatoire
lacatoire force-pushed the chore/generated-files-in-temp branch from 5016f3e to 4bf9e75 Compare August 7, 2026 12:31
doc-base is moving every file its build generates into a temp/
subdirectory, the manual file included. xmlRoot is the directory of the
file passed to -d, so it gains one level, and dirname($config->xmlRoot)
stops pointing at the directory holding the language checkouts: the
acronym entity file is then not found and expansions are silently
skipped.

The lookup now goes through $docsRoot, so the day doc-base moves, only
that line changes. The documented command line is updated as well.
@lacatoire lacatoire changed the title Document the new location of the generated manual file Resolve the language checkouts through one variable Aug 7, 2026
@lacatoire
lacatoire force-pushed the chore/generated-files-in-temp branch from 4bf9e75 to 8b4baba Compare August 7, 2026 12:45
@lacatoire lacatoire closed this Aug 7, 2026
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.

1 participant