.Dd July 22, 2016
.Dt MFLAG 1
.Os
.Sh NAME
.Nm mflag
.Nd manipulate Maildir mail flags
.Sh SYNOPSIS
.Nm
.Op Fl DFPRST
.Op Fl X Ar str
.br
.Op Fl dfprst
.Op Fl x Ar str
.br
.Op Fl v
.Op Ar msgs\ ...
.Sh DESCRIPTION
.Nm
flags changes the flags of the given
.Ar msgs
according to the options.
See
.Xr mmsg 7
for the message argument syntax.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl D
Mark
.Ar msgs
as draft.
.It Fl F
Mark
.Ar msgs
as flagged.
.It Fl P
Mark
.Ar msgs
as passed (resent/forwarded/bounced).
.It Fl R
Mark
.Ar msgs
as replied.
.It Fl S
Mark
.Ar msgs
as seen.
.It Fl T
Mark
.Ar msgs
as trashed.
.It Fl X Ar str
Mark
.Ar msgs
as with the chracters in
.Ar str .
.It Fl d
Unmark
.Ar msgs
as draft.
.It Fl f
Unmark
.Ar msgs
as flagged.
.It Fl p
Unmark
.Ar msgs
as passed (resent/forwarded/bounced).
.It Fl r
Unmark
.Ar msgs
as replied.
.It Fl s
Unmark
.Ar msgs
as seen.
.It Fl t
Unmark
.Ar msgs
as trashed.
.It Fl x Ar str
Unmark
.Ar msgs
as with the chracters in
.Ar str .
(Remember to use uppercase characters.)
.It Fl v
Read Maildir mails from stdin (or the use the whole current sequence, if
used interactively) and print the transformed list of file names.
.Pp
Can be used to keep the sequence intact in advent of renames.
.El
.Pp
Note that the
.Pa cur
link is updated in all cases, when affected.
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr mmsg 7
.Pp
.Lk https://cr.yp.to/proto/maildir.html "Using maildir format"
.Sh AUTHORS
.An Christian Neukirchen Aq Mt chneukirchen@gmail.com
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/