php / php/phd

Half of `doc-pl` is all bold

Open
#247 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
PHP
Stars
91
Forks
59
PR merge metrics
No merged PRs in 30d

Description

While developing a fix for doc-pl build failures, I stubbed on this. Running:

git -C phd checkout 5f10df173f923d261fa0ae3aa3b2f5778b327e73
php zpr-doc-base/configure.php --with-lang=pl -q
php phd/render.php -d zpr-doc-base/.manual.xml -f bigxhtml

Generates thousands of:

[11:57:01 - E_WARNING             ] /home/andre/phpdoc-test/phd/phpdotnet/phd/Package/Generic/XHTML.php:1899
preg_match(): Unknown modifier '/'

PhD checkout at 5f10df because I'm stuck with PHP 8.1. zpr-doc-base is https://github.com/php/doc-base/pull/277 , otherwise doc-pl wont validate.

This may be related or not with rendered doc-pl having half of the manual rendered with <strong> wrapping all tags after some point.

Image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the report with php zpr-doc-base/configure.php and php phd/render.php using the stated checkouts. Start at phpdotnet/phd/Package/Generic/XHTML.php:1899 and inspect the generated warnings and rendered doc-pl output. Done means the warning flood is resolved and the manual no longer renders large sections with bold tags.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.