From ded126141163058ab2e812bf965f40cfee3edc7f Mon Sep 17 00:00:00 2001 From: jgoerzen Date: Sat, 19 Jul 2003 00:49:13 +0100 Subject: [PATCH] /offlineimap/head: changeset 509 Added a section on upgrading to the documentation --- offlineimap/head/UPGRADING | 9 ++++++ offlineimap/head/debian/changelog | 7 ++++ offlineimap/head/offlineimap.1 | 41 ++++++++++++++++++++++-- offlineimap/head/offlineimap.sgml | 53 +++++++++++++++++++++++++++++-- 4 files changed, 104 insertions(+), 6 deletions(-) create mode 100644 offlineimap/head/UPGRADING diff --git a/offlineimap/head/UPGRADING b/offlineimap/head/UPGRADING new file mode 100644 index 0000000..45f448d --- /dev/null +++ b/offlineimap/head/UPGRADING @@ -0,0 +1,9 @@ +NOTE: + +The configuration file has changed in incompatile ways with 4.0. If you are +upgrading from a previous version, please read the UPGRADING section in the +manual before invoking OfflineIMAP. + +-- John + + diff --git a/offlineimap/head/debian/changelog b/offlineimap/head/debian/changelog index b3d564f..ea5876e 100644 --- a/offlineimap/head/debian/changelog +++ b/offlineimap/head/debian/changelog @@ -1,3 +1,10 @@ +offlineimap (4.0.0) unstable; urgency=low + + * Poof, this is 4.0. + * Added UPGRADING file and UPGRADING instructions. + + -- John Goerzen Fri, 18 Jul 2003 17:31:14 -0500 + offlineimap (3.99.20) unstable; urgency=low * OfflineIMAP now moves messages between new and cur in Maildir when flags diff --git a/offlineimap/head/offlineimap.1 b/offlineimap/head/offlineimap.1 index 5dfedba..960a406 100644 --- a/offlineimap/head/offlineimap.1 +++ b/offlineimap/head/offlineimap.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "OFFLINEIMAP" "1" "02 June 2003" "John Goerzen" "OfflineIMAP Manual" +.TH "OFFLINEIMAP" "1" "18 July 2003" "John Goerzen" "OfflineIMAP Manual" .SH NAME OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support @@ -77,7 +77,9 @@ machine, and point both \fBOfflineIMAP\fR and their mail reader of choice at it. This is often preferable to the mail reader's own IMAP support since \fBOfflineIMAP\fR supports many features (offline reading, for one) that most IMAP-aware -readers don't. +readers don't. However, this feature is not as time-tested +as traditional syncing, so my advice is to stick with normal +methods of operation for the time being. .SH "QUICK START" .PP If you have already installed \fBOfflineIMAP\fR system-wide, @@ -644,6 +646,11 @@ No. \fBOfflineIMAP\fR is smart enough to figure out message deletion without th crutch. You'll get the best results if you don't use this setting, in fact. .TP +\fBI've upgraded and now OfflineIMAP crashes when I start it up! Why?\fR +You need to upgrade your configuration +file. See [XRef to UPGRADING.4.0] at the end of this +manual. +.TP \fBHow do I specify the names of my folders?\fR You do not need to. \fBOfflineIMAP\fR is smart enough to automatically figure out what folders are present @@ -746,7 +753,7 @@ An informal benchmark yields these results for my setup: .TP 0.2i \(bu Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as -specified in RFC2060 +specified in RFC2060 and RFC3501 .TP 0.2i \(bu CRAM-MD5 as specified in RFC2195 @@ -832,6 +839,34 @@ the web interface . .PP The Web site also lists all current bugs, where you can check their status or contribute to fixing them. +.SH "UPGRADING TO 4.0" +.PP +If you are upgrading from a version of \fBOfflineIMAP\fR prior to +3.99.12, you will find that you will get errors when +\fBOfflineIMAP\fR starts up (relating to ConfigParser or +AccountHashGenerator) and the +configuration file. This is because the config file format +had to change to accomodate new features in 4.0. Fortunately, +it's not difficult to adjust it to suit. +.PP +First thing you need to do is stop any running \fBOfflineIMAP\fR +instance, making sure first that it's synced all your mail. +Then, modify your +\fI~/.offlineimaprc\fR file. You'll need to +split up each account section (make sure that it now starts +with "Account ") into two Repository sections (one for the +local side and another for the remote side.) See the files +\fIofflineimap.conf.minimal\fR and +\fIofflineimap.conf\fR in the distribution if +you need more assistance. +.PP +\fBOfflineIMAP\fR's status directory area has also changed. +Therefore, you should delete everything in ~/.offlineimap as +well as your local mail folders. +.PP +When you start up \fBOfflineIMAP\fR 4.0, it will re-download all +your mail from the server and then you can continue using it +like normal. .SH "COPYRIGHT" .PP OfflineIMAP, and this manual, are Copyright (C) 2002, 2003 John Goerzen. diff --git a/offlineimap/head/offlineimap.sgml b/offlineimap/head/offlineimap.sgml index 2f96963..dc04f19 100644 --- a/offlineimap/head/offlineimap.sgml +++ b/offlineimap/head/offlineimap.sgml @@ -10,7 +10,7 @@
jgoerzen@complete.org
JohnGoerzen - $Date: 2003-06-02 09:06:18 -0500 (Mon, 02 Jun 2003) $ + $Date: 2003-07-18 13:49:13 -0500 (Fri, 18 Jul 2003) $ @@ -114,7 +114,9 @@ of choice at it. This is often preferable to the mail reader's own IMAP support since &OfflineIMAP; supports many features (offline reading, for one) that most IMAP-aware - readers don't. + readers don't. However, this feature is not as time-tested + as traditional syncing, so my advice is to stick with normal + methods of operation for the time being. @@ -818,6 +820,15 @@ rm -r ~/.offlineimap/Repository-RepositoryName + I've upgraded and now &OfflineIMAP; + crashes when I start it up! Why? + You need to upgrade your configuration + file. See at the end of this + manual. + + + + How do I specify the names of my folders? You do not need to. &OfflineIMAP; is smart @@ -937,7 +948,7 @@ rm -r ~/.offlineimap/Repository-RepositoryName Conforming To Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as - specified in RFC2060 + specified in RFC2060 and RFC3501 CRAM-MD5 as specified in RFC2195 Maildir as specified in the Maildir manpage and @@ -1046,6 +1057,42 @@ rm -r ~/.offlineimap/Repository-RepositoryName + + Upgrading to 4.0 + + If you are upgrading from a version of &OfflineIMAP; prior to + 3.99.12, you will find that you will get errors when + &OfflineIMAP; starts up (relating to ConfigParser or + AccountHashGenerator) and the + configuration file. This is because the config file format + had to change to accomodate new features in 4.0. Fortunately, + it's not difficult to adjust it to suit. + + + First thing you need to do is stop any running &OfflineIMAP; + instance, making sure first that it's synced all your mail. + Then, modify your + ~/.offlineimaprc file. You'll need to + split up each account section (make sure that it now starts + with "Account ") into two Repository sections (one for the + local side and another for the remote side.) See the files + offlineimap.conf.minimal and + offlineimap.conf in the distribution if + you need more assistance. + + + &OfflineIMAP;'s status directory area has also changed. + Therefore, you should delete everything in ~/.offlineimap as + well as your local mail folders. + + + When you start up &OfflineIMAP; 4.0, it will re-download all + your mail from the server and then you can continue using it + like normal. + + + + Copyright OfflineIMAP, and this manual, are Copyright © 2002, 2003 John Goerzen.