NAME¶
sup-sync - sychronize the Sup index with message sources
SYNOPSIS¶
sup-sync [
options] source ...
DESCRIPTION¶
Synchronizes the Sup index with one or more message sources by adding messages,
deleting messages, or changing message state in the index as appropriate.
"Message state" means read/unread, archived/inbox, starred/unstarred,
and all user-defined labels on each message.
"Default source state" refers to any state that a source itself has
keeps about a message. Sup-sync uses this information when adding a new
message to the index. The source state is typically limited to read/unread,
archived/inbox status and a single label based on the source name. Messages
using the default source state are placed in the inbox (i.e. not archived) and
unstarred.
If no sources are given, sync from all usual sources. Supported source URI
schemes can be seen by running "sup-add
--help".
MESSAGE STATE OPTIONS¶
- --asis
- If the message is already in the index, preserve its state.
Otherwise, use default source state (default)
- --restore dumpfile
- Restore message state from a dump file created with
sup-dump. If a message is not in this dumpfile, act as --asis
- --discard
- Discard any message state in the index and use the default
source state. Dangerous!
- --archive, -x
- When using the default source state, mark messages as
archived.
- --read, -r
- When using the default source state, mark messages as
read.
- --extra-labels labels
- When using the default source state, also apply these
user-defined labels (a comma-separated list) (default)
OTHER OPTIONS¶
- --verbose, -v
- Print message ids as they're processed.
- --optimize, -o
- As the final operation, optimize the index.
- --all-sources
- Scan over all sources.
- --dry-run, -n
- Don't actually modify the index. Probably only useful with
--verbose.
- --version
- Show version information
- --help, -h
- Show help message
FILES¶
- $HOME/.sup/sources.yaml
- Configuration file for Sup mail sources
SEE ALSO¶
sup-mail(1),
sup-add(1),
sup-config(1),
sup-dump(1),
sup-tweak-labels(1)
AUTHOR¶
Sup was written by William Morgan <wmorgan-sup@masanjin.net>.
This manual page was written by Per Andersson <avtobiff@gmail.com> for the
Debian project (but may be used by others).
