PPAPI: Move PPB_Console out of dev.

ppapi/cpp/instance.h

 // Copyright (c) 2012 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.
 
 #include <map>
 #include <string>
 
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/ppb_console.h"
 #include "ppapi/cpp/instance_handle.h"
 #include "ppapi/cpp/view.h"
 
 // Windows defines 'PostMessage', so we have to undef it.
 #ifdef PostMessage
 #undef PostMessage
 #endif
 
 struct PP_InputEvent;
 
@@ skipping 438 matching lines @@
   /// Refer to HandleMessage() for receiving events from JavaScript.
   ///
   /// @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);
 
   /// @}
 
+  // @{
+  /// @name PPB_Console methods for logging to the console:
+
+  /// See PPB_Console.Log.
+  void LogToConsole(PP_LogLevel level, const Var& value);
+
+  /// See PPB_Console.LogWithSource.
+  void LogToConsoleWithSource(PP_LogLevel level,
+                              const Var& source,
+                              const Var& value);

[dmichael (off chromium), 2012/12/04 15:32:33]

For public APIs, we try to keep the documentation complete and up-to-date in C++
and C, rather than sending developers all over the code to find documentation.
Can you put the C doc here and reword as necessary, instead of refering to
PPB_Console?

[Nick Bray (chromium), 2012/12/04 23:14:56]

Done.

+
+  // @}
+
   /// AddPerInstanceObject() associates an instance with an interface,
   /// 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.
@@ skipping 48 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_