Updating documentation

ppapi/c/pp_size.h

Index: ppapi/c/pp_size.h
===================================================================
--- ppapi/c/pp_size.h	(revision 73518)
+++ ppapi/c/pp_size.h	(working copy)
@@ -7,7 +7,7 @@
 
 /**
  * @file
- * Defines the API ...
+ * This file defines the width and heigh to of a 2 dimenstional rectangle.
  */
 
 #include "ppapi/c/pp_macros.h"
@@ -17,8 +17,14 @@
  * @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);
@@ -30,6 +36,13 @@
  * @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;