#26334 [Ana]: global and static keywords

ID: 26334 Updated by: vrana@php.net Reported By: christian at freemails dot at Status: Analyzed -Bug Type: Documentation problem +Bug Type: Website problem PHP Version: Irrelevant New Comment: I don't see a way how to solve this in the documentation. There are files only for sect1s. Previous Comments: ------------------------------------------------------------------------ [2004-08-05 23:45:45] goba@php.net No, Philip, the file is named after the sect2 id. ------------------------------------------------------------------------ [2004-08-05 23:33:09] philip@php.net Goba, would this solve it? Index: en/language/variables.xml =================================================================== RCS file: /repository/phpdoc/en/language/variables.xml,v retrieving revision 1.79 diff -u -r1.79 variables.xml --- en/language/variables.xml 23 Jul 2004 00:18:21 -0000 1.79 +++ en/language/variables.xml 5 Aug 2004 08:09:57 -0000 @@ -374,7 +374,7 @@ </simpara> <sect2 id="language.variables.scope.global"> - <title>The global keyword</title> + <title id="language.keyword.global">The global keyword</title> <simpara> First, an example use of <literal>global</literal>: </simpara> @@ -473,7 +473,7 @@ </sect2> <sect2 id="language.variables.scope.static"> - <title>Using static variables</title> + <title id="language.keyword.static">Using static variables</title> <simpara> Another important feature of variable scoping is the <emphasis>static</emphasis> variable. A static variable exists I wouldn't feel write changing the sect2 ids but maybe we have to? ------------------------------------------------------------------------ [2003-11-20 12:39:55] goba@php.net Erm, the URL shortcuts and the PHP function list search only find nodes having a file named after the name of the keyword/function/control structure, etc. So modifying the ID would not be enough. As sect2s are not put onto their own pages, these need to be sect1s to get recognized by any of the quicref tools we have. Also 'variables.scope.' is not a searched prefix, thought it can be added if need be. But still only file names are searched for, so if the file name does not contain the searched keyword, it will not be found. Since the documentation is not reindexed to make these keywords be more easy to find, the current solution is for speed reasons. ------------------------------------------------------------------------ [2003-11-20 12:28:06] philip@php.net I thought I fixed this here: http://cvs.php.net/diff.php/phpdoc/en/language/variables.xml?r1=1.67&r2=1.68 Why doesn't the following pick this up? <sect2 id="language.variables.scope.global"> This is related to bug #16234 ------------------------------------------------------------------------ [2003-11-20 12:18:04] goba@php.net There is no global() function in PHP. There is a global keyword. It is like return or continue. It is not a function. Some keywords are accessible with URL shortcuts. It might be a good idea to let global be accessed this way. Note to the doc guys: possible to fix this by using id="language.keyword.global" and id="language.keyword.static" in the XML files. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/26334 -- Edit this bug report at http://bugs.php.net/?id=26334&edit=1