Page 86 - Mercury Manual.book

81 The MercuryP POP3 Server Module
Login-time listing constraints

that is, you enter your username as normal, then the list of constraint options you want to use
in brackets after the name, separating the options from each other using commas. This ap-
proach (appending the constraint to the username) means that it should be possible to use this
feature on any POP3-capable client that you can use to connect to Mercury, and should be
especially useful to people using low-capacity devices such as cellphones or PDAs to read
their mail, or when using slow or unreliable connections.

The constraint options that are available are:

NEW
UNREAD
URGENT
FROM=<expression>
SUBJECT=<expression>
SHOW=<expression>
OMIT=<expression>
SINCE=<date-time>

NEW The NEW constraint tells MercuryP to list only files that were not present in the mail-
box the last time you connected to it.

UNREAD The UNREAD constraint tells MercuryP to list only files that are not marked as
having been read (note that downloading a message via POP3 implicitly marks it as read)

URGENT The URGENT constraint tells Mercury to list only messages that have a "Priority",
"Importance" or "X-Priority" header indicating that the message is urgent.

FROM=<expr> This constraint tells MercuryP that it should only list messages where the
"From" field matches the expression you supply. If the expression contains an '@' sign, then
the comparison is performed only on the address portion of the field; if no '@' is present, the
comparison is performed only on the textual embellishments of the field (such as the personal
name). The expression can contain any Mercury regular expression characters and need not
contain the "From:" text or be enclosed in '*' closure markers.

SUBJECT=<expr> This constraint does much the same as the "From" constraint except that
it acts on the "Subject" field of the message.

SHOW=<expr> This constraint allows you to define a regular expression that is applied to
all the headers of the message. The expression should usually contain the entire header text
including the header keyword. The message is only displayed in the mail drop if the expres-
sion matches at least one header.

OMIT=<expr> This constraint is the opposite of the "SHOW" constraint: the expression you
supply is applied to every header in the message and if any header matches, the message is
omitted from the maildrop listing.

SINCE=<date-time> This constraint tells MercuryP to consider only messages whose
"Date" field contains a later date than the one you specify. The date should be in the format
"dd mmm yyyy hh:mm" - for example, "20 Jan 2008 12:30". You can omit the time if you
wish, in which case 0:01am is used. You can specify a timezone in the format +XXXX or -
XXXX at the end of the date-time if you wish - the default if you do not is +0000.