zeroc-ice 3.7.0 → 3.7.1

data/ext/ice/cpp/include/generated/Ice/PluginF.h

@@ -1,13 +1,13 @@
 // **********************************************************************
 //
-// Copyright (c) 2003-2017 ZeroC, Inc. All rights reserved.
+// Copyright (c) 2003-2018 ZeroC, Inc. All rights reserved.
 //
 // This copy of Ice is licensed to you under the terms described in the
 // ICE_LICENSE file included in this distribution.
 //
 // **********************************************************************
 //
-// Ice version 3.7.0
+// Ice version 3.7.1
 //
 // <auto-generated>
 //
@@ -40,7 +40,7 @@
 #   if ICE_INT_VERSION % 100 > 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 0
+#   if ICE_INT_VERSION % 100 < 1
 #       error Ice patch level mismatch!
 #   endif
 #endif
@@ -65,11 +65,14 @@ class PluginManager;
 
 }
 
+/// \cond STREAM
 namespace Ice
 {
 
 }
+/// \endcond
 
+/// \cond INTERNAL
 namespace Ice
 {
 
@@ -78,6 +81,7 @@ using PluginPtr = ::std::shared_ptr<Plugin>;
 using PluginManagerPtr = ::std::shared_ptr<PluginManager>;
 
 }
+/// \endcond
 
 #else // C++98 mapping
 
@@ -85,19 +89,25 @@ namespace Ice
 {
 
 class Plugin;
-ICE_API ::Ice::LocalObject* upCast(::Ice::Plugin*);
-typedef ::IceInternal::Handle< ::Ice::Plugin> PluginPtr;
+/// \cond INTERNAL
+ICE_API LocalObject* upCast(Plugin*);
+/// \endcond
+typedef ::IceInternal::Handle< Plugin> PluginPtr;
 
 class PluginManager;
-ICE_API ::Ice::LocalObject* upCast(::Ice::PluginManager*);
-typedef ::IceInternal::Handle< ::Ice::PluginManager> PluginManagerPtr;
+/// \cond INTERNAL
+ICE_API LocalObject* upCast(PluginManager*);
+/// \endcond
+typedef ::IceInternal::Handle< PluginManager> PluginManagerPtr;
 
 }
 
+/// \cond STREAM
 namespace Ice
 {
 
 }
+/// \endcond
 
 #endif
 

data/ext/ice/cpp/include/generated/Ice/Process.h

@@ -1,13 +1,13 @@
 // **********************************************************************
 //
-// Copyright (c) 2003-2017 ZeroC, Inc. All rights reserved.
+// Copyright (c) 2003-2018 ZeroC, Inc. All rights reserved.
 //
 // This copy of Ice is licensed to you under the terms described in the
 // ICE_LICENSE file included in this distribution.
 //
 // **********************************************************************
 //
-// Ice version 3.7.0
+// Ice version 3.7.1
 //
 // <auto-generated>
 //
@@ -46,7 +46,7 @@
 #   if ICE_INT_VERSION % 100 > 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 0
+#   if ICE_INT_VERSION % 100 < 1
 #       error Ice patch level mismatch!
 #   endif
 #endif
