lei-tag(1)

1LEI-TAG(1)                 public-inbox user manual                 LEI-TAG(1)
2
3
4

NAME

6       lei-tag - set/unset metadata on messages
7

SYNOPSIS

9       lei tag [OPTIONS] FILE [FILE...] METADATA [METADATA...]
10
11       lei tag [OPTIONS] (-|--stdin) METADATA [METADATA...]
12

DESCRIPTION

14       Set or unset volatile metadata on messages.  In JMAP terms, "volatile
15       metadata" includes "mailboxes" (analogous to a folder or label) and a
16       restricted set of "keywords".  This supported keywords are the
17       combination of system keywords (seen, answered, flagged, and draft),
18       which map to Maildir flags and mbox Status/X-Status headers, as well as
19       reserved keywords (forwarded, phishing, junk, and notjunk).
20
21       To add a label or keyword, prefix it with "+L:" and "+kw:",
22       respectively.  To remove a label or keyword, use "-L:" or "-kw:".  For
23       example, "+kw:flagged" would set the "flagged" keyword for the
24       specified messages, and "-L:INBOX" would remove the "INBOX" label.
25

OPTIONS

27       -F MAIL_FORMAT
28       --in-format=MAIL_FORMAT
29           Message input format: "eml", "mboxrd", "mboxcl2", "mboxcl", or
30           "mboxo".
31
32           Default: "eml"
33
34       -q
35       --quiet
36           Suppress feedback messages.
37

LABELS

39       Labels are user-defined values analogous to IMAP/JMAP mailbox names.
40       They must only contain lowercase characters, digits, and a limited
41       amount of punctuation (e.g. ".", "-", "@").
42
43       Messages may have multiple labels.
44

KEYWORDS

46       Keywords are "flags" in Maildir and IMAP terminology.  Common keywords
47       include: "seen", "answered", "flagged", and "draft", though
48       "forwarded", "phishing", "junk", and "notjunk" are also supported.
49
50       When writing to various mboxes, the common keywords will be mapped to
51       the "Status" and "X-Status" headers.
52
53       Messages may have multiple keywords.
54

CONTACT

56       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>
57
58       The mail archives are hosted at <https://public-inbox.org/meta/> and
59       <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
60

COPYRIGHT

62       Copyright 2021 all contributors <mailto:meta@public-inbox.org>
63
64       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
65