#43489 [Opn->Csd]: Class synopsis return types are not links

From: 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

« previous php.doc.bugs (#436) next »