Skip to content

Commit

Permalink
Change <classsynopsis> RelaxNG schema (#123)
Browse files Browse the repository at this point in the history
To not be incompatible with DocBook 5.1 and our docs
  • Loading branch information
Girgias authored May 14, 2024
1 parent f35be27 commit bfa76b3
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 2 deletions.
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,12 @@ DocBook on Linux or Windows, or what conventions you
should follow when writing phpdoc files, please refer
to the PHP Documentation HOWTO.

The PHP Documentation uses the [DocBook 5.2](https://tdg.docbook.org/tdg/5.2/) XML schema. \
However, there is one small change between the official Docbook 5.2 schema and the schema used by the PHP documentation:
the `<classsynopsis>` tag allows "One or more Oriented Object Programming inlines",
like the [DocBook 5.1](https://tdg.docbook.org/tdg/5.1/classsynopsis) schema does,
instead of "One Oriented Object Programming inlines".

You can read the HOWTO online at: http://doc.php.net/tutorial/

If you are already working with the phpdoc module,
Expand Down
4 changes: 3 additions & 1 deletion docbook/docbook-v5.2-os/rng/docbook.rng
Original file line number Diff line number Diff line change
Expand Up @@ -16249,7 +16249,9 @@ where the nonterminal
<zeroOrMore>
<ref name="db.templatename"/>
</zeroOrMore>
<ref name="db.oo.inlines"/>
<oneOrMore>
<ref name="db.oo.inlines"/>
</oneOrMore>
<zeroOrMore>
<choice>
<ref name="db.template"/>
Expand Down
4 changes: 3 additions & 1 deletion docbook/docbook-v5.2-os/rng/docbookxi.rng
Original file line number Diff line number Diff line change
Expand Up @@ -16394,7 +16394,9 @@ where the nonterminal
<zeroOrMore>
<ref name="db.templatename"/>
</zeroOrMore>
<ref name="db.oo.inlines"/>
<oneOrMore>
<ref name="db.oo.inlines"/>
</oneOrMore>
<zeroOrMore>
<choice>
<ref name="db.template"/>
Expand Down

0 comments on commit bfa76b3

Please sign in to comment.