This shows you the differences between two versions of the page.
Last revisionBoth sides next revision | |||
releasenotes:0.22.0 [2007/01/23 11:24] – texasfett | releasenotes:0.22.0 [2007/01/23 20:11] – texasfett | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== 0.22.0 (September 8, 2004) ====== | ====== 0.22.0 (September 8, 2004) ====== | ||
- | + | < | |
- | < | + | Welcome to POPFile v0.22.0 |
- | < | + | This version consists of a major update to v0.21.0 with many improvements |
- | and bug fixes:</ | + | and bug fixes: |
- | < | + | 1. History in database |
- | < | + | We've finally done away with the old method of keeping the message history |
- | in a single directory full of files (which was frankly flaky and hard to | + | in a single directory full of files (which was frankly flaky and hard to |
- | maintain). | + | |
- | per directory. | + | per directory. |
- | the other information that POPFile uses.</ | + | the other information that POPFile uses. |
- | < | + | This change brings two benefits: firstly it's a lot faster than previous |
- | versions because we can rely on the SQL database to do searching and sorting | + | |
- | for us; secondly, it brings extra flexibility and we now have additional | + | for us; secondly, it brings extra flexibility and we now have additional |
- | columns available in the history (we now have two time values (the date/time | + | |
- | the message was received by POPFile and the date/time in the message header), | + | the message was received by POPFile and the date/time in the message header), |
- | the From, To, Cc and Subject headers and message size).</ | + | the From, To, Cc and Subject headers and message size). |
- | < | + | 2. Switch UI to HTML templates |
- | < | + | Back in the mists of POPFile time I grafted an HTML interface onto my little |
- | Perl script and POPFile was born. Unfortunately that HTML interface had | + | Perl script and POPFile was born. Unfortunately that HTML interface had |
- | grown into thousands of lines of ugly Perl and HTML interwined. | + | grown into thousands of lines of ugly Perl and HTML interwined. |
- | completely separates out the HTML from the Perl.</ | + | |
- | < | + | More details are here: |
- | < | + | http:// |
- | < | + | This has a number of advantages: firstly, POPFile' |
- | because it's simpler; secondly, skinning POPFile can now take advantage of the | + | |
- | full power of HTML and not just a limited set of classes and lastly it's made | + | full power of HTML and not just a limited set of classes and lastly it's made |
- | it easy to expand the UI, which brings us to...</ | + | it easy to expand the UI, which brings us to... |
- | < | + | 3. UI improvements |
- | < | + | The History page is redesigned to be cleaner and support multiple, configurable |
- | columns (From, To, Cc, Arrived Date, Message Date, Subject, etc.). | + | |
- | options have been expanded. | + | |
- | and the line break showing when different download sessions occurred.</ | + | and the line break showing when different download sessions occurred. |
- | < | + | Many people will notice that the ' |
- | is because we've added an ' | + | is because we've added an ' |
- | or filter. | + | or filter. |
- | on unmagnetized messages select magnetized and Invert.</ | + | on unmagnetized messages select magnetized and Invert. |
- | < | + | Buckets page has been simplified to make it clearer. |
- | graph has been removed and unclassified messages are now correctly counted | + | graph has been removed and unclassified messages are now correctly counted |
- | in total messages and total errors. | + | in total messages and total errors. |
- | a simple drop down.</ | + | a simple drop down. |
- | < | + | The Advanced page now shows which parameters have been changed from the |
- | default. | + | |
- | < | + | Many of the skins had minor improvements. |
- | < | + | The first, ' |
- | < | + | As part of the UI improvement a new skin called ' |
- | that demonstrates how the UI for POPFile can be changed dramatically with | + | that demonstrates how the UI for POPFile can be changed dramatically with |
- | the new skinning scheme using only a few files.</ | + | the new skinning scheme using only a few files. |
- | < | + | 4. Anti-spam improvements |
- | < | + | The mail parsing engine has been updated to deal with the latest spammer |
- | trickery: notably the Flex Hex trick which you can read about in The | + | |
- | Spammers' | + | |
- | < | + | 5. Support for SMTP and NNTP |
- | < | + | For a long time we've had experimental support for two new protocols: |
- | SMTP (often used for incoming email) and NNTP (most commonly used for | + | SMTP (often used for incoming email) and NNTP (most commonly used for |
- | Usenet-style news). | + | |
- | with POPFile. | + | with POPFile. |
- | but can be enabled on the Advanced page.</ | + | but can be enabled on the Advanced page. |
- | < | + | The SMTP module is designed to act as a front-end for a real SMTP server |
- | accepting messages and proxying them into a single SMTP server after | + | |
- | performing classification. | + | |
- | News client and News server performing classification on articles.</ | + | News client and News server performing classification on articles. |
- | < | + | 6. Experimental support for IMAP |
- | < | + | The new experimental IMAP module is not included in the default distribution. |
- | You can find the documentation and a download link here:</ | + | You can find the documentation and a download link here: |
- | < | + | http:// |
- | < | + | The IMAP module is not a proxy, but acts as a service which will regularily |
- | check an IMAP server for new messages, classifies them and then moves them into | + | check an IMAP server for new messages, classifies them and then moves them into |
- | IMAP folders that correspond to your buckets. | + | IMAP folders that correspond to your buckets. |
- | outside the POPFile user interface simply by moving messages between folders | + | |
- | on the IMAP server.</ | + | on the IMAP server. |
- | < | + | IMAP module users should watch out about upsetting their ISP if they have a |
- | very large number of buckets. | + | very large number of buckets. |
- | each folder you monitor. | + | each folder you monitor. |
- | a user with an extrememly large number of buckets.</ | + | a user with an extrememly large number of buckets. |
- | < | + | 7. XML-RPC interface |
- | < | + | For some time we've had an experimental external interface to POPFile through |
- | XML-RPC. | + | |
- | it is disabled by default. | + | it is disabled by default. |
- | many different programming languages can communicate with POPFile to use its | + | many different programming languages can communicate with POPFile to use its |
- | services.</ | + | |
- | < | + | Full details of the API can be found here: |
- | < | + | http:// |
- | < | + | 8. Support for APOP, SSL and SOCKS |
- | < | + | The POP3 proxy has new support for the APOP authentication method. |
- | APOP authentication you change the POP3 server string in your email client | + | APOP authentication you change the POP3 server string in your email client |
- | from ' | + | from ' |
- | < | + | SSL support is added for all proxies. |
- | connections to servers. | + | |
- | client from ' | + | |
- | accept SSL connections, | + | |
- | < | + | SOCKS proxying is added to all proxies. |
- | to use go to the Configuration tab and set it for the appropriate proxy. | + | to use go to the Configuration tab and set it for the appropriate proxy. |
- | Outbound proxy connections will go via the SOCKS server specified.</ | + | |
- | < | + | The Windows installer DOES NOT include the components necessary for SSL |
- | support. | + | |
- | SSL components as follows:</ | + | SSL components as follows: |
- | < | + | IO:: |
- | Net:: | + | |
- | < | + | < |
- | < | + | 9. Transparent POP3 Proxying |
- | < | + | v0.22.0 includes support for transparent proxying of POP3 connections where |
- | the destination POP3 server is configured in POPFile and the mail client | + | the destination POP3 server is configured in POPFile and the mail client |
- | talks to POPFile without using the special host:user syntax for the hostname.</ | + | talks to POPFile without using the special host:user syntax for the hostname. |
- | < | + | This is most useful in a small office environment with a dedicated POP3 |
- | server where POPFile can act as a front end for the real POP3 server and | + | |
- | by installing it on the same machine as the POP3 server there' | + | by installing it on the same machine as the POP3 server there' |
- | change mail client settings. | + | |
- | real POP3 server on POPFile' | + | real POP3 server on POPFile' |
- | < | + | ESSENTIAL READING IF YOU ARE UPGRADING TO v0.22.0 |
- | < | + | 1. BACK UP YOUR OLD INSTALLATION: |
- | the entire POPFile directory somewhere. You can then safely install | + | the entire POPFile directory somewhere. You can then safely install |
- | POPFile v0.22.0 on top of your current installation; | + | |
- | is a sensible precaution.</ | + | is a sensible precaution. |
- | < | + | On Windows you may want to check out Brian' |
- | < | + | http:// |
- | < | + | 2. ON WINDOWS POPFILE IS AN EXE. Windows users will now be able to see |
- | POPFile running in the Task Manager with an executable called popfileXX.exe | + | |
- | where the XX is one of f, if, b, ib depending on configuration. POPFile | + | where the XX is one of f, if, b, ib depending on configuration. POPFile |
- | is started by running popfile.exe which chooses the appropriate popfileXX.exe</ | + | is started by running popfile.exe which chooses the appropriate popfileXX.exe |
- | < | + | This might cause your firewall to ask about giving popfileXX.exe permissions, |
- | in addition if you had allowed Perl permissions in your firewall they are | + | in addition if you had allowed Perl permissions in your firewall they are |
- | NO LONGER needed.</ | + | NO LONGER needed. |
- | < | + | KNOWN WINDOWS ISSUES |
- | < | + | 1. THE TRAYICON ON WINDOWS CAN CAUSE POPFILE TO FREEZE. |
- | if you attempt to view the trayicon' | + | if you attempt to view the trayicon' |
- | while checking or downloading mail POPFile may freeze. The exact cause is | + | while checking or downloading mail POPFile may freeze. The exact cause is |
- | still unknown but it may be related to some video drivers. If this problem | + | still unknown but it may be related to some video drivers. If this problem |
- | affects you turn off the trayicon. A solution is being looked into.</ | + | |
- | < | + | 2. ON WINDOWS I WANT TO CHECK MULTIPLE EMAIL ACCOUNTS SIMULTANEOUSLY. |
- | Because the time taken to start a new process on Windows is long under Perl | + | |
- | there is an optimization for Windows that is present by default: when a new | + | there is an optimization for Windows that is present by default: when a new |
- | connection is made between your email program and POPFile, POPFile handles it | + | |
- | in the ' | + | in the ' |
- | starts downloading very quickly, but is means that you can only downloaded | + | |
- | messages from one server at a time (up to 6 other connections will be queued | + | |
- | up and dealt with in the order they arrive) and the UI is unavaiable while | + | up and dealt with in the order they arrive) and the UI is unavaiable while |
- | downloading email.</ | + | |
- | < | + | You can turn this behavior off (and get simultaneous UI/email access and as |
- | many email connections as you like) by going to the Configuration panel in | + | many email connections as you like) by going to the Configuration panel in |
- | the UI and making sure that "Allow concurrent POP3 connections:" | + | the UI and making sure that "Allow concurrent POP3 connections:" |
- | Yes, or by specifying --set pop3_force_fork=1 on the command line.</ | + | Yes, or by specifying --set pop3_force_fork=1 on the command line. |
- | < | + | I AM USING THE CROSS PLATFORM VERSION |
- | < | + | POPFile requires a number of Perl modules that are available from CPAN. New |
- | in v0.22.0 are the need for the following:</ | + | in v0.22.0 are the need for the following: |
- | < | + | Date:: |
- | HTML:: | + | |
- | HTML:: | + | |
- | DBD:: | + | |
- | DBI | + | DBI |
- | Date::< | + | |
- | < | + | Please refer to the detailed installation instructions on the POPFile wiki |
- | < | + | http:// |
- | < | + | I AM USING THE CROSS PLATFORM VERSION AND WANT TO USE SQLITE 3 |
- | < | + | Since there is currently a great deal of change in SQLite and the Perl |
- | modules that interface with SQLite please read the following page for | + | |
- | a full explanation: | + | a full explanation: |
- | < | + | http:// |
- | < | + | (Thanks helphand for the detailed explanation of the issues.) |
- | < | + | DOWNLOADING |
- | < | + | You can obtain the latest releases of POPFile by visiting |
- | < | + | http:// |
- | < | + | UPGRADING |
- | < | + | Just install POPFile on top of the currently installed version. But did you |
- | read the ESSENTIAL READING above first.</ | + | read the ESSENTIAL READING above first. |
- | < | + | DONATIONS |
- | < | + | Thank you to everyone who has clicked the Donate! button and donated their |
- | hard earned cash to me in support of POPFile. Thank you also to the people | + | hard earned cash to me in support of POPFile. Thank you also to the people |
- | who have contributed patches, feature requests, bug reports and translations.</ | + | who have contributed patches, feature requests, bug reports and translations. |
- | < | + | http:// |
- | < | + | PRAISE |
- | < | + | This release sees an enormous improvement in the Windows installer which |
- | is the exclusive playground of Brian Smith. | + | is the exclusive playground of Brian Smith. |
- | make the Windows installer robust, clear and easy. Nice work, Brian!</ | + | make the Windows installer robust, clear and easy. Nice work, Brian! |
- | < | + | A new POPFile developer is Manni Heumann who has made a number of contributions |
- | to the release and wiki, the most significant of which is the implementation of | + | to the release and wiki, the most significant of which is the implementation of |
- | the experimental IMAP module.</ | + | the experimental IMAP module. |
- | < | + | Another new developer, Joseph Connors, has been very active in the HTML |
- | skinning of POPFile and has made major contributions to the POPFile | + | |
- | documentation on the Wiki.</ | + | |
- | < | + | Amatubu is always working to translate and expand the Wiki into Japanese and |
- | Yasuo Honda is spent a great deal of time reviewing the Japanese Wiki | + | Yasuo Honda is spent a great deal of time reviewing the Japanese Wiki |
- | pages.</ | + | |
- | < | + | CONCLUSION |
- | < | + | Keep the ideas and bug reports coming. If you are interested in knowing |
- | more about what's planned for future POPFile versions (or just learning | + | more about what's planned for future POPFile versions (or just learning |
- | about POPFile' | + | about POPFile' |
- | < | + | http:// |
- | < | + | John. |
+ | </ |
Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.