]> code.delx.au - offlineimap/commitdiff
/offlineimap/head: changeset 140
authorjgoerzen <jgoerzen>
Thu, 18 Jul 2002 01:12:42 +0000 (02:12 +0100)
committerjgoerzen <jgoerzen>
Thu, 18 Jul 2002 01:12:42 +0000 (02:12 +0100)
Forgot to update the docs. This should have gone into 3.0.2. Ooops.

offlineimap/head/manual.html
offlineimap/head/manual.pdf
offlineimap/head/manual.ps
offlineimap/head/manual.txt

index fef44128522de2873f9e990c72450ed39c3a91b6..4b361435299e0c74793056cf973832cae15c9e13 100644 (file)
@@ -25,7 +25,7 @@
 
 <hr>
 <!-- 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>
 <h2>NAME</h2>
 <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
 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"
        cols="2" cellspacing="0" cellpadding="0">
 <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%">
 gopher://quux.org/1/devel/offlineimap<br>
 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>
 <h2>SEE ALSO</h2>
 
index 98aaa6e9a6bc2cc436e5a8cdea6d1472909b771f..c07a84585e9f7c33e213ec88b5bdd941505a1abd 100644 (file)
Binary files a/offlineimap/head/manual.pdf and b/offlineimap/head/manual.pdf differ
index 80422d6455d608ec8f722a6619783a207fe240eb..79a127e14a4e042201831cb0c16be660a066f1d0 100644 (file)
@@ -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 <jgoerzen@complete.or)108 108 Q(g> and cop)-.18 E
-(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 124.8 Q
+(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 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
index 2a0a4de1ad2d9cb9637b017a27aeba9b9943190f..3a60fcfbf8955bc484c1973b5a9cf93826ec5a03 100644 (file)
@@ -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  <jgoerzen@complete.org>  and copyright is held as
+       OfflineIMAP,  its  libraries,   documentation,   and   all
+       included  files,  except  where noted, was written by John
+       Goerzen <jgoerzen@complete.org> 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).