-------------------------------------------------------------------------------
Dojo Storage
-------------------------------------------------------------------------------
Version X.XXX (does not have separate versioning -- versioned by release date)
Last Release date: March 2008
-------------------------------------------------------------------------------
Project state:
experimental
-------------------------------------------------------------------------------
Credits
	Brad Neuberg
	Alex Russell
-------------------------------------------------------------------------------
Project description

dojox.storage provides a JavaScript abstraction for persistent storage
as well as pluggable implementations which typically use native browser extensions
(e.g. Flash player, Gears)

-------------------------------------------------------------------------------
Dependencies:

FlashStorageProvider requires the Flash player
GearsStorageProvider requires the Gears extension
The various Air*StorageProviders require Adobe's AIR software

The open source mtasc compiler (www.mtasc.org) is needed to build the
ActionScript into SWF format.  The SWF object is maintained within svn, so
this step is only necessary if Storage.as is modified.  A sample build script
is provided (buildFlashStorage.sh)

-------------------------------------------------------------------------------
Documentation

See http://manual.dojotoolkit.org/WikiHome/DojoDotBook/Book50 for the
authoritative Dojo Storage docs.

See dojox/storage/demos/helloworld.html for a simple Hello World example
you can base your code off of.

-------------------------------------------------------------------------------
Installation instructions

If you want to use Dojo Storage in a web browser:

These installation instructions are to use Dojo Storage in a web browser; at
runtime, Dojo Storage will autodetect and use the best available storage
option. This includes:

  * Google Gears
  * HTML 5 Web Browsers (Firefox 2+)
  * Hidden Flash
  
If you are using a release build (if you downloaded Dojo from the Dojo
website then this is a release build -- if you checked it out from
Subversion yourself then you will have to build things yourself), if you 
only want to grab just the files from Dojo to use Dojo Storage
in the browser, take the following (but make sure to keep the directory
layout the same, or else things won't work correctly!):

* dojo/dojo.js
* dojox/storage/storage-browser.js
* dojox/storage/Storage.swf

To help with testing and development and to make sure you have everything 
right, its also useful to grab the following files:

* dojox/storage/README
* dojox/storage/demos/helloworld.html

If you want to use Dojo Storage with Adobe AIR:

[TBD! Why don't you write this and contribute!]

-------------------------------------------------------------------------------
Additional Notes