Cleaning up and adding new docs

ppapi/c/ppb.h

Index: ppapi/c/ppb.h
===================================================================
--- ppapi/c/ppb.h	(revision 74025)
+++ ppapi/c/ppb.h	(working copy)
@@ -7,8 +7,7 @@
 
 /**
  * @file
- * Defines the API ...
- *
+ * This file defines a function pointer type for the PPB_GetInterface function.
  */
 
 /**
@@ -17,8 +16,15 @@
  */
 
 /**
- * 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);
 /**