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

  Weather Docklet v0.5.1 for Y'z Dock v0.8.0+
  by Haitham Al-Beik                                  Friday, July 23rd, 2004
  www.dockex.com
  
  Weather.com
  Copyright © 1995-2004, The Weather Channel Interactive, Inc.
  Your use of this site constitutes your acceptance of the 
  LEGAL RESTRICTIONS AND TERMS OF USE.
  http://www.weather.com/common/home/legal.html

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

Revision History
----------------
 v0.5.1 (07-23-2004)
  + Force docklet to avoid reading from Cache
  + Added a quick update to the contextual menu (or via middle mouse click)

 v0.5 (01-18-2004)
  + ReWrote code to use Weather.com's XML Data Feed
  + Stardock's Weather Icons are now used

 v0.42 (07-02-2003)
  + Docklet DLL is now much smaller, only 124Kb!
  + Fixed Autoupdate
  + Fixed Temperature Conversion (C/F) Issue
  + Small bug fixes for speed and effeciency 

 v0.4 (06-20-2003)
  + Code redesign (faster, smaller, all sites in one docklet & uses less memory)
  + Dialog Box now containes the CustomURL (no need to restart docklet)
  + Shadow enhanced to look more like Y'z Dock's shadow (see xFeatures below)
    * Enable/Disable Shadow
    * Set Shadow Alpha Color
    * Set Shadow Distance
  + Added an Edge Color to the text (see xFeatures below)
    * Enable/Disable Edge
    * Set Edge Alpha Color
    * Set Edge Size
  + Ability to disable/enable the temperature to be viewed on the icon
  + the label is now (and only) shown by format (see xFeatures below)
    (e.g. "$l is $c ($t)" = "Shrewsbury, MA is Fair (23°)"
  + Auto-Update bug fixed
  + Internet Connection Check Added -- limited testing
    If your not connected, it'll show the NA icon and 
    the label will indicate a "No Internet Connection".
  + Proxy: The docklet should use the preconfigured proxy settings on your
    computer (if any) -- no testing, though
 
 v0.3i (06-18-2003)
  + Added International Support
  + Added different international sites to the popup menu
  + Added dynamic parsing code for multiple site support

 v0.3 (06-18-2003)
   +  Now supports the full 47 weather conditions - 100% Accuracy
   +  Included two icon sets (thanks Craig Butler & Marlon)
   +  Disable Polling by setting POLLING_PERIOD_MINUTES to 0
   +  Added CUSTOM_URL so users can use a specific page from weather.com (US)
   +  Added PROXY for proxy server settings
   +  Added PATH under ICONS so users can select a custom icon set
   +  Added FORMAT under LABEL (see xFeatures below for configuration)
   +  Added shadow behind the icon text
   +  Added ALPHA under TEXT for transparency (0-255); affects shadow as well
   +  Added TEMP_SHOW_UNIT to enable/disable the unit displayed (1/0)
   +  Added a BROWSER section for browser configuration to visit weather.com

 v0.2 (06-08-2003)
   +  Added a pop-up menu for better interface
   +  Added Metric Units for Tempreture (C)
   +  Added Label options to show/hide current Location, Zip and/or Condition
   +  Added an "Update Now!" to the pop-up menu
   +  Left Clicking the Docklet will load weather.com for more information
      or selecting "Visit Weather.com..." from the menu
   +  Added more icon integration (and more icon usability)
   +  Added INI file for more features (See below)
   
 v0.1 (06-02-2003)
   o  First Release


ReadMe First
------------
After loading the docklet, right click and select "Update Now!" from the popup
menu. From the menu you can update the Location by selecting the "Weather for".
Any changes you make from the menu will automatically update the INI file.

All the data is fed from weather.com's XML data feed.

Warning: This program is still beta and it is buggy! Use it for testing purposes
only. 

Installation
------------
  1. Exract the archive file inside your Yz Docklets folder 

  2. Right click the dock and select "Add Doclet..." 

  3. Highlight "Weather" and click on "Add to Dock" 


xFeatures (INI file)
--------------------
You can manually change settings by editing the weather.ini file manually.
Here is the content of the weather.ini:

   [DATA]
   LOCATION=01545                Current Weather Location to Show
   UNITS=1                       1/0 - Uses Metric/English Units or °F/°C

   [ICONS]
   PATH=icons\                   The folder in which the 47 icons are stored

   [LABEL]
   FORMAT=$[location]; $[condition] ($[temp])
				 Label Text Format
                                 $[condition] ->  Show Condition
                                 $[location]  ->  Show Location
                                 $[zip]       ->  Show Zip/Postal Code (if any)
                                 $[temp]      ->  Show Temperature

   [TEXT]
   FONT=Arial Black              Temperature Font to use
   SIZE=40                       Size of the Font to use
   COLOR_R=0                     Red subColor of the Font
   COLOR_G=0                     Green subColor of the Font
   COLOR_B=0                     Blue subColor of the Font
   COLOR_A=255                   Set the alpha-transparency value of the text
                                 Ranges from 0 to 255, 0 = fully transparent
   ALIGN_HORZ=1                  0/1/2 - Sets the Text Horizontal Alignment
                                         Near/Center/Far
   ALIGN_VERT=2                  0/1/2 - Sets the Text Vertical Alignment
                                         Near/Center/Far
                                         
   ALIGN_CSTM=0                  0/1 - Enable Custom Positioning of the Text
    ************************************************************************
     Please Note: If ALIGN_CSTM is set to 1, then ALIGN_HORZ and ALIGN_VERT
                  settings will be ignored.
    ************************************************************************
   ALIGN_CSTM_X=0                The Custom X position of the Text
   ALIGN_CSTM_Y=0                The Custom Y position of the Text
   
   TEMP_SYMBOL=°                 The Temperature Symbol to use. 
                                 Make sure it only ONE (1) character
   TEMP_SHOW=0                   0/1 - Disable/Enable the display of Temp.
   TEMP_SHOW_UNIT=0              0/1 - Disable/Enable the display of C or F
   
   SHADOW_SHOW=0                 0/1 - Disable/Enable Shadow
   SHADOW_COLOR_A=128            Set the alpha-transparency value of shadow
   SHADOW_DISTANCE=3             Set the shadow distance 
                                 (bottom-right from the text)
   EDGE_SHOW=1                   0/1 - Disable/Enable Edge on Text
   EDGE_COLOR_A=255              Set the alpha-transparency value of edge
   EDGE_SIZE=3                   Size of Edge

   [BROWSER]
   FILE=mozilla.exe              Sets the executable filename of the browser
                                 to be used when visiting www.weather.com
   PATH=                         The path that contains the executable
                                 (In most cases, this is not needed)

Terms of Use
------------
You can reproduce, change and distribute any files in this site, without 
permission as long as this file is included unchanged. 
No liability for the contents of any of the files can be accepted. Use the 
concepts, examples and other content at your own risk. Additionally, this is a 
beta version, possibly with many inaccuracies or errors. And please take into 
consideration that there may be specification change in the future. 

By downloading this docklet you agree to be bound to the terms of use described
at http://www.dockex.com/?pageId=disclaimer.

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

  http://www.dockex.com/
  Copyright © 2004 Haitham Al-Beik

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