Updating documentation

ppapi/c/pp_errors.h

Index: ppapi/c/pp_errors.h
===================================================================
--- ppapi/c/pp_errors.h	(revision 73626)
+++ ppapi/c/pp_errors.h	(working copy)
@@ -7,8 +7,7 @@
 
 /**
  * @file
- * Defines the API ...
-
+ * This file defines an enumeration of all Native Client errors.
  */
 
 /**
@@ -17,67 +16,77 @@
  * @{
  */
 
-/** Errors are negative valued. */
+/** This enumeration contains enumerators of all Native Client errors.
+ * Errors are negative valued.
+ */
 enum {
   PP_OK = 0,
 
   /**
-   * Returned by a function, taking a PP_CompletionCallback, that cannot
-   * complete synchronously.  This return value indicates that the given
+   * This value is returned by a function that accepts a PP_CompletionCallback
+   * and cannot complete synchronously.  This error indicates that the given
    * callback will be asynchronously notified of the final result once it is
    * available.
    */
   PP_ERROR_WOULDBLOCK = -1,
 
-  /** Indicates failure for unspecified reasons. */
+  /** This value indicates failure for unspecified reasons. */
   PP_ERROR_FAILED = -2,
 
   /**
-   * Indicates failure due to an asynchronous operation being interrupted,
-   * typically as a result of user action.
+   * This value indicates failure due to an asynchronous operation being
+   * interrupted, typically as a result of user action.
    */
   PP_ERROR_ABORTED = -3,
 
-  /** Indicates failure due to an invalid argument. */
+  /** This value indicates failure due to an invalid argument. */
   PP_ERROR_BADARGUMENT = -4,
 
-  /** Indicates failure due to an invalid PP_Resource. */
+  /** This value indicates failure due to an invalid PP_Resource. */
   PP_ERROR_BADRESOURCE = -5,
 
-  /** Indicates failure due to an unavailable PPAPI interface. */
+  /** This value indicates failure due to an unavailable PPAPI interface. */
   PP_ERROR_NOINTERFACE = -6,
 
-  /** Indicates failure due to insufficient privileges. */
+  /** This value indicates failure due to insufficient privileges. */
   PP_ERROR_NOACCESS = -7,
 
-  /** Indicates failure due to insufficient memory. */
+  /** This value indicates failure due to insufficient memory. */
   PP_ERROR_NOMEMORY = -8,
 
-  /** Indicates failure due to insufficient storage space. */
+  /** This value indicates failure due to insufficient storage space. */
   PP_ERROR_NOSPACE = -9,
 
-  /** Indicates failure due to insufficient storage quota. */
+  /** This value indicates failure due to insufficient storage quota. */
   PP_ERROR_NOQUOTA = -10,
 
-  /** Indicates failure due to an action already being in progress. */
+  /**
+   * This value indicates failure due to an action already being in
+   * progress.
+   */
   PP_ERROR_INPROGRESS = -11,
 
-  /** Indicates failure due to a file that does not exist. */
+  /** This value indicates failure due to a file that does not exist. */
   PP_ERROR_FILENOTFOUND = -20,
 
-  /** Indicates failure due to a file that already exists. */
+  /** This value indicates failure due to a file that already exists. */
   PP_ERROR_FILEEXISTS = -21,
 
-  /** Indicates failure due to a file that is too big. */
+  /** This value indicates failure due to a file that is too big. */
   PP_ERROR_FILETOOBIG = -22,
 
-  /** Indicates failure due to a file having been modified unexpectedly. */
+  /**
+   * This value indicates failure due to a file having been modified
+   * unexpectedly.
+   */
   PP_ERROR_FILECHANGED = -23,
 
-  /** Indicates failure due to a time limit being exceeded. */
+  /** This value indicates failure due to a time limit being exceeded. */
   PP_ERROR_TIMEDOUT = -30,
 
-  /** Indicates that the user cancelled rather providing expected input. */
+  /** This value indicates that the user cancelled rather than providing
+   * expected input.
+   */
   PP_ERROR_USERCANCEL = -40
 };
 
@@ -87,3 +96,4 @@
  */
 
 #endif  /* PPAPI_C_PP_ERRORS_H_ */
+