====================================
RSS and Atom Feeds Plugin for Eudora
        *** Version: 1.8 ***
------------------------------------
Copyright  2005 by Brana Bujenovic
        All Rights Reserved
====================================

About the Program
=================

RSS and Atom Feeds Plugin is a feed aggregator for Qualcomm Eudora.

* To manage subscriptions select "RSS and Atom Feeds" from the Tools menu.
* To download full/referring articles for individual messages select "Get Full Article" from the "Message Plugins" menu.
* To view the online article hold down 'Ctrl' key when selecting "Get Full Article".

Requirements
============

+ Eudora for Windows, version 4 or above.

+ Eudora-automation server
$ To enable Eudora-automation server, check Tools/Options/Automation/Automation enabled from this machine.

Setup
=====

Copy "feeds.dll" and "feeds.chm" into the "Plugins" subdirectory of Eudora program or data directory.

What's New?
===========

+ New Newsboard columns:
	Author - Article author.
	Published - Date and time article was originally published.
	Downloaded - Date and time when article was downloaded.
	Newsbox - Newsbox where article was downloaded.

+ Newsboard article-items now contain corresponding images.

# Newsboard articles are not automatically removed from the list when the article is opened. Instead, article is marked as Read.

+ Now it's possible to open the newsbox where the article is stored.

+ Newsboard-articles action: Select All.

+ Newsboard-articles action: Remove (from the board).

# Newsboard: Default Newsboard article action (triggered when the Enter is pressed) is now 'Open'. Press Ctrl+Enter to browse the article (with default Internet browser).

# Edit/Message Plug-ins: Default action for 'Get the Full Article' is now 'Open'. Press Ctrl+Enter to download (and paste) full article to the message body.

+ Newsboard/article pop-up menu.
$ To open the pop-up menu press right mouse button, or Shift+F10.

+ Newsboard toolbar.

# Newsboard now keeps sorting order from the previous session.

# Newsboard: Misc improvements.

# Updated About-box.

+ About-box hot-key: Shift+F1

History
=======

Version: 1.7
------------

### Updated HTML/XML parsing.

+ Updated support for RSS 2.0 feeds.

+ Updated support for Atom-type feeds (Atom 1.0).

### Tightened memory consumption.

+ Basic support for enclosures.

+ New article headers:
     Category - Additional article label (i.e. News, Music, Comics etc.).
     Website-Comments - Internet address with forum topic/comments on the article.
     Enclosed - Full URL of a media object attached to the article.
     Source - The RSS channel that the article came from.
All new headers are present only if the feed contains corresponding fields.

* Fixed a bug where article-author is replaced with overall feed-author (if different).

* Fixed a bug where article-title is replaced with overall feed-title (if different).

# Feeds plugin is now more tolerant towards different/exotic date formats (Atom feeds).

* Fixed a bug where Website header would contain no Internet address and the source feed in fact contains one.

+# More statusbar information.

+ Newsboard button.
Now it's possible to open Newsboard window from the main program interface.

# GUI slightly updated.

+ Updated Help file.

Version: 1.6
------------

+ News Board
$ News Board can be considered as extended Information-dialog. It displays new headlines, corresponding feeds and links for the web sites with full stories.
$ To browse the internet address with a full story just click on the item(s) from the News Board.
$ News Board can be particularly useful if there are several feeds that are checked periodically.

Version: 1.5
------------

### Periodic check background tasks moved to workers threads.

# Updated URLs.

Version: 1.4
------------

+ Article Viewer
$ In order to view on-line article, hold down Ctrl key when you hit "Get the Full Article" from the "Edit/Message Plugins" menu.
$ Article viewer provides few other options:
	1. Article
	1.1. Forward Inline
	1.2. Forward as Attachment
	1.3. Save as File
	2. View
	2.1. Full Article (Online) - Default
	2.2. Newsbox Article (Offline)
	2.3. Source
	3. File to Mailbox

+ Help File

* Aliases can now be longer then 16 characters.

Version: 1.3
------------

+ Custom mailbox per feed.
$ To assign the mailbox of your choice for particular feed, hit "Feed/Edit". Then, at the "Feed Properties" dialog hit "Newsbox" button and select the mailbox from the list. Hit 'Enter' (or double-click). To cancel the selection just hit the 'Esc' button.
$ If no default mailbox found, all corresponding articles will be downloaded to the In-box.

- Removed demo mode dialog for "Get Full Article".

+ Get Full Article - Text Portion Only (Experimental)
$ To download the full article without images and most of the HTML-formatting hold down the "Shift" key when selecting "Get Full Article" from the "Edit/Message Plugins" menu.

Version: 1.2
------------

