sup 1.1 → 1.3

data/man/sup-import-dump.1

@@ -1,69 +1,68 @@
-.\" Automatically generated by Pandoc 2.9.2.1
+.\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "SUP-IMPORT-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
-.hy
+.TH "SUP\-IMPORT\-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
 .SH NAME
-.PP
-sup-import-dump - import message state dump to Sup index
+sup\-import\-dump \- import message state dump to Sup index
 .SH SYNOPSIS
-.PP
-sup-import-dump [\f[I]options\f[R]] dumpfile
+sup\-import\-dump [\f[I]options\f[R]] dumpfile
 .SH DESCRIPTION
-.PP
-Imports message state previously exported by sup-dump into the index.
-sup-import-dump operates on the index only, so the messages must have
-already been added using sup-sync.
-If you need to recreate the index, see sup-sync --restore instead.
+Imports message state previously exported by sup\-dump into the index.
+sup\-import\-dump operates on the index only, so the messages must have
+already been added using sup\-sync.
+If you need to recreate the index, see sup\-sync \-\-restore  instead.
 .PP
 Messages not mentioned in the dump file will not be modified.
 .SH OPTIONS
 .TP
--v, --verbose
+\-v, \-\-verbose
 Print message ids as they\[cq]re processed
 .TP
--i, --ignore-missing
+\-i, \-\-ignore\-missing
 Silently skip over messages that are not in the index
 .TP
--w, --warn-missing
+\-w, \-\-warn\-missing
 Warn about messages that are not in the index, but continue
 .TP
--a, --abort-missing
+\-a, \-\-abort\-missing
 Abort on encountering messages that are not in the index (default)
 .TP
--t, --atomic
+\-t, \-\-atomic
 Use transaction to apply all changes atomically
 .TP
--n, --dry-run
+\-n, \-\-dry\-run
 Don\[cq]t actually modify the index.
-Probably only useful with --verbose
+Probably only useful with \-\-verbose
 .TP
---version
+\-\-version
 Show version information
 .TP
--h, --help
+\-h, \-\-help
 Show help message
 .SH SEE ALSO
