man/sup-sync.1 in sup-0.22.1 vs man/sup-sync.1 in sup-0.23

- old
+ new

@@ -1,148 +1,118 @@ -.TH "SUP\-SYNC" "1" "April 9, 2012" "Sup User Manual" "" +.\" Automatically generated by Pandoc 2.7.3 +.\" +.TH "SUP-SYNC" "1" "April 9, 2012" "Sup User Manual" "" +.hy .SH NAME .PP -sup\-sync \- sychronize the Sup index with message sources +sup-sync - sychronize the Sup index with message sources .SH SYNOPSIS .PP -sup\-sync [\f[I]options\f[]] source ... +sup-sync [\f[I]options\f[R]] source \&... .SH DESCRIPTION .PP Synchronizes the Sup index with one or more message sources by adding messages, deleting messages, or changing message state in the index as appropriate. .PP -"Message state" means read/unread, archived/inbox, starred/unstarred, -and all user\-defined labels on each message. +\[lq]Message state\[rq] means read/unread, archived/inbox, +starred/unstarred, and all user-defined labels on each message. .PP -"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. +\[lq]Default source state\[rq] 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. +Messages using the default source state are placed in the inbox +(i.e.\ not archived) and unstarred. .PP If no sources are given, sync from all usual sources. -Supported source URI schemes can be seen by running "sup\-add \-\-help". +Supported source URI schemes can be seen by running \[lq]sup-add +--help\[rq]. .SH MESSAGE STATE OPTIONS .TP -.B \-\-asis +.B --asis If the message is already in the index, preserve its state. Otherwise, use default source state (default) -.RS -.RE .TP -.B \-\-restore dumpfile -Restore message state from a dump file created with sup\-dump. -If a message is not in this dumpfile, act as \-\-asis -.RS -.RE +.B --restore dumpfile +Restore message state from a dump file created with sup-dump. +If a message is not in this dumpfile, act as --asis .TP -.B \-\-discard +.B --discard Discard any message state in the index and use the default source state. -\f[B]Dangerous!\f[] -.RS -.RE +\f[B]Dangerous!\f[R] .TP -.B \-x, \- +.B -x, - When using the default source state, mark messages as archived. -.RS -.RE .TP -.B \-r, \-\-read +.B -r, --read When using the default source state, mark messages as read. -.RS -.RE .TP -.B \-\-extra\-labels \f[I]STRING\f[] -When using the default source state, also apply these user\-defined -labels (a comma\-separated list) (default) -.RS -.RE +.B --extra-labels \f[I]STRING\f[R] +When using the default source state, also apply these user-defined +labels (a comma-separated list) (default) .SH OTHER OPTIONS .TP -.B \-v, \-\-verbose -Print message ids as they\[aq]re processed. -.RS -.RE +.B -v, --verbose +Print message ids as they\[cq]re processed. .TP -.B \-o, \-\-optimize +.B -o, --optimize As the final operation, optimize the index. -.RS -.RE .TP -.B \-\-all\-sources +.B --all-sources Scan over all sources. -.RS -.RE .TP -.B \-n, \-\-dry\-run -Don\[aq]t actually modify the index. -Probably only useful with \-\-verbose. -.RS -.RE +.B -n, --dry-run +Don\[cq]t actually modify the index. +Probably only useful with --verbose. .TP -.B \-\-version +.B --version Show version information -.RS -.RE .TP -.B \-h, \-\-help +.B -h, --help Show help message -.RS -.RE .SH FILES .TP .B $HOME/.sup/sources.yaml Configuration file for Sup mail sources -.RS -.RE .SH SEE ALSO .PP -sup(1), sup\-add(1), sup\-config(1), sup\-dump(1), -sup\-sync\-back\-maildir(1), sup\-tweak\-labels(1) +sup(1), sup-add(1), sup-config(1), sup-dump(1), +sup-sync-back-maildir(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/> -.RS -.RE .TP .B Code repository: <https://github.com/sup-heliotrope/sup/> -.RS -.RE .TP .B Sup Wiki: <https://github.com/sup-heliotrope/sup/wiki/> -.RS -.RE .TP .B Sup IRC channel: -#sup \@ freenode.net -.RS -.RE +#sup \[at] freenode.net .TP .B Mailing list: -supmua\@googlegroups.com +supmua\[at]googlegroups.com .RS .PP -supmua+subscribe\@googlegroups.com +supmua+subscribe\[at]googlegroups.com .PP Archives: <https://groups.google.com/d/forum/supmua/> .RE .SH COPYRIGHT .PP -Copyright © 2006\-2009 William Morgan <mworgan-sup@masanjin.net> +Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net> .PP -Copyright \@ 2013\-2014 Sup developers +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