.TH SUP-RECOVER-SOURCES "1" "April 9, 2012"

.SH NAME
sup-recover-sources \- rebuild a lost Sup source configuration file

.SH SYNOPSIS
.B sup-recover-sources
.RI [ options ]
[\fIsource uri\fR\&\.\.\.]

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

.SH OPTIONS
.TP
\fB\-\-unusual\fR
Mark sources as 'unusual'. Only usual sources will be polled by hand (default:
false)
.TP
\fB\-\-archive\fR
Mark sources as 'archive'. New messages from these sources will not appear in
the inbox (default: false)
.TP
\fB\-\-scan-num\fR N
Number of messages to scan per source (default: 10)
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help message

.SH FILES
.TP 30
.I $HOME/.sup/sources.yaml
Configuration file for Sup mail sources

.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@masanjin.net>.
.PP
This manual page was written by Per Andersson <avtobiff@gmail.com> for the
Debian project (but may be used by others).

\# vim: ft=groff tw=80