More trivial cleanupi of ppapi/c headers

ppapi/c/pp_completion_callback.h

 /* Copyright (c) 2011 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.
  */
+
+/* From pp_completion_callback.idl modified Sat Jul 16 16:50:26 2011. */
+
 #ifndef PPAPI_C_PP_COMPLETION_CALLBACK_H_
 #define PPAPI_C_PP_COMPLETION_CALLBACK_H_
 
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_stdint.h"
+
 /**
  * @file
  * This file defines the API to create and run a callback.
  */
 
-#include <stdlib.h>
-
-#include "ppapi/c/pp_macros.h"
-#include "ppapi/c/pp_stdint.h"
 
 /**
  * @addtogroup Typedefs
  * @{
  */
-
 /**
  * PP_CompletionCallback_Func defines the function signature that you implement
  * to receive callbacks on asynchronous completion of an operation.
  *
  * |user_data| is a pointer to user-specified data associated with this
  * function at callback creation. See PP_MakeCompletionCallback() for details.
  *
  * |result| is the result of the operation. Non-positive values correspond to
  * the error codes from pp_errors.h (excluding PP_OK_COMPLETIONPENDING).
  * Positive values indicate additional information such as bytes read.
  */
 typedef void (*PP_CompletionCallback_Func)(void* user_data, int32_t result);
 /**
  * @}
  */
 
 /**
- *
  * @addtogroup Enums
  * @{
  */
-
 /**
  * This enumeration contains flags used to control how non-NULL callbacks are
  * scheduled by asynchronous methods.
  */
 typedef enum {
   /**
    * This flag allows any non-NULL callback to be always invoked asynchronously,
    * on success or error, even if the operation could complete synchronously
    * without blocking.
    *
@@ skipping 10 matching lines @@
    * limited to the processing speed of the message loop.
    *
    * On synchronous method completion, the completion result will be returned
    * by the method itself. Otherwise, the method will return
    * PP_OK_COMPLETIONPENDING, and the callback will be invoked asynchronously on
    * the main thread of PPAPI execution.
    */
   PP_COMPLETIONCALLBACK_FLAG_OPTIONAL = 1 << 0
 } PP_CompletionCallback_Flag;
 PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_CompletionCallback_Flag, 4);
-
 /**
  * @}
  */
 
 /**
  * @addtogroup Structs
  * @{
  */
-
 /**
  * Any method that takes a PP_CompletionCallback can complete asynchronously.
  * Refer to PP_CompletionCallback_Flag for more information.
  *
  * If PP_CompletionCallback_Func is NULL, the operation might block if necessary
  * to complete the work. Refer to PP_BlockUntilComplete for more information.
  *
  * See PP_MakeCompletionCallback() for the description of each field.
  */
 struct PP_CompletionCallback {
   PP_CompletionCallback_Func func;
   void* user_data;
   int32_t flags;
 };
 /**
  * @}
  */
 
+#include <stdlib.h>
+
 /**
  * @addtogroup Functions
  * @{
  */
 /**
  * PP_MakeCompletionCallback() is used to create a PP_CompletionCallback
  * without flags. If you want to alter the default callback behavior, set the
  * flags to a bit field combination of PP_CompletionCallback_Flag's.
  *
  * Example:
@@ skipping 99 matching lines @@
     int32_t res) {
   struct PP_CompletionCallback temp = *cc;
   *cc = PP_BlockUntilComplete();
   PP_RunCompletionCallback(&temp, res);
 }
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PP_COMPLETION_CALLBACK_H_ */
+