@@ -74,25 +74,75 @@ class ProcessPrx;
 namespace Ice
 {
 
-class ICE_API Process : public virtual ::Ice::Object
+/**
+ * An administrative interface for process management. Managed servers must
+ * implement this interface.
+ *
+ * <p class="Note">A servant implementing this interface is a potential target
+ * for denial-of-service attacks, therefore proper security precautions
+ * should be taken. For example, the servant can use a UUID to make its
+ * identity harder to guess, and be registered in an object adapter with
+ * a secured endpoint.
+ * \headerfile Ice/Ice.h
+ */
+class ICE_API Process : public virtual Object
 {
 public:
 
     using ProxyType = ProcessPrx;
 
-    virtual bool ice_isA(::std::string, const ::Ice::Current&) const override;
-    virtual ::std::vector<::std::string> ice_ids(const ::Ice::Current&) const override;
-    virtual ::std::string ice_id(const ::Ice::Current&) const override;
-
+    /**
+     * Determines whether this object supports an interface with the given Slice type ID.
+     * @param id The fully-scoped Slice type ID.
+     * @param current The Current object for the invocation.
+     * @return True if this object supports the interface, false, otherwise.
+     */
+    virtual bool ice_isA(::std::string id, const Current& current) const override;
+
+    /**
+     * Obtains a list of the Slice type IDs representing the interfaces supported by this object.
+     * @param current The Current object for the invocation.
+     * @return A list of fully-scoped type IDs.
+     */
+    virtual ::std::vector<::std::string> ice_ids(const Current& current) const override;
+
+    /**
+     * Obtains a Slice type ID representing the most-derived interface supported by this object.
+     * @param current The Current object for the invocation.
+     * @return A fully-scoped type ID.
+     */
+    virtual ::std::string ice_id(const Current& current) const override;
+
+    /**
+     * Obtains the Slice type ID corresponding to this class.
+     * @return A fully-scoped type ID.
+     */
     static const ::std::string& ice_staticId();
 
-    virtual void shutdown(const ::Ice::Current&) = 0;
-    bool _iceD_shutdown(::IceInternal::Incoming&, const ::Ice::Current&);
-
-    virtual void writeMessage(::std::string, int, const ::Ice::Current&) = 0;
-    bool _iceD_writeMessage(::IceInternal::Incoming&, const ::Ice::Current&);
-
-    virtual bool _iceDispatch(::IceInternal::Incoming&, const ::Ice::Current&) override;
+    /**
+     * Initiate a graceful shut-down.
+     * @param current The Current object for the invocation.
+     * @see Communicator#shutdown
+     */
+    virtual void shutdown(const Current& current) = 0;
+    /// \cond INTERNAL
+    bool _iceD_shutdown(::IceInternal::Incoming&, const Current&);
+    /// \endcond
+
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param current The Current object for the invocation.
+     */
+    virtual void writeMessage(::std::string message, int fd, const Current& current) = 0;
+    /// \cond INTERNAL
+    bool _iceD_writeMessage(::IceInternal::Incoming&, const Current&);
+    /// \endcond
+
+    /// \cond INTERNAL
+    virtual bool _iceDispatch(::IceInternal::Incoming&, const Current&) override;
+    /// \endcond
 };
 
 }
