Skip to content

Commit bfa76b3

Browse files
authored
Change <classsynopsis> RelaxNG schema (#123)
To not be incompatible with DocBook 5.1 and our docs
1 parent f35be27 commit bfa76b3

File tree

3 files changed

+12
-2
lines changed

3 files changed

+12
-2
lines changed

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,12 @@ DocBook on Linux or Windows, or what conventions you
1818
should follow when writing phpdoc files, please refer
1919
to the PHP Documentation HOWTO.
2020

21+
The PHP Documentation uses the [DocBook 5.2](https://tdg.docbook.org/tdg/5.2/) XML schema. \
22+
However, there is one small change between the official Docbook 5.2 schema and the schema used by the PHP documentation:
23+
the `<classsynopsis>` tag allows "One or more Oriented Object Programming inlines",
24+
like the [DocBook 5.1](https://tdg.docbook.org/tdg/5.1/classsynopsis) schema does,
25+
instead of "One Oriented Object Programming inlines".
26+
2127
You can read the HOWTO online at: http://doc.php.net/tutorial/
2228

2329
If you are already working with the phpdoc module,

docbook/docbook-v5.2-os/rng/docbook.rng

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16249,7 +16249,9 @@ where the nonterminal
1624916249
<zeroOrMore>
1625016250
<ref name="db.templatename"/>
1625116251
</zeroOrMore>
16252-
<ref name="db.oo.inlines"/>
16252+
<oneOrMore>
16253+
<ref name="db.oo.inlines"/>
16254+
</oneOrMore>
1625316255
<zeroOrMore>
1625416256
<choice>
1625516257
<ref name="db.template"/>

docbook/docbook-v5.2-os/rng/docbookxi.rng

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16394,7 +16394,9 @@ where the nonterminal
1639416394
<zeroOrMore>
1639516395
<ref name="db.templatename"/>
1639616396
</zeroOrMore>
16397-
<ref name="db.oo.inlines"/>
16397+
<oneOrMore>
16398+
<ref name="db.oo.inlines"/>
16399+
</oneOrMore>
1639816400
<zeroOrMore>
1639916401
<choice>
1640016402
<ref name="db.template"/>

0 commit comments

Comments
 (0)