#50730 [Bgs]: suggest changing which is does by default--ambiguous
| From: | dave at deltatns dot com | Date: | Tue, 12 Jan 2010 17:29:56 +0000 |
| Subject: | #50730 [Bgs]: suggest changing which is does by default--ambiguous | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-3681@lists.php.net to get a copy of this message | ||
ID: 50730
User updated by: dave at deltatns dot com
Reported By: dave at deltatns dot com
Status: Bogus
Bug Type: Documentation problem
Operating System: wamp
PHP Version: Irrelevant
New Comment:
I do not agree, as I indicated already that I noticed that, however, it
is easily changed to make it clear at the place where I indicated.
I did not take the time to enter this because I thought it was bogus,
so I take exception to that status.
Takes more time to discuss this than to change it... so I am done. I
made a valid suggestion... if you do not want to act on it, that is your
choice.
Good luck, if you always treat suggestions this way. I will certainly
avoid making any more. Those of us who are not experts are your best
source for suggestions of this type.
I am still grateful for this documentation.. Thanks for that. Dave
Previous Comments:
------------------------------------------------------------------------
[2010-01-12 16:31:03] rquadling@php.net
The default is clearly identified in the description.
mixed print_r ( mixed $expression [, bool $return = false ] )
------------------------------------------------------------------------
[2010-01-12 15:43:34] dave at deltatns dot com
Description:
------------
in the print_r section called Parameters:
I would suggest changing
"If this parameter is set to TRUE, print_r() will return its output,
instead of printing it (which it does by default). "
to "...its output ( return=false, the default setting will print it)"
or some other phrase to remove the ambiguity of what the default might
be.
I am slower than most people. It took me 15 seconds or so to not read
the above with the meaning true will print it. very low priority and
maybe not worth doing...just FYI of my read of it.
The manual is a really valuable resource,which I use constantly. I am
very grateful to all who have contributed and worked on it. Thanks
Dave
Reproduce code:
---------------
---
From manual page: function.print-r#Parameters
---
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=50730&edit=1