Removed Doxygen groupings by ppb_, pp_, and ppp_. Added grouping by construct...

ppapi/c/ppb_var.h

 /* Copyright (c) 2010 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_VAR_H_
 #define PPAPI_C_PPB_VAR_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_module.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ppapi/c/pp_var.h"
 
 #define PPB_VAR_INTERFACE "PPB_Var;0.4"
 
 /**
+ *
+ * @addtogroup Enums
+ * @{
+ */
+
+/**
  * @file
  * Defines the PPB_Var struct.
  * See http://code.google.com/p/ppapi/wiki/InterfacingWithJavaScript
  * for general information on using this interface.
  * {PENDING: Should the generated doc really be pointing to methods?}
- *
- * @addtogroup PPB
- * @{
  */
-
 enum PP_ObjectProperty_Modifier {
   PP_OBJECTPROPERTY_MODIFIER_NONE       = 0,
   PP_OBJECTPROPERTY_MODIFIER_READONLY   = 1 << 0,
   PP_OBJECTPROPERTY_MODIFIER_DONTENUM   = 1 << 1,
   PP_OBJECTPROPERTY_MODIFIER_DONTDELETE = 1 << 2,
   PP_OBJECTPROPERTY_MODIFIER_HASVALUE   = 1 << 3
 };
+/**
+ * @}
+ */
+
 PP_COMPILE_ASSERT_ENUM_SIZE_IN_BYTES(PP_ObjectProperty_Modifier, 4);
 
+/**
+ * @addtogroup Structs
+ * @{
+ */
 struct PP_ObjectProperty {
   struct PP_Var name;
   struct PP_Var value;
   struct PP_Var getter;
   struct PP_Var setter;
   uint32_t modifiers;
 
   /** Ensure that this struct is 72 bytes wide by padding the end.  In some
    *  compilers, PP_Var is 8-byte aligned, so those compilers align this struct
    *  on 8-byte boundaries as well and pad it to 72 bytes even without this
    *  padding attribute.  This padding makes its size consistent across
    *  compilers.
    */
   int32_t padding;
 };
+/**
+ * @}
+ */
+
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_ObjectProperty, 72);
 
 /**
+ * @addtogroup Interfaces
+ * @{
+ */
+
+/**
  * PPB_Var API
  *
  * JavaScript specification:
  *
  * When referencing JS specification, we will refer to ECMAScript, 5th edition,
  * and we will put section numbers in square brackets.
  *
  * Exception handling:
  *
  * If an exception parameter is NULL, then any exceptions that happen during the
  * execution of the function will be ignored. If it is non-NULL, and has a type
  * of PP_VARTYPE_UNDEFINED, then if an exception is thrown it will be stored in
  * the exception variable. It it is non-NULL and not PP_VARTYPE_UNDEFINED, then
  * the function is a no-op, and, if it returns a value, it will return
  * PP_VARTYPE_UNDEFINED. This can be used to chain together multiple calls and
  * only check the exception at the end.
  *
  * Make sure not to intermix non-JS with JS calls when relying on this behavior
  * to catch JS exceptions, as non-JS functions will still execute!
 
  * JS engine's exceptions will always be of type PP_VARTYPE_OBJECT. However,
  * PP_Var interface can also throw PP_VARTYPE_STRING exceptions, in situations
  * where there's no JS execution context defined. These are usually invalid
  * parameter errors - passing an invalid PP_Var value, for example, will always
  * result in an PP_VARTYPE_STRING exception. Exceptions will not be of any other
  * type.
  * TODO(neb): Specify the exception for ill-formed PP_Vars, invalid module,
  * instance, resource, string and object ids.
+ *
  */
 struct PPB_Var {
   /**
    * Adds a reference to the given var. If this is not a refcounted object,
    * this function will do nothing so you can always call it no matter what the
    * type.
    */
   void (*AddRef)(struct PP_Var var);
 
   /**
@@ skipping 189 matching lines @@
    * JavaScript. Similar to the [[Construct]] internal method [13.2.2].
    *
    * For examples, to construct an empty object, do:
    * GetWindow().GetProperty("Object").Construct(0, NULL);
    */
   struct PP_Var (*Construct)(struct PP_Var object,
                              uint32_t argc,
                              struct PP_Var* argv,
                              struct PP_Var* exception);
 };
+/**
+ * @}
+ */
 
+/**
+ * @addtogroup Functions
+ * @{
+ */
 PP_INLINE struct PP_ObjectProperty PP_MakeSimpleProperty(struct PP_Var name,
                                                          struct PP_Var value) {
   struct PP_ObjectProperty result;
   result.name = name;
   result.value = value;
   result.getter = PP_MakeUndefined();
   result.setter = PP_MakeUndefined();
   result.modifiers = PP_OBJECTPROPERTY_MODIFIER_HASVALUE;
   return result;
 }
-
 /**
  * @}
- * End addtogroup PPB
  */
+
 #endif  /* PPAPI_C_PPB_VAR_H_ */