@@ -100,74 +150,141 @@ public:
 namespace Ice
 {
 
-class ICE_CLASS(ICE_API) ProcessPrx : public virtual ::Ice::Proxy<ProcessPrx, ::Ice::ObjectPrx>
+/**
+ * An administrative interface for process management. Managed servers must
+ * implement this interface.
+ *
+ * <p class="Note">A servant implementing this interface is a potential target
+ * for denial-of-service attacks, therefore proper security precautions
+ * should be taken. For example, the servant can use a UUID to make its
+ * identity harder to guess, and be registered in an object adapter with
+ * a secured endpoint.
+ * \headerfile Ice/Ice.h
+ */
+class ICE_CLASS(ICE_API) ProcessPrx : public virtual Proxy<ProcessPrx, ObjectPrx>
 {
 public:
 
-    void shutdown(const ::Ice::Context& context = Ice::noExplicitContext)
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @see Communicator#shutdown
+     */
+    void shutdown(const Context& context = noExplicitContext)
     {
-        _makePromiseOutgoing<void>(true, this, &Ice::ProcessPrx::_iceI_shutdown, context).get();
+        _makePromiseOutgoing<void>(true, this, &ProcessPrx::_iceI_shutdown, context).get();
     }
 
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @return The future object for the invocation.
+     * @see Communicator#shutdown
+     */
     template<template<typename> class P = ::std::promise>
-    auto shutdownAsync(const ::Ice::Context& context = Ice::noExplicitContext)
+    auto shutdownAsync(const Context& context = noExplicitContext)
         -> decltype(::std::declval<P<void>>().get_future())
     {
-        return _makePromiseOutgoing<void, P>(false, this, &Ice::ProcessPrx::_iceI_shutdown, context);
+        return _makePromiseOutgoing<void, P>(false, this, &ProcessPrx::_iceI_shutdown, context);
     }
 
+    /**
+     * Initiate a graceful shut-down.
+     * @param response The response callback.
+     * @param ex The exception callback.
+     * @param sent The sent callback.
+     * @param context The Context map to send with the invocation.
+     * @return A function that can be called to cancel the invocation locally.
+     * @see Communicator#shutdown
+     */
     ::std::function<void()>
     shutdownAsync(::std::function<void()> response,
                   ::std::function<void(::std::exception_ptr)> ex = nullptr,
                   ::std::function<void(bool)> sent = nullptr,
-                  const ::Ice::Context& context = Ice::noExplicitContext)
+                  const Context& context = noExplicitContext)
     {
-        return _makeLamdaOutgoing<void>(response, ex, sent, this, &Ice::ProcessPrx::_iceI_shutdown, context);
+        return _makeLamdaOutgoing<void>(response, ex, sent, this, &ProcessPrx::_iceI_shutdown, context);
     }
 
-    ICE_MEMBER(ICE_API) void _iceI_shutdown(const ::std::shared_ptr<::IceInternal::OutgoingAsyncT<void>>&, const ::Ice::Context&);
-
-    void writeMessage(const ::std::string& iceP_message, int iceP_fd, const ::Ice::Context& context = Ice::noExplicitContext)
+    /// \cond INTERNAL
+    ICE_MEMBER(ICE_API) void _iceI_shutdown(const ::std::shared_ptr<::IceInternal::OutgoingAsyncT<void>>&, const Context&);
+    /// \endcond
+
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     */
+    void writeMessage(const ::std::string& message, int fd, const Context& context = noExplicitContext)
     {
-        _makePromiseOutgoing<void>(true, this, &Ice::ProcessPrx::_iceI_writeMessage, iceP_message, iceP_fd, context).get();
+        _makePromiseOutgoing<void>(true, this, &ProcessPrx::_iceI_writeMessage, message, fd, context).get();
     }
 
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     * @return The future object for the invocation.
+     */
     template<template<typename> class P = ::std::promise>
-    auto writeMessageAsync(const ::std::string& iceP_message, int iceP_fd, const ::Ice::Context& context = Ice::noExplicitContext)
+    auto writeMessageAsync(const ::std::string& message, int fd, const Context& context = noExplicitContext)
         -> decltype(::std::declval<P<void>>().get_future())
     {
-        return _makePromiseOutgoing<void, P>(false, this, &Ice::ProcessPrx::_iceI_writeMessage, iceP_message, iceP_fd, context);
+        return _makePromiseOutgoing<void, P>(false, this, &ProcessPrx::_iceI_writeMessage, message, fd, context);
     }
 
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param response The response callback.
+     * @param ex The exception callback.
+     * @param sent The sent callback.
+     * @param context The Context map to send with the invocation.
+     * @return A function that can be called to cancel the invocation locally.
+     */
     ::std::function<void()>
-    writeMessageAsync(const ::std::string& iceP_message, int iceP_fd,
+    writeMessageAsync(const ::std::string& message, int fd,
                       ::std::function<void()> response,
                       ::std::function<void(::std::exception_ptr)> ex = nullptr,
                       ::std::function<void(bool)> sent = nullptr,
-                      const ::Ice::Context& context = Ice::noExplicitContext)
+                      const Context& context = noExplicitContext)
     {
-        return _makeLamdaOutgoing<void>(response, ex, sent, this, &Ice::ProcessPrx::_iceI_writeMessage, iceP_message, iceP_fd, context);
+        return _makeLamdaOutgoing<void>(response, ex, sent, this, &ProcessPrx::_iceI_writeMessage, message, fd, context);
     }
 
-    ICE_MEMBER(ICE_API) void _iceI_writeMessage(const ::std::shared_ptr<::IceInternal::OutgoingAsyncT<void>>&, const ::std::string&, int, const ::Ice::Context&);
+    /// \cond INTERNAL
+    ICE_MEMBER(ICE_API) void _iceI_writeMessage(const ::std::shared_ptr<::IceInternal::OutgoingAsyncT<void>>&, const ::std::string&, int, const Context&);
+    /// \endcond
 
+    /**
+     * Obtains the Slice type ID of this interface.
+     * @return The fully-scoped type ID.
+     */
     ICE_MEMBER(ICE_API) static const ::std::string& ice_staticId();
 
 protected:
 
+    /// \cond INTERNAL
     ProcessPrx() = default;
     friend ::std::shared_ptr<ProcessPrx> IceInternal::createProxy<ProcessPrx>();
 
-    ICE_MEMBER(ICE_API) virtual ::std::shared_ptr<::Ice::ObjectPrx> _newInstance() const override;
+    ICE_MEMBER(ICE_API) virtual ::std::shared_ptr<ObjectPrx> _newInstance() const override;
+    /// \endcond
 };
 
 }
 
