/offlineimap/head: changeset 510

Final commits before 4.0. This is the re-built manual and updated
ChangeLog.

offlineimap/head/ChangeLog

@@ -1,3 +1,141 @@
+------------------------------------------------------------------------
+rev 509:  jgoerzen | 2003-07-18 13:49:13 -0500 (Fri, 18 Jul 2003) | 3 lines
+Changed paths:
+   A /offlineimap/head/UPGRADING
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap.1
+   M /offlineimap/head/offlineimap.sgml
+
+Added a section on upgrading to the documentation
+
+
+------------------------------------------------------------------------
+rev 487:  jgoerzen | 2003-06-26 14:03:07 -0500 (Thu, 26 Jun 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/bin/offlineimap
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap/folder/Maildir.py
+   M /offlineimap/head/offlineimap/version.py
+   M /offlineimap/head/offlineimap.py
+
+Fixed version confusion
+
+------------------------------------------------------------------------
+rev 486:  jgoerzen | 2003-06-26 13:38:47 -0500 (Thu, 26 Jun 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/bin/offlineimap
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap/version.py
+   M /offlineimap/head/offlineimap.py
+
+Prep for 3.99.19
+
+------------------------------------------------------------------------
+rev 485:  jgoerzen | 2003-06-26 13:28:54 -0500 (Thu, 26 Jun 2003) | 5 lines
+Changed paths:
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap/folder/IMAP.py
+
+  * Applied patch from Joerg Wendland <joergland@debian.org> to use
+    APPENDUID result from mail servers that provide it.  Closes: #198772.
+
+Resolves: [debian.org #198772]
+
+------------------------------------------------------------------------
+rev 484:  jgoerzen | 2003-06-02 11:17:29 -0500 (Mon, 02 Jun 2003) | 7 lines
+Changed paths:
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap/folder/IMAP.py
+   M /offlineimap/head/offlineimap/imapserver.py
+
+  * Added a "force" option to imapserver/select to force a reloading of a
+    folder.  Per [complete.org #67], when cachemessagelist() was called
+    on an object that was cached from a previous run, it would not
+    re-issue the select().
+
+Closes: [complete.org #67]
+
+------------------------------------------------------------------------
+rev 482:  jgoerzen | 2003-06-02 11:11:51 -0500 (Mon, 02 Jun 2003) | 1 line
+Changed paths:
+   M /offlineimap/head/debian/control
+
+
+------------------------------------------------------------------------
+rev 481:  jgoerzen | 2003-06-02 11:09:57 -0500 (Mon, 02 Jun 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/Makefile
+   M /offlineimap/head/bin/offlineimap
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/debian/rules
+   M /offlineimap/head/offlineimap.py
+   M /offlineimap/head/setup.py
+
+Updated
+
+------------------------------------------------------------------------
+rev 480:  jgoerzen | 2003-06-02 09:52:33 -0500 (Mon, 02 Jun 2003) | 3 lines
+Changed paths:
+   M /offlineimap/head/offlineimap/init.py
+   M /offlineimap/head/offlineimap/ui/UIBase.py
+
+Fixed the -l option
+
+
+------------------------------------------------------------------------
+rev 479:  jgoerzen | 2003-06-02 09:07:30 -0500 (Mon, 02 Jun 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/offlineimap/init.py
+
+Made -d recognized
+
+------------------------------------------------------------------------
+rev 478:  jgoerzen | 2003-06-02 09:06:18 -0500 (Mon, 02 Jun 2003) | 4 lines
+Changed paths:
+   M /offlineimap/head/Makefile
+   M /offlineimap/head/bin/offlineimap
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/debian/control
+   M /offlineimap/head/debian/rules
+   M /offlineimap/head/manual.html
+   M /offlineimap/head/manual.pdf
+   M /offlineimap/head/manual.ps
+   M /offlineimap/head/manual.txt
+   M /offlineimap/head/offlineimap/imaplib.py
+   M /offlineimap/head/offlineimap/imapserver.py
+   M /offlineimap/head/offlineimap/init.py
+   M /offlineimap/head/offlineimap/ui/Curses.py
+   M /offlineimap/head/offlineimap/ui/TTY.py
+   M /offlineimap/head/offlineimap/ui/Tk.py
+   M /offlineimap/head/offlineimap/ui/UIBase.py
+   M /offlineimap/head/offlineimap.1
+   M /offlineimap/head/offlineimap.py
+   M /offlineimap/head/offlineimap.sgml
+   M /offlineimap/head/setup.py
+
+Added -l option.  Updated documentation for it.  Changed _msg to _display
+override in UI modules.  Renamed "doc" to "docs" target in Makefile to avoid
+conflicting with a subdir.
+
+------------------------------------------------------------------------
+rev 477:  jgoerzen | 2003-05-27 17:01:27 -0500 (Tue, 27 May 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/debian/changelog
+   M /offlineimap/head/offlineimap/folder/IMAP.py
+   M /offlineimap/head/offlineimap/imaplib.py
+
+Fixed SSL for Python2.3.
+
+------------------------------------------------------------------------
+rev 475:  jgoerzen | 2003-05-06 09:27:36 -0500 (Tue, 06 May 2003) | 2 lines
+Changed paths:
+   M /offlineimap/head/ChangeLog
+   M /offlineimap/head/bin/offlineimap
+   M /offlineimap/head/offlineimap/version.py
+   M /offlineimap/head/offlineimap.py
+
+Preparing for 3.99.17
+
 ------------------------------------------------------------------------
 rev 474:  jgoerzen | 2003-05-06 09:26:12 -0500 (Tue, 06 May 2003) | 17 lines
 Changed paths:

offlineimap/head/manual.html

@@ -229,7 +229,9 @@ CLASS="APPLICATION"
 >OfflineIMAP</SPAN
 > 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.
 	</P
 ></DIV
 ></DIV
@@ -1483,6 +1485,19 @@ CLASS="APPLICATION"
 	  </P
 ></DD
 ><DT
+>I've upgraded and now <SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+>
+	crashes when I start it up!  Why?</DT
+><DD
+><P
+>You need to upgrade your configuration
+	file.  See  at the end of this
+	      manual.
+	    </P
+></DD
+><DT
 >How do I specify the names of my folders?</DT
 ><DD
 ><P
@@ -1712,7 +1727,7 @@ CLASS="PROPERTY"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN478"
+NAME="AEN484"
 ></A
 ><H2
 >Conforming To</H2
@@ -1722,7 +1737,7 @@ NAME="AEN478"
 ><LI
 ><P
 >Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as
-	  specified in RFC2060</P
+	  specified in RFC2060 and RFC3501</P
 ></LI
 ><LI
 ><P
@@ -1751,14 +1766,14 @@ TARGET="_top"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN491"
+NAME="AEN497"
 ></A
 ><H2
 >Notes</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN493"
+NAME="AEN499"
 ></A
 ><H3
 >Deleting Local Folders</H3
@@ -1790,7 +1805,7 @@ CLASS="APPLICATION"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN500"
+NAME="AEN506"
 ></A
 ><H3
 >Multiple Instances</H3
@@ -1819,7 +1834,7 @@ CLASS="PROPERTY"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN507"
+NAME="AEN513"
 ></A
 ><H3
 >Copying Messages Between Folders</H3
@@ -1849,7 +1864,7 @@ CLASS="APPLICATION"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN513"
+NAME="AEN519"
 ></A
 ><H3
 >Use with Evolution</H3
@@ -1885,7 +1900,7 @@ CLASS="APPLICATION"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN521"
+NAME="AEN527"
 ></A
 ><H3
 >Use with KMail</H3
@@ -1919,7 +1934,7 @@ CLASS="APPLICATION"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN529"
+NAME="AEN535"
 ></A
 ><H3
 >Mailing List</H3
@@ -1938,7 +1953,7 @@ TARGET="_top"
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN533"
+NAME="AEN539"
 ></A
 ><H3
 >Bugs</H3
@@ -1964,7 +1979,70 @@ TARGET="_top"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN539"
+NAME="UPGRADING.4.0"
+></A
+><H2
+>Upgrading to 4.0</H2
+><P
+>	If you are upgrading from a version of <SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+> prior to
+	3.99.12, you will find that you will get errors when
+	<SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+> 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.
+      </P
+><P
+>	First thing you need to do is stop any running <SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+>
+	instance, making sure first that it's synced all your mail.
+	Then, modify your
+	<TT
+CLASS="FILENAME"
+>~/.offlineimaprc</TT
+> 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
+	<TT
+CLASS="FILENAME"
+>offlineimap.conf.minimal</TT
+> and
+	<TT
+CLASS="FILENAME"
+>offlineimap.conf</TT
+> in the distribution if
+	you need more assistance.
+      </P
+><P
+>	<SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+>'s status directory area has also changed.
+	Therefore, you should delete everything in ~/.offlineimap as
+	well as your local mail folders.
+      </P
+><P
+>	When you start up <SPAN
+CLASS="APPLICATION"
+>OfflineIMAP</SPAN
+> 4.0, it will re-download all
+	your mail from the server and then you can continue using it
+	like normal.
+      </P
+></DIV
+><DIV
+CLASS="REFSECT1"
+><A
+NAME="AEN559"
 ></A
 ><H2
 >Copyright</H2
@@ -2002,7 +2080,7 @@ CLASS="APPLICATION"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN548"
+NAME="AEN568"
 ></A
 ><H2
 >Author</H2
@@ -2054,7 +2132,7 @@ TARGET="_top"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN560"
+NAME="AEN580"
 ></A
 ><H2
 >See Also</H2

offlineimap/head/manual.txt

@@ -64,7 +64,9 @@ DESCRIPTION
        and point both OfflineIMAP and their mail reader 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.
+       IMAP-aware  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.
 
 QUICK START
        If  you  have already installed OfflineIMAP system-wide, or your system
@@ -546,6 +548,10 @@ OTHER FREQUENTLY ASKED QUESTIONS
               without this extra crutch.  You'll get the best results  if  you
               don't use this setting, in fact.
 
+       I've upgraded and now OfflineIMAP crashes when I start it up!  Why?
+              You  need  to  upgrade  your  configuration  file.  See [XRef to
+              UPGRADING.4.0] at the end of this manual.
+
        How do I specify the names of my folders?
               You do not need to.  OfflineIMAP is smart  enough  to  automati-
               cally figure out what folders are present on the IMAP server and
@@ -637,7 +643,7 @@ OTHER FREQUENTLY ASKED QUESTIONS
 
 CONFORMING TO
        o Internet Message Access Protocol version 4rev1 (IMAP 4rev1) as speci-
-         fied in RFC2060
+         fied in RFC2060 and RFC3501
 
        o CRAM-MD5 as specified in RFC2195
 
@@ -713,6 +719,29 @@ NOTES
        The Web site also lists all current bugs, where  you  can  check  their
        status or contribute to fixing them.
 
+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 configura-
+       tion 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 sec-
+       tions (one for the local side and another for the  remote  side.)   See
+       the  files offlineimap.conf.minimal and offlineimap.conf in the distri-
+       bution 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  (C)  2002,  2003 John
        Goerzen.
@@ -723,9 +752,9 @@ COPYRIGHT
        option) any later version.
 
        This  program  is  distributed  in the hope that it will be useful, but
-       WITHOUT   ANY   WARRANTY;   without   even   the  implied  warranty  of
+       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER-
-       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  Gen-
+       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
-       eral Public License for more details.
+       Public License for more details.
 
        You should have received a copy of the GNU General Public License along
        with this program; if not, write to the Free Software Foundation, Inc.,
@@ -755,4 +784,4 @@ SEE ALSO
 
 
 
-John Goerzen                     02 June 2003                   OFFLINEIMAP(1)
+John Goerzen                     18 July 2003                   OFFLINEIMAP(1)