+ Feed Properties: Check for new articles every 'X' minutes.
$ Now it's possible to set up the time interval for new-articles check. This can b done via Feed-Properties dialog. Once that's done, Feeds Aggregator will quietly download articles (in the background), while Eudora is running. All cached articles are stored at the "Feeds" folder of main data folder. Once user selects "RSS Feeds" from the Tools menu, all cashed articles will be imported into corresponding mailboxes (and cleared from the cache). This goes pretty fast since all the text was already downloaded, and downloading is the slowest part of the entire process.
$ This feature leads towards tremendous time and resources savings. Off course, articles will be downloaded if there is valid internet connection. If not, scheduled times will be rolled on for the first on-line opportunity.

# Misc improvements.

Version: 1.1
------------

+ 'Stop Download' option.

+ Main interface is now wider and taller.

+ Feeds Aggregator now contains some new graphics, check it out.
$ Well, 256 colors is sharp, zillion colors is a mess (especially when jamed into the 24x24 pix. picture). I somehow prefere 256 colors or so. Previous releases used mostly 16 colors (or less) per image!

# Faster xml parsing.

* Misc. bugixes

$ There are probably quite a few other changes in this release, but right now I can't remember any of them.

Version: 1.0
------------

+ Feed Properties: Download only new articles.
$ If this option checked, Feeds Aggregator will only download articles published after the latest downloaded article.
$ This allows us, among other things, to transfer old articles, we whish to keep, to another mailbox - Those old articles, although not present in the Feed-mailbox won't be downloaded again!

+ Downloaded articles now contain "Downloaded" header. This header contains date and time when particular article was downloaded, in RFC format.

+ Now it's possible to check several Feeds in one go.
$ To make a multiple selection:
[Disjoint]
a) Set focus on the Feeds-panel;
b) Hold down Ctrl key;
c) Browse with Up/Down arrows;
d) Make a selection with the Space key.
[Joint]
a) Set focus on the Feeds-panel;
b) Hold down Shift key;
c) Make a selection with Up/Down arrows;

- Removed now obsolete "Get New Articles for All Feeds" function(s).

+ Feed Properties dialog now displays (server-side assigned) title for particular feed.

* Fixed a bug that would cause incorrect report that there are no new articles, on frequent checks.

# Faster download speed.

### Tons of miscellaneous program improvements.

Version: 0.9
------------

+### Feeds Plugin now keeps track of what articles have been downloaded from the server. This enhancement leads toward 5-6 times faster download speed, if there are some articles in feed-corresponding mailboxes.

# Faster full-articles download speed (if "Download full/referring articles" checked).

* Fixed a bug that would cause incorrect report of "Automation Error", on machines where English is not a default language and/or international Eudora versions. (Ehm, people invented error numbers Brana, hello!)

+ Download Full Article [Per Message Base]
Now it's possible to download the full/referring article, per messages base. To do that just, open the particular message, make sure you are on-line, and select "Edit/Message Plugins/Get Full Article".
$ So now we can download the summaries, and then wile browsing summaries, select to download the full articles, when we show curiosity or interest :-)
$ This feature allows us to save some CPU time, working memory and hard disk space.

* Fixed a bug where "Download full/referring articles" was not considered on "Get New Articles for All Feeds" action.

* Closed some minor memory leaks that would occur when downloading new articles and "Download full/referring articles" option is checked.

+ Demo mode.
Demo mode limitations are:
a) "Get New Articles for All Feeds" feature is disabled.
b) Downloaded articles contain program add.
$ Note, registered users are entitled for the entire 1-series.

+ There are two numbers now near the newsboxes:
a) First is the number of unread messages.
b) Total number of messages.
So, the format is: [Number of unread messages]/[Total number of messages]

+ Newsbox icon now displays the red dot if there is at least one unread article in the mailbox.

+ Newsbox Menu (Newsbox: Right click or Shift + F10)
This menu contains to main item:
a) Open (selected mailbox)
b) Close (selected mailbox)

+ Newsboxes and feeds are now sorted in alphabetical order.

# Miscellaneous GUI improvements.

+ Added basic support for logging. Reserved for future versions.

Version: 0.8
------------

