Initial import from kshowmail 3.3.1 sources

1 files changed, 101 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..cb6edd3
--- /dev/null
+++ b/README
@@ -0,0 +1,101 @@
+This program is written by Eggert Ehmke, eggert.ehmke@berlin.de.
+It is distributed under the GNU public license. See COPYING for details.
+It is based on the command line tool showmail written by Manfred Haertel,
+Manfred.Haertel@rz-online.de.
+
+Kshowmail is a KDE tool to watch mails on a POP3 server.
+Headers and complete mails can be viewed without loading them to the
+local mail client. Unpleasant mail can be deleted from the server.
+The list of displayed mails can be refreshed via configurable timers.
+Filters can be assigned to mark known spam for deletion.
+Multiple accounts are supported.
+A sound can be played if new mail arrives.
+A command menu allows user configurable commands like fetchmail or sendmail.
+A special command can be defined to send complain mail against spam.
+
+The modifications I provided are mainly Qt/KDE stuff to generate a nice
+GUI interface. I am using the great development tool kDevelop V2.1.
+
+If you find the tool useful, tell me about it. If you find any bugs or
+want some additional features, just give me a hint. As time allows,
+I will try to fix them. If you like to translate the language files,
+I would be very happy.
+
+With version 0.5 the passwords are stored as scrambled text in the kshowmailrc file.
+This is no absolute protection, but at least the password cannot be read as
+clear text anymore. If you have old rc files with stored passwords, you must reeenter
+them.
+
+With version 2.2.0 large parts of the configuration are stored in the kshowmail.xml file,
+together with already loaded headers. The improves the speed of refresh a lot, as only
+new headers are loaded again. However, this concept is again imcompatible with the old
+rc file. You have to create your accounts again.
+
+Installation: see the INSTALL file and check the following:
+make sure the environment variables KDEDIR, QTDIR and PATH contain the correct values.
+For SuSE these are:
+KDEDIR=/opt/kde3
+QTDIR=/usr/lib/qt3
+PATH=$KDEDIR/bin:$QTDIR/bin:...
+If not already installed, you need the kde network include files. Get the
+kdenetwork-devel and kdepim-devel rpm packages or the source files.
+
+Known bugs:
+The connection to the pop3 server fails, if there is a null password.
+Sound gets interrupted sometimes.
+
+Fixed bugs:
+the messages are sorted in a wrong sequence;              fixed in 0.2
+the optiondelete.xpm file is not installed via tgz;       fixed in 0.2
+some messages are not translated into other languages;    fixed in 0.3
+segfaults when working on empty config list;              fixed in 0.3
+on some servers the service is called pop-3.              fixed in 0.4 by connect via port 110
+the status line is only updated after transfer.           fixed in 0.5 by changed event handling
+during dialogs or message boxes conflicting timers        fixed in 0.5
+password scrambling algorithm problem                     fixed in 0.5.1
+Endless loop if long messages are displayed               fixed in 0.5.2
+kshowmail locks if several messages are shown in sequence fixed in 0.5.2
+Sometimes the toolbar/statusbar get lost                  fixed in 2.2.0
+If the number of UIDL's in the cache exceedes 200,        fixed in 2.2.0; no uidl cache anymore
+old mail may be shown as new, if still on the server.                     we use xml file now
+the uidl0 is not found in the cache, even if it exists
+If the first account has no new messages, and the
+second account can't get connection,
+the list is not refreshed.																fixed in 2.2.1
+Crash when KDE shutdown                                   fixed in 2.2.2
+The sorting of messages by other columns (size)
+does not work. (535377)                                   fixed in 3.0.0
+The sorting by message numbers does not work correctly    fixed in 3.0.1
+in case of multiple accounts
+The AlertDialog::signalOk does not work.  (514243)        fixed in 3.0.1, was KDE2 bug
+Crash if all messages of last account are deleted         fixed in 3.0.1, never seen again
+Missing header fields if transfer interrupted (542602)    fixed in 3.0.1
+Crash when disabling account (559122)                     fixed in 3.0.1
+Wrong account activated if sorted backward (562903)       fixed in 3.0.2
+
+Acknowledgements:
+Since I started the kshowmail development, I received lots of feedback and constructive
+critics from all over the world. I appreciate this very much and want to say "thank you"
+to all of you. In particular:
+
+Manfred Haertel <Manfred.Haertel@rz-online.de> who wrote the original command line version.
+Espen Sand <espen.sand@neo.no>                 who provided the timers and some keyboard shortcuts.
+Nicolas Vignal <nicolas.vignal@fnac.net>       who provided RPM's for RedHat,
+                                                 and the french translation.
+Serge Parmentier <gerapa@skynet.be>�           who updated the french translation
+Edgardo Garc�a <edyx@mindless.com>             who provided the spanish translation
+Stephan Giesler <giesler@gmx.net>              who updated the spanish translation and
+                                                 did some testing.
+Mattias Newzella <newzella@swipnet.se>         who provided the swedish translation
+Aharon Schkolnik <aharon@health.gov.il>,       who did a lot of testing and created a lot of
+Matthias Doell <mail@MatthiasDoell.de>,          ideas that are now part of kshowmail.
+Thomas Watz <twatz@gmx.de>
+Maic Szotek <webmaster@dragontower.de>         who provided the nice new icons for the
+                                               3.x.x version.
+Gustavo Zamorano S. <gzsuniq@cableonda.net>    who suggested the "Reply" feature and tested
+                                               some scripts.
+Sandor Laza <slaza@xs4all.nl>                  who provided the hungarian translation.
+Gabriele Postorino <g.posto@tin.it>            who provided the italian translation.
+Robert Kratky <kratky@rob.cz>                  who provided the czech translation.
+
+Have a lot of fun! ;-)