+/// \cond STREAM
 namespace Ice
 {
 
 }
+/// \endcond
 
+/// \cond INTERNAL
 namespace Ice
 {
 
@@ -175,6 +292,7 @@ using ProcessPtr = ::std::shared_ptr<Process>;
 using ProcessPrxPtr = ::std::shared_ptr<ProcessPrx>;
 
 }
+/// \endcond
 
 #else // C++98 mapping
 
@@ -185,8 +303,10 @@ namespace Ice
 {
 
 class Process;
+/// \cond INTERNAL
 ICE_API void _readProxy(::Ice::InputStream*, ::IceInternal::ProxyHandle< ::IceProxy::Ice::Process>&);
 ICE_API ::IceProxy::Ice::Object* upCast(::IceProxy::Ice::Process*);
+/// \endcond
 
 }
 
@@ -196,20 +316,34 @@ namespace Ice
 {
 
 class Process;
-ICE_API ::Ice::Object* upCast(::Ice::Process*);
-typedef ::IceInternal::Handle< ::Ice::Process> ProcessPtr;
+/// \cond INTERNAL
+ICE_API Object* upCast(Process*);
+/// \endcond
+typedef ::IceInternal::Handle< Process> ProcessPtr;
 typedef ::IceInternal::ProxyHandle< ::IceProxy::Ice::Process> ProcessPrx;
 typedef ProcessPrx ProcessPrxPtr;
-ICE_API void _icePatchObjectPtr(ProcessPtr&, const ::Ice::ObjectPtr&);
+/// \cond INTERNAL
+ICE_API void _icePatchObjectPtr(ProcessPtr&, const ObjectPtr&);
+/// \endcond
 
 }
 
 namespace Ice
 {
 
+/**
+ * Base class for asynchronous callback wrapper classes used for calls to
+ * IceProxy::Ice::Process::begin_shutdown.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_shutdown.
+ */
 class Callback_Process_shutdown_Base : public virtual ::IceInternal::CallbackBase { };
 typedef ::IceUtil::Handle< Callback_Process_shutdown_Base> Callback_Process_shutdownPtr;
 
+/**
+ * Base class for asynchronous callback wrapper classes used for calls to
+ * IceProxy::Ice::Process::begin_writeMessage.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_writeMessage.
+ */
 class Callback_Process_writeMessage_Base : public virtual ::IceInternal::CallbackBase { };
 typedef ::IceUtil::Handle< Callback_Process_writeMessage_Base> Callback_Process_writeMessagePtr;
 
@@ -225,37 +359,82 @@ class ICE_CLASS(ICE_API) Process : public virtual ::Ice::Proxy<Process, ::IcePro
 {
 public:
 
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @see Communicator#shutdown
+     */
     ICE_MEMBER(ICE_API) void shutdown(const ::Ice::Context& context = ::Ice::noExplicitContext)
     {
         end_shutdown(_iceI_begin_shutdown(context, ::IceInternal::dummyCallback, 0, true));
     }
 
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @return The asynchronous result object for the invocation.
+     * @see Communicator#shutdown
+     */
     ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Context& context = ::Ice::noExplicitContext)
     {
         return _iceI_begin_shutdown(context, ::IceInternal::dummyCallback, 0);
     }
 
-    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::CallbackPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Initiate a graceful shut-down.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     * @see Communicator#shutdown
+     */
+    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::CallbackPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_shutdown(::Ice::noExplicitContext, del, cookie);
+        return _iceI_begin_shutdown(::Ice::noExplicitContext, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Context& context, const ::Ice::CallbackPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     * @see Communicator#shutdown
+     */
+    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Context& context, const ::Ice::CallbackPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_shutdown(context, del, cookie);
+        return _iceI_begin_shutdown(context, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Callback_Process_shutdownPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Initiate a graceful shut-down.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     * @see Communicator#shutdown
+     */
+    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Callback_Process_shutdownPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_shutdown(::Ice::noExplicitContext, del, cookie);
+        return _iceI_begin_shutdown(::Ice::noExplicitContext, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Context& context, const ::Ice::Callback_Process_shutdownPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Initiate a graceful shut-down.
+     * @param context The Context map to send with the invocation.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     * @see Communicator#shutdown
+     */
+    ::Ice::AsyncResultPtr begin_shutdown(const ::Ice::Context& context, const ::Ice::Callback_Process_shutdownPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_shutdown(context, del, cookie);
+        return _iceI_begin_shutdown(context, cb, cookie);
     }
 
-    ICE_MEMBER(ICE_API) void end_shutdown(const ::Ice::AsyncResultPtr&);
+    /**
+     * Completes an invocation of begin_shutdown.
+     * @param result The asynchronous result object for the invocation.
+     */
+    ICE_MEMBER(ICE_API) void end_shutdown(const ::Ice::AsyncResultPtr& result);
 
 private:
 
@@ -263,37 +442,88 @@ private:
 
 public:
 
-    ICE_MEMBER(ICE_API) void writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::Context& context = ::Ice::noExplicitContext)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     */
+    ICE_MEMBER(ICE_API) void writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::Context& context = ::Ice::noExplicitContext)
     {
-        end_writeMessage(_iceI_begin_writeMessage(iceP_message, iceP_fd, context, ::IceInternal::dummyCallback, 0, true));
+        end_writeMessage(_iceI_begin_writeMessage(message, fd, context, ::IceInternal::dummyCallback, 0, true));
     }
 
-    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::Context& context = ::Ice::noExplicitContext)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     * @return The asynchronous result object for the invocation.
+     */
+    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::Context& context = ::Ice::noExplicitContext)
     {
-        return _iceI_begin_writeMessage(iceP_message, iceP_fd, context, ::IceInternal::dummyCallback, 0);
+        return _iceI_begin_writeMessage(message, fd, context, ::IceInternal::dummyCallback, 0);
     }
 
