======================================================================
CHANGES for Ice 3.3.0
======================================================================

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.
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.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 plugin 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 plugin
  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 plugin. 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.
