~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~                           jsDOMenuBar Read Me                           ~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    * Project Name: jsDOMenuBar
    * Development Status: Stable
    * Version: 1.1.1 (View changelog.txt for more information)
    * Release Date: 12 February 2005
    * License: GNU General Public License (GPL) (View license.txt for more 
               information)
    * Programming Language: Javascript
    * Requirements:
          o jsDOMenu Version 1.3 or later
          o DOM compatible browser such as Mozilla, Mozilla 
            Firefox/Firefox, Netscape 7, Opera 7, Safari 1.x, Camino 0.8 
            and Microsoft Internet Explorer 6


License

jsDOMenuBar Version 1.1.1
Copyright (C) 2004 - 2005 Toh Zhiqiang
Released on 12 February 2005
Web Site: http://www.tohzhiqiang.per.sg/projects/jsdomenubar/

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.


Description

jsDOMenuBar is a cross-browser navigation menu bar that is based on DOM. 
It is an add-on to jsDOMenu that allows horizontal menu bars to be created 
and used together with jsDOMenu. You can configure it to be absolutely 
positioned, fixed positioned (does not move with the page during scrolling) or 
statically positioned. It supports unlimited menu bar items, and can be made 
draggable. jsDOMenuBar is 100% HTML/XHTML compliant, and is fully customizable 
through CSS. Every menu bar item can have an icon shown before the display 
text. Tested and works in many browsers such as Mozilla, Mozilla 
Firebird/Firefox, Netscape, Opera, Safari, Camino and Microsoft Internet 
Explorer.


Features

Some of the features of jsDOMenuBar are outlined below:

    * Tested and works in many browsers. Some are outlined below:
          o Mozilla 1.x
          o Mozilla Firefox 0.8 - 1.0
          o Mozilla Firebird 0.7
          o Netscape 7.x
          o Opera 7.23 - 7.5x
          o Safari 1.x
          o Camino 0.8
          o Microsoft Internet Explorer 5 - 6
    * Supports unlimited menu bar items.
    * Make use of jsDOMenu to create the menus for the menu bar items.
    * Font, colour, background colour, styles, etc, of menu bars and menu 
      bar items are fully customizable through CSS.
    * Switch to an alternate stylesheet to change the theme of the menu 
      bars and menus without reloading the page (works in certain browsers 
      only).
    * 100% HTML/XHTML compliant. No document.write() or document.writeln() 
      used.
    * Configure whether the menu bar is draggable.
    * Configure whether the menu bar is absolutely positioned, fixed 
      positioned (does not move with the page during scrolling) or statically 
      positioned.
    * Every menu bar item can have an icon shown before the display text.
    * Works in frames.
    * Released under GPL. You can help to improve jsDOMenuBar so that it 
      works in more browsers!


Restrictions

Some of the restrictions of jsDOMenuBar are outlined below:

    * Visitors must browse the page with Javascript enabled.


Known Issues

Some issues regarding jsDOMenuBar have been listed below:

    * Menus may appear slowly after prolong usage without reloading the page 
      or if the page has many submenus.
    * Icons will not be shown on absolute/fixed menu bars in Opera due to 
      positioning problems.


Demo

View the /demo folder for various demonstrations of jsDOMenuBar.

Note: If your web site use jsDOMenuBar and you do not mind sharing with 
the rest, do send in your web address so that the Webmaster can include in 
the demo page.


Documentation

View the /docs folder to learn how to install jsDOMenuBar and create the 
menu bars using simple Javascript codes.

Note: If you can think of any better method/implementation, please kindly 
inform the Webmaster so that he can include it in the next release of 
jsDOMenuBar. 


Download

The latest version of jsDOMenuBar can be downloaded at 
http://www.tohzhiqiang.per.sg/projects/jsdomenubar/download/.


Forum

Any bug, feature request, problem, comment, suggestion, etc, please post 
it in the forum at http://forums.tohzhiqiang.per.sg/.


Contact

Please post in the above forum first before contacting the Webmaster. If your 
post is not replied for a long time (e.g. a week), or if you have some urgent 
matters, please contact Webmaster at webmaster@tohzhiqiang.per.sg.