#43726 [NEW]: Constants descripton in imap_getmailboxes page is wrong
| From: | karpeles at ookoo dot org | Date: | Wed, 02 Jan 2008 06:29:47 +0000 |
| Subject: | #43726 [NEW]: Constants descripton in imap_getmailboxes page is wrong | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-402@lists.php.net to get a copy of this message | ||
From: karpeles at ookoo dot org
Operating system: Irrelevant
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: Constants descripton in imap_getmailboxes page is wrong
Description:
------------
The documentation currently says:
[snip] Attributes is a bitmask that can be tested against:
* LATT_NOINFERIORS - This mailbox has no "children" (there are no
mailboxes below this one).
* LATT_NOSELECT - This is only a container, not a mailbox - you cannot
open it.
* LATT_MARKED - This mailbox is marked. Only used by UW-IMAPD.
* LATT_UNMARKED - This mailbox is not marked. Only used by UW-IMAPD.
This is just wrong, only LATT_NOSELECT is right.
LATT_NOINFERIORS: This mailbox can not, ever, have children. You can not
call imap_createmailbox() to put a subdirectory in this mailbox, it won't
work (or your imap server is broken).
LATT_MARKED: This mailbox is marked. This means that it may contain new
messages since the last time it was checked. Not provided by all IMAP
servers.
LATT_UNMARKED: This mailbox does not contains anything new since last
check. If either MARKED or UNMARKED is provided, you can assume the IMAP
server supports this feature for this mailbox.
You can have a program written in PHP doing listmailboxes from times to
times to fetch new messages. If you see that the mailbox is "unmarked", you
can safely skip it when checking for new messages.
Reproduce code:
---------------
Irrelevant
Expected result:
----------------
Irrelevant
Actual result:
--------------
http://php.net/imap_getmailboxes
--
Edit bug report at http://bugs.php.net/?id=43726&edit=1
--
Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=43726&r=trysnapshot44
Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=43726&r=trysnapshot52
Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=43726&r=trysnapshot53
Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=43726&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=43726&r=fixedcvs
Fixed in release: http://bugs.php.net/fix.php?id=43726&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=43726&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=43726&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=43726&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=43726&r=support
Expected behavior: http://bugs.php.net/fix.php?id=43726&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=43726&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=43726&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=43726&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=43726&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=43726&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=43726&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=43726&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=43726&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=43726&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=43726&r=mysqlcfg