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"."