More trivial cleanupi of ppapi/c/trusted headers

ppapi/c/trusted/ppb_url_loader_trusted.h

-/* Copyright (c) 2010 The Chromium Authors. All rights reserved.
+/* 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.
  */
-#ifndef PPAPI_C_PPB_URL_LOADER_TRUSTED_H_
-#define PPAPI_C_PPB_URL_LOADER_TRUSTED_H_
+
+/* From trusted/ppb_url_loader_trusted.idl modified Fri Jul 15 14:09:06 2011. */
+
+#ifndef PPAPI_C_TRUSTED_PPB_URL_LOADER_TRUSTED_H_
+#define PPAPI_C_TRUSTED_PPB_URL_LOADER_TRUSTED_H_
 
 #include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
 
-#define PPB_URLLOADERTRUSTED_INTERFACE "PPB_URLLoaderTrusted;0.3"
+/**
+ * @file
+ * URL loader trusted interfaces. */
 
-// Callback that indicates the status of the download and upload for the
-// given URLLoader resource.
+
+/**
+ * @addtogroup Typedefs
+ * @{
+ */
+/**
+ * Callback that indicates the status of the download and upload for the
+ * given URLLoader resource.
+ */
 typedef void (*PP_URLLoaderTrusted_StatusCallback)(
-      PP_Instance pp_instance,
-      PP_Resource pp_resource,
-      int64_t bytes_sent,
-      int64_t total_bytes_to_be_sent,
-      int64_t bytes_received,
-      int64_t total_bytes_to_be_received);
+    PP_Instance pp_instance,
+    PP_Resource pp_resource,
+    int64_t bytes_sent,
+    int64_t total_bytes_to_be_sent,
+    int64_t bytes_received,
+    int64_t total_bytes_to_be_received);
 
-// Available only to trusted implementations.
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/* Available only to trusted implementations. */
+#define PPB_URLLOADERTRUSTED_INTERFACE_0_3 "PPB_URLLoaderTrusted;0.3"
+#define PPB_URLLOADERTRUSTED_INTERFACE PPB_URLLOADERTRUSTED_INTERFACE_0_3
+
 struct PPB_URLLoaderTrusted {
-  // Grant this URLLoader the capability to make unrestricted cross-origin
-  // requests.
+  /**
+   * Grant this URLLoader the capability to make unrestricted cross-origin
+   * requests.
+   */
   void (*GrantUniversalAccess)(PP_Resource loader);
 
-  // Registers that the given function will be called when the upload or
-  // downloaded byte count has changed. This is not exposed on the untrusted
-  // interface because it can be quite chatty and encourages people to write
-  // feedback UIs that update as frequently as the progress updates.
-  //
-  // The other serious gotcha with this callback is that the callback must not
-  // mutate the URL loader or cause it to be destroyed.
-  //
-  // However, the proxy layer needs this information to push to the other
-  // process, so we expose it here. Only one callback can be set per URL
-  // Loader. Setting to a NULL callback will disable it.
+  /**
+   * Registers that the given function will be called when the upload or
+   * downloaded byte count has changed. This is not exposed on the untrusted
+   * interface because it can be quite chatty and encourages people to write
+   * feedback UIs that update as frequently as the progress updates.
+   *
+   * The other serious gotcha with this callback is that the callback must not
+   * mutate the URL loader or cause it to be destroyed.
+   *
+   * However, the proxy layer needs this information to push to the other
+   * process, so we expose it here. Only one callback can be set per URL
+   * Loader. Setting to a NULL callback will disable it.
+   */
   void (*RegisterStatusCallback)(PP_Resource loader,
                                  PP_URLLoaderTrusted_StatusCallback cb);
+
 };
 
-#endif  // PPAPI_C_PPB_URL_LOADER_H_
+/**
+ * @}
+ */
 
+#endif  /* PPAPI_C_TRUSTED_PPB_URL_LOADER_TRUSTED_H_ */
+