#43489 [Fbk->Opn]: Class synopsis return types are not links
| From: | ezyang@php.net | Date: | Wed, 05 Dec 2007 02:48:15 +0000 |
| Subject: | #43489 [Fbk->Opn]: Class synopsis return types are not links | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-321@lists.php.net to get a copy of this message | ||
ID: 43489
User updated by: ezyang@php.net
Reported By: ezyang@php.net
-Status: Feedback
+Status: Open
Bug Type: Doc Build problem
Operating System: Windows Vista
PHP Version: Irrelevant
New Comment:
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.
Previous Comments:
------------------------------------------------------------------------
[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