Cleaning up and adding new docs

ppapi/c/ppb.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_H_
 #define PPAPI_C_PPB_H_
 
 /**
  * @file
- * Defines the API ...
- *
+ * This file defines a function pointer type for the PPB_GetInterface function.
  */
 
 /**
  * @addtogroup Typedefs
  * @{
  */
 
 /**
- * Returns an interface pointer for the interface of the given name, or NULL
- * if the interface is not supported. Interface names should be ASCII.
+ * This function pointer type defines the signature for the PPB_GetInterface
+ * function. A generic PPB_GetInterface pointer is passed to

[dmichael(do not use this one), 2011/02/11 16:42:04]

nit:  2 spaces after a period.

+ * PPP_InitializedModule when your module is loaded. You can use this pointer

[dmichael(do not use this one), 2011/02/11 16:42:04]

nit:  2 spaces after a period.

+ * to request a pointer to a specific browser interface. Browser interface

[dmichael(do not use this one), 2011/02/11 16:42:04]

nit:  2 spaces after period

+ * names are ASCII strings and are generally defined in the header file for the
+ * interface, such as PP_AUDIO_INTERFACE found in ppb.audio.h or

[dmichael(do not use this one), 2011/02/11 16:42:04]

ppb.audio.h -> ppb_audio.h

+ * PPB_GRAPHICS_2D_INTERFACE in ppb_graphics_2d.h.
+ *
+ * This value will be NULL if the interface is not supported on the browser.
  */
 typedef const void* (*PPB_GetInterface)(const char* interface_name);
 /**
  * @}
  */
 #endif  /* PPAPI_C_PPB_H_ */