PPAPI: Update pp_var.h documentation for Resource vars.

ppapi/api/pp_var.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the API for handling the passing of data types between
  * your module and the page.
  */
 
@@ skipping 27 matching lines @@
   /**
    * A double-precision floating point value. Use the <code>as_double</code>
    * member of the var.
    */
   PP_VARTYPE_DOUBLE = 4,
 
   /**
    * The Var represents a string. The <code>as_id</code> field is used to
    * identify the string, which may be created and retrieved from the
    * <code>PPB_Var</code> interface. These objects are reference counted, so
-   * AddRef and Release must be used properly to avoid memory leaks.
+   * AddRef() and Release() must be used properly to avoid memory leaks.
    */
   PP_VARTYPE_STRING = 5,
 
   /**
    * Represents a JavaScript object. This vartype is not currently usable
    * from modules, although it is used internally for some tasks. These objects
-   * are reference counted, so AddRef and Release must be used properly to avoid
-   * memory leaks.
+   * are reference counted, so AddRef() and Release() must be used properly to
+   * avoid memory leaks.
    */
   PP_VARTYPE_OBJECT = 6,
 
   /**
    * Represents an array of Vars. The <code>as_id</code> field is used to
    * identify the array, which may be created and manipulated from the
    * <code>PPB_VarArray</code> interface. These objects are reference counted,
-   * so AddRef and Release must be used properly to avoid memory leaks.
+   * so AddRef() and Release() must be used properly to avoid memory leaks.
    */
   PP_VARTYPE_ARRAY = 7,
 
   /**
    * Represents a mapping from strings to Vars. The <code>as_id</code> field is
    * used to identify the dictionary, which may be created and manipulated from
    * the <code>PPB_VarDictionary</code> interface. These objects are reference
-   * counted, so AddRef and Release must be used properly to avoid memory leaks.
+   * counted, so AddRef() and Release() must be used properly to avoid memory
+   * leaks.
    */
   PP_VARTYPE_DICTIONARY = 8,
 
   /**
    * ArrayBuffer represents a JavaScript ArrayBuffer. This is the type which
    * represents Typed Arrays in JavaScript. Unlike JavaScript 'Array', it is
    * only meant to contain basic numeric types, and is always stored
    * contiguously. See PPB_VarArrayBuffer_Dev for functions special to
-   * ArrayBuffer vars. These objects are reference counted, so AddRef and
-   * Release must be used properly to avoid memory leaks.
+   * ArrayBuffer vars. These objects are reference counted, so AddRef() and
+   * Release() must be used properly to avoid memory leaks.
    */
   PP_VARTYPE_ARRAY_BUFFER = 9,
 
   /**
-   * Resources are not currently supported but will be added in the future
-   * These objects are reference counted, so AddRef and Release must be used
-   * properly to avoid memory leaks.
+   * This type allows the <code>PP_Var</code> to wrap a <code>PP_Resource
+   * </code>. This can be useful for sending or receiving some types of
+   * <code>PP_Resource</code> using <code>PPB_Messaging</code> or
+   * <code>PPP_Messaging</code>.
+   *
+   * These objects are reference counted, so AddRef() and Release() must be used
+   * properly to avoid memory leaks. Under normal circumstances, the
+   * <code>PP_Var</code> will implicitly hold a reference count on the
+   * <code>PP_Resource</code> on your behalf. For example, if you call
+   * VarFromResource(), it implicitly calls PPB_Core::AddRefResource() on the
+   * <code>PP_Resource</code>. Likewise, PPB_Var::Release() on a Resource
+   * <code>PP_Var</code> will invoke PPB_Core::ReleaseResource() when the Var
+   * reference count goes to zero.
    */
   PP_VARTYPE_RESOURCE = 10
 };
 
 
 /**
  * The PP_VarValue union stores the data for any one of the types listed
  * in the PP_VarType enum.
  */
 [union] struct PP_VarValue {
@@ skipping 134 matching lines @@
   struct PP_Var result = { PP_VARTYPE_DOUBLE, 0, {PP_FALSE} };
   result.value.as_double = value;
   return result;
 }
 /**
  * @}
  */
 
 #endinl