#44328 [Ver->Csd]: \\Seen should be \Seen
| From: | vrana@php.net | Date: | Fri, 07 Nov 2008 11:28:49 +0000 |
| Subject: | #44328 [Ver->Csd]: \\Seen should be \Seen | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-1425@lists.php.net to get a copy of this message | ||
ID: 44328
Updated by: vrana@php.net
Reported By: ceo at l-i-e dot com
-Status: Verified
+Status: Closed
Bug Type: Documentation problem
Operating System: N/A
PHP Version: Irrelevant
New Comment:
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.
Previous Comments:
------------------------------------------------------------------------
[2008-03-04 19:35:33] danbrown@php.net
Patch submitted.
------------------------------------------------------------------------
[2008-03-04 18:43:55] philip@php.net
This idea applies to other values too, like \\Flagged, but using \\Seen
as an example shows this:
water:/cvs/phpdoc/en/reference/imap philip$ grep -ir '\\seen' *
constants.xml: Do not set the \Seen flag if not already set
functions/imap-body.xml: <constant>FT_PEEK</constant> - Do not
set the \Seen flag if not already set
functions/imap-clearflag-full.xml: The flags which you can unset
are "\\Seen", "\\Answered", "\\Flagged",
functions/imap-fetchbody.xml: <constant>FT_PEEK</constant> -
Do not set the \Seen flag if
functions/imap-savebody.xml: <constant>FT_PEEK</constant> - Do
not set the \Seen flag if
functions/imap-search.xml: SEEN - match messages that have
been read (the \\SEEN flag is set)
functions/imap-setflag-full.xml: The flags which you can set are
<literal>\\Seen</literal>,
functions/imap-setflag-full.xml:$status = imap_setflag_full($mbox,
"2,5", "\\Seen \\Flagged");
------------------------------------------------------------------------
[2008-03-04 17:55:05] ceo at l-i-e dot com
D'oh!
I mean on this page:
http://us2.php.net/manual/en/function.imap-setflag-full.php
------------------------------------------------------------------------
[2008-03-04 17:53:57] ceo at l-i-e dot com
Description:
------------
In the "flags" parameter description, there are extra bogus backslashes
(a la Magic Quotes) on all the values that are supposed to be valid.
The example code correctly uses \\Seen inside of quotes.
The RFC link uses \Seen as the data.
The "flags" section told me to use \\Seen as the data.
I spent the better part of a day trying to figure out why it wasn't
working...
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=44328&edit=1