Minor changes as per Christians most-recent review of the docs.

ppapi/cpp/instance.h

 // Copyright (c) 2011 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_CPP_INSTANCE_H_
 #define PPAPI_CPP_INSTANCE_H_
 
 /// @file
 /// This file defines the C++ wrapper for an instance.
 
@@ skipping 439 matching lines @@
   ///
   /// @param[in] message A <code>Var</code> containing the data to be sent to
   /// JavaScript. Message can have a numeric, boolean, or string value; arrays
   /// and dictionaries are not yet supported. Ref-counted var types are copied,
   /// and are therefore not shared between the instance and the browser.
   void PostMessage(const Var& message);
 
   /// @}
 
   /// AddPerInstanceObject() associates an instance with an interface,
-  /// creating an object... {PENDING: clarify!}
+  /// creating an object.
   ///
   /// Many optional interfaces are associated with a plugin instance. For
   /// example, the find in PPP_Find interface receives updates on a per-instance
   /// basis. This "per-instance" tracking allows such objects to associate
   /// themselves with an instance as "the" handler for that interface name.
   ///
   /// In the case of the find example, the find object registers with its
   /// associated instance in its constructor and unregisters in its destructor.
   /// Then whenever it gets updates with a PP_Instance parameter, it can
   /// map back to the find object corresponding to that given PP_Instance by
   /// calling GetPerInstanceObject.
   ///
   /// This lookup is done on a per-interface-name basis. This means you can
   /// only have one object of a given interface name associated with an
   /// instance.
   ///
   /// If you are adding a handler for an additional interface, be sure to
   /// register with the module (AddPluginInterface) for your interface name to
   /// get the C calls in the first place.
   ///
   /// Refer to RemovePerInstanceObject() and GetPerInstanceObject() for further
   /// information.
   ///
   /// @param[in] interface_name The name of the interface to associate with the
   /// instance
   /// @param[in] object
   void AddPerInstanceObject(const std::string& interface_name, void* object);
 
-  /// {PENDING: summarize Remove method here}
+  // {PENDING: summarize Remove method here}
   ///
   /// Refer to AddPerInstanceObject() for further information.
   ///
   /// @param[in] interface_name The name of the interface to associate with the
   /// instance
   /// @param[in] object
   void RemovePerInstanceObject(const std::string& interface_name, void* object);
 
   /// Look up an object previously associated with an instance. Returns NULL
   /// if the instance is invalid or there is no object for the given interface
@@ skipping 10 matching lines @@
  private:
   PP_Instance pp_instance_;
 
   typedef std::map<std::string, void*> InterfaceNameToObjectMap;
   InterfaceNameToObjectMap interface_name_to_objects_;
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_INSTANCE_H_