IMAP4Server: Add support for PERMANENTFLAGS response from SELECT and EXAMINE

	biny reported
Trac ID	trac#3951
Type	enhancement
Created	2009-08-02 05:39:37Z

SELECT: http://tools.ietf.org/html/rfc3501#section-6.3.1
EXAMINE: http://tools.ietf.org/html/rfc3501#section-6.3.2

http://tools.ietf.org/html/rfc3501#section-7.1

  PERMANENTFLAGS

     Followed by a parenthesized list of flags, indicates which of
     the known flags the client can change permanently.  Any flags
     that are in the FLAGS untagged response, but not the
     PERMANENTFLAGS list, can not be set permanently.  If the client
     attempts to STORE a flag that is not in the PERMANENTFLAGS
     list, the server will either ignore the change or store the
     state change for the remainder of the current session only.
     The PERMANENTFLAGS list can also include the special flag \*,
     which indicates that it is possible to create new keywords by
     attempting to store those flags in the mailbox.

trac-id__3951 3951
type__enhancement enhancement
reporter__biny biny
priority__normal normal
milestone__ 
branch__ 
branch_author__ 
status__new new
resolution__None None
component__mail mail
keywords__ 
time__1249191577000000 1249191577000000
changetime__1249358095000000 1249358095000000
version__None None
owner__ 
cc__exarkun

Start by reading the RFC 3501 sections linked in the issue, especially the SELECT and EXAMINE responses and the PERMANENTFLAGS definition. Trace the IMAP4Server entry points for SELECT and EXAMINE, then add the response describing which flags can be changed permanently. Done means both commands emit a correct PERMANENTFLAGS response consistent with the mailbox flags.