php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #44328 \\Seen should be \Seen
Submitted: 2008-03-04 17:53 UTC Modified: 2008-11-07 11:28 UTC
From: ceo at l-i-e dot com Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: N/A
Private report: No CVE-ID: None
Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please !
Your email address:
MUST BE VALID
Solve the problem:
47 + 14 = ?
Subscribe to this entry?

 
 [2008-03-04 17:53 UTC] 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...



Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2008-03-04 17:55 UTC] 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 18:43 UTC] 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 19:35 UTC] danbrown@php.net
Patch submitted.
 [2008-11-07 11:28 UTC] vrana@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.


 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Oct 31 23:01:28 2024 UTC