-.PP
-sup(1), sup-sync(1), sup-dump(1)
+sup(1), sup\-sync(1), sup\-dump(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>
+\c
+.UR https://github.com/sup-heliotrope/sup/issues
+.UE \c
 .SH CONTACT INFORMATION
 .TP
 The Sup web page:
-<https://sup-heliotrope.github.io/>
+\c
+.UR https://sup-heliotrope.github.io/
+.UE \c
 .TP
 Code repository:
-<https://github.com/sup-heliotrope/sup/>
+\c
+.UR https://github.com/sup-heliotrope/sup/
+.UE \c
 .TP
 Sup Wiki:
-<https://github.com/sup-heliotrope/sup/wiki/>
-.TP
-Sup IRC channel:
-#sup \[at] freenode.net
+\c
+.UR https://github.com/sup-heliotrope/sup/wiki/
+.UE \c
 .TP
 Mailing list:
 supmua\[at]googlegroups.com
@@ -71,17 +70,22 @@ supmua\[at]googlegroups.com
 .PP
 supmua+subscribe\[at]googlegroups.com
 .PP
-Archives: <https://groups.google.com/d/forum/supmua/>
+Archives: \c
+.UR https://groups.google.com/d/forum/supmua/
+.UE \c
 .RE
 .SH COPYRIGHT
+Copyright © 2006\-2009 William Morgan \c
+.MT mworgan-sup@masanjin.net
+.ME \c
 .PP
-Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
-.PP
-Copyright \[at] 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
-Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
-and is now developed and maintained by the Sup developers.
+Sup was originally written by William Morgan \c
+.MT wmorgan-sup@masanjin.net
+.ME \c
+\ and is now developed and maintained by the Sup developers.

data/man/sup-psych-ify-config-files.1

@@ -1,25 +1,21 @@
-.\" Automatically generated by Pandoc 2.9.2.1
+.\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "SUP-SYNC" "1" "September 3, 2014" "Sup User Manual" ""
-.hy
+.TH "SUP\-SYNC" "1" "September 3, 2014" "Sup User Manual" ""
 .SH NAME
-.PP
-sup-psych-ify-config-files - migrate Sup configuration
+sup\-psych\-ify\-config\-files \- migrate Sup configuration
 .SH SYNOPSIS
-.PP
-sup-psych-ify-config-files
+sup\-psych\-ify\-config\-files
 .SH DESCRIPTION
-.PP
 \f[B]YAML migration is deprecated by Ruby 2.1 and newer.\f[R]
 .PP
-If sup-psych-ify-config-files is executed by Ruby <= 2.0 it migrates the
-\f[I]$HOME/.sup/sources.yaml\f[R] configuration file by reading it with
-the SYCK YAML parser and emitting the results with the Psych YAML
+If sup\-psych\-ify\-config\-files is executed by Ruby <= 2.0 it migrates
+the \f[I]$HOME/.sup/sources.yaml\f[R] configuration file by reading it
+with the SYCK YAML parser and emitting the results with the Psych YAML
 emitter.
 .PP
 Read more on the Sup wiki
 .PP
-https://github.com/sup-heliotrope/sup/wiki/Migration-0.13-to-0.14
+https://github.com/sup\-heliotrope/sup/wiki/Migration\-0.13\-to\-0.14
 .SH FILES
 .TP
 $HOME/.sup/config.yaml
@@ -28,27 +24,30 @@ Sup configuration file
 $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(1), sup\-add(1), sup\-config(1), sup\-dump(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>
+\c
+.UR https://github.com/sup-heliotrope/sup/issues
+.UE \c
 .SH CONTACT INFORMATION
 .TP
 The Sup web page:
-<https://sup-heliotrope.github.io/>
+\c
+.UR https://sup-heliotrope.github.io/
+.UE \c
 .TP
 Code repository:
-<https://github.com/sup-heliotrope/sup/>
+\c
+.UR https://github.com/sup-heliotrope/sup/
+.UE \c
 .TP
 Sup Wiki:
-<https://github.com/sup-heliotrope/sup/wiki/>
-.TP
-Sup IRC channel:
-#sup \[at] freenode.net
+\c
+.UR https://github.com/sup-heliotrope/sup/wiki/
+.UE \c
 .TP
 Mailing list:
 supmua\[at]googlegroups.com
@@ -56,17 +55,22 @@ supmua\[at]googlegroups.com
 .PP
 supmua+subscribe\[at]googlegroups.com
 .PP
-Archives: <https://groups.google.com/d/forum/supmua/>
+Archives: \c
+.UR https://groups.google.com/d/forum/supmua/
+.UE \c
 .RE
 .SH COPYRIGHT
+Copyright © 2006\-2009 William Morgan \c
+.MT mworgan-sup@masanjin.net
+.ME \c
 .PP
-Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
-.PP
-Copyright \[at] 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
-Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
-and is now developed and maintained by the Sup developers.
+Sup was originally written by William Morgan \c
+.MT wmorgan-sup@masanjin.net
+.ME \c
+\ and is now developed and maintained by the Sup developers.

data/man/sup-recover-sources.1

@@ -1,73 +1,72 @@
-.\" Automatically generated by Pandoc 2.9.2.1
+.\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "SUP-RECOVER-SOURCES" "1" "April 9, 2012" "Sup User Manual" ""
-.hy
+.TH "SUP\-RECOVER\-SOURCES" "1" "April 9, 2012" "Sup User Manual" ""
 .SH NAME
-.PP
-sup-recover-sources - rebuild a lost Sup source configuration file
+sup\-recover\-sources \- rebuild a lost Sup source configuration file
 .SH SYNOPSIS
-.PP
-sup-recover-sources [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
+sup\-recover\-sources [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
 .SH DESCRIPTION
-.PP
 Rebuilds a lost sources.yaml file by reading messages from a list of
 sources and determining, for each source, the most prevalent `source_id'
 field of messages from that source in the index.
 .PP
-The only non-deterministic component to this is that if the same message
-appears in multiple sources, those sources may be mis-diagnosed by this
-program.
+The only non\-deterministic component to this is that if the same
+message appears in multiple sources, those sources may be mis\-diagnosed
+by this program.
 .PP
-If the first N messages (--scan-num below) all have the same source_id
-in the index, the source will be added to sources.yaml.
+If the first N messages (\-\-scan\-num below) all have the same
+source_id in the index, the source will be added to sources.yaml.
 Otherwise, the distribution will be printed, and you will have to add it
 by hand.
 .PP
 The offset pointer into the sources will be set to the end of the
-source, so you will have to run sup-import --rebuild for each new source
-after doing this.
+source, so you will have to run sup\-import \-\-rebuild for each new
+source after doing this.
 .SH OPTIONS
 .TP
---unusual
+\-\-unusual
 Mark sources as `unusual'.
 Only usual sources will be polled by hand (default: false)
 .TP
---archive
+\-\-archive
 Mark sources as `archive'.
 New messages from these sources will not appear in the inbox (default:
 false)
 .TP
---scan-num N
+\-\-scan\-num N
 Number of messages to scan per source (default: 10)
 .TP
--h, --help
+\-h, \-\-help
 Show help message
 .SH FILES
 .TP
 $HOME/.sup/sources.yaml
 Configuration file for Sup mail sources
 .SH SEE ALSO
-.PP
-sup(1), sup-config(1), sup-add(1), sup-import(1)
+sup(1), sup\-config(1), sup\-add(1), sup\-import(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>
+\c
+.UR https://github.com/sup-heliotrope/sup/issues
+.UE \c
 .SH CONTACT INFORMATION
 .TP
 The Sup web page:
-<https://sup-heliotrope.github.io/>
+\c
+.UR https://sup-heliotrope.github.io/
+.UE \c
 .TP
 Code repository:
-<https://github.com/sup-heliotrope/sup/>
+\c
+.UR https://github.com/sup-heliotrope/sup/
+.UE \c
 .TP
 Sup Wiki:
-<https://github.com/sup-heliotrope/sup/wiki/>
-.TP
-Sup IRC channel:
-#sup \[at] freenode.net
+\c
+.UR https://github.com/sup-heliotrope/sup/wiki/
+.UE \c
 .TP
 Mailing list:
 supmua\[at]googlegroups.com
@@ -75,17 +74,22 @@ supmua\[at]googlegroups.com
 .PP
 supmua+subscribe\[at]googlegroups.com
 .PP
-Archives: <https://groups.google.com/d/forum/supmua/>
+Archives: \c
+.UR https://groups.google.com/d/forum/supmua/
+.UE \c
 .RE
 .SH COPYRIGHT
+Copyright © 2006\-2009 William Morgan \c
+.MT mworgan-sup@masanjin.net
+.ME \c
 .PP
-Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
-.PP
-Copyright \[at] 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
-Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
-and is now developed and maintained by the Sup developers.
+Sup was originally written by William Morgan \c
+.MT wmorgan-sup@masanjin.net
+.ME \c
+\ and is now developed and maintained by the Sup developers.

data/man/sup-sync-back-maildir.1

@@ -1,28 +1,25 @@
-.\" Automatically generated by Pandoc 2.9.2.1
+.\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "SUP-SYNC-BACK-MAILDIR" "1" "August 25, 2014" "Sup User Manual" ""
-.hy
+.TH "SUP\-SYNC\-BACK\-MAILDIR" "1" "August 25, 2014" "Sup User Manual" ""
 .SH NAME
-.PP
-sup-sync-back-maildir - Export Xapian entries to Maildir sources on disk
+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]]
+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
+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
+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'),
+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
@@ -35,50 +32,53 @@ sources marked as usual and that have not disabled sync back using the
 configuration parameter sync_back = false in sources.yaml.
 .SH OPTIONS
 .TP
--n, --no-confirm
+\-n, \-\-no\-confirm
 Don\[cq]t ask for confirmation before synchronizing
 .TP
--m, --no-merge
+\-m, \-\-no\-merge
 Don\[cq]t merge new supported Maildir flags (R and P)
 .TP
--l, --list-sources
+\-l, \-\-list\-sources
 List your Maildir sources and exit
 .TP
--u, --unusual-sources-too
+\-u, \-\-unusual\-sources\-too
 Sync unusual sources too if no specific source information is given
 .TP
---version
+\-\-version
 Print version and exit
 .TP
--h, --help
+\-h, \-\-help
 Show brief help message
 .SH FILES
 .TP
 $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)
+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>
+\c
+.UR https://github.com/sup-heliotrope/sup/issues
+.UE \c
 .SH CONTACT INFORMATION
 .TP
 The Sup web page:
-<https://sup-heliotrope.github.io/>
+\c
+.UR https://sup-heliotrope.github.io/
+.UE \c
 .TP
 Code repository:
-<https://github.com/sup-heliotrope/sup/>
+\c
+.UR https://github.com/sup-heliotrope/sup/
+.UE \c
 .TP
 Sup Wiki:
-<https://github.com/sup-heliotrope/sup/wiki/>
-.TP
-Sup IRC channel:
-#sup \[at] freenode.net
+\c
+.UR https://github.com/sup-heliotrope/sup/wiki/
+.UE \c
 .TP
 Mailing list:
 supmua\[at]googlegroups.com
@@ -86,17 +86,22 @@ supmua\[at]googlegroups.com
 .PP
 supmua+subscribe\[at]googlegroups.com
 .PP
-Archives: <https://groups.google.com/d/forum/supmua/>
+Archives: \c
+.UR https://groups.google.com/d/forum/supmua/
+.UE \c
 .RE
 .SH COPYRIGHT
+Copyright © 2006\-2009 William Morgan \c
+.MT mworgan-sup@masanjin.net
+.ME \c
 .PP
-Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
-.PP
-Copyright \[at] 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
-Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
-and is now developed and maintained by the Sup developers.
+Sup was originally written by William Morgan \c
+.MT wmorgan-sup@masanjin.net
+.ME \c
+\ and is now developed and maintained by the Sup developers.

data/man/sup-sync.1

@@ -1,103 +1,102 @@
-.\" Automatically generated by Pandoc 2.9.2.1
+.\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "SUP-SYNC" "1" "April 9, 2012" "Sup User Manual" ""
-.hy
+.TH "SUP\-SYNC" "1" "April 9, 2012" "Sup User Manual" ""
 .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[R]] 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
 \[lq]Message state\[rq] means read/unread, archived/inbox,
-starred/unstarred, and all user-defined labels on each message.
+starred/unstarred, and all user\-defined labels on each message.
 .PP
 \[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.
+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.
 .PP
 If no sources are given, sync from all usual sources.
-Supported source URI schemes can be seen by running \[lq]sup-add
---help\[rq].
+Supported source URI schemes can be seen by running \[lq]sup\-add
+\-\-help\[rq].
 .SH MESSAGE STATE OPTIONS
 .TP
---asis
+\-\-asis
 If the message is already in the index, preserve its state.
 Otherwise, use default source state (default)
 .TP
---restore dumpfile
-Restore message state from a dump file created with sup-dump.
-If a message is not in this dumpfile, act as --asis
+\-\-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
---discard
+\-\-discard
 Discard any message state in the index and use the default source state.
 \f[B]Dangerous!\f[R]
 .TP
--x, -
+\-x, \-
 When using the default source state, mark messages as archived.
 .TP
--r, --read
+\-r, \-\-read
 When using the default source state, mark messages as read.
 .TP
---extra-labels \f[I]STRING\f[R]
-When using the default source state, also apply these user-defined
-labels (a comma-separated list) (default)
+\-\-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
--v, --verbose
+\-v, \-\-verbose
 Print message ids as they\[cq]re processed.
 .TP
--o, --optimize
+\-o, \-\-optimize
 As the final operation, optimize the index.
 .TP
---all-sources
+\-\-all\-sources
 Scan over all sources.
 .TP
--n, --dry-run
+\-n, \-\-dry\-run
 Don\[cq]t actually modify the index.
-Probably only useful with --verbose.
+Probably only useful with \-\-verbose.
 .TP
---version
+\-\-version
 Show version information
 .TP
--h, --help
+\-h, \-\-help
 Show help message
 .SH FILES
 .TP
 $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-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>
+\c
+.UR https://github.com/sup-heliotrope/sup/issues
+.UE \c
 .SH CONTACT INFORMATION
 .TP
 The Sup web page:
-<https://sup-heliotrope.github.io/>
+\c
+.UR https://sup-heliotrope.github.io/
+.UE \c
 .TP
 Code repository:
-<https://github.com/sup-heliotrope/sup/>
+\c
+.UR https://github.com/sup-heliotrope/sup/
+.UE \c
 .TP
 Sup Wiki:
-<https://github.com/sup-heliotrope/sup/wiki/>
-.TP
-Sup IRC channel:
-#sup \[at] freenode.net
+\c
+.UR https://github.com/sup-heliotrope/sup/wiki/
+.UE \c
 .TP
 Mailing list:
 supmua\[at]googlegroups.com
@@ -105,17 +104,22 @@ supmua\[at]googlegroups.com
 .PP
 supmua+subscribe\[at]googlegroups.com
 .PP
-Archives: <https://groups.google.com/d/forum/supmua/>
+Archives: \c
+.UR https://groups.google.com/d/forum/supmua/
+.UE \c
 .RE
 .SH COPYRIGHT
+Copyright © 2006\-2009 William Morgan \c
+.MT mworgan-sup@masanjin.net
+.ME \c
 .PP
-Copyright \[co] 2006-2009 William Morgan <mworgan-sup@masanjin.net>
-.PP
-Copyright \[at] 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
-Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
-and is now developed and maintained by the Sup developers.
+Sup was originally written by William Morgan \c
+.MT wmorgan-sup@masanjin.net
+.ME \c
+\ and is now developed and maintained by the Sup developers.