Rendering differences around non significant XML
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 35/100
- Tipo de issue
- Error
- Claridad
- Necesita aclaración
- Estado de actividad
- Tranquilo
- Stack tecnológico
- php
- Área
- build-system, documentation
Línea de trabajo
Reproduce la comparación con doc-base/configure.php, phd/render.php y doc-base/.manual.xml utilizando las revisiones exactas y el comando de PHP mostrado. Compara las salidas generadas para TDs vacíos y archivos omitidos, cambiando únicamente los comentarios XML o los namespaces duplicados. Se considera completado cuando se haya establecido si las diferencias son reproducibles y se haya identificado su origen, o se haya documentado que no se encontró una causa estable.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
While developing the XML trim project, testing showed some differences that may or may not be worth debugging. I think these changes (removal of XML comments and removal of duplicated XML namespaces) surfaced heisenbug, in a very controlled setup, so it is possible to stabilize PhD to not show dependent behaviour in non significant XML changes.
The setup:
phd 1a70b5bd531e4687b64447d0c0a3e33cb9c98714
en 36d18e7d4a32ecfdacc1eb086276ffb1baf0393c
doc-base (prev) 738f18cf429d45eed2698b8cd77d3364ea87f085
doc-base (next) 8eeece936aa2103c0632a22e47791749cb7aa697
php -v
PHP 8.1.2-1ubuntu2.25 (cli) (built: Jul 16 2026 18:32:33) (NTS)
rm -rf output
php doc-base/configure.php -q --with-lang=en
php phd/render.php --color false --package PHP --format php --format xhtml --format bigxhtml --format tocfeed -d doc-base/.manual.xml
These are the major differences observed.
Empty TD
There is a lot of:
< <td></td>
---
> <td class="empty"> </td>
These, while annoying, does not change the behaviour or rendered manual. The worrie is that XML comments or duplicated namespace somehow affects empty TDs.
Files omitted
There are a lot of files that are emitted with doc-base prev, that are not in doc-base prev. Things like:
Only in doc-base-prev-out/php-chunked-xhtml: intro.apache.html
Only in doc-base-prev-out/php-chunked-xhtml: intro.apcu.html
Only in doc-base-prev-out/php-chunked-xhtml: intro.array.html
...
Only in doc-base-prev-out/php-chunked-xhtml: intro.zmq.html
Only in doc-base-prev-out/php-chunked-xhtml: intro.zookeeper.html
Only in doc-base-prev-out/php-chunked-xhtml: mysqlinfo.intro.html
Only in doc-base-prev-out/php-chunked-xhtml: preface.html
Only in doc-base-prev-out/php-web: intro.apache.php
Only in doc-base-prev-out/php-web: intro.apcu.php
Only in doc-base-prev-out/php-web: intro.array.php
...
Only in doc-base-prev-out/php-web: intro.zmq.php
Only in doc-base-prev-out/php-web: intro.zookeeper.php
Only in doc-base-prev-out/php-web: mysqlinfo.intro.php
Only in doc-base-prev-out/php-web: preface.php
All these files appear to not being published on the main manual, so they also do not block XML trim merge, but is something that worries me more, as now entire files are being created or omitted bases in non-significant XML.
- Lenguaje dominante
- PHP
- Estrellas
- 91
- Forks
- 59
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Guía de contribución
No hay ninguna guía de contribución indexada para este repositorio
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de php/phd
-
Dificultad 4/5 3-5 días Aptitud para principiantes 52/100
-
Can <subtitle> not be used? Abierto
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
-
Half of `doc-pl` is all bold Abierto
Dificultad 4/5 3-5 días Aptitud para principiantes 42/100
-
enhancement
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
-
Rendering issue on Warning Abiertobug
Dificultad 3/5 1-2 días Aptitud para principiantes 42/100
Issues similares
-
tooling
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
UX
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
ProfessionalWiki/NeoWiki#1525 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
OpenConext/OpenConext-engineblock#2122 ·
-
Bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Automattic/safe-publish#594 ·