#37258 [Opn]: lot of missing documentation about oop

From: Date: Mon, 01 May 2006 13:40:38 +0000
Subject: #37258 [Opn]: lot of missing documentation about oop
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969372824@lists.php.net to get a copy of this message
ID: 37258 User updated by: php-bugs at T43 dot mine dot nu Reported By: php-bugs at T43 dot mine dot nu Status: Open Bug Type: Documentation problem PHP Version: Irrelevant New Comment: The oop5 documentation does not point to the class handling functions (as the oop4 documentation did, on the very first, the 'class' page at the end.) Previous Comments: ------------------------------------------------------------------------ [2006-05-01 13:29:34] php-bugs at T43 dot mine dot nu more missing. There can only be one constructor, as opposed to C++. So function classname($var1,$var2) can't coexist with function classname($var1) . Further, when there is a constructor, the new operator has to use it. Given function classname($var1), the call $apple= new classname; fails, but $apple=new classname('apple') is required syntax. ------------------------------------------------------------------------ [2006-05-01 13:17:11] php-bugs at T43 dot mine dot nu Description: ------------ the oop5 documentation has a lot of unclear / missing very basic passages. Among them are: Basics: How to define a member, How to define a method How to add a member to an instance ($apple->newmember) How to add a member to the class on the fly Constructors: the classname($var) syntax The sentence "Followed by a pair of curly braces, OF which contains the definition " the word 'OF' is grammatically wrong in the ears of non-english, making the sentence non-understandable. Most of this was missing in the php4 class documentation too. It is not clear whether the php5 class chapter replaces, or augments the php4 class chapter. I can't fix it as I can't delve into the sources of ZEND engine and the like. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=37258&edit=1

« previous php.doc (#969372824) next »