ICE 3.4.2

[php5-ice-freebsdport.git] / CHANGES

======================================================================
CHANGES for Ice 3.4.2
======================================================================

The entries below contain brief descriptions of the changes in a
release, in no particular order. Some of the entries reflect
significant new additions, while others represent minor corrections.
Although this list is not a comprehensive report of every change we
made in a release, it does provide details on the changes we feel
Ice users might need to be aware of.

We recommend that you use the release notes included in your Ice
distribution as a guide for migrating your applications to this
release, and the Ice manual for complete details on a particular
aspect of Ice.

Note that this file only includes changes since Ice 3.2.1. For the
change history of prior releases, refer to the CHANGES file in the
subdirectory of each language mapping (e.g., cpp/CHANGES).


======================================================================
Changes since version 3.4.1
======================================================================


General Changes
===============

- The operation mode sent over the wire for the Object operations
  ice_ping, ice_isA, ice_ids, and ice_id should be Nonmutating, but
  the language mappings were inconsistent in this respect. All
  language mappings now send the correct mode.

- Fixed a bug where under certain circumstances, Ice would
  indefinitely re-try to add a proxy to the Glacier2 routing table.

- Improved queuing of Glacier2 requests to the client to not invoke
  requests if the client connection already has requests pending for
  send. Instead, Glacier2 waits for the pending requests to be
  sent. This allow request overriding to occur more often when the
  client connection is slow.

- Fixed bug where an IceGrid node or registry could hang for a long
  time on startup if some IceGrid registry replicas weren't reachable.

- Added throwLocalException method to the Ice AsyncResult class. If
  the request fails with a local exception, this method throws the
  local exception.

- Fixed a bug that caused a crash if a timeout occurs while sending
  an AMI request and if automatic retry is enabled (the default).

- It is now possible to use a constant as the default value for a data
  member. For example:

  // Slice
  const int MIN = 1;

  struct Info
  {
      int size = MIN;
  };

  It is also possible for a constant to refer to another constant:

  // Slice
  const int MAXIMUM_SIZE = 100;
  const int DEFAULT_SIZE = MAXIMUM_SIZE;


C++ Changes
===========

- Fixed a bug in the Linux epoll selector implementation that could
  cause hangs when using the thread pool serialization mode.

- Fixed a memory leak in IceSSL on Windows.

- Fixed a bug in the generated code for a Slice structure containing
  at least one data member that declares a default value. The
  constructors were not being exported correctly in this case.

- Fixed a bug where the IceUtil::Timer thread could die in case very
  large delays were specified.

- Removed extra include/IceGrid/Perf.h file.


Java Changes
============

- Added support for Android.

- Added overloaded constructors for user and system exceptions that
  accept a Throwable argument.

- Added an ice_staticId method to generated PrxHelper classes.

- Fixed a bug in slice2java in which a floating point default value
  could cause a compile error.

- Fixed a bug where Ice.ServerIdleTime wouldn't consistently shutdown
  servers after the given period of inactivity.


C# Changes
==========

- Added support for the .NET Compact Framework.

- Added demo/Ice/compact, which is a simple graphical client that uses
  Ice for .NET Compact Framework.

- Fixed bugs in the generated code that caused naming conflicts when
  using a Slice module named 'System'.

- Added an ice_staticId method to generated PrxHelper classes.

- Fixed a bug in the generated code when a Slice class uses the
  property mapping and declares default values for its members.


Python Changes
==============

- Fixed bug where None was not recognized as a keyword.


Ruby Changes
============

- Fixed a bug in the Ice extension that would cause an ArgumentError
  to be raised when attempting to print a byte sequence whose value is
  a string that contains null bytes.


PHP Changes
===========

- Fixed a bug that caused 'undefined symbol IcePHP__t_XXX' errors when
  Ice.php or a generated file is included from a non-global scope.

- slice2php now generates 'require_once' statements corresponding to
  Slice #include directives, replacing the 'require' statements used
  in previous releases.

- Fixed a bug in the Ice extension that caused Ice-related INI
  settings to be ignored.


Visual Studio Add-in Changes
============================

- Fixed a bug that prevented the Add-in from automatically compiling
  Slice files when using a non-English version of Visual Studio.

- Improved the layout and wording of the Ice Configuration dialogs.

- Added $(IceHome) macro to VS 2008 project configurations.

- Changed C++ project configurations to use $(IceHome) macro in
  configuration settings.

- Removed Ice Home field from "Ice Configuration" dialog. Projects
  now always use the Ice installation corresponding to the location
  of the add-in DLL.

- Fixed issues that prevented the use of solution folders in Ice
  projects.

- Fixed an issue that caused the add-in to not work when using
  Visual Studio 2010 and "Solution Navigator".

- Added a check to prevent incorrect Runtime library usage in C++
  projects.

- Added support for .NET Smart Device project types used by the .NET
  Compact Framework.

- Improved add-in output messages.

- Fixed an issue that produced a deadlock in Visual Studio when
  Slice compiler output was large enough to fill the output buffer.

- Fixed support for parallel builds. The Slice compiler was run
  several times, once for each parallel build. Now the Slice
  compiler is run only once, before all parallel builds begin.

- Fixed an issue that could cause errors with Visual Studio if a
  Slice file was saved while the project was building.

- Fixed the add-in to work properly when --header-ext and
  --source-ext are present in Extra Compiler Options.

- Fixed the add-in to support building Freeze demos without the need
  to set environment variables.

- Fixed the add-in to always open generated files as read only;
  previously the generated files were not opened read only until the
  first project build.

- Added support for setting the output directory for generated files,
  making the add-in more VCS friendly.

- Added support for .NET DEVPATH.

- Added support for canceling changes in configuration dialogs. All
  the configuration dialogs now have OK, Cancel, Apply buttons with
  the standard semantics.

- Added warnings to prevent incorrect options from being entered in
  Extra Compiler Options.

- Added a timestamp to Slice build output, which is only printed when
  the trace level is Debug.

- The add-in now supports command-line builds.

- The add-in now avoids making extraneous changes to projects that
  could result in merge issues when projects are in a shared
  development.

- The add-in no longer overrides the debug environment setting for
  PATH, but rather appends appropriately.

- On the loss of focus when adding an include directory in the Slice
  Include Path, the addition is now saved rather than lost.

- Fixed an issue where moving a Slice-generated file to a filter so
  that it would be ignored by source control did not always work
  because the generated files could be moved back into the regular
  Source Files list by a build.

- Improved the tracing output generated by the add-in and changed
  the tracing options.


======================================================================
Changes since version 3.4.0
======================================================================


General Changes
===============

- Added the new property Freeze.DbEnv.<db>.LockFile and changed the
  dumpdb and transformdb utilities so that they can be run safely on
  a database environment that is currently open in another process.

- Changed the Glacier2 helper classes to cache the client category.

- Added the ability to use underscores in Slice identifiers. See the
  release notes for important information on this change.

