php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #43726 Constants descripton in imap_getmailboxes page is wrong
Submitted: 2008-01-02 06:29 UTC Modified: 2008-07-03 22:56 UTC
From: karpeles at ookoo dot org Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
View Developer Edit
 [2008-01-02 06:29 UTC] karpeles at ookoo dot org 
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

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2008-07-03 22:56 UTC] tularis@php.net 
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

Thank you for your help to make our documentation better.
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved. 		Last updated: Thu Oct 08 00:00:02 2026 UTC