zeroc-ice-x64-mingw 3.6.2 → 3.6.3

data/slice/Ice/LocalException.ice

@@ -915,7 +915,7 @@ local exception NoObjectFactoryException extends MarshalException
  * This can happen if client and server are compiled with mismatched Slice
  * definitions or if a class of the wrong type is passed as a parameter
  * or return value using dynamic invocation. This exception can also be
- * raised if {@link IceStorm} is used to send Slice class instances and
+ * raised if IceStorm is used to send Slice class instances and
  * an operation is subscribed to the wrong topic.
  *
  **/

data/slice/Ice/Locator.ice

@@ -84,7 +84,9 @@ interface Locator
 {
     /**
      *
-     * Find an object by identity and return its proxy.
+     * Find an object by identity and return a proxy that contains
+     * the adapter ID or endpoints which can be used to access the
+     * object.
      *
      * @param id The identity.
      *
@@ -99,8 +101,8 @@ interface Locator
 
     /**
      *
-     * Find an adapter by id and return its proxy (a dummy direct
-     * proxy created by the adapter).
+     * Find an adapter by id and return a proxy that contains
+     * its endpoints.
      *
      * @param id The adapter id.
      *

data/slice/Ice/Metrics.ice

@@ -269,7 +269,7 @@ class ThreadMetrics extends Metrics
      *
      * The number of threads which are currently performing other
      * activities. These are all other that are not counted with
-     * {@link inUseForUser} or {@link inUseForIO}, such as DNS
+     * {@link #inUseForUser} or {@link #inUseForIO}, such as DNS
      * lookups, garbage collection).
      *
      **/

data/slice/Ice/ObjectFactory.ice

@@ -23,8 +23,6 @@ module Ice
  * must be implemented by the application writer, and registered
  * with the communicator.
  *
- * @see Freeze
- *
  **/
 local interface ObjectFactory
 {

data/slice/Ice/RemoteLogger.ice

@@ -26,30 +26,30 @@ module Ice
 enum LogMessageType
 {
     /**
-     * 
+     *
      * The {@link Logger} received a print message.
-     * 
+     *
      **/
     PrintMessage,
 
     /**
-     * 
+     *
      * The {@link Logger} received a trace message.
-     * 
+     *
      **/
     TraceMessage,
 
     /**
-     * 
+     *
      * The {@link Logger} received a warning message.
-     * 
+     *
      **/
     WarningMessage,
 
     /**
-     * 
+     *
      * The {@link Logger} received an error message.
-     * 
+     *
      **/
     ErrorMessage
 };
@@ -71,32 +71,32 @@ sequence<LogMessageType> LogMessageTypeSeq;
 struct LogMessage
 {
     /**
-     * 
+     *
      * The type of message sent to the {@link Logger}.
-     * 
+     *
      **/
     LogMessageType type;
-    
+
     /**
-     * 
+     *
      * The date and time when the {@link Logger} received this message, expressed
      * as the number of microseconds since the Unix Epoch (00:00:00 UTC on 1 January 1970)
-     * 
+     *
      **/
     long timestamp;
 
     /**
-     * 
-     * For a message of type trace, the trace category of this log message; 
+     *
+     * For a message of type trace, the trace category of this log message;
      * otherwise, the empty string.
-     * 
+     *
      **/
     string traceCategory;
 
      /**
-     * 
+     *
      * The log message itself.
-     * 
+     *
      **/
     string message;
 };
@@ -123,24 +123,24 @@ interface RemoteLogger
     /**
      *
      * init is called by {@link LoggerAdmin#attachRemoteLogger} when a
-     * RemoteLogger proxy is attached. 
+     * RemoteLogger proxy is attached.
      *
      * @param prefix The prefix of the associated local {@link Logger}
-     * 
+     *
      * @param logMessages Old log messages generated before "now".
      *
      * @see LoggerAdmin#attachRemoteLogger
      *
      *
      **/
-    void init(string prefix, LogMessageSeq logMessages); 
+    void init(string prefix, LogMessageSeq logMessages);
+
 
-    
     /**
      *
      * Log a {@link LogMessage}. Note that log may be called by {@link LoggerAdmin}
      * before {@link #init}.
-     * 
+     *
      * @param message The message to log.
      *
      * @see Logger
@@ -163,7 +163,7 @@ exception RemoteLoggerAlreadyAttachedException
 
 /**
  *
- * The interface of the admin object that allows an Ice application the attach its 
+ * The interface of the admin object that allows an Ice application the attach its
  * {@link RemoteLogger} to the {@link Logger} of this admin object's Ice communicator.
  *
  **/
@@ -171,8 +171,8 @@ interface LoggerAdmin
 {
     /**
      *
-     * attachRemoteLogger is called to attach a {@link RemoteLogger} object to 
-     * the local {@link Logger}. 
+     * attachRemoteLogger is called to attach a {@link RemoteLogger} object to
+     * the local {@link Logger}.
      * attachRemoteLogger calls init on the provided {@link RemoteLogger} proxy.
      *
      * @param prx A proxy to the remote logger.
@@ -182,9 +182,9 @@ interface LoggerAdmin
      *
      * @param traceCategories The categories of traces that the remote logger wishes to receive.
      * This parameter is ignored if messageTypes is not empty and does not include trace.
-     * An empty list means no filtering (send all trace categories). 
+     * An empty list means no filtering (send all trace categories).
      *
-     * @param messageMax The maximum number of log messages (of all types) to be provided 
+     * @param messageMax The maximum number of log messages (of all types) to be provided
      * to {@link RemoteLogger#init}. A negative value requests all messages available.
      *
      * @throws RemoteLoggerAlreadyAttachedException Raised if this remote logger is already
@@ -192,7 +192,7 @@ interface LoggerAdmin
      *
      **/
     void attachRemoteLogger(RemoteLogger* prx, LogMessageTypeSeq messageTypes, StringSeq traceCategories,
-                            int messageMax) 
+                            int messageMax)
         throws RemoteLoggerAlreadyAttachedException;
 
     /**
@@ -211,14 +211,14 @@ interface LoggerAdmin
      *
      * getLog retrieves log messages recently logged.
      *
-     * @param messageTypes The list of message types that the caller wishes to receive. 
+     * @param messageTypes The list of message types that the caller wishes to receive.
      * An empty list means no filtering (send all message types).
      *
      * @param traceCategories The categories of traces that caller wish to receive.
      * This parameter is ignored if messageTypes is not empty and does not include trace.
-     * An empty list means no filtering (send all trace categories). 
+     * An empty list means no filtering (send all trace categories).
      *
-     * @param messageMax The maximum number of log messages (of all types) to be returned. 
+     * @param messageMax The maximum number of log messages (of all types) to be returned.
      * A negative value requests all messages available.
      *
      * @param prefix The prefix of the associated local {@link Logger}.

data/slice/Ice/Router.ice

@@ -31,6 +31,9 @@ interface Router
      * Get the router's client proxy, i.e., the proxy to use for
      * forwarding requests from the client to the router.
      *
+     * If a null proxy is returned, the client will forward requests
+     * to the router's endpoints.
+     *
      * @return The router's client proxy.
      *
      **/

data/slice/IceGrid/Session.ice

@@ -88,7 +88,8 @@ interface Session extends Glacier2::Session
 
     /**
      *
-     * Release an object.
+     * Release an object that was allocated using <tt>allocateObjectById</tt> or
+     * <tt>allocateObjectByType</tt>.
      *
      * @param id The identity of the object to release.
      *
@@ -99,9 +100,6 @@ interface Session extends Glacier2::Session
      * released. This might happen if the object isn't allocatable or
      * isn't allocated by the session.
      *
-     * @see #allocateObjectById
-     * @see #allocateObjectByType
-     *
      **/
     void releaseObject(Ice::Identity id)
         throws ObjectNotRegisteredException, AllocationException;
@@ -109,14 +107,12 @@ interface Session extends Glacier2::Session
     /**
      *
      * Set the allocation timeout. If no objects are available for an
-     * allocation request, the request will hang for the duration of
-     * this timeout.
+     * allocation request, a call to <tt>allocateObjectById</tt> or
+     * <tt>allocateObjectByType</tt> will block for the duration of this
+     * timeout.
      *
      * @param timeout The timeout in milliseconds.
      *
-     * @see #allocateObjectById
-     * @see #allocateObjectByType
-     *
      **/
     idempotent void setAllocationTimeout(int timeout);
 };

data/slice/IceLocatorDiscovery/IceLocatorDiscovery.ice

@@ -25,9 +25,9 @@ module IceLocatorDiscovery
  * are searching for Ice locators. Ice locator implementations invoke
  * on this interface to provide their locator proxy.
  *
- * @see Locator
+ * @see Ice.Locator
  * @see Lookup
- * 
+ *
  **/
 interface LookupReply
 {
@@ -47,14 +47,14 @@ interface LookupReply
  * The Ice lookup interface is implemented by Ice locator
  * implementations and can be used by clients to find available Ice
  * locators on the network.
- * 
- * Ice locator implementations provide a well-known `Ice/LocatorLookup' 
- * object accessible through UDP multicast. Clients typically make a 
+ *
+ * Ice locator implementations provide a well-known `Ice/LocatorLookup'
+ * object accessible through UDP multicast. Clients typically make a
  * multicast findLocator request to find the locator proxy.
  *
- * @see Locator
+ * @see Ice.Locator
  * @see LookupReply
- * 
+ *
  **/
 interface Lookup
 {

data/slice/IcePatch2/FileServer.ice

@@ -16,9 +16,9 @@
 
 /**
  *
- * IcePatch can be used to update file hiearchies in a simple and
+ * IcePatch can be used to update file hierarchies in a simple and
  * efficient manner. Checksums ensure file integrity, and data is
- * compressed before download.
+ * compressed before downloading.
  *
  **/
 ["objc:prefix:ICEPATCH2"]
@@ -35,8 +35,7 @@ sequence<Ice::ByteSeq> ByteSeqSeq;
 
 /**
  *
- * The <tt>partition</tt> argument for
- * {@link FileServer#getFileInfoSeq} was not in the range 0-255.
+ * A <tt>partition</tt> argument for was not in the range 0-255.
  *
  **/
 exception PartitionOutOfRangeException
@@ -45,8 +44,7 @@ exception PartitionOutOfRangeException
 
 /**
  *
- * This exception is raised if {@link FileServer#getFileCompressed} cannot read the
- * contents of a file.
+ * This exception is raised if a file's contents cannot be read.
  *
  **/
 exception FileAccessException
@@ -61,11 +59,8 @@ exception FileAccessException
 
 /**
  *
- * This exception is raised if {@link FileServer#getFileCompressed} or
- * {@link FileServer#getFileInfoSeq} try to operate in files with size
- * large than 2.1 GB, these operations does not support working with
- * large files instead {@link FileServer#getLargeFileCompressed} and 
- * {@link FileServer#getLargeFileInfoSeq} must be used.
+ * This exception is raised if an operation tries to use a file whose size is
+ * larger than 2.1 GB. Use the "large" versions of the operations instead.
  *
  **/
 exception FileSizeRangeException extends FileAccessException
@@ -81,19 +76,18 @@ interface FileServer
 {
     /**
      *
-     * Return the {@link FileInfoSeq} for the specified partition. If the
-     * partion number is out of range, the operation throws
+     * Return file information for the specified partition.
      * 
-     * <p class="Deprecated"> This operation is deprecated, and only keep for
-     * compativility with old Ice clients (older than version 3.6).
-     *
-     * {@link PartitionOutOfRangException}.
+     * <p class="Deprecated"> This operation is deprecated and only present for
+     * compatibility with old Ice clients (older than version 3.6).
      *
      * @param partition The partition number in the range 0-255.
      *
-     * @return A sequence containing the {@link FileInfo} structures for
-     * files in the specified partition.
+     * @return A sequence containing information about the files in the
+     * specified partition.
      *
+     * @throws PartitionOutOfRangeException If the partition number is out of range.
+     * @throws FileSizeRangeException If a file is larger than 2.1GB.
      **/
     ["deprecate:getFileInfoSeq() is deprecated, use getLargeFileInfoSeq() instead.",
      "nonmutating", "cpp:const"] idempotent FileInfoSeq getFileInfoSeq(int partition)
@@ -101,15 +95,14 @@ interface FileServer
         
     /**
      *
-     * Return the {@link FileInfoSeq} for the specified partition. If the
-     * partion number is out of range, the operation throws
-     * {@link PartitionOutOfRangException}.
+     * Returns file information for the specified partition.
      *
      * @param partition The partition number in the range 0-255.
      *
-     * @return A sequence containing the {@link FileInfo} structures for
-     * files in the specified partition.
+     * @return A sequence containing information about the files in the
+     * specified partition.
      *
+     * @throws PartitionOutOfRangeException If the partition number is out of range.
      **/
     ["nonmutating", "cpp:const"] idempotent LargeFileInfoSeq getLargeFileInfoSeq(int partition)
         throws PartitionOutOfRangeException;
@@ -139,13 +132,11 @@ interface FileServer
 
     /**
      *
-     * Read the specified file. If the read operation fails, the
-     * operation throws {@link FileAccessException}. This operation may only
-     * return fewer bytes than requested in case there was an
-     * end-of-file condition.
+     * Read the specified file. This operation may only return fewer bytes than requested
+     * in case there was an end-of-file condition.
      *
-     * <p class="Deprecated"> This operation is deprecated, and only keep for
-     * compativility with old Ice clients (older than version 3.6).
+     * <p class="Deprecated"> This operation is deprecated and only present for
+     * compatibility with old Ice clients (older than version 3.6).
      *
      * @param path The pathname (relative to the data directory) for
      * the file to be read.
@@ -156,6 +147,9 @@ interface FileServer
      *
      * @return A sequence containing the compressed file contents.
      *
+     * @throws FileAccessException If an error occurred while trying to read the file.
+     * @throws FileSizeRangeException If a file is larger than 2.1GB.
+     *
      **/
     ["deprecate:getFileCompressed() is deprecated, use getLargeFileCompressed() instead.",
      "amd", "nonmutating", "cpp:const", "cpp:array"] 
@@ -164,10 +158,8 @@ interface FileServer
         
     /**
      *
-     * Read the specified file. If the read operation fails, the
-     * operation throws {@link FileAccessException}. This operation may only
-     * return fewer bytes than requested in case there was an
-     * end-of-file condition.
+     * Read the specified file. This operation may only return fewer bytes than requested
+     * in case there was an end-of-file condition.
      *
      * @param path The pathname (relative to the data directory) for
      * the file to be read.
@@ -178,6 +170,8 @@ interface FileServer
      *
      * @return A sequence containing the compressed file contents.
      *
+     * @throws FileAccessException If an error occurred while trying to read the file.
+     *
      **/
     ["amd", "nonmutating", "cpp:const", "cpp:array"] 
     idempotent Ice::ByteSeq getLargeFileCompressed(string path, long pos, int num)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zeroc-ice-x64-mingw
 version: !ruby/object:Gem::Version
-  version: 3.6.2
+  version: 3.6.3
 platform: ruby
 authors:
 - ZeroC, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-04 00:00:00.000000000 Z
+date: 2016-10-05 00:00:00.000000000 Z
 dependencies: []
 description: |
   The Internet Communications Engine (Ice) provides a robust, proven
@@ -203,7 +203,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: ZeroC Ice for Ruby