Doc->Bug #69011 [Opn->Wfx]: contraddiction in echo documentation
| From: | sobak@php.net | Date: | Mon, 06 Apr 2015 06:12:41 +0000 |
| Subject: | Doc->Bug #69011 [Opn->Wfx]: contraddiction in echo documentation | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-12106@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=69011&edit=1
ID: 69011
Updated by: sobak@php.net
Reported by: teo8976 at gmail dot com
Summary: contraddiction in echo documentation
-Status: Open
+Status: Wont fix
-Type: Documentation Problem
+Type: Bug
-Package: Documentation problem
+Package: Doc Build problem
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
Sorry, but this is how our documentation renderer works. It can be changed, but I doubt anyone will
find the time for such an edge case.
Previous Comments:
------------------------------------------------------------------------
[2015-02-08 02:35:26] teo8976 at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/function.echo
---
This:
"""
Description
void echo ( string $arg1 [, string $... ] )
"""
is in contraddiction with this:
"""
Additionally, if you want to pass more than one parameter to echo, the parameters must not be
enclosed within parentheses.
"""
The second is true, so the first must be corrected.
It should read something like:
"""
Description
void echo ( string $arg1)
void echo string $arg1 [, string $... ]
"""
And by the way, why on earth not changing the behavior so that it does accept parenthesis with more
than one parameter??
Test script:
---------------
---
From manual page: http://www.php.net/function.echo
---
This:
"""
Description
void echo ( string $arg1 [, string $... ] )
"""
is in contraddiction with this:
"""
Additionally, if you want to pass more than one parameter to echo, the parameters must not be
enclosed within parentheses.
"""
The second is true, so the first must be corrected.
It should read something like:
"""
Description
void echo ( string $arg1)
void echo string $arg1 [, string $... ]
"""
And by the way, why on earth not changing the behavior so that it does accept parenthesis with more
than one parameter??
Expected result:
----------------
---
From manual page: http://www.php.net/function.echo
---
This:
"""
Description
void echo ( string $arg1 [, string $... ] )
"""
is in contraddiction with this:
"""
Additionally, if you want to pass more than one parameter to echo, the parameters must not be
enclosed within parentheses.
"""
The second is true, so the first must be corrected.
It should read something like:
"""
Description
void echo ( string $arg1)
void echo string $arg1 [, string $... ]
"""
And by the way, why on earth not changing the behavior so that it does accept parenthesis with more
than one parameter??
Actual result:
--------------
---
From manual page: http://www.php.net/function.echo
---
This:
"""
Description
void echo ( string $arg1 [, string $... ] )
"""
is in contraddiction with this:
"""
Additionally, if you want to pass more than one parameter to echo, the parameters must not be
enclosed within parentheses.
"""
The second is true, so the first must be corrected.
It should read something like:
"""
Description
void echo ( string $arg1)
void echo string $arg1 [, string $... ]
"""
And by the way, why on earth not changing the behavior so that it does accept parenthesis with more
than one parameter??
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=69011&edit=1