## Faster download speed.
* Resolved a problem where some valid feeds where dished as invalid because of the encoded URL-path.
+ Download full/referring articles
$ This option allows us to download full (blog) referred articles (if available).
$ Note: In some cases, full web article is the entire blog (so it consists of all the articles) (ex: MSN Spaces), and in most of the cases it's the article summery (ex: Yahoo, cnn, Washington Post, BBC, Reuters). Sometimes however the entire article is part of the blog (ex: Official Google Blog).
$ This feature is available per Feed-basis, and can be toggled on and off at the Feed-Properties dialog.
$ If this feature is turned on, overall download speed can be considerable slower, depending on the feed.
$ The feed icon now indicates whether this feature is turned on or off.
$ Here is one time-saver scenario: In case you are not reading all the articles from a feed, un-check "Download full/referring articles", and download all the summaries. Then, if you want to read the full text, delete particular message(s), check "Download full/referring articles", and hit "Download" again.
## Changed is the way how program settings are stored, and all information needs to be entered again.
# File "rss.lst" is no longer in use and can be safely deleted.
# File "rss.ini" is no longer in use and can be safely deleted.
# New program file-name is "feeds.dll".
$ You can safely delete "rss.dll".
+ Now it's possible to assign the same mailbox for two or more feeds.
+ Feed name (server assigned) is now added to the message headers (ex: Feed: CNN.com - World).
+# Feed Aliases
$ Now it's possible to set up several feeds with same 'server assigned' feed-name. In order to do that it's necessary to specify the unique alias for every feed. This is done via Feed Properties dialog.

Version: 0.7
------------

+ Get New Blog for All Feeds
$ Now it's possible to download all blogs at once. To start this action click "Tools Menu/Get New Blog for All Feeds".
## Miscellaneous improvements.

Version: 0.6
------------

### RSS Feeds Plugin now uses Eudora automation server for creating mailboxes.
$ Cons: Due to a certain old bug in COM-server, all mailboxes are stored at the root level (main data folder).
$ Pros: 
	Feed-mailbox window position, column widths and sorting order are now preserved (when new articles are downloaded);
	Feed-mailbox names are no longer limited to 8 characters;
	Mailbox file extension ("MBX") no longer appears in the mailbox name;
	New feed-mailboxes now appear on Eudora-mailbox panel right away;
	Message status in feed-mailboxes now preserved (when new articles are downloaded);
	etc.
+ Information dialog.
$ This dialog informs us about number of new blogs, invalid rss feeds, automation issues and other stuff.
+ There is new "Pending" mailbox at the root folder. This mailbox is used for maintenance jobs and should not be deleted.
# Status bar is now wider, so more information can fit there.
+ When Feed-mailbox (i.e. "Newsbox") is selected (on the left panel), corresponding Feed is automatically pre-selected (on the right panel).
(Press the Tab-key, or Alt+N, for full selection.)
+ When Feed item (i.e. "News & Blogs") is selected (on the right panel), corresponding Feed-mailbox (i.e. "Newsbox") is automatically pre-selected (on the left panel).
(Press the Tab-key, or Alt+B, for full selection.)
+ Now you can hear the sound notification if feed is not valid, during the check. (This will be optional in future versions, if any.)
# Download-button is bolded a little so it should be easily distinguished from Delete-button.

Version: 0.5
------------
+ Support for basic Atom feed type publications.
# Several minor graphical enhancements.

Version: 0.4
------------
+ Newsbox Panel.
$ Newsbox Panel let us overview and open (Eudora 4 and above) newsboxes for currently active/subscribed feeds.
Also, Newsbox Panel will let us open recently created newsboxes without having to restart Eudora. To open the newsbox, select the icon from the panel and hit "Enter" or left mouse button twice.
+ Status Bar.
+ Eudora toolbar/tools menu icon (Eudora 4 and above).

Version: 0.3
------------
+ Single newsbox per RSS feed.
$ Every RSS Feed is now tight to its corresponding newsbox. All RSS newsboxes are stored in "News and Blogs" mailfolder.
$ Use configuration dialog to specify friendly name for selected newsbox.
+ Saved blogs now contain "Message-Id" header, which is derived from the "guid" or "link" tags (if present), respectively.

Version: 0.2
------------
+ Support for Windows 95/98/ME/NT4.
* Feed Properties text box is no longer limited on 50 characters.

Version: 0.1
------------
This is an initial release. Please see "About the Program" section of this document for more information.

Price
=====

This program is shareware. The registration price for this program is US$ 12.

If you do register this program, this is what you will get for your money:
(a) A registration code and instructions on how to input this code to register your copy of RSS Feeds Aggregator for Eudora. This process will get rid of demo-mode restrictions.
(b) Free upgrades to all future versions of 1-series.
(c) Technical support, via e-mail.
(d) The eternal gratitude of the author.

Supporting shareware development will result in better programs.

Disclaimer of Warranty
======================

This software is provided on an "AS IS" and "AS AVAILABLE" basis without warranties of any kind, express, implied or statutory, including but not limited to, the implied warranties of title, noninfringement merchantability and fitness for a particular purpose. I do not warrant that the software will be - uninterrupted, timely, reliable, secure or error-free and expressly disclaim any warranties as to the files contained herewith.

Release Date
============

August 13th 2006
