--------------------------------------------------------------------------------

  RSS Reader Docklet v0.1 for Object Dock v1.99a+
  by Fedro Ponce de Leon                           Tuesday, February 10th, 2009
  www.feterspace.com.mx
  
--------------------------------------------------------------------------------

Table of Contents
-----------------
      
    * Revision History
    * Description
    * Requirements 
    * Installation 
    * Cofiguration
    * Uninstallation 
    * Terms of Use
    * Contact


Revision History
----------------
    +  First Release

Description
------------
This docklet will let you configure and display feeds from RSS and/or Atom 
feeds. You may configure muliple feeds and let the docklet check them regularly 
to stay tunned to the latest developments of your favourite feeds.

The docklet would let you display the feed contents or an specific feed item 
through its integrated Feed reader (based on Internet Explorer ActiveX control) 
or to show them using your default web browser or whatever application you 
choose to setup (which will be run by sending the feeds URL as a parameter to it).

Warning: This program is still beta and it is buggy! Use it for testing purposes
only. It should work both under Windows Vista & Windows XP SP2+. 


Installation
------------
  1. Exract the ZIP file inside your Object Dock 'Docklets' folder.
  2. Right click the dock and select "Add" then add an "RSS Reader Docklet".
  

Configuration
-------------
   
  It is possible to setup multiple RSS/Atom Feeds to be monitored. To access the 
  Docklet Configuration dialog, right click the Docklet's icon and select the  
  "RSS Reader Docklet Settings..." menu item, the configuration Dialog for the 
  docklet should appear. From here you can set the following options:
  
  - General Tab : Used to configure the docklet icon & label settings and the 
                  way feeds will be shown.
		+ Label - Docklet label
		+ Docklet Info - What information will be displayed at docklet icon, 
										 possible options are show docklet label (first setting), 
										 Show profile title (title of the selected feed), Show RSS 
										 feed item title (title of the currently selected feed item)
										 Show RSS feed item link (URL to the currentrly selected 
										 feed item). You may hide the info althogether by checking 
										 "Do not show any docklet info".
		+ Docklet Label - What information will be displayed at docklet label, 
										  possible options are show docklet label (first setting), 
										  Show profile title (title of the selected feed), Show RSS 
										  feed item title (title of the currently selected feed item)
										  Show RSS feed item link (URL to the currentrly selected 
										  feed item). You may prevent the label from showing by 
										  checking "Hide label".
		+ When RSS Feed item is selected: Sets where the feed item will be displayed.
		                                  - Open RSS feed window: displays the item 
		                                    using the integrated feed reader. Check
		                                    "Save windows position & size" to 
		                                    preserve the window position and size 
		                                    after closing the reader, so subsecuent 
		                                    items will be shown using the previously 
		                                    saved window position and size. Leave it 
		                                    unchecked to open the reader window 
		                                    centered in your screen using default 
		                                    size.
		                                  - Open default web browser: display the 
		                                    feed item using your currently configured
		                                    default web browser.
		                                  - Open application: display the feed item
		                                    using the selected application, use the 
		                                    browse button (...) to locate the 
		                                    application executable. Note: Normally 
		                                    this would be an Internet Browser 
		                                    (FireFox, Safari, Chrome, Internet
		                                    Explorer) when the browser you want to use 
		                                    to display feeds is not your default 
		                                    browser, nevertheless this could be any 
		                                    application that would accept the feed's 
		                                    URL as a parameter during launch.
	
	- Icons & Images : Used to configure the default docklet icon & menu icon.
		+ Background icon - Browse/Reset the Docklet icon.
		+ Strip menu icon - Browse/Reset the menu icon, used to list the available 
												strips in the context pop-up menu.
	
	- Docklet Font : Configuration settings for the font used for docklet 
	                 information display. Options incluide font face, size, 
	                 Font/Background color & transparency levels. By default the 
	                 text is shown with a framed background and rounded corners, 
	                 Background settings would let you customize it to suit your 
	                 preferences.
	               
	- RSS Feed Profiles: Let you configure multiple RSS Feed profiles that will be 
	                     available to the docklet. Each configured profile may 
	                     contain the following parameters:
	                     - RSS Feed: URL of the RSS/Atom Feed
	                     - RSS Feed title: Feed title shown by the docklet. Could 
	                                       be left blanck while initially 
	                                       configuring a feed, it will be filled
	                                       with the title in the feed.
	                     - Icons: You may configure an docklet & menu icon for
	                              each profile. By default it will inherit the
	                              currently configured docklet icons.
	                     - Check: After capturing the feed's URL use Check to 
	                              verify the feed is accesible.

Uninstallation
--------------
   Remove all instances from all docks windows and then delete the RSSReader
   folder form docklets folder.


Terms of Use
------------
This software may be used free of charge and may be freely re-distributed in its
original form or in a modified form provided it is offered free of charge. It is 
offered as-is and the user accepts all responsibility for consequences arising 
from it's use. I accept no liability for consequences arising from the use of 
this software.


Contact
-------
Comments/Suggestions/Problems, Please email me at fedroponce@feterspace.com.mx

-------------------------------------------------------------------------------

  http://www.feterspace.com.mx/
  Copyright  2008 Fedro Ponce de Leon <fedroponce@feterspace.com.mx> 

-------------------------------------------------------------------------------