-    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::CallbackPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     */
+    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::CallbackPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_writeMessage(iceP_message, iceP_fd, ::Ice::noExplicitContext, del, cookie);
+        return _iceI_begin_writeMessage(message, fd, ::Ice::noExplicitContext, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::Context& context, const ::Ice::CallbackPtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     */
+    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::Context& context, const ::Ice::CallbackPtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_writeMessage(iceP_message, iceP_fd, context, del, cookie);
+        return _iceI_begin_writeMessage(message, fd, context, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::Callback_Process_writeMessagePtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     */
+    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::Callback_Process_writeMessagePtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_writeMessage(iceP_message, iceP_fd, ::Ice::noExplicitContext, del, cookie);
+        return _iceI_begin_writeMessage(message, fd, ::Ice::noExplicitContext, cb, cookie);
     }
 
-    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& iceP_message, ::Ice::Int iceP_fd, const ::Ice::Context& context, const ::Ice::Callback_Process_writeMessagePtr& del, const ::Ice::LocalObjectPtr& cookie = 0)
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param context The Context map to send with the invocation.
+     * @param cb Asynchronous callback object.
+     * @param cookie User-defined data to associate with the invocation.
+     * @return The asynchronous result object for the invocation.
+     */
+    ::Ice::AsyncResultPtr begin_writeMessage(const ::std::string& message, ::Ice::Int fd, const ::Ice::Context& context, const ::Ice::Callback_Process_writeMessagePtr& cb, const ::Ice::LocalObjectPtr& cookie = 0)
     {
-        return _iceI_begin_writeMessage(iceP_message, iceP_fd, context, del, cookie);
+        return _iceI_begin_writeMessage(message, fd, context, cb, cookie);
     }
 
-    ICE_MEMBER(ICE_API) void end_writeMessage(const ::Ice::AsyncResultPtr&);
+    /**
+     * Completes an invocation of begin_writeMessage.
+     * @param result The asynchronous result object for the invocation.
+     */
+    ICE_MEMBER(ICE_API) void end_writeMessage(const ::Ice::AsyncResultPtr& result);
 
 private:
 
@@ -301,11 +531,17 @@ private:
 
 public:
 
+    /**
+     * Obtains the Slice type ID corresponding to this interface.
+     * @return A fully-scoped type ID.
+     */
     ICE_MEMBER(ICE_API) static const ::std::string& ice_staticId();
 
 protected:
+    /// \cond INTERNAL
 
     ICE_MEMBER(ICE_API) virtual ::IceProxy::Ice::Object* _newInstance() const;
+    /// \endcond
 };
 
 }
