|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Bug #52314 Incorrect use of classsynopsisinfo
Submitted: 2010-07-12 12:17 UTC Modified: 2012-04-06 17:37 UTC
Avg. Score:5.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:1 (100.0%)
Same OS:1 (100.0%)
From: RQuadling at GMail dot com Assigned: bjori (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: n/a
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
Block user comment
Status: Assign to:
Bug Type:
From: RQuadling at GMail dot com
New email:
PHP Version: OS:


 [2010-07-12 12:17 UTC] RQuadling at GMail dot com
Looking at most of the OOP class pages ...

3 chosen at random :

There is an empty white box at the top of the class definition.

The issue seems to be due to the first ooclass tag which isn't rendered 

The xml also has ooclass and oointerface tags inside an classsynopsisinfo. This 
seems to be against the intent of a classsynopsisinfo.

TDG5 ( says 
"Supplementary information in a classsynopsis. See classsynopsis. 

Unlike the other info elements, classsynopsisinfo is not a container for meta-
information. Instead classsynopsisinfo is a verbatim environment for adding 
additional information to a class synopsis."

Also important on this is the processing expectations which are "This element is 
displayed “verbatim”; whitespace and line breaks within this element are 

What exactly warrants "Supplementary information" is the issue here. DocBook has 
tags for ooclass and oointerface (and these are in the "1 or more of" sequence 
for classsynopsis) and so have no need to be thought of as "supplementary 

Using classsynopsisinfo to show comments (/* Methods */, /* Constants */, etc.) 
would seem to fit the spirit of this tag.

So ...

<!-- {{{ Synopsis -->

<!-- {{{ Class synopsis -->
<!-- }}} -->
    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>

should be ...

<!-- {{{ Synopsis -->

<!-- }}} -->
    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>

No need for the classsynopsisinfo with the ooclass tags.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2010-10-23 14:51 UTC]
-Type: Documentation Problem +Type: Bug
 [2012-04-06 17:37 UTC]
This was fixed a while ago
 [2012-04-06 17:37 UTC]
-Status: Open +Status: Closed -Assigned To: +Assigned To: bjori
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Wed May 29 06:01:32 2024 UTC