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).

                                                  April 9, 2012                                      SUP-SYNC(1)