@@ -315,7 +551,18 @@ protected:
 namespace Ice
 {
 
-class ICE_API Process : public virtual ::Ice::Object
+/**
+ * An administrative interface for process management. Managed servers must
+ * implement this interface.
+ *
+ * <p class="Note">A servant implementing this interface is a potential target
+ * for denial-of-service attacks, therefore proper security precautions
+ * should be taken. For example, the servant can use a UUID to make its
+ * identity harder to guess, and be registered in an object adapter with
+ * a secured endpoint.
+ * \headerfile Ice/Ice.h
+ */
+class ICE_API Process : public virtual Object
 {
 public:
 
@@ -324,46 +571,96 @@ public:
 
     virtual ~Process();
 
-    virtual bool ice_isA(const ::std::string&, const ::Ice::Current& = ::Ice::emptyCurrent) const;
-    virtual ::std::vector< ::std::string> ice_ids(const ::Ice::Current& = ::Ice::emptyCurrent) const;
-    virtual const ::std::string& ice_id(const ::Ice::Current& = ::Ice::emptyCurrent) const;
-
+    /**
+     * Determines whether this object supports an interface with the given Slice type ID.
+     * @param id The fully-scoped Slice type ID.
+     * @param current The Current object for the invocation.
+     * @return True if this object supports the interface, false, otherwise.
+     */
+    virtual bool ice_isA(const ::std::string& id, const Current& current = emptyCurrent) const;
+
+    /**
+     * Obtains a list of the Slice type IDs representing the interfaces supported by this object.
+     * @param current The Current object for the invocation.
+     * @return A list of fully-scoped type IDs.
+     */
+    virtual ::std::vector< ::std::string> ice_ids(const Current& current = emptyCurrent) const;
+
+    /**
+     * Obtains a Slice type ID representing the most-derived interface supported by this object.
+     * @param current The Current object for the invocation.
+     * @return A fully-scoped type ID.
+     */
+    virtual const ::std::string& ice_id(const Current& current = emptyCurrent) const;
+
+    /**
+     * Obtains the Slice type ID corresponding to this class.
+     * @return A fully-scoped type ID.
+     */
     static const ::std::string& ice_staticId();
 
-    virtual void shutdown(const ::Ice::Current& = ::Ice::emptyCurrent) = 0;
+    /**
+     * Initiate a graceful shut-down.
+     * @param current The Current object for the invocation.
+     * @see Communicator#shutdown
+     */
+    virtual void shutdown(const Current& current = emptyCurrent) = 0;
+    /// \cond INTERNAL
     bool _iceD_shutdown(::IceInternal::Incoming&, const ::Ice::Current&);
-
-    virtual void writeMessage(const ::std::string&, ::Ice::Int, const ::Ice::Current& = ::Ice::emptyCurrent) = 0;
+    /// \endcond
+
+    /**
+     * Write a message on the process' stdout or stderr.
+     * @param message The message.
+     * @param fd 1 for stdout, 2 for stderr.
+     * @param current The Current object for the invocation.
+     */
+    virtual void writeMessage(const ::std::string& message, Int fd, const Current& current = emptyCurrent) = 0;
+    /// \cond INTERNAL
     bool _iceD_writeMessage(::IceInternal::Incoming&, const ::Ice::Current&);
+    /// \endcond
 
-    virtual bool _iceDispatch(::IceInternal::Incoming&, const ::Ice::Current&);
+    /// \cond INTERNAL
+    virtual bool _iceDispatch(::IceInternal::Incoming&, const Current&);
+    /// \endcond
 
 protected:
 
-    virtual void _iceWriteImpl(::Ice::OutputStream*) const;
-    virtual void _iceReadImpl(::Ice::InputStream*);
+    /// \cond STREAM
+    virtual void _iceWriteImpl(OutputStream*) const;
+    virtual void _iceReadImpl(InputStream*);
+    /// \endcond
 };
 
+/// \cond INTERNAL
 inline bool operator==(const Process& lhs, const Process& rhs)
 {
-    return static_cast<const ::Ice::Object&>(lhs) == static_cast<const ::Ice::Object&>(rhs);
+    return static_cast<const Object&>(lhs) == static_cast<const Object&>(rhs);
 }
 
 inline bool operator<(const Process& lhs, const Process& rhs)
 {
-    return static_cast<const ::Ice::Object&>(lhs) < static_cast<const ::Ice::Object&>(rhs);
+    return static_cast<const Object&>(lhs) < static_cast<const Object&>(rhs);
 }
+/// \endcond
 
 }
 
