Hi all,
While going through some bug reports I realized that the 'The Basics'
section of the PHP 5 classes and objects section, as it stands, could
use some attention. I've been going over it and and have rewritten much
of it to be more precise, and have also separated the class variables
sect2 out into its own sect1 and given it a bit of a rewrite as well.
In days of old I would have just committed this and been done with it,
but since I've only recently been getting back into the documentation
after having been away for a few years, I wanted to see if there are any
objections to such an endeavour. :)
For the most part the changes are to make the basics section a little
more reference-like and to provide a bit more specificity. I realize
that there is still work to be done, but this is, to me, a good first
step toward providing a true reference on PHP 5 class/object behaviour.
I do realize that there is now some redundant content between the new
'Class variables' sections and the existing 'Visibility' section, but
this can either be A) fixed, or B) thought of as a Good Thing since it
merely reinforces some important information.
The new changes are available at the following URL if anybody cares to
take a look and comment on the idea:
http://www.thebuttlesschaps.com/phpdoc/language.oop5.html
Comments, criticisms, and feedback greatly appreciated!
Regards,
Torben