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 #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
View Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
If you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: ceo at l-i-e dot com
New email:
PHP Version: OS:

 

 [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-2025 The PHP Group
All rights reserved. 		Last updated: Sat Jul 12 05:01:33 2025 UTC