ID:               32785
 Updated by:       [EMAIL PROTECTED]
 Reported By:      [EMAIL PROTECTED]
-Status:           Assigned
+Status:           Closed
 Bug Type:         Documentation problem
 Operating System: Debian GNU/Linux
 PHP Version:      4.3.10
 Assigned To:      nlopess
 New Comment:

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.

Warning added.

I agree with sniper that documenting not-yet-existing features is work
for a work.


Previous Comments:
------------------------------------------------------------------------

[2005-04-21 01:31:37] [EMAIL PROTECTED]

The documentation does mention this:

If the limit parameter is negative, all components except the last
limit are returned. This feature was added in PHP 5.1.0.

Sure the 5.1+ example could have a comment specifying this version
requirement but no need to get all crazy! :) When the explode() docs
get converted to the new doc style the change will be much clearer as
each function now has a CHANGELOG.

We document future versions too, it's the way it is. A more appropriate
question is "why not" but anyway it's so people using the manual can
handle/know future changes/additions, and that we don't forget to
document these changes. See also:

http://php.net/manual/en/about.phpversions.php

------------------------------------------------------------------------

[2005-04-21 00:49:40] [EMAIL PROTECTED]

Assigned to Nuno: Thanks for wasting our time.


------------------------------------------------------------------------

[2005-04-21 00:45:31] [EMAIL PROTECTED]

Also: Why the hell do you doc people put something like this in the
manual WHEN THERE IS NO SUCH RELEASE ever made with such
feature(s)???!!!

------------------------------------------------------------------------

[2005-04-21 00:43:54] [EMAIL PROTECTED]

Reclassified as documentation problem: The examples should have BIG
note about the being like that only with PHP 5.1!!!!


------------------------------------------------------------------------

[2005-04-21 00:03:55] [EMAIL PROTECTED]

It does the same on current PHP-version also.

nandus% uname -a
FreeBSD nandus.mikrolahti.fi 5.4-STABLE FreeBSD 5.4-STABLE #0: Tue Apr
19 23:27:27 EEST 2005    
[EMAIL PROTECTED]:/usr/obj/usr/src/sys/NANDUS  i386

nandus% cat explode.php
<?php
$str = 'one|two|three|four';

// positive limit
print_r(explode('|', $str, 2));

// negative limit
print_r(explode('|', $str, -1));
?>

nandus% php explode.php
Content-type: text/html
X-Powered-By: PHP/5.0.4

Array
(
    [0] => one
    [1] => two|three|four
)
Array
(
    [0] => one
    [1] => two
    [2] => three
    [3] => four
)

------------------------------------------------------------------------

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/32785

-- 
Edit this bug report at http://bugs.php.net/?id=32785&edit=1

Reply via email to