==================================================================
Snippet-title:		hovertext v1.0
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		30 June 2005   Vienna Austria
==================================================================

Content of zipped file:
-----------------------
snippet_hovertext.php
readme_hovertext.txt (this file)

Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[hovertext]] tag in any post which you make, or any or of your template files (e.g frontpage_template.html).
3) rebuild the FrontPage(s).
   
Description:
------------
* Outputs a CSS Class and the HMTL required to show a 'tooltip' when the cursor
* hovers over the specified text. This tag is generally meant to be used in
* individual posrs (entries), but there is no reason why you should not use it
* elsewhere, e,g: on your frontPage)
*
* For instance, if the cursor hovers over the word Pivot, a pop up box with the
* explanation "quite simply the world's best blogging system" can be achieved
* by putting this in your entry
* [[hovertext:Pivot:quite simply the world's best blogging system]]
*
* Visit http://www.keellings.com/blog/_demos/hovertext.php to see it
* in action
 

Parameters:
-----------
*
* @param	string	   text        - the text which the hoverText will explain
*                                        If blank, the snippet does nothing.
* @param	string	   hoverText   - explanation of the text parameter, which
*                                        appears as a pop-up when the cursor
*                                        hovers over the text.
*                                        If blank, the snippet does nothing.
* @param	int	   useCssClass - if 0 (default), the appearance of the 
*                                        generated link is governed by the following
*                                        parameters.
*                                        if 1, the following parameters are ignored
*                                        and the appearance of the enerated link is 
*                                        governed by a CSS style named ".hoverText"
*                                        which it is your responsibility to declare
*                                        in your CSS.  
* @param	string	   colour      - the text parameter will be rendered in
*                                        this colour (or even in this color,
*                                        if you must). Default='red', see
*                                        http://www.w3schools.com/css/css_colornames.asp
*                                        If blank, no colour will added.
* @param	bool       bottom      - defines the bottom (underline) appearance
*                                        of the Text parameter. Default is a
*                                        dotted line, 1 pixel wide
*                                        (1px dotted #000). See
*                                        http://www.w3schools.com/css/pr_border-bottom.asp
*                                        http://www.domedia.org/oveklykken/css-borders.php
*                                        If blank, no undeline will added.
* @param	bool       cursor      - defines the appearance of the cursor, See
*                                        http://www.w3schools.com/css/pr_class_cursor.asp
*                                        Default is 'help', which shows a question
*                                        mark
* @access	public
* @return   CSS and HTML code to implement thr hoverText pop-up.


History:
-----------
v1.0 - 2005/06/30 Vienna, Austria.  Intial version
v1.1 - 2005/07/05 Kouvola, Finland. With thanks to the incomparable ElectraWoman, 
                                    who showed me how to simplify the CSS by
                                    declaring it within the span tag, rather than