Skip to content

Convert and move global.ent into doc-en - #5722

Open
alfsb wants to merge 2 commits into
php:masterfrom
alfsb:global-move
Open

Convert and move global.ent into doc-en#5722
alfsb wants to merge 2 commits into
php:masterfrom
alfsb:global-move

Conversation

@alfsb

@alfsb alfsb commented Jul 28, 2026

Copy link
Copy Markdown
Member

Move global.ent entirely into doc-en, all of it, including URLs, at least while manual split is not complete.

The only thing that is truly global resting in doc-base/entities/global.ent was URLs, but these are also "moved" here as to allow changes to be more easily done, without depending on PRs that cross repositories.

Tested on all languages. As an incidental first result, text-entitites.php found a duplication (url.libevent), already fixed. After, is to change all residual files in doc-base/entities to note these files are to be erased, when doc-ext recreates any (hopefully few) entities they need.

Comments and reviews are welcome. Plan to merge this in one week.

@alfsb alfsb changed the title Conver and move global.ent into doc-en Convert and move global.ent into doc-en Jul 28, 2026
@jordikroon

jordikroon commented Jul 28, 2026

Copy link
Copy Markdown
Member

I was asking you if this was all, but then the full list of links came in.
This looks great. I don't have much to say about the comment, let's see if we get any feedback from translators positive or negative if any.

I have a strong feeling a big chunk of these links are in third-party extensions. So it would do good to see this file become shorter over time when we migrate those to doc-ext.

@alfsb

alfsb commented Jul 29, 2026

Copy link
Copy Markdown
Member Author

After parts of manuals start moving into doc-ext, a tool that lists all entities, and then a tool that tries to build the manual with one entity erased, can be used to check unused entities in doc-en, and also translations, to shrink the language-snippets.ent.

I may create an entities/entities.remove.dtd file, to push these cases here, so no conversion into XML would be necessary.

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