Doc #61178 [NEW]: More info needed on "$section" parameter.

From: Operating system: n/a PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:More info needed on "$section" parameter. Description: ------------ --- From manual page: http://www.php.net/function.imap-fetchbody#refsect1- function.imap-fetchbody-parameters --- The description of the "$section" parameter to imap_fetchbody is woefully inadequate. At the very least, it could use links to the relevant parts of the IMAP standard it refers to, which (as far as I can determine) are § 6.4.5 "FETCH Command" (http://tools.ietf.org/html/rfc3501#section-6.4.5) and the definition of fetch-att in § 9 "Formal Syntax" (http://tools.ietf.org/html/rfc3501#section-9) on page 85 (http://tools.ietf.org/html/rfc3501#page-85). A note such as the following would be helpful (though it should be checked for accuracy): "Since PHP array indices are 0-based while section numbers are 1-based, you must add 1 to the index of any section taken from the result of imap_fetchstructure before using it with imap_fetchbody. For example, if $parts is the result of imap_fetchstructure, $parts[0] would correspond to section number "1", and $parts[2][1][0] corresponds to "3.2.1"." -- Edit bug report at https://bugs.php.net/bug.php?id=61178&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=61178&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=61178&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=61178&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=61178&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=61178&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=61178&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=61178&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=61178&r=needscript Try newer version: https://bugs.php.net/fix.php?id=61178&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=61178&r=support Expected behavior: https://bugs.php.net/fix.php?id=61178&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=61178&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=61178&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=61178&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=61178&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=61178&r=dst IIS Stability: https://bugs.php.net/fix.php?id=61178&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=61178&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=61178&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=61178&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=61178&r=mysqlcfg