#47032 [NEW]: contradictions in isset docs

From: 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

« previous php.doc.bugs (#1703) next »