Doc #75564 [NEW]: Unclear what "failure" is in Memcached::addServer()

From: teo8976 at gmail dot com Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Unclear what "failure" is in Memcached::addServer() Description: ------------ --- From manual page: http://www.php.net/memcache.addserver --- "Returns TRUE on success or FALSE on failure." That might seem self-explaining, but it is not, because of this: "When using this method [...] the network connection is not established until actually needed. Thus there is no overhead in adding a large number of servers to the pool, even though they might not all be used." So, if the connection is not established when calling addServer(), it is unclear what exactly might "fail" and cause this method to return false. That should be explained. -- Edit bug report at https://bugs.php.net/bug.php?id=75564&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=75564&r=trysnapshot54 Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=75564&r=trysnapshot55 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=75564&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=75564&r=fixed Fixed in release: https://bugs.php.net/fix.php?id=75564&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=75564&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=75564&r=needscript Try newer version: https://bugs.php.net/fix.php?id=75564&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=75564&r=support Expected behavior: https://bugs.php.net/fix.php?id=75564&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=75564&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=75564&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=75564&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=75564&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=75564&r=dst IIS Stability: https://bugs.php.net/fix.php?id=75564&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=75564&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=75564&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=75564&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=75564&r=mysqlcfg