[DRE-commits] [sup-mail] 03/06: Use upstream man pages
Per Andersson
avtobiff at moszumanska.debian.org
Tue Oct 7 10:35:59 UTC 2014
This is an automated email from the git hooks/post-receive script.
avtobiff pushed a commit to branch master
in repository sup-mail.
commit 87d58a1fbb1a76ea1f51d6b68b2071f38b5f086c
Author: Per Andersson <avtobiff at gmail.com>
Date: Tue Oct 7 12:07:59 2014 +0200
Use upstream man pages
---
debian/changelog | 1 +
debian/man/sup-add.1 | 129 ++++++++++++++++++++--------
debian/man/sup-cmd.1 | 52 ------------
debian/man/sup-config.1 | 100 ++++++++++++++++------
debian/man/sup-dump.1 | 107 +++++++++++++++++-------
debian/man/sup-import-dump.1 | 118 +++++++++++++++++++-------
debian/man/sup-mail.1 | 159 ++++++++++++++++++++++++-----------
debian/man/sup-recover-sources.1 | 137 ++++++++++++++++++++----------
debian/man/sup-server.1 | 38 ---------
debian/man/sup-sync.1 | 176 ++++++++++++++++++++++++++-------------
debian/man/sup-tweak-labels.1 | 126 ++++++++++++++++++++--------
11 files changed, 749 insertions(+), 394 deletions(-)
diff --git a/debian/changelog b/debian/changelog
index 0206503..421cff8 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,7 @@
sup-mail (0.20.0-1) UNRELEASED; urgency=low
* New upstream release.
+ - Use upstream man pages
* d/compat: Set to 9, since we use debhelper 9.
* Bump Standard-Version to 3.9.6, no changes needed
diff --git a/debian/man/sup-add.1 b/debian/man/sup-add.1
index 4c1251e..60694be 100644
--- a/debian/man/sup-add.1
+++ b/debian/man/sup-add.1
@@ -1,63 +1,124 @@
-.TH SUP-ADD "1" "April 9, 2012"
-
+.TH "SUP\-ADD" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-add \- add a source to the Sup source list
-
+.PP
+sup\-add \- add a source to the Sup source list
.SH SYNOPSIS
-.B sup-add
-.RI [ options ]
-[\fIsource uri\fR\&\.\.\.]
-
+.PP
+sup\-add [\f[I]options\f[]] [\f[I]source uri...\f[]]
.SH DESCRIPTION
+.PP
Add one ore more sources to the Sup source list
.PP
For mbox files on local disk, use the form:
.IP
-mbox:<path to mbox file>, or
+.nf
+\f[C]
+mbox:<path\ to\ mbox\ file>,\ or
-mbox://<path to mbox file>
+mbox://<path\ to\ mbox\ file>
+\f[]
+.fi
.PP
For Maildir folders, use the form:
.IP
-maildir:<path to Maildir directory>; or
-
-maildir://<path to Maildir directory>
+.nf
+\f[C]
+maildir:<path\ to\ Maildir\ directory>;\ or
+maildir://<path\ to\ Maildir\ directory>
+\f[]
+.fi
.SH OPTIONS
.TP
-\fB\-\-archive\fR, \fB\-a\fR
+.B \-a, \-\-archive
Automatically archive all new messages from thesesources.
+.RS
+.RE
.TP
-\fB\-\-unusual\fR, \fB\-u\fR
+.B \-u, \-\-unusual
Do not automatically poll these sources for new messages.
+.RS
+.RE
.TP
-\fB\-\-labels\fR, \fB\-l\fR label
-A comma\-separated set of labels to apply to all messages from this source
+.B \-l \f[I]STRING\f[], \-\-labels \f[I]STRING\f[]
+A comma\-separated set of labels to apply to all messages from this
+source
+.RS
+.RE
.TP
-\fB\-\-force\-new\fR, \fB\-f\fR
+.B \-f, \-\-force\-new
Create a new account for this source, even if one already exists
+.RS
+.RE
.TP
-\fB\-\-force\-account\fR, \fB\-o\fR account
-Reuse previously defined account user at hostname
+.B \-o \f[I]STRING\f[], \-\-force\-account \f[I]STRING\f[]
+Reuse previously defined account user\@hostname
+.RS
+.RE
.TP
-\fB\-\-version\fR, \fB\-v\fR
+.B \-v, \-\-version
Print version and exit
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH FILES
-.TP 30
-.I $HOME/.sup/sources.yaml
+.TP
+.B $HOME/.sup/sources.yaml
Configuration file for Sup mail sources
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-config(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+sup(1), sup\-config(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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-cmd.1 b/debian/man/sup-cmd.1
deleted file mode 100644
index f6c8380..0000000
--- a/debian/man/sup-cmd.1
+++ /dev/null
@@ -1,52 +0,0 @@
-.TH SUP-CMD "1" "April 9, 2012"
-
-.SH NAME
-sup-cmd \- connect to a running sup-server
-
-.SH SYNOPSIS
-.B sup-cmd
-[\fIglobal options\fR]
-command
-.RI [ options ]
-
-.SH DESCRIPTION
-Connect to a running sup-server and execute command.
-.PP
-Valid commands are:
-.IP
-query count label add
-
-.SH OPTIONS
-.TP
-\fB\-\-archive\fR, \fB\-a\fR
-Automatically archive all new messages from these sources.
-.TP
-\fB\-\-unusual\fR, \fB\-u\fR
-Do not automatically poll these sources for new messages.
-.TP
-\fB\-\-labels\fR, \fB\-l\fR label
-A comma\-separated set of labels to apply to all messages from this source
-.TP
-\fB\-\-force\-new\fR, \fB\-f\fR
-Create a new account for this source, even if one
-already exists.
-.TP
-\fB\-\-force\-account\fR, \fB\-o\fR account
-Reuse previously defined account user at hostname
-.TP
-\fB\-\-version\fR, \fB\-v\fR
-Print version and exit
-.TP
-\fB\-\-help\fR, \fB\-h\fR
-Show help message
-
-.SH SEE ALSO
-sup-mail(1), sup-server(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
diff --git a/debian/man/sup-config.1 b/debian/man/sup-config.1
index c28b410..8c8d509 100644
--- a/debian/man/sup-config.1
+++ b/debian/man/sup-config.1
@@ -1,38 +1,84 @@
-.TH SUP-CONFIG "1" "April 2012"
-
+.TH "SUP\-CONFIG" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-config \- interactive configuration tool for Sup
-
+.PP
+sup\-config \- interactive configuration tool for Sup
.SH SYNOPSIS
-.B sup-config
-.RI [ options ]
-
+.PP
+sup\-config [\f[I]options\f[]]
.SH DESCRIPTION
-Interactive configuration tool for Sup. Won't destroy existing configuration.
-
+.PP
+Interactive configuration tool for Sup.
+Won\[aq]t destroy existing configuration.
.SH OPTIONS
.TP
-\fB\-\-version\fR, \fB\-v\fR:
-Print version and exit
+.B \-v, \-\-version
+Print versian and exit
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR:
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH FILES
-.TP 30
-.I $HOME/.sup/config.yaml
+.TP
+.B $HOME/.sup/config.yaml
Configuration file for Sup
-.TP 30
-.I $HOME/.sup/sources.yaml
+.RS
+.RE
+.TP
+.B $HOME/.sup/sources.yaml
Configuration file for Sup mail sources
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-add(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+.PP
+sup(1), sup\-add(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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-dump.1 b/debian/man/sup-dump.1
index 05b5d8c..c064c48 100644
--- a/debian/man/sup-dump.1
+++ b/debian/man/sup-dump.1
@@ -1,43 +1,94 @@
-.TH SUP-DUMP "1" "April 9, 2012"
-
+.TH "SUP\-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-dump \- dumps message state from Sup index
-
+.PP
+sup\-dump \- dumps message state from Sup index
.SH SYNOPSIS
-.B sup-dump
-.RI [ options ]
-
+.PP
+sup\-dump [\f[I]options\f[]]
.SH DESCRIPTION
-Dumps all message state from the Sup index to standard out. You can later use
-sup\-sync \fB\-\-restored\fR \fB\-\-restore\fR <filename> to recover the index.
.PP
-This tool is primarily useful in the event that a Sup upgrade breaks index
-format compatibility.
-
+Dumps all message state from the Sup index to standard out.
+You can later use sup\-sync \-\-restored \-\-restore to recover the
+index.
+.PP
+This tool is primarily useful in the event that a Sup upgrade breaks
+index format compatibility.
.SH OPTIONS
.TP
-\fB\-\-version\fR, \fB\-v\fR
+.B \-v, \-\-version
Print version and exit
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH EXAMPLES
+.PP
Dump message state and store in file
.IP
-sup\-dump > filename
-.TP
+.nf
+\f[C]
+sup\-dump\ >\ filename
+\f[]
+.fi
+.PP
Dump message state and compress output to store in file
.IP
-sup\-dump | bzip2 > filename.bz2
-
+.nf
+\f[C]
+sup\-dump\ |\ bzip2\ >\ filename.bz2
+\f[]
+.fi
.SH SEE ALSO
-sup-mail(1), sup-sync(1), sup-import-dump(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+.PP
+sup(1), sup\-sync(1), sup\-import\-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>
+.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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-import-dump.1 b/debian/man/sup-import-dump.1
index 88e25f9..ec19a2b 100644
--- a/debian/man/sup-import-dump.1
+++ b/debian/man/sup-import-dump.1
@@ -1,54 +1,108 @@
-.TH SUP-IMPORT-DUMP "1" "April 9, 2012"
-
+.TH "SUP\-IMPORT\-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-import-dump \- import message state dump to Sup index
-
+.PP
+sup\-import\-dump \- import message state dump to Sup index
.SH SYNOPSIS
-.B sup-import-dump
-.RI [ options ]
-dumpfile
-
+.PP
+sup\-import\-dump [\f[I]options\f[]] 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
-\fB\-\-restore\fR <filename> instead.
+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
-\fB\-\-verbose\fR, \fB\-v\fR
-Print message ids as they're processed
+.B \-v, \-\-verbose
+Print message ids as they\[aq]re processed
+.RS
+.RE
.TP
-\fB\-\-ignore\-missing\fR, \fB\-i\fR
+.B \-i, \-\-ignore\-missing
Silently skip over messages that are not in the index
+.RS
+.RE
.TP
-\fB\-\-warn\-missing\fR, \fB\-w\fR
+.B \-w, \-\-warn\-missing
Warn about messages that are not in the index, but continue
+.RS
+.RE
.TP
-\fB\-\-abort\-missing\fR, \fB\-a\fR
+.B \-a, \-\-abort\-missing
Abort on encountering messages that are not in the index (default)
+.RS
+.RE
.TP
-\fB\-\-atomic\fR, \fB\-t\fR
+.B \-t, \-\-atomic
Use transaction to apply all changes atomically
+.RS
+.RE
.TP
-\fB\-\-dry\-run\fR, \fB\-n\fR
-Don't actually modify the index. Probably only useful with \fB\-\-verbose\fR
+.B \-n, \-\-dry\-run
+Don\[aq]t actually modify the index.
+Probably only useful with \-\-verbose
+.RS
+.RE
.TP
-\fB\-\-version\fR
+.B \-\-version
Show version information
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-sync(1), sup-dump(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+.PP
+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>
+.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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-mail.1 b/debian/man/sup-mail.1
index 97a97ab..3c27eb9 100644
--- a/debian/man/sup-mail.1
+++ b/debian/man/sup-mail.1
@@ -1,65 +1,130 @@
-.TH "SUP" 1
-
+.TH "SUP" "1" "April 8, 2014" "Sup User Manual" ""
.SH NAME
-sup-mail \- Sup, a thread-centric mailer with tagging and fast search
-
+.PP
+sup \- a curses\-based email client
.SH SYNOPSIS
-.B sup-mail
-.RI [ options ]
+.PP
+sup [\f[I]options\f[]]
.SH DESCRIPTION
-This manual page documents briefly the
-.B sup-mail
-command.
.PP
-.B Sup
-is a console-based email client. The command
-.B sup-mail
-invokes the interactive curses frontend. Several other commands are used to
-configure Sup and add mail sources; please refer to the "New User's Guide" for
-details.
-
+Sup is a console\-based email client for people with a lot of email.
+.PP
+It presents an interface of a list of threads, which are each
+hierarchical collections email messages.
+Threads can have multiple tags applied to them.
+It supports a very fast full\-text search, automatic contact\-list
+management, custom code insertion via a Ruby hook system, and more.
+If you're the type of person who treats email as an extension of your
+long\-term memory, Sup is for you.
.SH OPTIONS
.TP
-.B \-\-list\-hooks, \-l
-List all hooks and descriptions, and quit
+.B \-l, \-\-list\-hooks
+List all hooks and descriptions, and quit.
+.RS
+.RE
.TP
-.B \-\-no\-threads, \-n
-Turn off threading. Helps with debugging. (Necessarily disables background
-polling for new messages.)
+.B \-n, \-\-no\-threads
+Turn off threading.
+Helps with debugging.
+(Necessarily disables background polling for new messages.)
+.RS
+.RE
.TP
-.B \-\-no\-initial\-poll, \-o
-Don't poll for new messages when starting
+.B \-o, \-\-no\-initial\-poll
+Don\[aq]t poll for new messages when starting.
+.RS
+.RE
.TP
-.B \-\-search, \-s query
+.B \-s \f[I]QUERY\f[], \-\-search \f[I]QUERY\f[]
Search for this query upon startup
+.RS
+.RE
.TP
-.B \-\-compose, \-c recipient
+.B \-c \f[I]STRING\f[], \-\-compose \f[I]STRING\f[]
Compose message to this recipient upon startup
+.RS
+.RE
.TP
-.B \-\-version, \-v
-Show version of program
+.B \-j \f[I]STRING\f[], \-\-subject \f[I]STRING\f[]
+When composing, use this subject
+.RS
+.RE
.TP
-.B \-\-help, \-h
-Show summary of options
-
+.B \-v, \-\-version
+Print version and exit
+.RS
+.RE
+.TP
+.B \-h, \-\-help
+Show brief help message
+.RS
+.RE
.SH FILES
-.TP 30
-$HOME/.sup/colors.yaml
-Color theme for Sup, see
-.I /usr/share/doc/sup-mail/examples
-for example themes
-
+.TP
+.B $HOME/.sup/config.yaml
+Configuration file for Sup
+.RS
+.RE
+.TP
+.B $HOME/.sup/sources.yaml
+Configuration file for Sup mail sources
+.RS
+.RE
+.TP
+.B $HOME/.sup/colors.yaml
+Color theme for Sup
+.RS
+.RE
.SH SEE ALSO
-mail(1), sup-add(1), sup-cmd(1), sup-config(1), sup-dump(1),
-sup-import-dump(1), sup-recover-sources(1), sup-server(1), sup-sync(1),
-sup-sync-back(1), sup-tweak-labels(1)
.PP
-.I /usr/share/doc/sup-mail/NewUserGuide.txt.gz
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
+mail(1), sup\-add(1), sup\-config(1), sup\-dump(1),
+sup\-import\-dump(1), sup\-recover\-sources(1), sup\-sync(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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 2013\-2014 Sup developers
.PP
-This manual page was written by Decklin Foster <decklin at red\-bean.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-recover-sources.1 b/debian/man/sup-recover-sources.1
index 145eebe..579071a 100644
--- a/debian/man/sup-recover-sources.1
+++ b/debian/man/sup-recover-sources.1
@@ -1,57 +1,106 @@
-.TH SUP-RECOVER-SOURCES "1" "April 9, 2012"
-
+.TH "SUP\-RECOVER\-SOURCES" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-recover-sources \- rebuild a lost Sup source configuration file
-
+.PP
+sup\-recover\-sources \- rebuild a lost Sup source configuration file
.SH SYNOPSIS
-.B sup-recover-sources
-.RI [ options ]
-[\fIsource uri\fR\&\.\.\.]
-
+.PP
+sup\-recover\-sources [\f[I]options\f[]] [\f[I]source uri...\f[]]
.SH DESCRIPTION
-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.
-
-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.
-
-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.
-
-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.
-
+.PP
+Rebuilds a lost sources.yaml file by reading messages from a list of
+sources and determining, for each source, the most prevalent
+\[aq]source_id\[aq] 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.
+.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.
+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.
.SH OPTIONS
.TP
-\fB\-\-unusual\fR
-Mark sources as 'unusual'. Only usual sources will be polled by hand (default:
-false)
+.B \-\-unusual
+Mark sources as \[aq]unusual\[aq].
+Only usual sources will be polled by hand (default: false)
+.RS
+.RE
.TP
-\fB\-\-archive\fR
-Mark sources as 'archive'. New messages from these sources will not appear in
-the inbox (default: false)
+.B \-\-archive
+Mark sources as \[aq]archive\[aq].
+New messages from these sources will not appear in the inbox (default:
+false)
+.RS
+.RE
.TP
-\fB\-\-scan-num\fR N
+.B \-\-scan\-num N
Number of messages to scan per source (default: 10)
+.RS
+.RE
.TP
-\fB\-h\fR, \fB\-\-help\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH FILES
-.TP 30
-.I $HOME/.sup/sources.yaml
+.TP
+.B $HOME/.sup/sources.yaml
Configuration file for Sup mail sources
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-config(1), sup-add(1), sup-import(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+.PP
+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>
+.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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-server.1 b/debian/man/sup-server.1
deleted file mode 100644
index 3a4974f..0000000
--- a/debian/man/sup-server.1
+++ /dev/null
@@ -1,38 +0,0 @@
-.TH SUP-SERVER "1" "April 9, 2012"
-
-.SH NAME
-sup-server \- interact with a Sup index
-
-.SH SYNOPSIS
-.B sup-server
-.RI [ options ]
-
-.SH DESCRIPTION
-Start a server with which one can interact with a Sup index.
-
-.SH OPTIONS
-.TP
-\fB\-\-host\fR, \fB\-o\fR address
-Address to listen on (default: localhost)
-.TP
-\fB\-\-port\fR, \fB\-p\fR
-Port to listen on (default: 4300)
-.TP
-\fB\-\-verbose\fR, \fB\-v\fR
-Be verbose
-.TP
-\fB\-\-help\fR, \fB\-h\fR
-Show help message
-
-.SH SEE ALSO
-sup-mail(1), sup-cmd(1)
-.PP
-/usr/share/doc/sup-mail/protocol.md
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
diff --git a/debian/man/sup-sync.1 b/debian/man/sup-sync.1
index e372a44..d886f9d 100644
--- a/debian/man/sup-sync.1
+++ b/debian/man/sup-sync.1
@@ -1,86 +1,148 @@
-.TH SUP-SYNC "1" "April 9, 2012"
-
+.TH "SUP\-SYNC" "1" "April 9, 2012" "Sup User Manual" ""
.SH NAME
-sup-sync \- sychronize the Sup index with message sources
-
+.PP
+sup\-sync \- sychronize the Sup index with message sources
.SH SYNOPSIS
-.B sup-sync
-.RI [ options ]
-source ...
-
+.PP
+sup\-sync [\f[I]options\f[]] source ...
.SH 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.
.PP
-"Message state" means read/unread, archived/inbox, starred/unstarred, and all
-user\-defined labels on each message.
+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.
.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. 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.
+"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.
.PP
-If no sources are given, sync from all usual sources. Supported source URI
-schemes can be seen by running "sup\-add \fB\-\-help\fR".
-
+If no sources are given, sync from all usual sources.
+Supported source URI schemes can be seen by running "sup\-add \-\-help".
.SH MESSAGE STATE OPTIONS
.TP
-\fB\-\-asis\fR
-If the message is already in the index, preserve its state. Otherwise, use
-default source state (default)
+.B \-\-asis
+If the message is already in the index, preserve its state.
+Otherwise, use default source state (default)
+.RS
+.RE
.TP
-\fB\-\-restore\fR dumpfile
-Restore message state from a dump file created with sup\-dump. If a message is
-not in this dumpfile, act as \fB\-\-asis\fR
+.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
.TP
-\fB\-\-discard\fR
+.B \-\-discard
Discard any message state in the index and use the default source state.
-Dangerous!
-.TP
-\fB\-\-archive\fR, \fB\-x\fR
-When using the default source state, mark messages as archived.
+\f[B]Dangerous!\f[]
+.RS
+.RE
+.PP
+\-x, \-: When using the default source state, mark messages as archived.
.TP
-\fB\-\-read\fR, \fB\-r\fR
+.B \-r, \-\-read
When using the default source state, mark messages as read.
+.RS
+.RE
.TP
-\fB\-\-extra\-labels\fR labels
-When using the default source state, also apply these user\-defined labels (a
-comma\-separated list) (default)
-
+.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
.SH OTHER OPTIONS
.TP
-\fB\-\-verbose\fR, \fB\-v\fR
-Print message ids as they're processed.
+.B \-v, \-\-verbose
+Print message ids as they\[aq]re processed.
+.RS
+.RE
.TP
-\fB\-\-optimize\fR, \fB\-o\fR
+.B \-o, \-\-optimize
As the final operation, optimize the index.
+.RS
+.RE
.TP
-\fB\-\-all\-sources\fR
+.B \-\-all\-sources
Scan over all sources.
+.RS
+.RE
.TP
-\fB\-\-dry\-run\fR, \fB\-n\fR
-Don't actually modify the index. Probably only useful with \fB\-\-verbose\fR.
+.B \-n, \-\-dry\-run
+Don\[aq]t actually modify the index.
+Probably only useful with \-\-verbose.
+.RS
+.RE
.TP
-\fB\-\-version\fR
+.B \-\-version
Show version information
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH FILES
-.TP 30
-.I $HOME/.sup/sources.yaml
+.TP
+.B $HOME/.sup/sources.yaml
Configuration file for Sup mail sources
-
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-add(1), sup-config(1), sup-dump(1), sup-tweak-labels(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
diff --git a/debian/man/sup-tweak-labels.1 b/debian/man/sup-tweak-labels.1
index 0e6188e..b9f99b0 100644
--- a/debian/man/sup-tweak-labels.1
+++ b/debian/man/sup-tweak-labels.1
@@ -1,58 +1,114 @@
-.TH SUP-TWEAK-LABELS "1" "April 9, 2012"
-
+.TH "SUP\-TWEAK\-LABELS" "1" "April 9, 2012" "Sup User Manuel" ""
.SH NAME
-sup-tweak-labels \- batch modification of message state already in index
-
+.PP
+sup\-tweak\-labels \- batch modification of message state already in
+index
.SH SYNOPSIS
-.B sup-tweak-labels
-.RI [ options ]
-source ...
-
+.PP
+sup\-tweak\-labels [\f[I]options\f[]] source ...
.SH DESCRIPTION
+.PP
Batch modification of message state for messages already in the index.
.PP
-Supported source URI schemes can be seen by running "sup\-add \fB\-\-help\fR".
-
+Supported source URI schemes can be seen by running "sup\-add \-\-help".
.SH OPTIONS
.TP
-\fB\-\-add\fR, \fB\-a\fR labels
+.B \-a \f[I]STRING\f[], \-\-add \f[I]STRING\f[]
One or more labels (comma\-separated) to add to every message from the
specified sources (default: )
+.RS
+.RE
.TP
-\fB\-\-remove\fR, \fB\-r\fR labels
-One or more labels (comma\-separated) to remove from every message from the
-specified sources, if those labels are present (default: )
+.B \-r \f[I]STRING\f[], \-\-remove \f[I]STRING\f[]
+One or more labels (comma\-separated) to remove from every message from
+the specified sources, if those labels are present (default: )
+.RS
+.RE
.TP
-\fB\-\-query\fR, \fB\-q\fR query
+.B \-q \f[I]QUERY\f[], \-\-query \f[I]QUERY\f[]
A Sup search query
-
+.RS
+.RE
.SH OTHER OPTIONS
.TP
-\fB\-\-verbose\fR, \fB\-v\fR
-Print message ids as they're processed
+.B \-v, \-\-verbose
+Print message ids as they\[aq]re processed
+.RS
+.RE
.TP
-\fB\-\-very\-verbose\fR, \fB\-e\fR
-Print message names and subjects as they're processed
+.B \-e, \-\-very\-verbose
+Print message names and subjects as they\[aq]re processed
+.RS
+.RE
.TP
-\fB\-\-all\-sources\fR
+.B \-\-all\-sources
Scan over all sources
+.RS
+.RE
.TP
-\fB\-\-dry\-run\fR, \fB\-n\fR
-Don't actually modify the index. Probably only useful with \fB\-\-verbose\fR
+.B \-n, \-\-dry\-run
+Don\[aq]t actually modify the index.
+Probably only useful with \-\-verbose
+.RS
+.RE
.TP
-\fB\-\-version\fR
+.B \-\-version
Show version information
+.RS
+.RE
.TP
-\fB\-\-help\fR, \fB\-h\fR
+.B \-h, \-\-help
Show help message
-
+.RS
+.RE
.SH SEE ALSO
-sup-mail(1), sup-add(1)
-
-.SH AUTHOR
-Sup was written by William Morgan <wmorgan-sup at masanjin.net>.
-.PP
-This manual page was written by Per Andersson <avtobiff at gmail.com> for the
-Debian project (but may be used by others).
-
-\# vim: ft=groff tw=80
+.PP
+sup(1), sup\-add(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
+.TP
+.B Mailing list:
+supmua\@googlegroups.com
+.RS
+.PP
+supmua+subscribe\@googlegroups.com
+.PP
+Archives: <https://groups.google.com/d/forum/supmua/>
+.RE
+.SH COPYRIGHT
+.PP
+Copyright © 2006\-2009 William Morgan <mworgan-sup at masanjin.net>
+.PP
+Copyright \@ 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 at masanjin.net>
+and is now developed and maintained by the Sup developers.
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-ruby-extras/sup-mail.git
More information about the Pkg-ruby-extras-commits
mailing list