Index: ppapi/api/pp_var.idl |
diff --git a/ppapi/api/pp_var.idl b/ppapi/api/pp_var.idl |
index fda2332b895509588ce700ab551fec8c921a3709..aeeb7bf8fd8d87bc9faf4d90a418a16ccdb047af 100644 |
--- a/ppapi/api/pp_var.idl |
+++ b/ppapi/api/pp_var.idl |
@@ -44,23 +44,33 @@ enum PP_VarType { |
/** |
* 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. |
+ * <code>PPB_Var</code> interface. These objects are reference counted, so |
+ * 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. |
+ * 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. |
*/ |
PP_VARTYPE_OBJECT = 6, |
/** |
- * Arrays and dictionaries are not currently supported but will be added |
- * in future revisions. These objects are reference counted so be sure |
- * to properly AddRef/Release them as you would with strings to ensure your |
- * module will continue to work with future versions of the API. |
+ * 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. |
*/ |
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. |
+ */ |
PP_VARTYPE_DICTIONARY = 8, |
/** |
@@ -68,7 +78,8 @@ enum PP_VarType { |
* 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. |
+ * ArrayBuffer vars. These objects are reference counted, so AddRef and |
+ * Release must be used properly to avoid memory leaks. |
*/ |
PP_VARTYPE_ARRAY_BUFFER = 9 |
}; |