Docs: Update quota mgmt API docs to use methods that don't throw console warnings.

chrome/common/extensions/docs/templates/articles/offline_storage.html

 <h1>Managing HTML5 Offline Storage</h1>
 
 <p>
 HTML5 introduced many storage APIs that let you  store a large amount of data locally in your users' browsers. But the amount of space allocated for each app is, by default, restricted to a few megabytes. Google Chrome  lets you ask for a larger storage quota, beyond the previous limit of just 5 MB. </p>
 <p>This document introduces you to the basic concepts around the types of storage used in Chrome and describes the experimental Quota Management API, which lets you manage your storage quota. The document assumes that you are already familiar with the  general concepts of client-side storage  and know how to use  offline APIs. </p>
 <h2 id="contents">Contents</h2>
 <ol>
   <li><a href="#types">Types of storage</a>
   <ol>
     <li><a href="#temporary">Temporary  </a></li>
@@ skipping 166 matching lines @@
 <h3 id="query">Querying  storage usage and availability</h3>
 <p>To query the storage size that is being used and the available space left for the host, call <code>queryUsageAndQuota()</code> with the following:</p>
 <ul>
   <li>Type of storage you want to check</li>
   <li>Success callback </li>
 </ul>
 <p>The usage reported by the  API might not match  with the actual size of the user data, as each storage might need some extra bytes to store its metadata. Also, status updates can lag, resulting in the API not reflecting the most recent storage status. </p>
 <p>The following code snippet shows how you can ask about storage space:</p>
 <pre class="prettyprint">
 // Request storage usage and capacity left
-window.webkitStorageInfo.queryUsageAndQuota(webkitStorageInfo.TEMPORARY, //the type can be either TEMPORARY or PERSISTENT
-function(used, remaining) {
-  console.log("Used quota: " + used + ", remaining quota: " + remaining);
-}, function(e) {
-  console.log('Error', e); 
-} );</pre>
+// choose either Temporary or Persistent

[mkearney1, 2015/04/16 00:25:27]

Nit: Capitalize 'choose' in comment.

+navigator.webkitTemporaryStorage.queryUsageAndQuota ( 
+    function(usedBytes, grantedBytes) {  
+        console.log('we are using ', usedBytes, ' of ', grantedBytes, 'bytes');
+    }, 
+    function(e) { console.log('Error', e);  }
+);
+</pre>
 <p>If you want to ask for the status of persistent storage, simply replace <span class="prettyprint"><code>webkitStorageInfo.<strong>TEMPORARY</strong></code></span> with <span class="prettyprint"><code>webkitStorageInfo.<strong>PERSISTENT</strong></code></span>. The enum is also in the <code>window</code> object (global namespace), so you can also use <code>window.<strong>PERSISTENT</strong></code> and  <code>window.<strong>TEMPORARY</strong></code>.</p>
 <p class="backtotop"><a href="#top">Back to top</a></p>
 
 <h3 id="asking_more">Asking for more storage</h3>
 <p>You don't need to ask for more temporary storage as the allocation is automatic, and you can't get beyond the maximum limit (as described in the <a href="#table">table</a>). </p>
 <p>For persistent storage for Files System API, the  default quota is 0, so you need to explicitly request storage for your application. Call <code>requestQuota()</code> with the following:</p>
 <ul>
   <li>Type of storage</li>
   <li>Size</li>
   <li>Success callback</li>
 </ul>
 <p>Depending on what you ask for, the following happens:</p>
 <ul>
   <li>If you ask for a larger quota, the browser presents an info bar to the user and prompts them to either grant or deny permission for increased quota. In some cases, the request might be silently rejected, and the current quota or smaller quota is returned.</li>
   <li>If the amount of quota you request is less than the app's current allocation, no prompt is shown. </li>
   <li>If you ask for more storage than what is allowed, you get an error (<code>QUOTA_EXCEEDED_ERR</code>). </li>
   <li>If you call <code>requestQuota()</code> again after the user has already granted permission, nothing happens. So don't bother calling the method again.</li>
 </ul>
 <p>The following shows how you can ask for more storage space:</p>
 <pre class="prettyprint">
 // Request Quota (only for File System API) </span> 
