man/labels: update manpage

Small fixes, some clarifications.
This commit is contained in:
Dirk-Jan C. Binnema
2025-12-14 11:28:12 +02:00
committed by Seth Ladygo
parent 2b6d709158
commit a803eb77fd

View File

@ -26,23 +26,24 @@ mu-labels - attach labels to messages. Export labels to file, and import them.
A label is a string associated with a message. A label is a string associated with a message.
*mu labels* has five sub-commands (i.e., 'sub-sub-commands'): *mu labels* has six sub-commands (i.e., 'sub-sub-commands'):
- *update* for changing the labels for the messages matching some query - *update* for changing the labels for the messages matching some query
- *clear* for clearing all labels from messages matching some query - *clear* for clearing all labels from messages matching some query
- *list* to list all labels that are used in the store - *list* to list all labels that are used in the store
- *list-restore* to restore the list of labels from the store - *list-restore* to restore the list of labels from the database (store)
- *export* to write the label information to a file - *export* to write the label information to a file
- *import* the read label information from a file - *import* the read label information from a file
Important: unlike other message metadata stored by *mu*, labels _cannot_ be restored *Important*: unlike other message metadata stored by *mu*, labels _cannot_ be restored
by merely re-indexing messages. Hence, to avoid loosing label information, you by merely re-indexing messages, since the information is not part of the message
must *export* it before re-indexing, and *import* afterwards. files. Hence, to avoid loosing label information, you must *export* it before
re-indexing, and *import* afterwards.
* UPDATE OPTIONS * UPDATE OPTIONS
The *update* command changes the labels for messages that match some query. The The *update* command changes the labels for messages that match some query. The
query must be recognized as a single parameter; hence, it must be quoted when query must be recognized as a _single_ parameter; hence, it must be quoted when
using from a shell. using from a shell.
** --labels ** --labels