New C++ Docs.

ppapi/cpp/module.h

-// Copyright (c) 2010 The Chromium Authors. All rights reserved.
+// 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_MODULE_H_
 #define PPAPI_CPP_MODULE_H_
 
 #include <map>
 #include <string>
 
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_module.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ppapi/c/ppb.h"
 #include "ppapi/c/ppb_core.h"
 #include "ppapi/cpp/core.h"
 
+
+/// @file
+/// This file defines a Module object which uniquely identifies the module

[dmichael (off chromium), 2011/08/03 15:50:49]

Maybe keep it simple:
'This file defines the Module class.'

The Module should have some class documentation, maybe something like this
(stolen from sdk hello_world.cc):
The Module class.  The browser calls the CreateInstance() method to create
an instance of your module on the web page.  The browser creates a new
instance for each <embed> tag with
<code>type="application/x-nacl"</code>.

[jond, 2011/08/03 20:15:08]

Done.

+/// or .nexe.
 namespace pp {
 
 class Instance;
 
 class Module {
  public:
   typedef std::map<PP_Instance, Instance*> InstanceMap;
 
   // You may not call any other PP functions from the constructor, put them
   // in Init instead. Various things will not be set up until the constructor
@@ skipping 90 matching lines @@
 
   // All additional interfaces this plugin can handle as registered by
   // AddPluginInterface.
   typedef std::map<std::string, const void*> InterfaceMap;
   InterfaceMap additional_interfaces_;
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_MODULE_H_