cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [4/5] docs commit: [CB-3818] clarify diff storage specs; no plugin access
Date Tue, 30 Jul 2013 18:02:27 GMT
[CB-3818] clarify diff storage specs; no plugin access


Branch: refs/heads/master
Commit: 0929908011e88d471cd37fe6c470a2e9f7e46720
Parents: 8cb8b7c
Author: Mike Sierra <>
Authored: Tue Jul 30 12:36:54 2013 -0400
Committer: Michael Brooks <>
Committed: Tue Jul 30 11:02:07 2013 -0700

 .../storage/localstorage/        | 16 +++++----
 docs/en/edge/cordova/storage/         | 36 +++++++++++++-------
 2 files changed, 34 insertions(+), 18 deletions(-)
diff --git a/docs/en/edge/cordova/storage/localstorage/ b/docs/en/edge/cordova/storage/localstorage/
index 8428966..66b3562 100644
--- a/docs/en/edge/cordova/storage/localstorage/
+++ b/docs/en/edge/cordova/storage/localstorage/
@@ -20,9 +20,11 @@ license: Licensed to the Apache Software Foundation (ASF) under one
-Provides access to a [W3C Storage interface](
+Provides access to the W3C's
+[Web Storage interface](
-    var storage = window.localStorage;
+    var permanentStorage = window.localStorage;
+    var tempStorage = window.sessionStorage;
@@ -40,10 +42,12 @@ Methods
-The `window.localStorage` interface is based on the W3C Web Storage
-interface.  An app can use it to save persistent data using key-value
-pairs.  The `window.sessionStorage` interface works the same way, but
-all data is cleared each time the app closes.
+The `window.localStorage` interface implements the W3C's [Web Storage
+interface](  An app can use it to
+save persistent data using key-value pairs.  The
+`window.sessionStorage` interface works the same way in every respect,
+except that all data is cleared each time the app closes. Each
+database provides a separate namespace.
 Supported Platforms
diff --git a/docs/en/edge/cordova/storage/ b/docs/en/edge/cordova/storage/
index 02d1fa4..0e93244 100644
--- a/docs/en/edge/cordova/storage/
+++ b/docs/en/edge/cordova/storage/
@@ -22,12 +22,22 @@ Storage
 > Provides access to the device's storage options.
-This API is based on the [W3C Web SQL Database
-Specification]( and [W3C Web
-Storage API Specification]( Some
-devices already provide an implementation of these specifications, in
-which case the built-in support applies.  Cordova's implementation
-offers compatible support for those that don't.
+This API offers storage options based on two different W3C
+* The
+  [Web Storage API Specification](
+  allows you to access data via simple key/value pairs.  See the
+  section on localStorage for complete details on this interface.
+* The
+  [Web SQL Database Specification](
+  offers more full-featured database tables accessed via SQL queries.
+  A summary of this interface appears immediately below.
+Cordova provides access to both interfaces for the minority of devices
+that don't already support them. Otherwise the built-in
+implementations apply.
@@ -50,10 +60,17 @@ Objects
 - SQLResultSet
 - SQLResultSetRowList
 - SQLError
-- localStorage
 ## Accessing the Feature
+As of version 3.0, access to Storage APIs is built into Cordova, and
+does not require using the CLI to add plugins as described in The
+Command-line Interface.
+If you are using the older set of Cordova tools that precede the CLI,
+the following platform-specific configuration settings are still
 * Android (in `app/res/xml/config.xml`)
         <feature name="Storage">
@@ -64,8 +81,3 @@ Objects
         <feature id="blackberry.widgetcache" required="true" version="" />
-* iOS (no special permissions required)
-* Windows Phone (no special permissions required)
-* Tizen (no special permissions required)

View raw message