.\" Automatically generated by Pandoc 2.7.3
.\"
.TH "SUP-SYNC-BACK-MAILDIR" "1" "August 25, 2014" "Sup User Manual" ""
.hy
.SH NAME
.PP
sup-sync-back-maildir - Export Xapian entries to Maildir sources on disk
.SH SYNOPSIS
.PP
sup-sync-back-maildir [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
.SH DESCRIPTION
.PP
This script parses the Xapian entries for a given Maildir source and
renames (changes maildir flags) e-mail files on disk according to the
labels stored in the index.
It will export all the changes you made in Sup to your Maildirs so that
they can be propagated to your IMAP server with e.g.\ offlineimap.
.PP
The script also merges some Maildir flags into Sup such as R (replied)
and P (passed, forwarded), for instance suppose you have an e-mail file
like this: foo_bar:2,FRS (flags are favorite, replied, seen) and its
Xapian entry has labels `starred', the merge operation will add the
`replied' label to the Xapian entry.
.PP
If you choose not to merge (-m) you will lose information (`replied'),
and in the previous example the file will be renamed to foo_bar:2,FS.
.PP
Running this script is \f[I]strongly\f[R] recommended when setting the
\[lq]sync_back_to_maildir\[rq] option from false to true in config.yaml
or changing the \[lq]sync_back\[rq] flag to true for a source in
sources.yaml.
.PP
If no source is given, the default behavior is to sync back all Maildir
sources marked as usual and that have not disabled sync back using the
configuration parameter sync_back = false in sources.yaml.
.SH OPTIONS
.TP
.B -n, --no-confirm
Don\[cq]t ask for confirmation before synchronizing
.TP
.B -m, --no-merge
Don\[cq]t merge new supported Maildir flags (R and P)
.TP
.B -l, --list-sources
List your Maildir sources and exit
.TP
.B -u, --unusual-sources-too
Sync unusual sources too if no specific source information is given
.TP
.B --version
Print version and exit
.TP
.B -h, --help
Show brief help message
.SH FILES
.TP
.B $HOME/.sup/sources.yaml
Configuration file for Sup mail sources
.SH SEE ALSO
.PP
sup(1), sup-add(1), sup-config(1), sup-dump(1), sup-sync(1),
sup-tweak-labels(1)
.SH REPORTING BUGS
.PP
You are welcome to submit bug reports to the Sup issue tracker, located
at
.PP
<https://github.com/sup-heliotrope/sup/issues>
.SH CONTACT INFORMATION
.TP
.B The Sup web page:
<http://supmua.org/>
.TP
.B Code repository:
<https://github.com/sup-heliotrope/sup/>
.TP
.B Sup Wiki:
<https://github.com/sup-heliotrope/sup/wiki/>
.TP
.B Sup IRC channel:
#sup \[at] freenode.net
.TP
.B Mailing list:
supmua\[at]googlegroups.com
.RS
.PP
supmua+subscribe\[at]googlegroups.com
.PP
Archives: <https://groups.google.com/d/forum/supmua/>
.RE
.SH COPYRIGHT
.PP
Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
.PP
Copyright \[at] 2013-2014 Sup developers
.PP
Permission is granted to copy and distribute this manual under the terms
of the GNU General Public License; either version 2 or (at your option)
any later version.
.SH AUTHORS
Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
and is now developed and maintained by the Sup developers.