Updating documentation

ppapi/c/pp_size.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_PP_SIZE_H_
 #define PPAPI_C_PP_SIZE_H_
 
 /**
  * @file
- * Defines the API ...
+ * This file defines the width and heigh to of a 2 dimenstional rectangle.
  */
 
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_stdint.h"
 
 /**
  * @addtogroup Structs
  * @{
  */
+
+/**
+ * The PP_Size struct contains the size of a 2D rectangle.
+ */
 struct PP_Size {
+  /** This value represents the width of the rectangle. */
   int32_t width;
+  /** This value represents the height of the rectangle. */
   int32_t height;
 };
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_Size, 8);
 /**
  * @}
  */
 
 /**
  * @addtogroup Functions
  * @{
  */
+
+/**
+ * PP_MakeSize() places two 32 bit integers inside a PP_Size structure.

[dmichael(do not use this one), 2011/02/02 23:36:51]

wording like 'creates a PP_Size...'

[jond, 2011/02/03 17:28:11]

Done.

+ * @param[in] w A 32 bit value representing a width.
+ * @param[in] h A 32 bit value representing a height.
+ * @return A PP_Size structure.
+ */
 PP_INLINE struct PP_Size PP_MakeSize(int32_t w, int32_t h) {
   struct PP_Size ret;
   ret.width = w;
   ret.height = h;
   return ret;
 }
 /**
  * @}
  */
 #endif  /* PPAPI_C_PP_SIZE_H_ */