second round

1 files changed, 76 insertions, 97 deletions

diff --git a/cppe/RELEASE_NOTES.txt b/cppe/RELEASE_NOTES.txt
index cac2b973932..19b871f1e4b 100644
--- a/cppe/RELEASE_NOTES.txt
+++ b/cppe/RELEASE_NOTES.txt
@@ -2,21 +2,31 @@ Ice-E 1.2.0 Release Notes
 =========================
 
 
-Platform Support
-----------------
-
-Ice-E no longer officially supports the following platforms:
-
- * Fedora Core 4
- * Windows 2000
+New Supported Platforms
+-----------------------
 
-The following platforms are now officially supported:
+The following platforms are now supported for Ice-E:
 
  * Windows Vista
  * Windows Mobile 5.0
  * Windows Mobile 6
  * SuSE Enterprise 10 Linux
  * Gumstix Linux
+ * Java 5
+ * Java 6
+
+For the complete list of supported platforms, please see
+
+  http://www.zeroc.com/icee/platforms.html
+
+
+Desupported Platforms
+---------------------
+
+Ice-E no longer supports the following platforms:
+
+ * Fedora Core 4
+ * Windows 2000
 
 The following C++ compilers are no longer supported:
 
@@ -28,18 +38,32 @@ For Java, we no longer support:
 
  * JDK 1.1.8
 
-The following are now supported for Java:
 
- * Java 5
- * Java 6
+API Changes - General
+---------------------
 
-For the complete list of supported platforms, please see
+- Added Communicator::propertyToProxy() which creates a proxy from
+  a set of properties. This operation allows you to set various local
+  proxy settings, such as the locator, which cannot be set using
+  stringToProxy().
 
-  http://www.zeroc.com/icee/platforms.html
+- Message batches are now automatically flushed when the total size of
+  the batch reaches the message size maximum. This feature can be
+  controlled using the Ice.BatchAutoFlush property, which is on by
+  default.
 
+- If a proxy does not specify a hostname (via -h HOST), the client
+  only attempts to connect to the loopback interface (127.0.0.1).
 
-API Changes - General
----------------------
+- For object adapters without endpoints, Ice.Trace.Network >= 2 now
+  prints a trace message.
+
+- Added a new Slice metadata tag for operations. The ["nonmutating"]
+  tag provides backward compatibility for idempotent operations that
+  were previously declared using the deprecated 'nonmutating' keyword.
+  You can replace the 'nonmutating' keyword with '["nonmutating"]
+  idempotent' to maintain compatibility with objects implemented using
+  earlier versions.
 
 - Added the following proxy methods:
 
@@ -87,54 +111,6 @@ API Changes - General
   The initializeWithXXX functions have been deprecated and the
   setLogger() operation has been removed.
 
-
-API Changes - C++ Only
-----------------------
-
-- The ice_name() member function of exceptions derived from
-  Ice::Exception (and, hence, IceUtil::Exception) now returns a
-  non-const string instead of a const string:
-
-  const ::std::string ice_name() const; // Old signature
-
-  ::std::string ice_name() const; // New signature
-
-- The signature of createProperties(argc, argv) is now:
-
-  PropertiesPtr createProperties(int* argc, char* argv[],
-                                 const PropertiesPtr& defaults = 0,
-                                 const StringConverterPtr& conv = 0);
-
-  where "defaults" represents an optional set of default properties
-  used to initialize the new Properties object. Ice properties
-  defined on the command line and properties defined in a
-  configuration file override these default properties.
-
-  If a string converter is supplied, it is only invoked when a program
-  calls the Properties::load operation. Each key and value in the
-  property file is passed to the converter.
-
-
-API Changes - Java Only
------------------------
-
-- Added new createProperties() methods:
-
-  public static Properties
-  createProperties(StringSeqHolder args, Properties defaults)
-
-  public static Properties
-  createProperties(String[] args, Properties defaults)
-
-  "defaults" represents an optional set of default properties
-  used to initialize the new Properties object. Ice properties
-  defined on the command-line and properties defined in the Ice
-  config file may override these default properties.
-
-
-Removed Features
-----------------
-
 - Removed most specializations of the Ice::ProtocolException local
   exception to reduce code size. Only the following specializations
   were kept:
@@ -155,36 +131,9 @@ Removed Features
 - Removed support for local interfaces in Slice.
 
 
-New Features - General
+API Changes - C++ Only
 ----------------------
 
-- Added Communicator::propertyToProxy() which creates a proxy from
-  a set of properties. This operation allows you to set various local
-  proxy settings, such as the locator, which cannot be set using
-  stringToProxy().
-
-- Message batches are now automatically flushed when the total size of
-  the batch reaches the message size maximum. This feature can be
-  controlled using the Ice.BatchAutoFlush property, which is on by
-  default.
-
-- If a proxy does not specify a hostname (via -h HOST), the client
-  only attempts to connect to the loopback interface (127.0.0.1).
-
-- For object adapters without endpoints, Ice.Trace.Network >= 2 now
-  prints a trace message.
-
-- Added a new Slice metadata tag for operations. The ["nonmutating"]
-  tag provides backward compatibility for idempotent operations that
-  were previously declared using the deprecated 'nonmutating' keyword.
-  You can replace the 'nonmutating' keyword with '["nonmutating"]
-  idempotent' to maintain compatibility with objects implemented using
-  earlier versions.
-
-
-New Features - C++ Only
------------------------
-
 - Added a new Slice metadata tag for operations. The ["cpp:const"] tag
   generates a const member function on the corresponding servant base
   class.
@@ -205,6 +154,14 @@ New Features - C++ Only
   what() is implemented in terms of toString(), so overriding
   toString() also changes the string returned by what().
 
+- The ice_name() member function of exceptions derived from
+  Ice::Exception (and, hence, IceUtil::Exception) now returns a
+  non-const string instead of a const string:
+
+  const ::std::string ice_name() const; // Old signature
+
+  ::std::string ice_name() const; // New signature
+
 - For non-abstract Slice classes, the generated C++ code now has a
   protected destructor. This prevents accidental allocation of
   class instances on the stack or as static variables. For the
@@ -226,12 +183,34 @@ New Features - C++ Only
 - Added support for the new Slice metadata tag ["cpp:type:wstring"],
   which generates code to use std::wstring instead of std::string.
 
+- The signature of createProperties(argc, argv) is now:
+
+  PropertiesPtr createProperties(int* argc, char* argv[],
+                                 const PropertiesPtr& defaults = 0,
+                                 const StringConverterPtr& conv = 0);
+
+  where "defaults" represents an optional set of default properties
+  used to initialize the new Properties object. Ice properties
+  defined on the command line and properties defined in a
+  configuration file override these default properties.
+
+  If a string converter is supplied, it is only invoked when a program
+  calls the Properties::load operation. Each key and value in the
+  property file is passed to the converter.
+
 
-Bug Fixes - C++ Only
---------------------
+API Changes - Java Only
+-----------------------
 
-- Fixed a bug where proxy operator< could return an incorrect result
-  for proxies of different types (e.g., direct vs. indirect proxies).
+- Added new createProperties() methods:
 
-- Fixed an assert that could occur when a proxy received over the
-  wire contained an unknown endpoint.
+  public static Properties
+  createProperties(StringSeqHolder args, Properties defaults)
+
+  public static Properties
+  createProperties(String[] args, Properties defaults)
+
+  "defaults" represents an optional set of default properties
+  used to initialize the new Properties object. Ice properties
+  defined on the command-line and properties defined in the Ice
+  config file may override these default properties.