#43489 [Opn->Csd]: Class synopsis return types are not links
| From: | bjori@php.net | Date: | Thu, 10 Jan 2008 21:41:04 +0000 |
| Subject: | #43489 [Opn->Csd]: Class synopsis return types are not links | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-436@lists.php.net to get a copy of this message | ||
ID: 43489
Updated by: bjori@php.net
Reported By: ezyang@php.net
-Status: Open
+Status: Closed
Bug Type: Doc Build problem
Operating System: Windows Vista
PHP Version: Irrelevant
-Assigned To:
+Assigned To: bjori
New Comment:
This bug has been fixed in CVS. Since the websites are not directly
updated from the CVS server, the fix might need some time to spread
across the globe to all mirror sites, including PHP.net itself.
Thank you for the report, and for helping us make PHP.net better.
objects and other pseudo types (mixed, callback..) in fieldsynopsis &
methodparam now generate links, and methodsynopsis when not in
classsynopsis.
Previous Comments:
------------------------------------------------------------------------
[2007-12-05 02:48:15] ezyang@php.net
I think a phpdotnet::format_type_text() change would work better, but
that's just my opinion. We've never linked to the base PHP types, and I
don't think we're about to start.
------------------------------------------------------------------------
[2007-12-04 12:21:22] bjori@php.net
We should be consistent.. Either all <fieldsynopsis><type>s should be
links or none...
Or maybe always link <type> if its a classname (methodparam,
methodsynopsis, classsynopsisinfo..)?
------------------------------------------------------------------------
[2007-12-04 09:44:39] bjori@php.net
See phpdotnet::format_type_text(), we should probably add a default
case there that checks if class.$type exists - and if so, link to it.
------------------------------------------------------------------------
[2007-12-03 20:41:08] ezyang@php.net
Description:
------------
Inside the generated class synopsis, return types for method are often
classes. These classes should be linkified to point to their respective
documentation page.
Reproduce code:
---------------
<fieldsynopsis>
<modifier>readonly</modifier>
<modifier>public</modifier>
<type>DOMElement</type>
<varname
linkend="domdocument.props.documentelement">documentElement</varname>
</fieldsynopsis>
Expected result:
----------------
DOMElement in generated output is link
Actual result:
--------------
Class name is not.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=43489&edit=1