-window.webkitStorageInfo.requestQuota(PERSISTENT, 1024*1024, function(grantedBytes) {
-  window.webkitRequestFileSystem(PERSISTENT, grantedBytes, onInitFs, errorHandler); 
-}, function(e) {
-  console.log('Error', e); 
+var requestedBytes = 1024*1024*10; // 10MB
+
+navigator.webkitPersistentStorage.requestQuota (
+    requestedBytes, function(grantedBytes) {  
+        window.requestFileSystem(PERSISTENT, grantedBytes, onInitFs, errorHandler);
+
+    }, function(e) { console.log('Error', e); }
+);
 });</pre>
 <p class="backtotop"><a href="#top">Back to top</a></p>
 
 <h3 id="reset">Resetting quota for testing</h3>
 <p>When you are testing storage in your app, you might want to clear the stored data so that you can test quota management afresh in your app. To do so:</p>
 <ol>
   <li>Enter <code>chrome://settings/cookies</code> in the omnibox (the address bar). </li>
   <li>Search for your app.</li>
   <li>Select your app. </li>
   <li>Click the <strong>X</strong> on the  right side of the highlighted selection.</li>
@@ skipping 35 matching lines @@
     </tr>
     <tr>
       <td><code>void <a href="#requestQuota" title="#add">requestQuota</a> (in unsigned short storageType, unsigned long long newQuotaInBytes, optional StorageInfoQuotaCallback successCallback, optional StorageInfoErrorCallback errorCallback)</code></td>
     </tr>
   </tbody>
 </table>
 <h3 id="methods">Methods</h3>
 <h4 id="queryUsageAndQuota">queryUsageAndQuota</h4>
 <p>Check the storage size that is being used and the available space left for the host.</p>
 
-<pre class="prettyprint">webkitStorageInfo.queryUsageAndQuota(
-      webkitStorageInfo.TEMPORARY,   // or PERSISTENT
-      usageCallback,
+<pre class="prettyprint"> // you could also use it from webkitPersistentStorage
+navigator.webkitTemporaryStorage.queryUsageAndQuota(
+      successCallback,
       errorCallback);</pre>
-
-
-<h5>Parameters</h5>
-<dl>
-<dt>storageType</dt>
-<dd>The type of storage for the current usage. The value could either be <code>TEMPORARY</code> or <code>PERSISTENT</code>. </dd>
-</dl>
 <dl>
   <dt>successCallback</dt>
   <dd>Optional callback with two parameters: <ul>
     <li>The current number of bytes the app is using. </li>
     <li>The number of bytes left in the quota. </li>
   </ul>
   </dd>
 </dl>
 <dl>
   <dt>errorCallback</dt>
   <dd>Optional error callback.</dd>
   <dt>&nbsp;</dt>
 </dl>
 <p class="backtotop"><a href="#top">Back to top</a></p>
 <hr />
 <h4 id="requestQuota">requestQuota</h4>
 
 <p>Ask for more storage. The browser presents an info bar to prompt user to grant or deny the app the permission to have more storage.</p>
 
-<pre class="prettyprint">webkitStorageInfo.requestQuota(
-      webkitStorageInfo.PERSISTENT // or TEMPORARY
+<pre class="prettyprint"> // you could also use it from webkitTemporaryStorage
+navigator.webkitPersistentStorage.requestQuota (
       newQuotaInBytes,
       quotaCallback,
       errorCallback);</pre>
 
 <h5>Parameters</h5>
 <dl>
-  <dt>storageType</dt>
-  <dd>The type of storage for the current usage. The value could either be <code>TEMPORARY</code> or <code>PERSISTENT</code>. Temporary storage is automatically allocated, so only call the method for   <code>PERSISTENT</code> storage. </dd>
+ 
   <dt>newQuotaInBytes</dt>
   <dd>The amount of bytes you want in your storage quota.  </dd>
 </dl>
 <dl>
   <dt>successCallback</dt>
   <dd>Optional callback that passes the amount of bytes granted. </dd>
 </dl>
 <dl>
   <dt>errorCallback</dt>
   <dd>Optional error callback.</dd>
 </dl>
 
 <h2 id="future">Future development</h2>
 <p>The plan is to put all HTML5 offline storage APIs—including IndexedDB, Application Cache, Files System,{# LocalStorage, SessionStorage,#} and other APIs that might be specified—under the Quota Management API. You will be able to manage all storage allocation with it. </p>