Updated/rewrote documentation.

ppapi/c/pp_resource.h

Index: ppapi/c/pp_resource.h
===================================================================
--- ppapi/c/pp_resource.h	(revision 77656)
+++ ppapi/c/pp_resource.h	(working copy)
@@ -10,7 +10,8 @@
 
 /**
  * @file
- * Defines the API ...
+ * This file defines the PP_Resource type which represents data associated with
+ * the module.
  */
 
 /**
@@ -19,19 +20,18 @@
  */
 
 /**
- * A resource is data associated with the Pepper plugin interface. While a
- * Var represents something callable to JS or from the plugin to the DOM, a
- * resource has no meaning or visibility outside of the plugin interface.
+ * This typdef represents an opaque handle assigned by the browser to the
+ * resource. The handle is guaranteed never to be 0 for a valid resource, so a
+ * module can initialize it to 0 to indicate a "NULL handle." Some interfaces
+ * may return a NULL resource to indicate failure.
  *
- * Resources are reference counted. Use AddRefResource and ReleaseResource to
- * manage your reference count of a resource. The data will be automatically
- * destroyed when the internal reference count reaches 0.
+ * While a Var represents something callable to JS or from the module to
+ * the DOM, a resource has no meaning or visibility outside of the module
+ * interface.
  *
- * Value is an opaque handle assigned by the browser to the resource. It is
- * guaranteed never to be 0 for a valid resource, so a plugin can initialize
- * it to 0 to indicate a "NULL handle." Some interfaces may return a NULL
- * resource to indicate failure.
- *
+ * Resources are reference counted. Use AddRefResource and ReleaseResource in
+ * ppb_core.h to manage the reference count of a resource. The data will be
+ * automatically destroyed when the internal reference count reaches 0.
  */
 typedef int32_t PP_Resource;
 PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_Resource, 4);