#47032 [NEW]: contradictions in isset docs
| From: | charles at chaoslizard dot org | Date: | Wed, 07 Jan 2009 23:55:28 +0000 |
| Subject: | #47032 [NEW]: contradictions in isset docs | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-1703@lists.php.net to get a copy of this message | ||
From: charles at chaoslizard dot org
Operating system:
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: contradictions in isset docs
Description:
------------
The docs for isset (http://php.net/isset) are misleading and
contradictory.
"Determine whether a variable is set"--that part would make sense alone.
Skip a sentence and it says "isset() will return FALSE if testing a
variable that has been set to NULL". If this sentence is true, the first
sentence is false, misleading, and incomplete: it should read something
like "Determine whether a variable is set to anything except NULL".
To put it another way, the problem is that it first claims to
unconditionally check for a variable that "is set", but then claims to
return FALSE for a variable that "has been set" to a particular value.
The problem could hinge on the nebulous definition of "set". If this is
the case, I'd suggest not using the phrase "has been set" in the later
sentence.
It looks like bug #19080 may have prompted the documentation to read like
it does now.
--
Edit bug report at http://bugs.php.net/?id=47032&edit=1
--
Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=47032&r=trysnapshot52
Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=47032&r=trysnapshot53
Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=47032&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=47032&r=fixedcvs
Fixed in CVS and need be documented: http://bugs.php.net/fix.php?id=47032&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=47032&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=47032&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=47032&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=47032&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=47032&r=support
Expected behavior: http://bugs.php.net/fix.php?id=47032&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=47032&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=47032&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=47032&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=47032&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=47032&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=47032&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=47032&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=47032&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=47032&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=47032&r=mysqlcfg