git-svn-id: svn+ssh://svn.gna.org/svn/feed2imap/trunk/feed2imap@44 f70e237a-67f3-0310-a06c-d2b8a7116972

11 files changed, 607 insertions, 41 deletions

diff --git a/data/man/man1/feed2imap-cleaner.1 b/data/man/man1/feed2imap-cleaner.1
new file mode 100644
index 0000000..4f11135
--- /dev/null
+++ b/data/man/man1/feed2imap-cleaner.1
@@ -0,0 +1,43 @@
+.TH feed2imap\-cleaner 1 "Jul 25, 2005"  
+.SH NAME
+feed2imap\-cleaner \- Removes old items from IMAP folders
+.SH SYNOPSIS
+\fBfeed2imap\-cleaner\fR [OPTIONS]
+.SH DESCRIPTION
+feed2imap\-cleaner deletes old items from IMAP folders specified in the configuration file. The actual query string used to determine whether an item is old is :
+"SEEN NOT FLAGGED BEFORE (3 days ago)". Which means that an item WON'T be deleted if it satisfies one of the following conditions :
+.TP 0.2i
+\(bu
+It isn't 3 days old ;
+.TP 0.2i
+\(bu
+It hasn't been read yet ;
+.TP 0.2i
+\(bu
+It is flagged (marked as Important, for example).
+.TP 
+\fB\-d\fR, \fB\-\-dry\-run\fR 
+Don't remove anything, but show what would be removed if run without this option.
+.TP 
+\fB\-f\fR, \fB\-\-config \fIfile\fB\fR 
+Use another config file (~/.feed2imaprc is the default).
+.SH BUGS
+Deletion criterias should probably be more configurable.
+.SH "SEE ALSO"
+Homepage : 
+http://home.gna.org/feed2imap/
+.PP
+\fBfeed2imaprc\fR(5),
+\fBfeed2imap\fR(1)
+.SH AUTHOR
+Copyright (C) 2005 Lucas Nussbaum lucas@lucas\-nussbaum.net
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+.PP
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+more details.
diff --git a/data/man/man1/feed2imap-dumpconfig.1 b/data/man/man1/feed2imap-dumpconfig.1
new file mode 100644
index 0000000..65bf426
--- /dev/null
+++ b/data/man/man1/feed2imap-dumpconfig.1
@@ -0,0 +1,28 @@
+.TH feed2imap\-dumpconfig 1 "Jul 25, 2005"  
+.SH NAME
+feed2imap\-dumpconfig \- Dump feed2imap config
+.SH SYNOPSIS
+\fBfeed2imap\-dumpconfig\fR [OPTIONS]
+.SH DESCRIPTION
+feed2imap\-dumpconfig dumps the content of your feed2imaprc to screen.
+.TP 
+\fB\-f\fR, \fB\-\-config \fIfile\fB\fR 
+Use another config file (~/.feed2imaprc is the default).
+.SH "SEE ALSO"
+Homepage : 
+http://home.gna.org/feed2imap/
+.PP
+\fBfeed2imaprc\fR(5),
+\fBfeed2imap\fR(1)
+.SH AUTHOR
+Copyright (C) 2005 Lucas Nussbaum lucas@lucas\-nussbaum.net
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+.PP
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+more details.
diff --git a/data/man/man1/feed2imap-opmlimport.1 b/data/man/man1/feed2imap-opmlimport.1
new file mode 100644
index 0000000..2702e72
--- /dev/null
+++ b/data/man/man1/feed2imap-opmlimport.1
@@ -0,0 +1,27 @@
+.TH feed2imap\-opmlimport 1 "Jul 25, 2005"  
+.SH NAME
+feed2imap\-opmlimport \- Convert an OPML subscription list to a feed2imap config file
+.SH SYNOPSIS
+\fBfeed2imap\-opmlimport\fR
+.SH DESCRIPTION
+feed2imap\-opmlimport reads an OPML subscription list on standard input and outputs a feed2imap configuration file on standard output. The resulting configuration file will require some tweaking.
+.SH BUGS
+Should probably accept parameters to be able to change default values.
+.SH "SEE ALSO"
+Homepage : 
+http://home.gna.org/feed2imap/
+.PP
+\fBfeed2imaprc\fR(5),
+\fBfeed2imap\fR(1)
+.SH AUTHOR
+Copyright (C) 2005 Lucas Nussbaum lucas@lucas\-nussbaum.net
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+.PP
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+more details.
diff --git a/data/man/man1/feed2imap.1 b/data/man/man1/feed2imap.1
index 3b92b30..18eebae 100644
--- a/data/man/man1/feed2imap.1
+++ b/data/man/man1/feed2imap.1
@@ -1,45 +1,42 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "ALEXANDRIA" 1 "Apr 14, 2004" "" ""
+.TH feed2imap 1 "Jul 25, 2005"  
 .SH NAME
-alexandria \- manage your book collection
-.SH "SYNOPSIS"
-.ad l
-.hy 0
-.HP 11
-\fBalexandria\fR
-.ad
-.hy
-
-.SH "DESCRIPTION"
-
-.PP
-This manual page documents briefly the \fBalexandria\fR command\&. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page\&.
-
-.PP
-Alexandria is a GNOME application to help you manage your book collection\&. It currently does not accept any arguments\&.
-
+feed2imap \- clever RSS/ATOM feed aggregator
+.SH SYNOPSIS
+\fBfeed2imap\fR [OPTIONS]
+.SH DESCRIPTION
+feed2imap is an RSS/Atom feed aggregator. After
+Downloading feeds (over HTTP or HTTPS), it uploads them to a specified
+folder of an IMAP mail server. The user can then access the feeds using
+Mutt, Evolution, Mozilla Thunderbird or even a webmail.
+.TP 
+\fB\-V\fR, \fB\-\-version\fR 
+Show version information.
+.TP 
+\fB\-v\fR, \fB\-\-verbose\fR 
+Run in verbose mode.
+.TP 
+\fB\-c\fR, \fB\-\-rebuild\-cache\fR 
+Rebuilds the cache. Fetches all items and mark them as already seen. Useful if you lose your .feed2imap.cache file.
+.TP 
+\fB\-f\fR, \fB\-\-config \fIfile\fB\fR 
+Use another config file (~/.feed2imaprc is the default).
 .SH "SEE ALSO"
-
+Homepage : 
+http://home.gna.org/feed2imap/
 .PP
-\fIhttp://alexandria.rubyforge.org/\fR 
-
+\fBfeed2imaprc\fR(5),
+\fBfeed2imap\-cleaner\fR(1),
+\fBfeed2imap\-dumpconfig\fR(1),
+\fBfeed2imap\-opmlimport\fR(1)
 .SH AUTHOR
-Dafydd Harries.
+Copyright (C) 2005 Lucas Nussbaum lucas@lucas\-nussbaum.net
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+.PP
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+more details.
diff --git a/data/man/man5/feed2imaprc.5 b/data/man/man5/feed2imaprc.5
new file mode 100644
index 0000000..abfc658
--- /dev/null
+++ b/data/man/man5/feed2imaprc.5
@@ -0,0 +1,26 @@
+.TH feed2imaprc 5 "Jul 25, 2005"  
+.SH NAME
+feed2imaprc \- feed2imap configuration file
+.SH SYNOPSIS
+\fBfeed2imaprc\fR is feed2imap's configuration file. It is usually located in \fB~/.feed2imaprc\fR.
+.SH EXAMPLE
+See \fB/usr/share/doc/feed2imap/examples/feed2imaprc\fR.
+.SH BUGS
+This manpage should probably give more details.
+.SH "SEE ALSO"
+Homepage : 
+http://home.gna.org/feed2imap/
+.PP
+\fBfeed2imap\fR(1)
+.SH AUTHOR
+Copyright (C) 2005 Lucas Nussbaum lucas@lucas\-nussbaum.net
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+.PP
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+more details.
diff --git a/manpages/Makefile b/manpages/Makefile
new file mode 100644
index 0000000..bb2ebd7
--- /dev/null
+++ b/manpages/Makefile
@@ -0,0 +1,23 @@
+MANDIR := ../data/man
+
+all: $(MANDIR)/man1/feed2imap.1 $(MANDIR)/man1/feed2imap-cleaner.1 $(MANDIR)/man1/feed2imap-dumpconfig.1 $(MANDIR)/man1/feed2imap-opmlimport.1 $(MANDIR)/man5/feed2imaprc.5
+
+$(MANDIR)/man1/feed2imap.1: feed2imap.xml
+	docbook2x-man $<
+	cp $$(basename $@) $@
+
+$(MANDIR)/man1/feed2imap-cleaner.1: feed2imap-cleaner.xml
+	docbook2x-man $<
+	cp $$(basename $@) $@
+
+$(MANDIR)/man1/feed2imap-dumpconfig.1: feed2imap-dumpconfig.xml
+	docbook2x-man $<
+	cp $$(basename $@) $@
+
+$(MANDIR)/man1/feed2imap-opmlimport.1: feed2imap-opmlimport.xml
+	docbook2x-man $<
+	cp $$(basename $@) $@
+
+$(MANDIR)/man5/feed2imaprc.5: feed2imaprc.xml
+	docbook2x-man $<
+	cp $$(basename $@) $@
diff --git a/manpages/feed2imap-cleaner.xml b/manpages/feed2imap-cleaner.xml
new file mode 100644
index 0000000..333bd92
--- /dev/null
+++ b/manpages/feed2imap-cleaner.xml
@@ -0,0 +1,97 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+	[
+	<!ENTITY program   "feed2imap-cleaner">
+	<!ENTITY command   "<command>&program;</command>">
+	<!ENTITY firstname "Lucas">
+	<!ENTITY surname   "Nussbaum">
+	<!ENTITY address   "lucas@lucas-nussbaum.net">
+	]>
+<refentry>
+<refentryinfo>
+	<author>
+		<firstname>&firstname;</firstname>
+		<surname>&surname;</surname>
+	</author>
+	<address>&address;</address>
+	<copyright>
+		<year>2005</year>
+		<holder>&firstname; &surname;</holder>
+	</copyright>
+	<date>Jul 25, 2005</date>
+</refentryinfo>
+<refmeta>
+	<refentrytitle>&program;</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv>
+	<refname>&program;</refname>
+	<refpurpose>Removes old items from IMAP folders</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>feed2imap-cleaner</command> [OPTIONS]
+	</cmdsynopsis>
+</refsynopsisdiv>
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para><command>feed2imap-cleaner</command> deletes old items from IMAP folders specified in the configuration file. The actual query string used to determine whether an item is old is :
+	"SEEN NOT FLAGGED BEFORE (3 days ago)". Which means that an item WON'T be deleted if it satisfies one of the following conditions :</para>
+	
+	<itemizedlist>
+	<listitem><para>It isn't 3 days old ;</para></listitem>
+	<listitem><para>It hasn't been read yet ;</para></listitem>
+	<listitem><para>It is flagged (marked as Important, for example).</para></listitem>
+	</itemizedlist>
+
+<variablelist>
+	<varlistentry>
+		<term>
+			<option>-d</option></term><term><option>--dry-run</option>
+		</term>
+		<listitem>
+			<para>Don't remove anything, but show what would be removed if run without this option.</para> 
+		</listitem>
+	</varlistentry>
+	<varlistentry>
+		<term>
+			<option>-f</option></term><term><option>--config <replaceable>file</replaceable></option>
+		</term>
+		<listitem>
+			<para>Use another config file (~/.feed2imaprc is the default).</para> 
+		</listitem>
+	</varlistentry></variablelist>
+</refsect1>
+<refsect1>
+	<title>BUGS</title>
+	<para>Deletion criterias should probably be more configurable.</para>
+
+</refsect1>
+<refsect1>
+	<title>SEE ALSO</title>
+
+	<para>Homepage : 
+	<ulink url="http://home.gna.org/feed2imap/">http://home.gna.org/feed2imap/</ulink></para>
+
+	<para>
+	<citerefentry><refentrytitle>feed2imaprc</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+	</para>
+</refsect1>
+<refsect1>
+	<title>AUTHOR</title>
+	<para>Copyright (C) 2005 Lucas Nussbaum <email>lucas@lucas-nussbaum.net</email></para>
+
+	<para>This program is free software; you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by the
+	Free Software Foundation; either version 2 of the License, or (at your
+	option) any later version.</para>
+
+	<para>This program is distributed in the hope that it will be useful, but
+	WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+	more details.</para>
+
+</refsect1>
+</refentry>
diff --git a/manpages/feed2imap-dumpconfig.xml b/manpages/feed2imap-dumpconfig.xml
new file mode 100644
index 0000000..bc1e4dc
--- /dev/null
+++ b/manpages/feed2imap-dumpconfig.xml
@@ -0,0 +1,77 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+	[
+	<!ENTITY program   "feed2imap-dumpconfig">
+	<!ENTITY command   "<command>&program;</command>">
+	<!ENTITY firstname "Lucas">
+	<!ENTITY surname   "Nussbaum">
+	<!ENTITY address   "lucas@lucas-nussbaum.net">
+	]>
+<refentry>
+<refentryinfo>
+	<author>
+		<firstname>&firstname;</firstname>
+		<surname>&surname;</surname>
+	</author>
+	<address>&address;</address>
+	<copyright>
+		<year>2005</year>
+		<holder>&firstname; &surname;</holder>
+	</copyright>
+	<date>Jul 25, 2005</date>
+</refentryinfo>
+<refmeta>
+	<refentrytitle>&program;</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv>
+	<refname>&program;</refname>
+	<refpurpose>Dump feed2imap config</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>feed2imap-dumpconfig</command> [OPTIONS]
+	</cmdsynopsis>
+</refsynopsisdiv>
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para><command>feed2imap-dumpconfig</command> dumps the content of your feed2imaprc to screen.</para>
+	
+<variablelist>
+	<varlistentry>
+		<term>
+			<option>-f</option></term><term><option>--config <replaceable>file</replaceable></option>
+		</term>
+		<listitem>
+			<para>Use another config file (~/.feed2imaprc is the default).</para> 
+		</listitem>
+	</varlistentry></variablelist>
+</refsect1>
+<refsect1>
+	<title>SEE ALSO</title>
+
+	<para>Homepage : 
+	<ulink url="http://home.gna.org/feed2imap/">http://home.gna.org/feed2imap/</ulink></para>
+
+	<para>
+	<citerefentry><refentrytitle>feed2imaprc</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+	</para>
+</refsect1>
+<refsect1>
+	<title>AUTHOR</title>
+	<para>Copyright (C) 2005 Lucas Nussbaum <email>lucas@lucas-nussbaum.net</email></para>
+
+	<para>This program is free software; you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by the
+	Free Software Foundation; either version 2 of the License, or (at your
+	option) any later version.</para>
+
+	<para>This program is distributed in the hope that it will be useful, but
+	WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+	more details.</para>
+
+</refsect1>
+</refentry>
diff --git a/manpages/feed2imap-opmlimport.xml b/manpages/feed2imap-opmlimport.xml
new file mode 100644
index 0000000..d8055d9
--- /dev/null
+++ b/manpages/feed2imap-opmlimport.xml
@@ -0,0 +1,73 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+	[
+	<!ENTITY program   "feed2imap-opmlimport">
+	<!ENTITY command   "<command>&program;</command>">
+	<!ENTITY firstname "Lucas">
+	<!ENTITY surname   "Nussbaum">
+	<!ENTITY address   "lucas@lucas-nussbaum.net">
+	]>
+<refentry>
+<refentryinfo>
+	<author>
+		<firstname>&firstname;</firstname>
+		<surname>&surname;</surname>
+	</author>
+	<address>&address;</address>
+	<copyright>
+		<year>2005</year>
+		<holder>&firstname; &surname;</holder>
+	</copyright>
+	<date>Jul 25, 2005</date>
+</refentryinfo>
+<refmeta>
+	<refentrytitle>&program;</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv>
+	<refname>&program;</refname>
+	<refpurpose>Convert an OPML subscription list to a feed2imap config file</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>feed2imap-opmlimport</command>
+	</cmdsynopsis>
+</refsynopsisdiv>
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para><command>feed2imap-opmlimport</command> reads an OPML subscription list on standard input and outputs a feed2imap configuration file on standard output. The resulting configuration file will require some tweaking.</para>
+
+</refsect1>
+<refsect1>
+	<title>BUGS</title>
+	<para>Should probably accept parameters to be able to change default values.</para>
+
+</refsect1>
+<refsect1>
+	<title>SEE ALSO</title>
+
+	<para>Homepage : 
+	<ulink url="http://home.gna.org/feed2imap/">http://home.gna.org/feed2imap/</ulink></para>
+
+	<para>
+	<citerefentry><refentrytitle>feed2imaprc</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+	</para>
+</refsect1>
+<refsect1>
+	<title>AUTHOR</title>
+	<para>Copyright (C) 2005 Lucas Nussbaum <email>lucas@lucas-nussbaum.net</email></para>
+
+	<para>This program is free software; you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by the
+	Free Software Foundation; either version 2 of the License, or (at your
+	option) any later version.</para>
+
+	<para>This program is distributed in the hope that it will be useful, but
+	WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+	more details.</para>
+
+</refsect1>
+</refentry>
diff --git a/manpages/feed2imap.xml b/manpages/feed2imap.xml
new file mode 100644
index 0000000..75d278f
--- /dev/null
+++ b/manpages/feed2imap.xml
@@ -0,0 +1,106 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+	[
+	<!ENTITY program   "feed2imap">
+	<!ENTITY command   "<command>&program;</command>">
+	<!ENTITY firstname "Lucas">
+	<!ENTITY surname   "Nussbaum">
+	<!ENTITY address   "lucas@lucas-nussbaum.net">
+	]>
+<refentry>
+<refentryinfo>
+	<author>
+		<firstname>&firstname;</firstname>
+		<surname>&surname;</surname>
+	</author>
+	<address>&address;</address>
+	<copyright>
+		<year>2005</year>
+		<holder>&firstname; &surname;</holder>
+	</copyright>
+	<date>Jul 25, 2005</date>
+</refentryinfo>
+<refmeta>
+	<refentrytitle>&program;</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv>
+	<refname>&program;</refname>
+	<refpurpose>clever RSS/ATOM feed aggregator</refpurpose>
+</refnamediv>
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>feed2imap</command> [OPTIONS]
+	</cmdsynopsis>
+</refsynopsisdiv>
+<refsect1>
+	<title>DESCRIPTION</title>
+
+	<para><command>feed2imap</command> is an RSS/Atom feed aggregator. After
+	Downloading feeds (over HTTP or HTTPS), it uploads them to a specified
+	folder of an IMAP mail server. The user can then access the feeds using
+	Mutt, Evolution, Mozilla Thunderbird or even a webmail.</para>
+
+<variablelist>
+	<varlistentry>
+		<term>
+			<option>-V</option></term><term><option>--version</option>
+		</term>
+		<listitem>
+			<para>Show version information.</para> 
+		</listitem>
+	</varlistentry>
+	<varlistentry>
+		<term>
+			<option>-v</option></term><term><option>--verbose</option>
+		</term>
+		<listitem>
+			<para>Run in verbose mode.</para> 
+		</listitem>
+	</varlistentry>
+	<varlistentry>
+		<term>
+			<option>-c</option></term><term><option>--rebuild-cache</option>
+		</term>
+		<listitem>
+			<para>Rebuilds the cache. Fetches all items and mark them as already seen. Useful if you lose your .feed2imap.cache file.</para> 
+		</listitem>
+	</varlistentry>
+	<varlistentry>
+		<term>
+			<option>-f</option></term><term><option>--config <replaceable>file</replaceable></option>
+		</term>
+		<listitem>
+			<para>Use another config file (~/.feed2imaprc is the default).</para> 
+		</listitem>
+	</varlistentry></variablelist>
+</refsect1>
+<refsect1>
+	<title>SEE ALSO</title>
+
+	<para>Homepage : 
+	<ulink url="http://home.gna.org/feed2imap/">http://home.gna.org/feed2imap/</ulink></para>
+
+	<para>
+	<citerefentry><refentrytitle>feed2imaprc</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap-cleaner</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap-dumpconfig</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+	<citerefentry><refentrytitle>feed2imap-opmlimport</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+	</para>
+</refsect1>
+<refsect1>
+	<title>AUTHOR</title>
+	<para>Copyright (C) 2005 Lucas Nussbaum <email>lucas@lucas-nussbaum.net</email></para>
+
+	<para>This program is free software; you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by the
+	Free Software Foundation; either version 2 of the License, or (at your
+	option) any later version.</para>
+
+	<para>This program is distributed in the hope that it will be useful, but
+	WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+	more details.</para>
+
+</refsect1>
+</refentry>
diff --git a/manpages/feed2imaprc.xml b/manpages/feed2imaprc.xml
new file mode 100644
index 0000000..b2289b3
--- /dev/null
+++ b/manpages/feed2imaprc.xml
@@ -0,0 +1,69 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+	[
+	<!ENTITY program   "feed2imaprc">
+	<!ENTITY command   "<command>&program;</command>">
+	<!ENTITY firstname "Lucas">
+	<!ENTITY surname   "Nussbaum">
+	<!ENTITY address   "lucas@lucas-nussbaum.net">
+	]>
+<refentry>
+<refentryinfo>
+	<author>
+		<firstname>&firstname;</firstname>
+		<surname>&surname;</surname>
+	</author>
+	<address>&address;</address>
+	<copyright>
+		<year>2005</year>
+		<holder>&firstname; &surname;</holder>
+	</copyright>
+	<date>Jul 25, 2005</date>
+</refentryinfo>
+<refmeta>
+	<refentrytitle>&program;</refentrytitle>
+	<manvolnum>5</manvolnum>
+</refmeta>
+<refnamediv>
+	<refname>&program;</refname>
+	<refpurpose>feed2imap configuration file</refpurpose>
+</refnamediv>
+<refsect1>
+	<title>SYNOPSIS</title>
+
+	<para><filename>feed2imaprc</filename> is feed2imap's configuration file. It is usually located in <filename>~/.feed2imaprc</filename>.</para>
+</refsect1>
+<refsect1>
+	<title>EXAMPLE</title>
+	<para>See <filename>/usr/share/doc/feed2imap/examples/feed2imaprc</filename>.</para>
+</refsect1>
+<refsect1>
+	<title>BUGS</title>
+	<para>This manpage should probably give more details.</para>
+</refsect1>
+<refsect1>
+	<title>SEE ALSO</title>
+
+	<para>Homepage : 
+	<ulink url="http://home.gna.org/feed2imap/">http://home.gna.org/feed2imap/</ulink></para>
+
+	<para>
+	<citerefentry><refentrytitle>feed2imap</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+	</para>
+</refsect1>
+<refsect1>
+	<title>AUTHOR</title>
+	<para>Copyright (C) 2005 Lucas Nussbaum <email>lucas@lucas-nussbaum.net</email></para>
+
+	<para>This program is free software; you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by the
+	Free Software Foundation; either version 2 of the License, or (at your
+	option) any later version.</para>
+
+	<para>This program is distributed in the hope that it will be useful, but
+	WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+	or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+	more details.</para>
+
+</refsect1>
+</refentry>