+/// \cond STREAM
 namespace Ice
 {
 
 }
+/// \endcond
 
 namespace Ice
 {
 
+/**
+ * Type-safe asynchronous callback wrapper class used for calls to
+ * IceProxy::Ice::Process::begin_shutdown.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_shutdown.
+ */
 template<class T>
 class CallbackNC_Process_shutdown : public Callback_Process_shutdown_Base, public ::IceInternal::OnewayCallbackNC<T>
 {
@@ -381,30 +678,65 @@ public:
     }
 };
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(const IceUtil::Handle<T>& instance, void (T::*cb)(), void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_shutdown<T>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(const IceUtil::Handle<T>& instance, void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_shutdown<T>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(T* instance, void (T::*cb)(), void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_shutdown<T>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(T* instance, void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_shutdown<T>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Type-safe asynchronous callback wrapper class with cookie support used for calls to
+ * IceProxy::Ice::Process::begin_shutdown.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_shutdown.
+ */
 template<class T, typename CT>
 class Callback_Process_shutdown : public Callback_Process_shutdown_Base, public ::IceInternal::OnewayCallback<T, CT>
 {
@@ -422,30 +754,69 @@ public:
     }
 };
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T, typename CT> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(const IceUtil::Handle<T>& instance, void (T::*cb)(const CT&), void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_shutdown<T, CT>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T, typename CT> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(const IceUtil::Handle<T>& instance, void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_shutdown<T, CT>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T, typename CT> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(T* instance, void (T::*cb)(const CT&), void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_shutdown<T, CT>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_shutdown.
+ */
 template<class T, typename CT> Callback_Process_shutdownPtr
 newCallback_Process_shutdown(T* instance, void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_shutdown<T, CT>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Type-safe asynchronous callback wrapper class used for calls to
+ * IceProxy::Ice::Process::begin_writeMessage.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_writeMessage.
+ */
 template<class T>
 class CallbackNC_Process_writeMessage : public Callback_Process_writeMessage_Base, public ::IceInternal::OnewayCallbackNC<T>
 {
@@ -463,30 +834,65 @@ public:
     }
 };
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(const IceUtil::Handle<T>& instance, void (T::*cb)(), void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_writeMessage<T>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(const IceUtil::Handle<T>& instance, void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_writeMessage<T>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(T* instance, void (T::*cb)(), void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_writeMessage<T>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(T* instance, void (T::*excb)(const ::Ice::Exception&), void (T::*sentcb)(bool) = 0)
 {
     return new CallbackNC_Process_writeMessage<T>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Type-safe asynchronous callback wrapper class with cookie support used for calls to
+ * IceProxy::Ice::Process::begin_writeMessage.
+ * Create a wrapper instance by calling ::Ice::newCallback_Process_writeMessage.
+ */
 template<class T, typename CT>
 class Callback_Process_writeMessage : public Callback_Process_writeMessage_Base, public ::IceInternal::OnewayCallback<T, CT>
 {
@@ -504,24 +910,58 @@ public:
     }
 };
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T, typename CT> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(const IceUtil::Handle<T>& instance, void (T::*cb)(const CT&), void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_writeMessage<T, CT>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T, typename CT> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(const IceUtil::Handle<T>& instance, void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_writeMessage<T, CT>(instance, 0, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param cb The success method of the callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T, typename CT> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(T* instance, void (T::*cb)(const CT&), void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {
     return new Callback_Process_writeMessage<T, CT>(instance, cb, excb, sentcb);
 }
 
+/**
+ * Creates a callback wrapper instance that delegates to your object.
+ * Use this overload when your callback methods receive a cookie value.
+ * @param instance The callback object.
+ * @param excb The exception method of the callback object.
+ * @param sentcb The sent method of the callback object.
+ * @return An object that can be passed to an asynchronous invocation of IceProxy::Ice::Process::begin_writeMessage.
+ */
 template<class T, typename CT> Callback_Process_writeMessagePtr
 newCallback_Process_writeMessage(T* instance, void (T::*excb)(const ::Ice::Exception&, const CT&), void (T::*sentcb)(bool, const CT&) = 0)
 {