Cleaning up and adding new docs

ppapi/c/pp_stdint.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_STDINT_H_
 #define PPAPI_C_PP_STDINT_H_
 
 /**
  * @file
- * Provides a definition of C99 sized types
- * across different compilers.
+ * This file provides a definition of C99 sized types
+ * for Microsoft compilers. These definitions only apply
+ * for trusted modules.
  */
 
 /**
  *
  * @addtogroup Typedefs
  * @{
  */
 #if defined(_MSC_VER)
 
+/** This value represents a guaraneteed unsighed 8 bit integer */

[dmichael(do not use this one), 2011/02/08 17:04:38]

s/guaraneteed/guaranteed/
s/unsighed/unsigned/
(and guaraneteed shows up in a few below, too)
Also, these should probably all end with a period.

[jond, 2011/02/09 16:42:04]

Done.

 typedef unsigned char uint8_t;
+
+/** This value represents a guaraneteed signed 8 bit integer */
 typedef signed char int8_t;
+
+/** This value represents a guaraneteed unsigned 16 bit short */
 typedef unsigned short uint16_t;
+
+/** This value represents a guaraneteed signed 16 bit short */
 typedef short int16_t;
+
+/** This value represents a guaraneteed unsigned 32 bit integer */
 typedef unsigned int uint32_t;
+
+/** This value represents a guaraneteed signed 32 bit integer */
 typedef int int32_t;
+
+/** This value represents a guaraneteed signed 64 bit integer */
 typedef __int64 int64_t;
+
+/** This value represents a guaraneteed unsigned 64 bit integer */
 typedef unsigned __int64 uint64_t;
 /**
  * @}
  */
 #else
 #include <stdint.h>
 #endif
 
 #include <stddef.h>  /* Needed for size_t. */
 
 #endif  /* PPAPI_C_PP_STDINT_H_ */