/offlineimap/head: changeset 140

Forgot to update the docs. This should have gone into 3.0.2. Ooops.
This commit is contained in:
jgoerzen 2002-07-18 02:12:42 +01:00
parent 647640f468
commit 14a160ea93
4 changed files with 131 additions and 45 deletions

View File

@ -25,7 +25,7 @@
<hr> <hr>
<!-- Creator : groff version 1.17.2 --> <!-- Creator : groff version 1.17.2 -->
<!-- CreationDate: Mon Jul 15 11:26:37 2002 --> <!-- CreationDate: Wed Jul 17 15:12:19 2002 -->
<a name="NAME"></a> <a name="NAME"></a>
<h2>NAME</h2> <h2>NAME</h2>
<table width="100%" border=0 rules="none" frame="void" <table width="100%" border=0 rules="none" frame="void"
@ -869,6 +869,30 @@ from the server as well. (If you don't understand this,
don't worry; you probably won't encounter this don't worry; you probably won't encounter this
situation)</td></table> situation)</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="4%"></td><td width="96%">
<b>COPYING MESSAGES BETWEEN FOLDERS</b></td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
Normally, when you copy a message between folders or add a
new message to a folder locally, <b>OfflineIMAP</b> will
just do the right thing. However, sometimes this can be
tricky -- if your IMAP server does not provide the SEARCH
command, or does not return something useful,
<b>OfflineIMAP</b> cannot determine the new UID of the
message. So, in these rare instances, OfflineIMAP will
upload the message to the IMAP server and delete it from
your local folder. Then, on your next sync, the message will
be re-downloaded with the proper UID. <b>OfflineIMAP</b>
makes sure that the message was properly uploaded before
deleting it, so there should be no risk of data
loss.</td></table>
<table width="100%" border=0 rules="none" frame="void" <table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0"> cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"> <tr valign="top" align="left">
@ -969,6 +993,22 @@ its homepage via either Gopher or HTTP:</td></table>
<td width="10%"></td><td width="90%"> <td width="10%"></td><td width="90%">
gopher://quux.org/1/devel/offlineimap<br> gopher://quux.org/1/devel/offlineimap<br>
http://quux.org/devel/offlineimap</td></table> http://quux.org/devel/offlineimap</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
OfflineIMAP may also be downloaded using Subversion.
Additionally, the distributed tar.gz may be updated with a
simple &quot;svn update&quot; command; it is ready to go.
For information on getting OfflineIMAP with Subversion,
please visit:</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
http://svn.complete.org/</td></table>
<a name="SEE ALSO"></a> <a name="SEE ALSO"></a>
<h2>SEE ALSO</h2> <h2>SEE ALSO</h2>

Binary file not shown.

View File

