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
+Status: Closed
Bug Type: Documentation problem
PHP Version: Irrelevant
Assigned To: colder
New Comment:
I leave it as closed, together with my previous comment.
Previous Comments:
------------------------------------------------------------------------
[2006-05-01 14:40:12] php-bugs at T43 dot mine dot nu
May I further suggest for (A), to switch examples 19-1 and 19-2, such
that first comes the Simple Example, and then the specialty of $this
with respect to static - is nowhere basic and could be easily be
referenced from the static section near examples 19-14 and 19-15 ).
regarding (B) there are UCN's that seem to make good use of it for
templates.
And an overall "Thank You" for the feedback.
------------------------------------------------------------------------
[2006-05-01 14:31:14] [EMAIL PROTECTED]
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
------------------------------------------------------------------------
[2006-05-01 14:23:09] [EMAIL PROTECTED]
(A) will be fixed
(B) "It is allowed to add member fields to just one instance."
Even if it's possible, I don't think it's considered as a good
practice. I'm not sure if it needs to be explicitely documented, at
least I wouldn't recommend it.
(D) will be fixed
(E) will be fixed
------------------------------------------------------------------------
[2006-05-01 14:08:54] php-bugs at T43 dot mine dot nu
(E) english grammar (as seen by non-english like me) would require the
OF removed in the first paragraph.
------------------------------------------------------------------------
[2006-05-01 14:06:41] php-bugs at T43 dot mine dot nu
Thanks for the feedback.
(A) "This is illustrated in the following example: "
but then follow TWO examples, 19-1 and 19-2. English grammar requires
"This is illustrated in the following examples: "
And the examples are a bit meagre. The oop4 documentation was richer.
(B) 2) "How to add a member to the class on the fly"
I fail to see what you're trying to describe here.
It is allowed to add member fields to just one instance.
given class fruit has no field "sweet", one can add one to an instance,
simply by $apple->sweet=true;
(C) >>Until you've something new, this bug report seems bogus to me.
Maybe, but classes, from the manual, have a very steep learning curve,
even in php terms.
(D) The reference to the class/object handling functions is missing.
>From this it is unclear whether oop5 augments, or replaces oop4
documentation.
------------------------------------------------------------------------
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/37258
--
Edit this bug report at http://bugs.php.net/?id=37258&edit=1
