Re: How to link to reserved words?
| From: | Hannes Magnusson | Date: | Wed, 06 Aug 2008 07:59:07 +0000 |
| Subject: | Re: How to link to reserved words? | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969379238@lists.php.net to get a copy of this message | ||
On Wed, Aug 6, 2008 at 05:20, Paul Reinheimer <preinheimer@gmail.com> wrote:
> Hey all
>
>
> How do I link to a reserved word in the see also section? Ideally I
> want to link file_get_contents() to
>
> http://ca.php.net/manual/en/reserved.variables.httpresponseheader.php
Good point. You could obviously just use the ID and do <link
linkend="reserved.variables.httpresponseheader">$http_response_header</link>
(or even <xref linkend="reserved.variables.httpresponseheader" />),
but it would be much more fun if <var>$http_response_header</var>
would automatically link to the correct refentry.
For that idea to work we would have to, yet again, modify the DocBook
DTD and introduce <phpdoc:varentry> (which "inherits" refentry) so we
can properly distinguish between function refentries and variable
refentries... I already have a patch for <phpdoc:classref> (for
classess) which I'll commit after the next build on friday.. Any
objections to introducing <phpdoc:varentry>? (or does anyone have a
better name for it?)
Regarding general reserved words (__FILE__, __METHOD__, xor, static,
if....), you'll have to link to those "manually" via <link> or <xref
/>.
-Hannes