@ -1,6 +1,6 @@
%!PS-Adobe-3.0 %!PS-Adobe-3.0
%%Creator: groff version 1.17.2 %%Creator: groff version 1.17.2
%%CreationDate: Mon Jul 15 11:26:30 2002 %%CreationDate: Wed Jul 17 15:12:18 2002
%%DocumentNeededResources: font Times-Roman %%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold %%+ font Times-Bold
%%+ font Times-Italic %%+ font Times-Italic
@ -656,56 +656,81 @@ F .897(people might think that it w)3.397 F .897(ould be wise to)-.1 F
leted from)-2.916 F(the serv)108 417.6 Q(er as well.)-.15 E leted from)-2.916 F(the serv)108 417.6 Q(er as well.)-.15 E
(\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18 (\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18
G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
(ncounter this situation\))-2.5 E F2(MAILING LIST)87 434.4 Q F0 (ncounter this situation\))-2.5 E F2(COPYING MESSA)87 434.4 Q
(There is an Of)108 446.4 Q(\215ineIMAP mailing list a)-.25 E -.25(va) (GES BETWEEN FOLDERS)-.55 E F0(Normally)108 446.4 Q 5.858(,w)-.65 G
-.2 G(ilable.).25 E 2.447 -.8(To s)108 463.2 T .847 3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359
(ubscribe, send the te).8 F .847 (essage between folders or add a ne)-5.858 F 5.859(wm)-.25 G 3.359
(essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 458.4
Q F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E
-.15(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
-3.353 F(er)-.15 E .29(does not pro)108 470.4 R .29
(vide the SEARCH command, or does not return something useful,)-.15 F F2
(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .174
(mine the ne)108 482.4 R 2.674(wU)-.25 G .174(ID of the message.)-2.674
F .173(So, in these rare instances, Of)5.173 F .173
(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108
494.4 R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55
G .64(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)
-.15 F(wn-)-.25 E 1.473(loaded with the proper UID.)108 506.4 R F2
(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
-.1 F 1.472(as properly uploaded before)-.1 F
(deleting it, so there should be no risk of data loss.)108 518.4 Q F2
(MAILING LIST)87 535.2 Q F0(There is an Of)108 547.2 Q
(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.447 -.8
(To s)108 564 T .847(ubscribe, send the te).8 F .847
(xt "Subscribe" in the subject of a mail to of)-.15 F (xt "Subscribe" in the subject of a mail to of)-.15 F
(\215ineimap-request@complete.or)-.25 E 3.348(g. T)-.18 F(o)-.8 E (\215ineimap-request@complete.or)-.25 E 3.348(g. T)-.18 F(o)-.8 E
(post, send the message to of)108 475.2 Q(\215ineimap@complete.or)-.25 E (post, send the message to of)108 576 Q(\215ineimap@complete.or)-.25 E
(g.)-.18 E F1 -.11(BU)72 492 S(GS).11 E F0 (g.)-.18 E F1 -.11(BU)72 592.8 S(GS).11 E F0
(Should be reported to the author at the address speci\214ed belo)108 (Should be reported to the author at the address speci\214ed belo)108
504 Q -.65(w.)-.25 G F1(COPYRIGHT)72 520.8 Q F0(Of)108 532.8 Q 604.8 Q -.65(w.)-.25 G F1(COPYRIGHT)72 621.6 Q F0(Of)108 633.6 Q
(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .287 (\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .287
(This program is free softw)108 549.6 R .287(are; you can redistrib)-.1 (This program is free softw)108 650.4 R .287(are; you can redistrib)-.1
F .286(ute it and/or modify it under the terms of the GNU General)-.2 F F .286(ute it and/or modify it under the terms of the GNU General)-.2 F
.766(Public License as published by the Free Softw)108 561.6 R .766 .766(Public License as published by the Free Softw)108 662.4 R .766
(are F)-.1 F .766(oundation; either v)-.15 F .766 (are F)-.1 F .766(oundation; either v)-.15 F .766
(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 573.6 Q (ersion 2 of the License, or \(at your)-.15 F(option\) an)108 674.4 Q
2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib) 2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib)
108 590.4 R .579(uted in the hope that it will be useful, b)-.2 F .579 108 691.2 R .579(uted in the hope that it will be useful, b)-.2 F .579
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.079(;w)-.92 G(ithout)-3.079 E (ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.079(;w)-.92 G(ithout)-3.079 E
-2.15 -.25(ev e)108 602.4 T 2.729(nt).25 G .229(he implied w)-2.729 F -2.15 -.25(ev e)108 703.2 T 2.729(nt).25 G .229(he implied w)-2.729 F
.229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F .229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F
(AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E (AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E
(the GNU General Public License for more details.)108 614.4 Q -1.1(Yo) (the GNU General Public License for more details.)108 715.2 Q
108 631.2 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei) (John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
.15 E -.15(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)
-2.77 G .27
(he GNU General Public License along with this program; if not, write)
-2.77 F(to:)108 643.2 Q(Free Softw)108 660 Q(are F)-.1 E
(oundation, Inc.)-.15 E(59 T)108 672 Q(emple Place)-.7 E(Suite 330)108
684 Q(Boston, MA)108 696 Q(02111-1307)5 E(USA)108 708 Q(John Goerzen)72
768 Q(July 12, 2002)151.655 E(5)201.915 E EP
%%Page: 6 6 %%Page: 6 6
%%BeginPageSetup %%BeginPageSetup
BP BP
%%EndPageSetup %%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R /F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10.95 (\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E -1.1(Yo)108 84 S
/Times-Bold@0 SF -.548(AU)72 84 S(THOR).548 E/F2 10/Times-Bold@0 SF 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei).15 E -.15
(Of\215ineIMAP)108 96 Q(,)-.92 E F0 .488 (ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)-2.77 G .27
(he GNU General Public License along with this program; if not, write)
-2.77 F(to:)108 96 Q(Free Softw)108 112.8 Q(are F)-.1 E(oundation, Inc.)
-.15 E(59 T)108 124.8 Q(emple Place)-.7 E(Suite 330)108 136.8 Q
(Boston, MA)108 148.8 Q(02111-1307)5 E(USA)108 160.8 Q/F1 10.95
/Times-Bold@0 SF -.548(AU)72 177.6 S(THOR).548 E/F2 10/Times-Bold@0 SF
(Of\215ineIMAP)108 189.6 Q(,)-.92 E F0 .488
(its libraries, documentation, and all included \214les, e)2.987 F .488 (its libraries, documentation, and all included \214les, e)2.987 F .488
(xcept where noted, w)-.15 F .488(as written by John)-.1 F (xcept where noted, w)-.15 F .488(as written by John)-.1 F
(Goerzen <jgoerzen@complete.or)108 108 Q(g> and cop)-.18 E (Goerzen <jgoerzen@complete.or)108 201.6 Q(g> and cop)-.18 E
(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 124.8 Q (yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 218.4 Q
(\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\ (\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\
homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 141.6 Q homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 235.2 Q
(g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E (g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E
(http://quux.or)108 153.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E (http://quux.or)108 247.2 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap)-.25 E F1(SEE ALSO)72 182.4 Q F2(mutt)108 194.4 Q F0 (\215ineimap)-.25 E(Of)108 264 Q 2.529(\215ineIMAP may also be do)-.25 F
(\(1\),)A F2(python)2.5 E F0(\(1\).)A(John Goerzen)72 768 Q 2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
(July 12, 2002)151.655 E(6)201.915 E EP (rsion. Additionally).15 F 5.028(,t)-.65 G 2.528(he distrib)-5.028 F
2.528(uted tar)-.2 F 2.528(.gz may be)-.55 F .717
(updated with a simple "svn update" command; it is ready to go.)108 276
R -.15(Fo)5.718 G 3.218(ri).15 G .718(nformation on getting Of)-3.218 F
(\215ineIMAP)-.25 E(with Sub)108 288 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(http://svn.complete.or)108 304.8 Q(g/)-.18 E
F1(SEE ALSO)72 321.6 Q F2(mutt)108 333.6 Q F0(\(1\),)A F2(python)2.5 E
F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(6)201.915 E EP
%%Trailer %%Trailer
end end
%%EOF %%EOF

View File

@ -406,33 +406,47 @@ NOTES
understand this, don't worry; you probably won't encounter understand this, don't worry; you probably won't encounter
this situation) this situation)
COPYING MESSAGES BETWEEN FOLDERS
Normally, when you copy a message between folders or add a
new message to a folder locally, OfflineIMAP will just do
the right thing. However, sometimes this can be tricky --
if your IMAP server does not provide the SEARCH command,
or does not return something useful, OfflineIMAP cannot
determine the new UID of the message. So, in these rare
instances, OfflineIMAP will upload the message to the IMAP
server and delete it from your local folder. Then, on
your next sync, the message will be re-downloaded with the
proper UID. OfflineIMAP makes sure that the message was
properly uploaded before deleting it, so there should be
no risk of data loss.
MAILING LIST MAILING LIST
There is an OfflineIMAP mailing list available. There is an OfflineIMAP mailing list available.
To subscribe, send the text "Subscribe" in the subject of To subscribe, send the text "Subscribe" in the subject of
a mail to offlineimap-request@complete.org. To post, send a mail to offlineimap-request@complete.org. To post, send
the message to offlineimap@complete.org. the message to offlineimap@complete.org.
BUGS BUGS
Should be reported to the author at the address specified Should be reported to the author at the address specified
below. below.
COPYRIGHT COPYRIGHT
OfflineIMAP is Copyright (C) 2002 John Goerzen. OfflineIMAP is Copyright (C) 2002 John Goerzen.
This program is free software; you can redistribute it This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any either version 2 of the License, or (at your option) any
later version. later version.
This program is distributed in the hope that it will be This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more PURPOSE. See the GNU General Public License for more
details. details.
You should have received a copy of the GNU General Public You should have received a copy of the GNU General Public
License along with this program; if not, write to: License along with this program; if not, write to:
Free Software Foundation, Inc. Free Software Foundation, Inc.
@ -442,9 +456,9 @@ COPYRIGHT
USA USA
AUTHOR AUTHOR
OfflineIMAP, its libraries, documentation, and all OfflineIMAP, its libraries, documentation, and all
included files, except where noted, was written by John included files, except where noted, was written by John
Goerzen <jgoerzen@complete.org> and copyright is held as Goerzen <jgoerzen@complete.org> and copyright is held as
stated in the COPYRIGHT section. stated in the COPYRIGHT section.
OfflineIMAP may be downloaded, and information found, from OfflineIMAP may be downloaded, and information found, from
@ -453,6 +467,13 @@ AUTHOR
gopher://quux.org/1/devel/offlineimap gopher://quux.org/1/devel/offlineimap
http://quux.org/devel/offlineimap http://quux.org/devel/offlineimap
OfflineIMAP may also be downloaded using Subversion.
Additionally, the distributed tar.gz may be updated with a
simple "svn update" command; it is ready to go. For
information on getting OfflineIMAP with Subversion, please
visit:
http://svn.complete.org/
SEE ALSO SEE ALSO
mutt(1), python(1). mutt(1), python(1).