- Added the setConnectContext method to Glacier2.SessionFactoryHelper,
  which allows an application to provide a request context to be used
  when creating a Glacier2 session. (Java and C#)

- Fixed IceGrid bug where node observers would not be notified when a
  server is re-enabled after it has been updated and if the server was
  disabled following an activation failure.

- Fixed a bug in the Glacier2.SessionFactoryHelper class (Java/C#) in
  which the getPort() method would return an incorrect default port if
  no port was configured.


C++ Changes
===========

- Fixed a bug in slice2cpp in which streaming code was not generated
  properly for types in nested modules.

- slice2cpp now generates a "one-shot" constructor for a Slice
  structure if at least one of its members has a default value.

- Fixed a bug in slice2cpp so that asynchronous "end_op" methods are
  now exported properly.

- Fixed a bug in slice2cpp that would generate invalid code for a
  Slice exception when the --stream option was not used.

- Fixed compatibility issues with OpenSSL 1.0.

- Fixed a bug in slice2cpp that would cause invalid code to be
  generated for a nested Slice definition when the --stream option was
  used.

- Fixed a bug in Freeze that disabled automatic log deletion.


Java Changes
============

- Fixed an issue in which intensive use of Freeze or the stream API
  could cause an OutOfMemoryError. Note that Freeze maps must be
  regenerated with slice2freezej to incorporate this fix.

- Fixed a bug in the Slice2Java ant task in which duplicate Slice
  files could be passed to slice2java. Also fixed a bug in slice2java
  that caused the translator to fail if a duplicate file was passed
  on the command line.

- Fixed race condition which could cause the thread pool selector
  thread to go away (causing the thread pool to not dispatch further
  incoming messages).

- Deprecated Ice.AsyncCallback. To use the generic asynchronous
  callback facility, applications should derive their classes from
  Ice.Callback.

- The size method on a Freeze.Map and on the value of an indexed 
  submap now use the current transaction associated with the
  connection, if any.


C# Changes
==========

- Fixed a bug in the generated code that prevented sequences from
  being marshaled using the stream API if the sequences used generic
  collection types.

- Fixed a bug in the IceSSL plug-in that could incorrectly report a
  certificate verification failure when the IceSSL.CheckCertName
  property is enabled.


Python Changes
==============

- Fixed a bug in which destroyed Communicator instances were not being
  garbage collected.

- Fixed a bug in Ice.Application in which the exit status was not
  properly returned from main().


======================================================================
Changes since version 3.4b
======================================================================


General Changes
===============

- Added ability to define default values for Slice data members. For
  example, you can write:

  // Slice
  class C
  {
      int i = 2;
      string name = "John";
  };

- Fixed IceGrid bug where the IceGrid node would disconnect from the
  registry if the clock was moved backward.

- Fixed hang in slice2cs and slice2py that would occur if a comment
  contained a '<' with no closing '>'.

- Fixed a bug in the Java and C# stream classes where readString() and
  readBlob() were not checking the size before allocating memory.

- Fixed source files to have consistent end of line terminators.

- Fixed the Ice.initialize(), Ice.initialize(Ice.InitializationData)
  and Ice.createProperties() overloads in Python, Ruby and PHP to
  match the C++, .NET and Java behavior. These overloads no longer
  read the ICE_CONFIG environment variable.

- Fixed IceGrid bug where updating an application could cause a
  temporary hang if a server deactivation hanged during the update.


C++ Changes
===========

- Renamed the createIceStringConverter function back to
  createStringConverter for compatibility with previous releases.


Python Changes
==============

- Fixed a code generation bug that could lead to undefined Slice
  types, depending on the order in which the generated code was
  imported.

- Changed the Python mapping for long integer constants so that 64-bit
  values are no longer generated as strings.


Ruby Changes
============

- Fixed a compilation error when using Ruby 1.8.7 (patch level >=
  248).


======================================================================
Changes since version 3.3.1
======================================================================


General Changes
===============

These entries apply to all relevant language mappings unless otherwise
noted.

- Added a new asynchronous method invocation (AMI) facility for C++,
  C#, Java, and Python. The previous API is now deprecated.

- Added the ability to invoke flushBatchRequests asynchronously on a
  communicator or connection.

- The Ice extension for Visual Studio is now included in the Ice
  distribution. The source code for the extension can be found in the
  vsplugin subdirectory of the source distribution. Note that the
  extension no longer supports Visual Studio 2005.

- Added a cloneWithPrefix operation to the Logger interface.

- Added a removeServantLocator operation to the ObjectAdapter
  interface.

- The translators now include a comment at the beginning of each
  generated file to indicate that the file is machine-generated.
  This is particularly useful for tools such as StyleCop.

- The IceGrid graphical administration tool now allows you to filter
  the live deployment for a particular application.

- Added the ability to query an IceGrid node to determine the number
  of CPU sockets on its host machine. Currently this only works for
  Windows Vista (or later) and native (non-VM) Linux. You can also
  manually configure the number of CPU sockets.

- Freeze now uses file locks to prevent multiple processes from
  opening the same database environment.

- Added new utility classes to simplify the use of Glacier2. The
  Glacier2::Application class extends Ice::Application to add support
  for keeping a Glacier2 session alive and automatically restarting it
  when necessary. For Java and C#, helper classes are also provided
  for use in graphical programs. See the Ice manual for more
  information.

- Added new InputStream::readAndCheckSeqSize method to read and check
  the size of a sequence. The check ensures the sequence size is
  consistent with the stream buffer size. This is useful to prevent
  over-allocating memory for the sequence if the input stream data
  cannot be trusted.

- When using the system logger (enabled when Ice.UseSyslog is set), it
  is now possible to set the facility via the Ice.SyslogFacility
  property. The default value is LOG_USER.

- It is now legal to pass an empty name to createObjectAdapterWithRouter
  and createObjectAdapterWithEndpoints. If so, a UUID will be used for
  the object adapter's name.

- Added support for dispatching servant invocations and AMI callbacks
  in application-specific threads (e.g., in a GUI-safe thread). The
  application needs to implement the Ice::Dispatcher interface and
  initialize the communicator appropriately to use this dispatcher
  implementation. See the Ice manual for more information.

- icegridadmin now clears the user-supplied password after use.

- icegridadmin now correctly handles EOF when reading username and
  password.

- The Connection::createProxy method will now create a secure
  proxy if the connection is secure and a datagram proxy if the
  connection is a datagram connection.

- Added Communicator::proxyToProperty which converts a proxy to a
  property set.

- Calling Glacier2::Router::destroySession() no longer raises an
  Ice::ConnectionLostException exception. Glacier2 no longer
  forcefully closes the connection of a destroyed session but instead
  allows active connection management (ACM) for client connections to
  close it (see below).

- Glacier2 has been changed to support the use of active connection
  management. Active connection management is enabled by default for
  Glacier2 client connections if Glacier2.SessionTimeout is set.
  The ACM timeout is set to twice the value of the session timeout. If
  the session timeout is disabled, ACM is also disabled for client
  connections.

- Added support for a per-object adapter ACM timeout configured via
  the <adapter>.ACM property. If not set, the property defaults to
  value of Ice.ACM.Server set for the adapter's communicator.

- Improved the Ice run time's invocation retry facility to always
  retry at least once on Ice::CloseConnectionException failures even
  if the retry limit has been reached. If retries are disabled, this
  ensures that an invocation is retried if it fails with an
  Ice::CloseConnectionException.

- Added Glacier2.AddConnectionContext property to enable forwarding
  connection information into the context of routed invocations. See
  the manual for more information. Glacier2.AddSSLContext has been
  deprecated, this new property should be used instead.

- Added Ice.Override.CloseTimeout property. This property overrides
  timeout settings used to close connections.

- Ice connections are now forcefully closed after sending a close
  connection message and once the connection timeout
  expires. Previously, the connection would only be closed when the
  object adapter or communicator was destroyed.

- The new Ice::ThreadHookPlugin class allows you to install thread
  notification hooks during communicator initialization via plug-ins.

- Added Glacier2::Router::refreshSession, which keeps the client's
  Glacier2 session alive. This is useful in the case that the
  application architecture does not use a Glacier2 session
  manager. Modified demo/Glacier2/callback to demonstrate the use of
  this method.

- Fixed bug in icegridadmin where invalid XML could cause a crash.

- Fixed a bug where calling the object adapter waitForHold() method
  would cause other calls on the object adapter to hang until the
  waitForHold() method returned.

- Improved connection establishment scalability. Creating or accepting
  a new connection should now be done in constant time regardless of
  the number of connections already established or accepted.

- Fixed Glacier2 router bug which would cause the getCategoryForClient
  method to throw Ice::NullHandleException if the server endpoints
  were not set; instead it now returns an empty string.

- Ice.NegativeSizeException has been removed. The run time now throws
  MarshalException or UnmarshalOutOfBoundsException instead.

- The Ice thread pool now supports receiving and sending data over Ice
  connections using multiple threads. Allowing multiple connections to
  concurrently send and receive data improves CPU usage on machines
  with multiple cores. The maximum number of threads allowed to
  concurrently send/receive data is capped by the number of available
  cores.

- The Ice run time now uses Windows completion ports and overlapped IO
  to accept, connect, and receive and send data over connections. This
  improves scalability of server applications handling many
  connections on Windows.

- Ice connections now support read timeouts. A connection will now
  eventually timeout once the connection timeout is reached if no more
  data is available for reading after the message header was received.
  ACM no longer closes a connection for which a message is being
  received.

- The IceSSL.TrustOnly properties support a new syntax that allows you
  to reject a peer whose distinguished name matches certain criteria.

- IceSSL now compares the host name or IP address in a proxy endpoint
  (if any) against the common name of the server's certificate when
  the property IceSSL.CheckCertName is enabled. This is in addition to
  the existing behavior that compared the host name or IP address
  against the DNS names and IP addresses in the server certificate's
  subject alternative name extension.

- slice2docbook is no longer supported and has been removed from
  the distribution.

- slice2html comments now use a syntax that matches the javadoc
  syntax. Instead of

      module::interface::operation

  slice2html now expects

      module.interface#operation

  Similarly, the link syntax now follows the javadoc syntax. Instead
  of

      [module::interface::operation]

  slice2html now expects

      {@link module.interface#operation}

  The old syntax is still supported; slice2html prints a warning for
  each source file in which it encounters the old syntax.

- A batch invocation now only throws if the connection associated
  with the proxy failed and there were batch requests queued at the
  time of the failure. If there were no batch requests queued, the
  batch invocation does not throw but instead tries to obtain a new
  connection.

- Added the ability to read properties from the Windows registry. This
  is done by setting the Ice.Config property to a value such as the
  following:

    HKLM\Software\MyCompany\IceProperties

  This will read all the string values from the specified key in
  HKEY_LOCAL_MACHINE and set them as Ice properties.

- iceserviceinstall, the Windows service installation utility, now
  supports reading its configuration settings from HKLM in the Windows
  registry.

- Added ability to get information from endpoints such as host and
  port without having to parse the stringified endpoint.

- Added ability to get addressing information from a connection.

- The IceSSL::ConnectionInfo type is now generated from a local Slice
  definition. You can downcast this type to NativeConnectionInfo if
  you require access to native certificates.

- Slice files are now allowed to be in UTF-8 format and include UTF-8
  BOM at start of file and include UTF-8 characters in comments.

- Fixed bug in Slice compilers that would cause a crash if a Slice
  file had double slashes in its path.

- The following properties were deprecated in Ice 3.2 and have been
  removed:

  Glacier2.AddUserToAllowCategories
  Glacier2.AllowCategories
  Ice.UseEventLog

- The following APIs were deprecated in Ice 3.2 and have been removed:

  Communicator::setDefaultContext
  Communicator::getDefaultContext
  ObjectPrx:ice_defaultContext

- Support for the deprecated Slice keyword 'nonmutating' has been
  removed. As a result the following property has also been removed:

  Freeze.UseNonmutating

- HP-UX is no longer a supported platform for Ice.

- Added extra network tracing to show the list of local interfaces
  currently available when an endpoint is using a wildcard host, as
  well as the published endpoints for an object adapter. Both of these
  traces will be shown when Ice.Trace.Network >= 1.

- Added new property, Ice.Trace.ThreadPool, that when set >= 1 enables
  tracing of thread pool creation as dynamic thread pools grow and
  shrink.

- Changed the format of the default logger output. Traces are now
  prepended by '--', warnings by '-!' and errors by '!!'.

- The value of the thread pool SizeWarn property is now 0 by default
  rather than 80% of Size. This means that by default warnings about
  thread pool growth will now be disabled.

- Added example demo/Ice/plugin to show how to write a simple Ice
  plug-in as well as a Logger plug-in.

- Added getPlugins method to PluginManager which returns a list of the
  names of all installed plug-ins.

- The reason member of MemoryLimitException now contains the size of
  the request that caused the exception as well as the value of the
  maximum message size.

- The Ice::Application helper classes now use the process logger to
  emit errors rather than just writing directly to stderr.

- A Slice class that implements an interface but does not define or
  inherit any operations is now mapped to a concrete class. This
  change affects the Java, C#, Python, and Ruby language mappings.

- It is now possible to use an UNC path as an include directive for
  the Slice compilers.

- Fixed a bug in slice2html that caused incorrect hyperlinks to be
  generated for the summary of the index sections of a module page.

- Added a new property, Ice.LogFile, which causes the default Ice
  logger to write to a file rather than stderr. The file name is the
  property's value.

- Added the following operations to the ObjectAdapter API:

   - addDefaultServant
   - removeDefaultServant
   - findDefaultServant

  These methods provide a simpler way of using default servants in
  Ice. Please refer to the manual for more information.

- Using the --depend option with Slice compilers that support it no
  longer outputs dependency info even if the Slice file itself
  contains errors.


C++ Changes
============

- Added a new demo named "interleaved" that shows how to use
  asynchronous invocation and dispatch to achieve maximum throughput
  with Ice.

- Fixed a bug that prevented an application from using Unicode path
  names for Freeze databases on Windows.

- Enhanced the portable streaming API to provide better support for
  template programming.

- The C++ class generated for a derived Slice class no longer uses
  virtual inheritance by default. The metadata "cpp:virtual" can be
  defined for a Slice class to force the translator to use virtual
  inheritance when necessary.

- The following functions have new overloaded versions on Windows that
  accept a Unicode argument vector:

  Ice::Application::main
  Ice::Service::main
  Ice::argsToStringSeq

- Added support for specifying the priority of threads in a thread
  pool. See the Ice manual for more information.

- Added new demo book/map_filesystem.

- IceUtil:: Shared now uses the native atomic functions provided by gcc
  4.1 and later on supported platforms. For details see
  http://gcc.gnu.org/onlinedocs/gcc-4.1.0/gcc/Atomic-Builtins.html

- Fixed a bug in slice2cpp that could cause incorrect includes to be
  generated if a Slice file was included that was a symbolic link.

- On Windows it is now possible to build the Ice DLLs with unique names
  for each supported compiler. See UNIQUE_DLL_NAMES setting in
  cpp/config/Make.rules.mak.

- The Ice DLLs no longer all use the default base load address.

- Changed the signature of the Ice::Service start method.

- Added new static methods to initialize an IceUtil::Time class from
  a double:

  IceUtil::Time::secondsDouble(double)
  IceUtil::Time::milliSecondsDouble(double)
  IceUtil::Time::microSecondsDouble(double)

- Added the ability to use alternative database storage for IceStorm
  and IceGrid other than Freeze. The following SQL databases are
  supported: SQLite and PostgreSQL. Please see the manual for more
  information.

- Fixed a bug where globally-scoped garbage collected class pointers
  could cause a crash on application termination.

- Fixed a bug where an SSL connection was rejected because of a
  certificate validation failure even if IceSSL.VerifyPeer=0.

- Added ice_stackTrace() method to Exception classes, which returns
  the exception stack trace on platforms/compilers that support it.
  Currently this is only supported with the GCC compiler.

- Added new property, Ice.PrintStackTraces, which controls whether the
  Ice logger utility classes (Ice::Trace, Ice::Warning, etc) print the
  stack trace for Ice exceptions. By default it is enabled for debug
  builds and disabled for release builds.

- Removed AMD_Array_Object_ice_invoke class and instead added an
  ice_response method to AMD_Object_ice_invoke that uses the array
  type.

- The system logger (enabled when Ice.UseSyslog is set) now uses the
  value of Ice.ProgramName as the log identifier prefix.

- Fixed crash if Application::main() or Service::main() were called
  with argc == 0.


Java Changes
============

- The Freeze map API now uses Java5 generic type conventions.

- Ice now tests for the presence of the Bzip2 classes only if an
  application attempts to use compression.

- Added new demo book/map_filesystem.

- Changed IceSSL to use the keystore as the truststore if no
  truststore is explicitly defined.

- Added new ice_dispatch method to Object that does not take a
  DispatchInterceptorAsyncCallback parameter to be used for
  synchronous dispatch only.

- Added support for using direct buffers in the transport layer to
  minimize copying. The semantics of the Ice.CacheMessageBuffers
  property have been extended as follows:

  0 = no buffer caching
  1 = buffer caching using non-direct buffers
  2 = buffer caching using direct buffers

  If this property is not defined, the new default value is 2.

- The Ice run time now re-throws exceptions using fillInStackTrace to
  ensure the exception stack trace includes the calling point.

- Added the "classLoader" member to Ice.InitializationData, which
  allows you to supply a custom class loader that Ice uses to load
  plug-ins, user exceptions, concrete Slice classes, etc.

- Fixed a bug in the implementation of ice_invoke_async.

- The Freeze classes are now stored in a separate JAR file named
  Freeze.jar.

- The translator no longer generates one-shot constructors for class,
  struct and exception types if doing so would exceed Java's limit of
  255 parameters for a method.

- Fixed a bug where an outgoing SSL connection was allowed even though
  certificate validation failed.

- A holder class generated for a Slice class or interface now extends
  the generic base class Ice.ObjectHolderBase and implements the
  streaming interface Ice.ReadObjectCallback.

- slice2java no longer generates a <name>OperationsNC interface for
  local interfaces and classes. This makes the code easier to browse
  with IDEs.

- slice2java now preserves javadoc comments that appear in the Slice
  source and writes them through to the corresponding APIs in the
  generated code.

- Ice.jar and Freeze.jar now include source files. This allows IDEs
  such as Eclipse to browse the Ice source code and to display javadoc
  comments.

- Fixed a bug that caused UnmarshalOutOfBoundsException during an
  attempt to unmarshal an exception or class if Ice.jar is installed
  in the JVM's extension directory.

- The following APIs are deprecated and will be removed in a future
  release.

  Ice.Object.ice_hash()
  Ice.ObjectPrx.ice_getHash()
  Ice.ObjectPrx.ice_toString()

- The StackSize thread pool configuration property is now used.

- The generated classes for Slice structs are no longer declared final.

- Ice.Util.generateUUID has been deprecated. Use
  java.util.UUID.randomUUID().toString() instead.

- Ice now supports the ability to load a configuration file as a class
  path resource. For a path name specified in the ICE_CONFIG
  environment variable, in the --Ice.Config command-line option, or
  passed to Properties::load(), Ice first attempts to open the file as
  a class path resource and, if that fails, tries to open it as a file
  in the local file system. See the manual for more information.

- Removed the Java2 mapping. The release notes contain instructions
  for migrating an application to the Java5 mapping.

- Changed the Slice compiler to emit @SuppressWarning annotations only
  when necessary.

- Fixed a discrepancy between the documented behavior of the property
  IceSSL.CheckCertName and its actual behavior. The documented
  behavior states that IceSSL compares the host name as it appears in
  the proxy's endpoint against the server certificate's alternative
  subject names. The actual behavior in Ice 3.3 differed slightly in
  that the host name may have undergone a translation that could
  result in IceSSL using a different host name than that of the proxy.
  For example, the proxy may have contained "127.0.0.1" but IceSSL
  used "localhost". This could cause the SSL connection attempt to
  fail if IceSSL.CheckCertName is enabled. IceSSL now uses the host
  name from the proxy for this validation step.


C# Changes
==========

- The Ice DLLs no longer all use the default base load address.

- Both Ice Plugin and IceBox Service configuration now allow you to
  enter a full path as the assembly DLL name.

- Added new ice_dispatch method to Object that does not take a
  DispatchInterceptorAsyncCallback parameter to be used for
  synchronous dispatch only.

- IceSSL's behavior with respect to the IceSSL.CheckCertName property
  is now consistent with that of C++ and Java. Specifically, IceSSL
  compares the host name or IP address in a proxy endpoint (if any)
  against the common name and subject alternative names of the
  server's certificate. In prior releases, IceSSL relied on .NET to
  perform the validation of the common name but no comparison was made
  with the subject alternative names.

- Fixed bug where random endpoint selection would only work for
  proxies with more than two endpoints.

- Fixed thread safety issue in random endpoint selection.

- slice2cs no longer generates a <name>OperationsNC interface for
  local interfaces and classes. This makes the code easier to browse
  with IDEs.

- slice2cs now converts javadoc comments in Slice files into Visual C#
  XML documentation comments. This allows you to generate
  an <assembly>.xml file from the documentation comments by passing
  the /doc option to Visual C#. The comments in the <assembly>.xml
  file are shown as Visual C# tooltips if the <assembly>.xml file is
  installed in the same directory as the <assembly>.dll file.

  The build for Ice now generates the <assembly>.xml file for each
  assembly and installs it, so Visual C# displays tooltips for Ice
  APIs.

- The generated types for Slice classes, interfaces, structs and
  exceptions are now declared as partial.

- The following APIs are deprecated and will be removed in a future
  release.

  Ice.Object.ice_hash()
  Ice.ObjectPrx.ice_getHash()
  Ice.ObjectPrx.ice_toString()

- The StackSize thread pool configuration property is now used.

- The default Ice logger now uses System.Diagnostics.Trace to
  output messages. Please see manual and Trace documentation for
  more information.

- Ice.Util.generateUUID has been deprecated. Use
  System.Guid.NewGuid.ToString() instead.


Python Changes
==============

- The extension now restores the pre-existing dlopen flags.

- The __cmp__ method generated for slice structures and enumerations
  has been replaced by the rich operators __lt__, __le__, __eq__,
  __ne__, __gt__, __ge__.

- Slice comments are now converted into Python docstrings in the
  generated code.

- Added the administrative facet API.

- Integer values are now accepted where floating point values are
  expected.

- Objects that support the number protocol are now accepted as legal
  values for Slice integer and floating-point types.

- 64-bit integers are now supported in buffer types.


Ruby Changes
============

- The following API as been deprecated and will be removed in a
  future release.

  Ice::ObjectPrx::ice_getHash()


PHP Changes
===========

- Enumerations are now supported as dictionary key types.

- Integer values are now accepted where floating point values are
  expected.

- Added slice2php and removed dynamic Slice translation.

- Added support for PHP namespaces (requires PHP 5.3 or later).

- Added ability to create and destroy communicators. Use the function
  Ice_initialize (\Ice\initialize) to create a communicator. By
  default, all communicators created during a page request are
  destroyed automatically at the end of the request.

- Added ability to register a communicator for use in a subsequent
  page request. Three new functions are provided:

  * Ice_register   (\Ice\register)
  * Ice_unregister (\Ice\unregister)
  * Ice_find       (\Ice\find)

- Added a demo (in Glacier2/hello) that shows how to register and
  use the same communicator instance for multiple page requests in a
  PHP session.

- Added support for all Slice local exceptions.

- The INI settings are now used to configure property sets that a
  script can use to initialize a communicator. The ice.slice directive
  is no longer supported.

- Added the function Ice_createProperties().

- Now generating minimal proxy classes to simplify downcasting.

- Removed the "$ICE" global variable.

- Removed the following methods:

  $ICE->setProperty()
  $ICE->getProperty()

- Removed the following functions:

  Ice_stringToIdentity()
  Ice_identityToString()
  Ice_loadProfile()
  Ice_loadProfileWithArgs()
  Ice_dumpProfile()


Visual Studio Plugin Changes
============================

- Added support for Visual Basic projects. For Visual Basic projects
  the plug-in only takes care of managing Ice references and not slice
  compilation.

- It is now possible to install the plug-in when "My Documents" is
  linked to a network drive.

- The plug-in will no longer modify projects for which it is not
  enabled.

- The plug-in will now compile slice files for C++ projects even if
  the project does not have "C++ Options".


======================================================================
Changes since version 3.3.0
======================================================================


General Changes
===============

These entries apply to all relevant language mappings unless otherwise
noted.

- Fixed a bug where ice_getCachedConnection could throw if called
  shortly after connection establishment failed.

- Fixed an IceGrid bug where an application update could trigger the
  deactivation of all session-activated servers even if these servers
  were not updated.

- The frequency at which Ice checks for connections that can be reaped
  by active connection management (ACM) is now set by default to 10%
  of the smallest, non-zero ACM setting (Ice.ACM.Client and
  Ice.ACM.Server), with a minimum value of 5 seconds and a maximum
  value of 5 minutes. This default can be overridden by setting
  Ice.MonitorConnections, which is no longer deprecated, and whose
  value is the check frequency in seconds.

- Fixed a bug in IceBox where services using the shared communicator
  would be passed the wrong communicator if re-started with the IceBox
  service manager interface.

- Improved Glacier2 to automatically destroy the client session if the
  forwarding of a request from a back-end server to the client fails
  with an unrecoverable error. This is particularly useful for clients
  that receive requests from back-end servers on a regular basis and
  disable the Glacier2 session timeout. If for some reason the client
  becomes unreachable, Glacier2 will eventually destroy the client
  session (assuming timeouts are properly configured on the Glacier2
  client endpoints).

- Added support for updating locator cache endpoints in the background
  if the new Ice.BackgroundLocatorCacheUpdates property is set to 1.

  Locator cache updates are triggered if the proxy locator cache
  timeout is configured and the cached endpoints are older than the
  configured timeout.

  By default, locator cache updates are performed before making an
  invocation, delaying the invocation until the new endpoints are
  retrieved from the locator. With this feature enabled, the locator
  cache updates are performed in the background and the invocation
  that triggered the update uses the previously cached endpoints.

- Optimized the Ice client run time to minimize locator requests when
  multiple concurrent or AMI requests need to resolve the endpoints of
  the same well-known object, object adapter, or replica group.

- Fixed a bug in IceGrid that would cause it to generate incorrect
  configuration files for servers whose ice-version was set to a
  version previous to Ice 3.3.0.

- Fixed a bug in the Slice translators that prevented them from being
  run from a directory without write permissions, even if no output
  files were being written to the directory.

- Fixed a bug where retried AMI calls could cause the timer thread to
  print an error message if the retry failed and if Ice.RetryIntervals
  was configured with non-zero time intervals.

- All error output from the Slice compilers now goes to stderr.

- Made unmarshaling code robust against messages containing invalid
  indexes for class instances.

- Fixed IcePatch2 to handle non-ASCII file names properly.

- Fixed a bug in IceGrid that could cause the registry to fail with an
  assertion if an application is synchronized concurrently by multiple
  administrative clients (or by nodes started with the --deploy
  option).

- IceGrid locator implementation changes:

  * Fixed a bug where the registry could crash when resolving the
    endpoints of a replica group if some servers were activating
    concurrently.

  * Fixed a bug where the registry could hang when resolving the
    endpoints of a round-robin replica group if a member of the
    replica group was removed concurrently.

  * Improved the scalability of the locator implementation to better
    handle a high volume of concurrent requests. The registry now
    limits the number of invocations to the IceGrid nodes to get the
    object adapter endpoints.

- A Slice compiler now removes any files it has generated during the
  current execution if it fails or is interrupted.

- The Slice compilers that support the --depend option now use an exit
  status of 1 if a failure occurs while generating dependencies. In
  previous releases the compilers used an exit status of 0.

- Fixed a bug in the iceca script that prevented the command "init
  --overwrite" from working properly on Windows.

- Fixed a bug where the IceBox shared communicator ignored Ice
  communicator properties specified in an IceBox service configuration
  file.

- Fixed a bug where Ice plug-ins could be destroyed more than once.

- Fixed several issues in the IceGrid GUI.


C++ Changes
===========

- Fixed a bug in IceSSL plug-in which could cause a crash on
  communicator destruction.

- Changed the thread pool to ensure that references to AMI callback
  objects are released as soon as possible.

- Fixed bug in slice2cpp that caused bad code to be generated for
  classes and modules whose name was a C++ keyword.

- Fixed a bug in IceSSL where the IceSSL.CheckCertName property did
  not have any effect.

- Fixed icegridadmin `service list' command crash.

- Fixed a bug where slice2cpp and slice2freeze would generate absolute
  include paths if the command line option "-I." was used.

- Fixed a Freeze transactional evictor bug that could cause the
  transaction of an asynchronous method dispatch to be rolled back if
  rollback on user exception was enabled.

- Fixed a bug that could cause the first invocation on a proxy to
  incorrectly be sent compressed or not compressed.

- Fixed a bug on Windows that could cause an interrupted application
  to spin for a while before terminating.


Java Changes
============

- Slice types now implement java.io.Serializable.

- If a servant raises OutOfMemoryError while dispatching an operation,
  the Ice run time now traps it and treats it as a hard error, meaning
  Ice logs an error message and closes the connection on which the
  request was received.

- Added object serialization that allows native Java objects to be
  sent as operation parameters. See the Slice chapter and the Java
  language mapping chapter in the manual for more information.

- Fixed bug in slice2java that caused bad code to be generated for a
  class whose name was a Java keyword if the class contained data
  members.

- The path names specified by the IceSSL.Keystore, IceSSL.Truststore,
  and IceSSL.Random properties can now refer to class path resources.

- Added methods to the IceSSL plug-in to allow keystores, truststores,
  and RNG seeds to be specified using input streams.

- Fixed the IceSSL.ConnectionInfo type so that the "incoming" and
  "adapterName" members are public.

- Added support for using Ice in an applet, along with a new demo.


C# Changes
==========

- Added object serialization that allows native C# objects to be sent
  as operation parameters. See the Slice chapter and the C# language
  mapping chapter in the manual for more information.

- Changed the Ice run time to no longer rely on .NET worker threads
  to start asynchronous I/O operations.

- Fixed a bug in slice2cs that caused a core dump if a dictionary had
  a value type of Object.

- Fixed a bug in slice2cs that caused incorrect code to be generated
  if an operation had a parameter named "ex".

- Fixed a bug in slice2cs that caused incorrect code to be generated
  if a Slice class used the property mapping and also applied
  a ["cs:attribute:..."] metadata directive to a data member.

- Fixed an issue that could cause an application to fail to start if
  Ice was unable to load an assembly that was referenced (but not
  required) by the program and not present on the system.

- Fixed a bug in marshaling code that caused a trailing zero byte
  to be marshaled for user exceptions without class data members.

- Fixed a bug in slice2cs that caused incorrect code to be generated
  for a dictionary that used a structure as the key type.

- Fixed a bug in slice2cs that caused incorrect code to be generated
  for a sequence whose element type is a structure that uses the
  class mapping.


Python Changes
==============

- Implemented the Ice.Trace.Slicing property for user exceptions.

- It is now possible to pass a sequence of 64-bit integer values
  using an object that supports the buffer protocol.

- Fixed a bug in the constructors of user-defined types that have
  structures as data members. Consider this example:

  // Slice
  struct Point {
      int x;
      int y;
  };
  struct Event {
      Point location;
      ...
  };

  The Event constructor supplied a default instance of the Point
  member if the caller did not supply one. However, this default
  instance was unintentionally shared by all Event objects that
  omitted a value for the Point member during construction. The
  generated code now ensures that each instance of Event assigns a
  new instance of Point.

- Fixed bugs in getImplicitContext related to using it when an
  implicit context had not been set.

- Fixed bugs in stringToProxy and propertyToProxy related to null
  proxies.

- Ice.getSliceDir() now only searches for the "slice" directory in a
  standard Ice installation.

- Improved the way the build system locates the Python framework on
  Mac OS X.


Ruby Changes
============

- The translator now generates an eql? method for Slice structures.

- Implemented the Ice.Trace.Slicing property for user exceptions.

- Added helper Ice.getSliceDir, which locates the "slice" directory in
  a standard Ice installation.


PHP Changes
===========

- It is now possible to specify multiple Slice files in your profile
  configuration that have common include files. For example, if A.ice
  and B.ice both include Common.ice, you can now do the following:

  ice.slice=-I. A.ice B.ice

  In previous releases this would have caused a redefinition error,
  which you could work around by creating a single Slice file that
  included both A.ice and B.ice. This workaround is no longer
  necessary.

- Fixed bugs in the ice_router and ice_locator proxy methods.


======================================================================
Changes since version 3.2.1
======================================================================


General Changes
===============

These entries apply to all relevant language mappings unless otherwise
noted.

- It is now possible to use UNC paths on Windows in the configuration
  of Ice services, such as in the value of the IceGrid.Node.Data
  property for an IceGrid node.

- Fixed bug in slice2html that caused incorrect hyperlinks to be
  generated if nested modules were used.

- Added support for non-blocking AMI and batch requests. Activities
  such as DNS lookups, endpoint resolution, connection establishment,
  and sending the request are now performed in the background if
  necessary.

- AMI requests now return a boolean to indicate if the request is
  sent synchronously. If not sent synchronously and the AMI callback
  implements the Ice::AMISentCallback interface, the Ice run time
  calls the ice_sent() method once the request is sent.

- AMI timeouts are no longer triggered by the connection monitor
  thread at regular time intervals. Instead, timeouts are now
  triggered on time just like synchronous invocations. As a result,
  the setting of the Ice.MonitorConnections is no longer useful and
  this property has been deprecated.

- Added the proxy methods ice_flushBatchRequests() and
  ice_flushBatchRequests_async() to flush the batch requests of the
  connection associated with the proxy. Like AMI requests, the
  ice_flushBatchRequests_async() method is guaranteed to not block.

- Added support for oneway AMI requests. The ice_response() method of
  the AMI callback is never called for oneway requests sent with AMI.
  Unlike regular oneway requests which might block until the request
  is passed to the TCP/IP stack, oneway AMI requests can't block.

- Removed the thread-per-connection (TPC) concurrency model.
  Applications that were using TPC for its ordering guarantees can use
  the new thread pool serialization feature.

- The Ice thread pool now supports a new serialization mode that
  serializes the processing of messages received over a connection.
  For example, this is useful when you want to ensure the orderly
  dispatching of oneway requests from a client even if the thread pool
  has multiple threads. Serialization is enabled by setting the thread
  pool's Serialize property to 1.

- An Ice server will now abort() if there are no more file descriptors
  available to accept incoming connections. Note that this behavior is
  subject to change in the final release.

- An IceGrid node is more conservative when removing the directory of
  a server. The node only removes the directory when the server is
  explicitly removed from a deployed application or if the directory
  contains only files and directories that were created by the node.

- IceGrid's round-robin load balancing policy better handles servers
  that are unreachable.

- Fixed an IceGrid bug where patching servers deployed with the
  attribute `application-distrib' set to false wouldn't work.

- Added an object adapter to the IceGrid registry. The adapter is
  named `IceGrid.Registry.AdminSessionManager' and is responsible for
  Glacier2 administrative sessions.

- When resolving the endpoints of a replica group, the IceGrid locator
  no longer waits for an object adapter to complete its activation if
  another adapter is already active.

- Fixed an IceGrid descriptor bug where re-opening an unnamed property
  set would cause multiple property definitions.

- Added a fix to prevent the IceGrid node from printing an annoying
  thread pool size warning on startup.

- Fixed IceGrid bug where updates to IceBox services were not
  correctly sent to the IceGrid GUI or to IceGrid registry slaves.

- The IceGrid node now unblocks the SIGHUP, SIGINT and SIGTERM signals
  from forked servers.

- The IceGrid node now prints a warning if it can't reach the IceGrid
  registry when it starts. This warning can be disabled with --nowarn.

- An IceBox service can now recursively start and stop other IceBox
  services from within its start and stop methods. The level of
  recursion is limited to the threads in the administrative object
  adapter's thread pool.

- Configuration properties for IceBox services can now be defined on
  the command line.

- IceBox services that share a communicator now use a dedicated
  communicator instance that is not used by the IceBox server. This
  dedicated communicator only inherits properties from the server's
  communicator if IceBox.InheritProperties is set to a non-zero value.

- It is no longer necessary to define a value for the property
  IceBox.ServiceManager.Endpoints. If this property is not defined,
  the ServiceManager interface is not available.

- Changes related to Highly-Available IceStorm

  - IceStorm now supports master/slave replication with automatic
    failover.

  - IceStorm also supports a transient mode that uses no databases.
    This mode is enabled using the new property <service>.Transient.
    Replication is not supported in this mode.

  - Subscriptions are now persistent (except in transient mode).

  - Added a new Quality of Service (QoS) parameter, retryCount, to
    control when subscribers are removed. IceStorm automatically
    removes a subscriber after the specified number of unsuccessful
    event deliveries. The default value of retryCount is 0, meaning
    the subscriber is removed immediately upon any failure. A
    subscriber is always removed on a hard failure, which is defined
    as the occurrence of ObjectNotExistException or
    NotRegisteredException.

  - The IceStorm database format has changed. Use the utility
    icestormmigrate to migrate from the database formats of Ice 3.1.1
    and Ice 3.2.1. The old migration script (updateicestorm.py) has
    been removed.

  - Added the new C++ example demo/IceStorm/replication2, which
    demonstrates how to manually configure IceStorm replication.

  - Added the "replica" command to icestormadmin to get debugging
    information on IceStorm replication.

  - The TopicManager object adapter now uses its own thread pool in
    the replicated case to ensure that ordering is guaranteed by
    default even if a publisher uses a oneway proxy.

  - Upon shutdown IceStorm now guarantees that all received events
    are delivered to all subscribers.

  - Added Topic::getNonReplicatedPublisher, which always return a
    non-replicated publisher proxy.

  - All IceStorm properties must be prefixed with the service name.
    For example, consider the following IceBox service configuration:

    IceBox.Service.Foo=IceStormService,33:createIceStorm ...

    In this case the IceStorm configuration properties must use the
    "Foo" prefix, such as

    Foo.Discard.Interval=10

  - Removed the icestormadmin Slice checksum check. This avoids
    warnings when using icestormadmin against an older version of
    IceStorm.

- It is now possible to specify properties in a config file with
  space, '#' or '=' in either the key or value string. It is necessary
  to escape '#' and '=' as '\#' and '\='. Leading or trailing spaces
  are only allowed in keys and need to be escaped as '\ '.

- Properties set programmatically can no longer have leading or
  trailing whitespace in the key.

- There is no longer a limit on the allowable length of a property
  line in an Ice config file. Previously the limit was 1024.

- The new property Ice.Warn.UnusedProperties causes the communicator
  to display a warning during its destruction that lists all
  properties that were set but whose values were never read.

- The way that the Ice run time determines whether a proxy invocation
  is eligible for collocation optimization has changed somewhat. The
  Ice run time no longer performs a DNS lookup; instead, invocations
  on a direct proxy will use the optimization only if the host and
  port of one of its endpoints match the host and port of an endpoint
  or published endpoint of an object adapter from the same
  communicator.

- Exceptions thrown from collocation-optimized invocations are now
  fully transparent. If an operation throws an exception that is not
  in the operation's exception specification, or throws a non-Ice
  exception, the client receives UnknownUserException or
  UnknownException, exactly as if the servant for a remote invocation
  had thrown the same exception. (In earlier versions, the client
  received the original exception, rather than an unknown exception.)

  For Ice run-time exceptions, all run-time exceptions are passed
  to the client as UnknownLocalException, except for

  - ObjectNotExistException
  - FacetNotExistException
  - OperationNotExistException
  - OperationNotExistException
  - UnknownException
  - UnknownLocalException
  - UnknownUserException
  - CollocationOptimizationException

- The property Ice.Default.CollocationOptimization and the proxy
  property <proxy>.CollocationOptimization have been deprecated and
  replaced by Ice.Default.CollocationOptimized and
  <proxy>.CollocationOptimized, respectively.

- Most proxy factory methods now return a proxy of the same type as
  the original and no longer require the use of a checked or unchecked
  cast. For example, in C++ you can write

  HelloPrx hello = ...;
  hello = hello->ice_oneway();

  Previously you would have needed a cast, such as

  hello = HelloPrx::uncheckedCast(hello->ice_oneway());

  In Java and .NET, you must use a type cast:

  hello = (HelloPrx)hello.ice_oneway();

- If a proxy contains a host that is multihomed, the client will now
  try all the available IP addresses. Previously, only the first in
  the address list returned by the DNS was used and others were
  ignored.

- It's now possible to change the compression setting for a fixed
  proxy. In previous releases, calling ice_compress on a fixed proxy
  would raise Ice::FixedProxyException.

- Added a new skipEncapsulation method to the Ice::InputStream
  interface. This method can be used to skip an encapsulation when
  reading from a stream.

- The endEncapsulation method from the Ice::InputStream interface will
  now throw Ice::EncapsulationException if not all the data from the
  encapsulation has been read.

- The marshaling code now throws an exception if an enumerator that is
  out of range for its enumeration is sent or received.

- Network tracing now also includes failures to connect if
  the Ice.Trace.Network property is set to 2.

- The property Ice.Trace.Location has been deprecated and replaced
  by Ice.Trace.Locator.

- The Ice locator tracing (enabled with the `Ice.Trace.Locator'
  property) now traces calls to locator registry when an object
  adapter updates its endpoints or the server process proxy is
  registered.

- The new property Ice.TCP.Backlog allows you to specify the size of
  incoming connection backlog for TCP/IP sockets. This setting is
  also used for SSL. In C++ the default value is SOMAXCONN or 511 if
  that macro is not defined. In Java and .NET the default value is
  511.

- Added support for IPv6. It is disabled by default but can be enabled
  using the configuration property Ice.IPv6. The property Ice.IPv4 can
  be used to disable IPv4 support.

- Added support for UDP multicast.

- A new object adapter property, <adapter>.ProxyOptions, lets you
  customize the proxies that the adapter creates.

- Added a new operation to the ObjectAdapter interface named
  refreshPublishedEndpoints(). This operation allows you to update an
  adapter's published endpoints after a change in the available local
  interfaces or after a change to the PublishedEndpoints property.

- The "-h *" endpoint option is now only valid for object adapter
  endpoints. It can no longer be used in proxy endpoints or object
  adapter published endpoints.

- Ice now listens on INADDR_ANY for object adapter endpoints that do
  not contain a host name (or are set to use "-h *" or "-h 0.0.0.0").
  Previously, Ice would only listen on the local interfaces that were
  present when the adapter was created.

- Accepting incoming connections can no longer block a thread from a
  server thread pool. This includes activities such as connection
  validation and SSL handshaking.

- Changed servant locators so both locate() and finished() can throw
  user exceptions.

- Improved Glacier2 to take advantage of the new non-blocking aspects
  of Ice. Glacier2 now uses the thread pool concurrency model and, in
  buffered mode, Glacier2 only uses a single thread to forward queued
  requests. As a result, Glacier2 now requires a fixed number of
  threads regardless of the number of connected clients.

- Glacier2 filters are now disabled by default for IceGrid client
  and administrative sessions created with the IceGrid session
  managers. If you rely on these filters being enabled, you must now
  explicitly set the property IceGrid.Registry.SessionFilters or
  IceGrid.Registry.AdminSessionFilters.

- The use of sequences (and structs containing sequences) as valid
  dictionary keys has been deprecated and will be removed in a future
  release.

- slice2vb has been removed from the distribution and is no longer
  supported. To use Visual Basic .NET with Ice, use slice2cs to
  generate C# code from Slice definitions, and then use a C# compiler
  to create a DLL from the generated code. Then link against that DLL
  in your Visual Basic project.

- Fixed a variety of bugs with slice2cpp where incorrect code
  would be generated when C++ reserved words are used as Slice
  identifiers.

- If a class, interface, or exception has a base, slice2html now
  generates a hyperlink to the base. (Previously, only the name of the
  base was shown, without a hyperlink.)

- slice2html now generates documentation for Slice constant
  definitions.

- slice2html now generates the scoped name for the <h1> element of
  each page instead of the unqualified name. For example, it now shows
  "Ice::DNSException" instead of "DNSException".

- The ability to install a logger via the Ice.LoggerPlugin property
  has been removed. The new mechanism requires that you create an
  instance of the Ice::LoggerPlugin class in your plug-in factory.
  Please see the manual for more details.

- It is no longer possible to provide input files on the command line
  for icestormadmin or icegridadmin.

- Freeze evictor update:

  - the existing evictor was renamed BackgroundSaveEvictor
  - added new TransactionalEvictor

- Fixed a bug in FreezeScript that caused a failure when a script
  attempted to access the 'length' member of a string value.

- Added support for string concatenation in FreezeScript using the
  '+' operator.

- dumpdb output now goes to stdout.


C++ Changes
===========

- Fixed icepatch2server crash on exit bug.

- Fixed race condition in IceUtil::Cache.

- Changed the string methods in InputStream and OutputStream to accept
  an optional boolean argument. If true (the default), strings are
  processed by the string converter (if any) before marshaling or
  unmarshaling. If false, the string converter is bypassed. No source
  code changes are necessary for existing programs.

- The new Ice::StringConverterPlugin class allows you to install a
  custom string converter and/or wstring converter during communicator
  initialization.

- The Ice shared library now provides a string converter plug-in
  factory: createStringConverter. See the Ice manual for details.

- IceUtil::stringToWstring and IceUtil::wstringToString now take
  a second argument of type ConversionFlags. It can be either
  strictConversion or lenientConversion. The default is
  lenientConversion for compatibility with previous releases. See
  the Ice manual for further details.

- Added IceGrid secure demo to demonstrate how to setup a secure
  IceGrid deployment.

- Fixed a Glacier2 assert that would occur if the configuration
  defined only the SSL permissions verifier.

- The IceUtil::Timer destroy method no longer joins with the timer
  execution thread if it's called from a timer task. Instead, the
  thread is detached.

- The IceUtil::Timer schedule and scheduleRepeated methods now throw
  IceUtil::IllegalArgumentException if the timer is destroyed.

- Fixed potential Slice parser assert.

- Added an HA IceStorm template to config/templates.xml.

- Removed the index parameter from the IceStorm template.

- It is now possible to manually configure the node proxies when
  using HA IceStorm in conjunction with IceGrid.

- iceca and associated ImportKey.class are now copied into bin and lib
  respectively.

- iceca did not correctly support the --verbose flag with the import
  command.

- iceca request has been simplified. The command now takes the name of
  the file to generate, the common name, and an optional email
  address.

- The iceca ImportKey.class utility is now installed in
  /usr/share/Ice-3.3.0 for an RPM install or ${prefix}/lib otherwise.

- The following APIs were deprecated in Ice 3.1 and have been removed:

  Application::main(int, char*[], const char*, const Ice::LoggerPtr&)
  initializeWithLogger
  initializeWithProperties
  initializeWithPropertiesAndLogger
  stringToIdentity
  identityToString
  ObjectPrx::ice_hash
  ObjectPrx::ice_communicator
  ObjectPrx::ice_newIdentity
  ObjectPrx::ice_newContext
  ObjectPrx::ice_newFacet
  ObjectPrx::ice_newAdapterId
  ObjectPrx::ice_newEndpoints
  ObjectPrx::ice_collocationOptimization
  ObjectPrx::ice_connection

- Added "public" keyword to the definition of IceSSL::PublicKey.

- Fixed a bug in slice2freeze in which it was not properly handling
  the "cpp:type:wstring" metadata, which would result in narrow
  strings being used in generated code when wstring should have been
  used instead.

- IceInternal::GCShared now derives from IceUtil::Shared. This now
  makes it possible to have a servant class derived from
  IceUtil::Thread (which, previously, was impossible).

- The thread stack size specified with the IceUtil::Thread::start()
  method parameter is now adjusted to PTHREAD_STACK_MIN if it's
  inferior to it. On Mac OS X, it's also adjusted to the next closest
  multiple of the page size (4KB).

- Added a new overloading of the Ice::createInputStream method:

  Ice::InputStreamPtr createInputStream(
      const CommunicatorPtr&,
      const pair< const Byte*, const Byte*>&);

- Fixed a bug in the encoding of user exceptions with a class
  attribute and returned by AMD-dispatched invocations. An extra byte
  was encoded at the end. This fix doesn't affect on the wire
  compatibility with old Ice clients.

- Added what() member to IceUtil::Exception, so a single catch handler
  can be used for Ice exceptions:

  try
  {
      // Call something that may throw an Ice exception
  }
  catch(const ::std::exception& ex)
  {
      cerr << ex.what() << endl; // Works for any ::std::exception,
                                 // including Ice exceptions
  }

  what() is implemented in terms of ice_print(), so overriding
  ice_print() also changes the string returned by what().


Java Changes
============

- Fixed the slice2java ant task to redirect stderr output so that
  messages from the preprocessor are not interpreted as dependencies.

- Fixed the slice2java ant task to recompile all of the files in the
  file list if at least one of the files has changed and checksums are
  being generated.

- Deprecated the class IceUtil.Version.

- Added the methods stringVersion and intVersion to Ice.Util for
  obtaining the Ice version.

- Fixed a NullPointerException thrown when allocating an InputStream
  with an empty buffer.

- Fixed a NullPointerException thrown when calling startEncapsulation
  on an OutputStream.

- The following APIs were deprecated in Ice 3.1 and have been removed:

  Application.main(String, String[], String, Logger)
  Util.initializeWithLogger
  Util.initializeWithProperties
  Util.initializeWithPropertiesAndLogger
  ObjectPrx.ice_hash
  ObjectPrx.ice_communicator
  ObjectPrx.ice_newIdentity
  ObjectPrx.ice_newContext
  ObjectPrx.ice_newFacet
  ObjectPrx.ice_newAdapterId
  ObjectPrx.ice_newEndpoints
  ObjectPrx.ice_collocationOptimization
  ObjectPrx.ice_connection

- Ice for Java now supports the ICE_CONFIG environment variable.

- The Java2 language mapping is now deprecated.

- Added support for a password callback in IceSSL. Also added new
  properties for specifying the name of a password callback class or
  certificate verifier class.

- LocalObject is now mapped to java.lang.Object; an out LocalObject
  parameter is still mapped to an Ice.LocalObjectHolder object.
  Ice.LocalObjectHolder now holds a java.lang.Object. The interface
  Ice.LocalObject and the abstract class Ice.LocalObjectImpl are now
  deprecated.

- Ice.LocalException and Ice.UserException now implement
  java.lang.Cloneable.

- Fixed the generated hashCode method to prevent NullPointerException.


.NET Changes
============

- Added the methods stringVersion and intVersion to Ice.Util for
  obtaining the Ice version.

- Fixed a NullReferenceException thrown when allocating an InputStream
  with an empty buffer.

- Fixed a NullReferenceException thrown when calling
  startEncapsulation on an OutputStream.

- Changed Ice.Exception to derive from System.Exception rather than
  System.ApplicationException in accordance with Microsoft's
  recommendations for writing custom exceptions.

- The following APIs were deprecated in Ice 3.1 and have been removed:

  Application.main(string, string[], string, Logger)
  Util.initializeWithLogger
  Util.initializeWithProperties
  Util.initializeWithPropertiesAndLogger
  ObjectPrx.ice_hash
  ObjectPrx.ice_communicator
  ObjectPrx.ice_newIdentity
  ObjectPrx.ice_newContext
  ObjectPrx.ice_newFacet
  ObjectPrx.ice_newAdapterId
  ObjectPrx.ice_newEndpoints
  ObjectPrx.ice_collocationOptimization
  ObjectPrx.ice_connection

- The Ice.Application class now supports signal handling on Mono.

- Added the build macro MANAGED, which can be enabled if you want to
  build a version of the Ice run time that uses only managed code.

- Improved marshaling performance for Ice for .NET. This particularly
  affects programs running under Mono on big-endian machines, where
  marshaling performance of sequences improves by up to a factor of
  10. For little-endian machines (both Windows and Mono), marshaling
  performance is also improved.

- Added ice_name() method to exceptions, in keeping with the C++
  and Java convention. The method returns the Slice type ID of
  exception, without a leading "::" qualifier.

- Fixed a bug that caused a NullPointer exception for sequences
  of structs if the structs used the class mapping and the sequence
  contained null elements.

- Fixed a bug that caused a NullPointer exception when marshaling
  a struct containing reference types if that was nested inside
  a data type, such as another exception or struct.

- Added support for a password callback in IceSSL. Also added new
  properties for specifying the name of a password callback class or
  certificate verifier class. See manual for more details.

- Fixed a bug in slice2cs that caused incorrect code to be generated
  for data members of classes and structures that used the
  ["clr:property"] metadata directive.

- Fixed a bug in slice2cs that caused incorrect code to be generated
  for Slice exceptions with data members that had the same name as one
  of the data members of System.ApplicationException.

- The metadata directive "cs:collection" is no longer valid.
  Use ["clr:collection"] instead.

- Added a new mapping for Slice sequences to use C# 2.0
  generics:

  // Slice
  ["clr:generic:List"] sequence<int> S;

  maps to:

  // C#
  System.Collections.Generic.List<int> S;

  This also works for types other than List. Please see the manual for
  more details.

- Added a new mapping for Slice dictionaries to use C# 2.0
  generics:

  // Slice
  dictionary<string, int> D;

  maps to:

  // C#
  System.Collections.Generic.Dictionary<string, int> D;

  The previous mapping to the .NET 1.1 DictionaryBase class is still
  supported with the "clr:collection" metadata directive.

- LocalObject is now mapped to System.Object. The interface
  Ice.LocalObject and the abstract class Ice.LocalObjectImpl are now
  deprecated.

- The Ice.Util.proxyIdentityCompare and proxyIdentityAndFacetCompare
  methods are now using string.CompareOrdinal to compare the identity
  category, name and the facet instead of string.Compare with the
  CultureInfo.InvariantCulture culture-specific information.

- Ice.LocalException and Ice.UserException now implement
  System.ICloneable.

- Ice for C# has been renamed Ice for .NET and the assemblies have
  been renamed as well. For example icecs.dll is now just Ice.dll.


Python Changes
==============

- Fixed a bug that occurred when converting an Ice.Identity object to
  a string via str(). In prior releases, this conversion used the
  global method Ice.identityToString, but that method is no longer
  supported. As a result, the output now resembles that of other
  user-defined types.

- Added the methods Ice.stringVersion and Ice.intVersion.

- Unicode objects are now accepted as arguments (or data members of
  arguments) to remote Slice operations. The local Ice API still uses
  8-bit strings.

- Added new Ice/converter demo to illustrate how to use the new Ice
  for C++ string converter plug-in. This demo is very similar to the
  C++ demo.

- Fixed a deadlock bug that could occur when a multithreaded client
  executes Slice operations that return abstract objects by value.

- Removed "#!/usr/bin/env python" where unnecessary.

- Added ice_staticId() method to generated Slice classes.

- The following APIs were deprecated in Ice 3.1 and have been removed:

  initializeWithLogger
  initializeWithProperties
  initializeWithPropertiesAndLogger
  identityToString
  stringToIdentity
  ObjectPrx.ice_communicator
  ObjectPrx.ice_newIdentity
  ObjectPrx.ice_newContext
  ObjectPrx.ice_newFacet
  ObjectPrx.ice_newAdapterId
  ObjectPrx.ice_newEndpoints
  ObjectPrx.ice_connection

- Fixed a bug where returning an AMD servant from a ServantLocator
  would cause a deadlock in the IcePy extension.

- Added support for blobjects.

- Fixed a code generation bug with slice2py where the proxy type
  for a Python reserved word would be incorrectly named. For example,
  interface def would generate a proxy class named _defPrx, not the
  correct class name defPrx.

- LocalObject is now mapped to the Python base 'object' type. The
  class Ice.LocalObject is now deprecated.

- Fixed a bug in Ice.initialize that would cause a crash if the
  configuration file specified by --Ice.Config was not found.


Ruby Changes
============

- Added the methods Ice::stringVersion and Ice::intVersion.

- Removed "#!/usr/bin/env ruby" where unnecessary.

- Added ice_staticId() method to generated Slice classes.

- Fixed a code generation bug with slice2rb where the reserved words
  BEGIN and END would generate classes, modules and constants named
  _BEGIN, and _END which is illegal. They now generate BEGIN_ and
  END_.

- Fixed a bug where marshaling a plain object proxy fails with an
  uninitialized constant exception.


PHP Changes
===========

- Constructors are now generated for Slice structure, exception, and
  class types. Constructor parameters supply default values for each
  data member.

- A null value is now allowed where a sequence or dictionary value is
  expected.

- Added the methods Ice_stringVersion and Ice_intVersion.

- Removed the undocumented PHP constants ICE_STRING_VERSION and
  ICE_INT_VERSION.

- LocalObject is now mapped to PHP's base object type. The interface
  Ice.LocalObject and the abstract class Ice.LocalObjectImpl are now
  deprecated.

- Added support for an optional context argument to ice_checkedCast
  and ice_uncheckedCast.

- Added the following proxy methods:

  ice_getRouter/ice_router
  ice_getLocator/ice_locator

- Added the translator option "-w" to suppress warnings during Slice
  translation.