FetchMail update from Steve Brewin
1) Documentation and Samples
- now include fetchmail_configuration_2_2.xml
- documentation_2_1.xml updated to include the above
- fetchpop_configuration_2_1.xml includes text indicating it is deprecated and fetchmail is prefered
- now has a sub-directory 'samples' that has a sub-directory 'fetchmail' containing the samples described in the xdocs
2) Added features. - When the intended recipient cannot be determined by an Account processing can optionally be deferred to the next pass, giving other Accounts within the fetch task the oppurtunity to resolve the recipient.
3) Improved features. - DynamicAccounts are now preserved between passes, enabling communication of state and variables such as the List of deferred messages required by the defer processing described above.
4) Sundry refactorings and tidying up. The major refactoring is that Account objects replace ParsedConfiguration as primary source of the context for fetchmail delegate classes.
5) Within the docs and config have highlighted the fact that the POP3 protocol does not mandate the SEEN flag, therefore the markSeen attribute may not stick when fetching from a POP3 server. Have also refactored the code to include handler methods for when JavaMail considers the server to have a non-permanent SEEN flag. The default handlers behave as normal when a non-permanent flag is tested and log warnings when a non-permanent flag is set, subclasses may choose to extend this behaviour, maybe to add SEEN support when the server doesn't have it?
Committed 9/21-22/2003 by Noel, included in 2.2.0a11.