Doc #60791 [NEW]: missing documentation

From: Date: Wed, 18 Jan 2012 13:19:46 +0000
Subject: Doc #60791 [NEW]: missing documentation
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-7788@lists.php.net to get a copy of this message
From: Operating system: windows PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:missing documentation Description: ------------ --- From manual page: http://www.php.net/function.curl-setopt --- the setopt documentation is missing CURLOPT_FTP_CREATE_MISSING_DIRS (bool) Test script: --------------- 1. Browse to the php curl documentation, scour for a create directory type command, find there isn't one/doesn't work. 2. Browse google for 10 mins for some solved forum of someone making a dir with curl HTTP - hit a dead end. 3. Search google for CURLOPT & come across the official curl changelog, browse through all the different options until you come across CURLOPT_FTP_CREATE_MISSING_DIRS 4. Feel like you need to share it with the world. 5. Find none of the common forums you normally would put it on, stackoverflow daniweb etc. 6. Decide to add it as a comment on the php.net site 7. Find out how complex it is to say, "use CURLOPT_FTP_CREATE_MISSING_DIRS to set cURL to make directories, would of saved me ages" 8. Do it anyway 9. Notice it is actually there under "predefined constants" 10. Lose the will to live but also wonder why it isn't referenced in setopt's 11. Check over the 10 points 12. My work is done -- Edit bug report at https://bugs.php.net/bug.php?id=60791&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=60791&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=60791&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=60791&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=60791&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=60791&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=60791&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=60791&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=60791&r=needscript Try newer version: https://bugs.php.net/fix.php?id=60791&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=60791&r=support Expected behavior: https://bugs.php.net/fix.php?id=60791&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=60791&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=60791&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=60791&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=60791&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=60791&r=dst IIS Stability: https://bugs.php.net/fix.php?id=60791&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=60791&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=60791&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=60791&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=60791&r=mysqlcfg

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