Re: svn: /phpdoc/en/trunk/language/ constants.xml

From: Date: Mon, 04 Aug 2014 10:12:14 +0000
Subject: Re: svn: /phpdoc/en/trunk/language/ constants.xml
References: 1 2 3  Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-12699@lists.php.net to get a copy of this message
On 4 August 2014 10:19, Maciej Sobaczewski <sobak@php.net> wrote: > I can't see your reply, only my message quoted. Is there something wrong > with this edit? > Nothing *wrong*, I just thought it would be good to keep a mention that __FILE__ resolves symlinks in the page and not just in the changelog. > > Cheers, > Maciej. > > W dniu 2014-08-04 10:42, Peter Cowburn pisze: > > On 4 August 2014 08:48, Maciej Sobaczewski <sobak@php.net> wrote: >> >> sobak Mon, 04 Aug 2014 07:48:40 +0000 >>> >>> Revision: >>> http://svn.php.net/viewvc?view=revision&revision=334472 >>> >>> Log: >>> Minor rewrite magic constants section to focus on PHP 5. Changelog added. >>> >>> Changed paths: >>> U phpdoc/en/trunk/language/constants.xml >>> >>> Modified: phpdoc/en/trunk/language/constants.xml >>> =================================================================== >>> --- phpdoc/en/trunk/language/constants.xml 2014-08-04 06:59:26 UTC >>> (rev 334471) >>> +++ phpdoc/en/trunk/language/constants.xml 2014-08-04 07:48:40 UTC >>> (rev 334472) >>> @@ -232,9 +232,6 @@ >>> <entry> >>> The full path and filename of the file. If used inside an >>> include, >>> the name of the included file is returned. >>> - Since PHP 4.0.2, <constant>__FILE__</constant> always contains >>> an >>> - absolute path with symlinks resolved whereas in older versions >>> it contained relative path >>> - under some circumstances. >>> >>> >> I think it would be a good idea to keep the symlink resolving information >> up here too, not just in the changelog. >> >> >> </entry> >>> </row> >>> <row xml:id="constant.dir"> >>> @@ -244,23 +241,18 @@ >>> the directory of the included file is returned. This is >>> equivalent >>> to <literal>dirname(__FILE__)</literal>. This directory name >>> does not have a trailing slash unless it is the root >>> directory. >>> - (Added in PHP 5.3.0.) >>> </entry> >>> </row> >>> <row xml:id="constant.function"> >>> <entry><constant>__FUNCTION__</constant></entry> >>> <entry> >>> - The function name. (Added in PHP 4.3.0) As of PHP 5 this >>> constant >>> - returns the function name as it was declared (case-sensitive). >>> In >>> - PHP 4 its value is always lowercased. >>> + The function name. >>> </entry> >>> </row> >>> <row xml:id="constant.class"> >>> <entry><constant>__CLASS__</constant></entry> >>> <entry> >>> - The class name. (Added in PHP 4.3.0) As of PHP 5 this constant >>> - returns the class name as it was declared (case-sensitive). In >>> PHP >>> - 4 its value is always lowercased. The class name includes the >>> namespace >>> + The class name. The class name includes the namespace >>> it was declared in (e.g. <literal>Foo\Bar</literal>). >>> Note that as of PHP 5.4 __CLASS__ works also in traits. When >>> used >>> in a trait method, __CLASS__ is the name of the class the >>> trait >>> @@ -270,24 +262,20 @@ >>> <row xml:id="constant.trait"> >>> <entry><constant>__TRAIT__</constant></entry> >>> <entry> >>> - The trait name. (Added in PHP 5.4.0) As of PHP 5.4 this >>> constant >>> - returns the trait as it was declared (case-sensitive). The >>> trait name includes the namespace >>> + The trait name. The trait name includes the namespace >>> it was declared in (e.g. <literal>Foo\Bar</literal>). >>> </entry> >>> </row> >>> - >>> <row xml:id="constant.method"> >>> <entry><constant>__METHOD__</constant></entry> >>> <entry> >>> - The class method name. (Added in PHP 5.0.0) The method name is >>> - returned as it was declared (case-sensitive). >>> + The class method name. >>> </entry> >>> </row> >>> <row xml:id="constant.namespace"> >>> <entry><constant>__NAMESPACE__</constant></entry> >>> <entry> >>> - The name of the current namespace (case-sensitive). This >>> constant >>> - is defined in compile-time (Added in PHP 5.3.0). >>> + The name of the current namespace. >>> </entry> >>> </row> >>> </tbody> >>> @@ -301,6 +289,64 @@ >>> <function>file_exists</function>&listendand; >>> <function>function_exists</function>. >>> </para> >>> + >>> + <sect2 xml:id="language.constants.predefined.changelog"> >>> + <title>Changelog</title> >>> + >>> + <para> >>> + <informaltable> >>> + <tgroup cols="2"> >>> + <thead> >>> + <row> >>> + <entry>&Version;</entry> >>> + <entry>&Description;</entry> >>> + </row> >>> + </thead> >>> + <tbody> >>> + <row> >>> + <entry>5.4.0</entry> >>> + <entry> >>> + Added <constant>__TRAIT__</constant> constant >>> + </entry> >>> + </row> >>> + <row> >>> + <entry>5.3.0</entry> >>> + <entry> >>> + Added <constant>__DIR__</constant> and >>> <constant>__NAMESPACE__</constant> constants >>> + </entry> >>> + </row> >>> + <row> >>> + <entry>5.0.0</entry> >>> + <entry> >>> + Added <constant>__METHOD__</constant> constant >>> + </entry> >>> + </row> >>> + <row> >>> + <entry>5.0.0</entry> >>> + <entry> >>> + Before this version values of some magic constants were always >>> lowercased. >>> + All of them are case-sensitive now (contain names as they were >>> declared). >>> + </entry> >>> + </row> >>> + <row> >>> + <entry>4.3.0</entry> >>> + <entry> >>> + Added <constant>__FUNCTION__</constant> and >>> <constant>__CLASS__</constant> constants >>> + </entry> >>> + </row> >>> + <row> >>> + <entry>4.0.2</entry> >>> + <entry> >>> + <constant>__FILE__</constant> always contains an absolute path >>> with symlinks >>> + resolved whereas in older versions it contained relative path >>> + under some circumstances >>> + </entry> >>> + </row> >>> + </tbody> >>> + </tgroup> >>> + </informaltable> >>> + </para> >>> + </sect2> >>> </sect1> >>> </chapter> >>> >>> >>> >>> -- >>> PHP Documentation Commits Mailing List (http://www.php.net/) >>> To unsubscribe, visit: http://www.php.net/unsub.php >>> >>> >> >

« previous php.doc.cvs (#12699) next »