/offlineimap/head: changeset 510

Final commits before 4.0. This is the re-built manual and updated
ChangeLog.
This commit is contained in:
jgoerzen 2003-07-19 00:54:18 +01:00
parent ded1261411
commit b8a3bcb0a1
5 changed files with 1160 additions and 847 deletions

View File

@ -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:

View File

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

Binary file not shown.

File diff suppressed because it is too large Load Diff

View File

@ -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
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Gen-
eral Public License for more details.
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
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)