diff --git a/offlineimap/head/manual.html b/offlineimap/head/manual.html index fef4412..4b36143 100644 --- a/offlineimap/head/manual.html +++ b/offlineimap/head/manual.html @@ -25,7 +25,7 @@
- +

NAME

+ + +
+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.
+ @@ -969,6 +993,22 @@ its homepage via either Gopher or HTTP:
gopher://quux.org/1/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

diff --git a/offlineimap/head/manual.pdf b/offlineimap/head/manual.pdf index 98aaa6e..c07a845 100644 Binary files a/offlineimap/head/manual.pdf and b/offlineimap/head/manual.pdf differ diff --git a/offlineimap/head/manual.ps b/offlineimap/head/manual.ps index 80422d6..79a127e 100644 --- a/offlineimap/head/manual.ps +++ b/offlineimap/head/manual.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%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 %%+ font Times-Bold %%+ 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 (\(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 -(ncounter this situation\))-2.5 E F2(MAILING LIST)87 434.4 Q F0 -(There is an Of)108 446.4 Q(\215ineIMAP mailing list a)-.25 E -.25(va) --.2 G(ilable.).25 E 2.447 -.8(To s)108 463.2 T .847 -(ubscribe, send the te).8 F .847 +(ncounter this situation\))-2.5 E F2(COPYING MESSA)87 434.4 Q +(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 446.4 Q 5.858(,w)-.65 G +3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359 +(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 (\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 -(g.)-.18 E F1 -.11(BU)72 492 S(GS).11 E F0 +(post, send the message to of)108 576 Q(\215ineimap@complete.or)-.25 E +(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 -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 -(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 -.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 -(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) -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 --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 (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) -108 631.2 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei) -.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 +(the GNU General Public License for more details.)108 715.2 Q +(John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP %%Page: 6 6 %%BeginPageSetup BP %%EndPageSetup /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 -/Times-Bold@0 SF -.548(AU)72 84 S(THOR).548 E/F2 10/Times-Bold@0 SF -(Of\215ineIMAP)108 96 Q(,)-.92 E F0 .488 +(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E -1.1(Yo)108 84 S +2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei).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 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 (xcept where noted, w)-.15 F .488(as written by John)-.1 F -(Goerzen and cop)-.18 E -(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 124.8 Q +(Goerzen and cop)-.18 E +(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\ - 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 -(http://quux.or)108 153.6 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 -(\(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 +(http://quux.or)108 247.2 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E +(\215ineimap)-.25 E(Of)108 264 Q 2.529(\215ineIMAP may also be do)-.25 F +2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028 +(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 end %%EOF diff --git a/offlineimap/head/manual.txt b/offlineimap/head/manual.txt index 2a0a4de..3a60fcf 100644 --- a/offlineimap/head/manual.txt +++ b/offlineimap/head/manual.txt @@ -406,33 +406,47 @@ NOTES understand this, don't worry; you probably won't encounter 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 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 the message to offlineimap@complete.org. BUGS - Should be reported to the author at the address specified + Should be reported to the author at the address specified below. COPYRIGHT 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 - License as published by the Free Software Foundation; - either version 2 of the License, or (at your option) any + License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any 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 - warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR - PURPOSE. See the GNU General Public License for more + warranty of MERCHANTABILITY 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 + You should have received a copy of the GNU General Public License along with this program; if not, write to: Free Software Foundation, Inc. @@ -442,9 +456,9 @@ COPYRIGHT USA AUTHOR - OfflineIMAP, its libraries, documentation, and all - included files, except where noted, was written by John - Goerzen and copyright is held as + OfflineIMAP, its libraries, documentation, and all + included files, except where noted, was written by John + Goerzen and copyright is held as stated in the COPYRIGHT section. OfflineIMAP may be downloaded, and information found, from @@ -453,6 +467,13 @@ AUTHOR gopher://quux.org/1/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 mutt(1), python(1).