minor edits

6 files changed, 184 insertions, 114 deletions

diff --git a/cpp/install/unix/README.Darwin b/cpp/install/unix/README.Darwin
index a2e2054524a..a96720ba095 100644
--- a/cpp/install/unix/README.Darwin
+++ b/cpp/install/unix/README.Darwin
@@ -88,19 +88,24 @@ below:
 $ export PATH=$ICE_HOME/bin:$PATH
 
 Ice shared libraries and executables in this distribution contain 
-/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services 
-and tools, you can either:
- - create a symbolic link /opt/Ice-@mmver@ that points to your Ice
-   installation.
-     $ ln -s $ICE_HOME /opt/Ice-@mmver@
- - or add $ICE_HOME/lib to your DYLD_LIBRARY_PATH environment variable 
-     $ export DYLD_LIBRARY_PATH=$ICE_HOME/lib:$DYLD_LIBRARY_PATH
+/opt/Ice-@mmver@/lib as the embedded runpath. In order to run Ice
+services and tools, you can do one of the following:
+
+ - Create a symbolic link /opt/Ice-@mmver@ that points to your Ice
+   installation:
+
+   $ ln -s $ICE_HOME /opt/Ice-@mmver@
+
+ - Add $ICE_HOME/lib to your DYLD_LIBRARY_PATH environment variable:
+
+   $ export DYLD_LIBRARY_PATH=$ICE_HOME/lib:$DYLD_LIBRARY_PATH
 
 On Intel platforms, you also need to set DYLD_BIND_AT_LAUNCH to
 prevent random crashes at runtime in the dynamic linker binding code:
 
 $ export DYLD_BIND_AT_LAUNCH=1
 
+
 C++
 ---
 
@@ -171,7 +176,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
@@ -193,4 +198,3 @@ With the binary installers, simply uninstall the previous version of
 Ice and install the new one. Already deployed applications that were
 compiled against the <x>.<y>.0 runtime will automatically use the
 <x>.<y>.1 runtime.
-
diff --git a/cpp/install/unix/README.HP-UX b/cpp/install/unix/README.HP-UX
index d1d380863af..84a108d485f 100644
--- a/cpp/install/unix/README.HP-UX
+++ b/cpp/install/unix/README.HP-UX
@@ -51,7 +51,9 @@ Java
 ----
 
 Ice for Java requires J2SE 1.4.2 or 1.5.0. Java for HP-UX is available
-from HP at http://www.hp.com/products1/unix/java
+from HP at
+
+  http://www.hp.com/products1/unix/java
 
 
 ======================================================================
@@ -63,22 +65,24 @@ This distribution includes the C++ and Java runtime for Berkeley DB
 was built using HP aC++ version A.03.56. The Berkeley DB and OpenSSL
 licenses are provided in the file THIRD_PARTY_LICENSE.
 
+
 ======================================================================
 Ice extension for Python
 ======================================================================
 
-Ice for Python is fully supported on HP-UX. However it is not 
-included in this distribution because there is no suitable binary
-distribution for Python itself available from HP and other common
-repositories for HP-UX software.
+Ice for Python is fully supported on HP-UX. However it is not included
+in this distribution because there is no suitable binary distribution
+for Python itself available from HP or other common repositories for
+HP-UX software.
+
+If you want to use Ice for Python on HP-UX, you can build the source
+distribution available at 
 
-If you want to use Ice for Python on HP-UX, you can build Ice for 
-Python using its source distribution, available at 
-http://www.zeroc.com/download.html.
+  http://www.zeroc.com/download.html
 
 
 ======================================================================
-64 bit builds
+64-bit builds
 ======================================================================
 
 This distribution only contains 32-bit binaries. If you need a 64-bit
@@ -105,13 +109,18 @@ below:
 $ export PATH=$ICE_HOME/bin:$PATH
 
 Ice shared libraries and executables in this distribution contain 
-/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services 
-and tools, you can either:
- - create a symbolic link /opt/Ice-@mmver@ that points to your Ice
-   installation.
-     $ ln -s $ICE_HOME /opt/Ice-@mmver@
- - or add $ICE_HOME/lib to your SHLIB_PATH environment variable 
-     $ export SHLIB_PATH=$ICE_HOME/lib:$SHLIB_PATH
+/opt/Ice-@mmver@/lib as the embedded runpath. In order to run Ice
+services and tools, you can do one of the following:
+
+ - Create a symbolic link /opt/Ice-@mmver@ that points to your Ice
+   installation:
+
+   $ ln -s $ICE_HOME /opt/Ice-@mmver@
+
+ - Add $ICE_HOME/lib to your SHLIB_PATH environment variable:
+
+   $ export SHLIB_PATH=$ICE_HOME/lib:$SHLIB_PATH
+
 
 C++
 ---
@@ -173,7 +182,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
@@ -196,8 +205,9 @@ Ice and install the new one. Already deployed applications that were
 compiled against the <x>.<y>.0 runtime will automatically use the
 <x>.<y>.1 runtime.
 
+
 ======================================================================
-Acknowledgements
+Acknowledgments
 ======================================================================
 
 This product includes software developed by the OpenSSL Project for
diff --git a/cpp/install/unix/README.Linux-RPM b/cpp/install/unix/README.Linux-RPM
index 1ea1c1b7307..10d6cb0db15 100644
--- a/cpp/install/unix/README.Linux-RPM
+++ b/cpp/install/unix/README.Linux-RPM
@@ -37,11 +37,12 @@ Additional Ice components are provided in separate RPM packages:
 
 These RPMs are available for download at the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Note: Ice Ruby RPMs are currently available only on Red Hat Enterprise
 Linux.
 
+
 ======================================================================
 Setting up your environment to use Ice
 ======================================================================
@@ -90,7 +91,7 @@ this issue by editing the following file
 
 and changing it to use /dev/urandom instead of /dev/random. If you do
 not have permission to modify the security file, you can also use the
-command line option shown below:
+command-line option shown below:
 
 $ java -Djava.security.egd=file:/dev/urandom MyClass ...
 
@@ -101,7 +102,10 @@ java.net.preferIPv4Stack to true. For example:
 
 $ java -Djava.net.preferIPv4Stack=true MyClass ...
 
-See also: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6483406
+For more information on this issue, refer to Sun's bug database:
+
+  http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6483406
+
 
 Python
 ------
@@ -117,6 +121,7 @@ On a x86_64 system, the python Ice extension is installed in
 
 $ export PYTHONPATH=/usr/lib64/Ice-@ver@/python:$PYTHONPATH
 
+
 C#/Mono
 -------
 
@@ -143,6 +148,7 @@ mono. For example,
 
 $ mono server.exe
 
+
 Ruby
 ----
 
@@ -159,12 +165,14 @@ $ export RUBYLIB=/usr/lib64/Ice-@ver@/ruby:$RUBYLIB
 Note: Ice Ruby RPMs are currently available only on Red Hat Enterprise
 Linux.
 
+
 PHP
 ---
 
 The Ice extension for PHP is loaded automatically when the interpreter
 loads the contents of the file /etc/php.d/ice.ini (on Red Hat Enterprise
-Linux) or /etc/php5/conf.d/ice.ini (on SuSE Linux Enterprise Server):
+Linux) or /etc/php5/conf.d/ice.ini (on SuSE Linux Enterprise Server).
+This file contains the line shown below:
 
 extension=IcePHP.so
 
@@ -180,12 +188,13 @@ phpinfo() function from a script.
 
 On SuSE Linux Enterprise Server 10, you need to install php5 version 
 5.1.2-29.22 or greater (as long as the greater version maintains 
-binary compatibility). 
-php5 5.1.2-29.22 is not binary compatible with the php5 RPM (version
-5.1.2-29.5) included in the original SuSE Linux Enterprise Server 10 
-distribution.
+binary compatibility). Note that php5 5.1.2-29.22 is not binary
+compatible with the php5 RPM (version 5.1.2-29.5) included in the
+original SuSE Linux Enterprise Server 10 distribution.
 
-SELinux Notes (for Red Hat Enterprise Linux users):
+
+SELinux Notes (for Red Hat Enterprise Linux users)
+--------------------------------------------------
 
 SELinux augments the traditional Unix permissions with a number of
 new features. In particular, SELinux can prevent the httpd daemon from
@@ -193,7 +202,7 @@ opening network connections and reading files without the proper
 SELinux types.
 
 If you suspect that your IcePHP application does not work due to
-SELinux restrictions, we recommend that you first try with SELinux
+SELinux restrictions, we recommend that you first try it with SELinux
 disabled. As root, run:
 
 # setenforce 0
@@ -215,9 +224,10 @@ the following:
 
   # chcon -R -t httpd_sys_content_t /opt/MyApp/slice 
 
-See this FAQ for more information on SELinux:
+For more information on SELinux in Red Hat Enterprise Linux 4, refer
+to the link below:
 
-http://fedora.redhat.com/docs/selinux-faq/
+  http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
 
 
 ======================================================================
@@ -232,14 +242,14 @@ associated configuration files:
 - /etc/init.d/glacier2router and /etc/glacier2router.conf
 
 None of these services are enabled during the RPM installation; you 
-need to manually enable the desired service(s) with:
-# chkconfig --add <service-name>
-for example:
+need to manually enable the desired service(s) using the chkconfig
+command, for example:
+
 # chkconfig --add icegridregistry
 
 Before doing so, please review the script itself and its associated
 configuration file. You should create one or more accounts to run 
-these services ('iceuser' in the sample scripts); for icegridregistry
+these services ('iceuser' in the sample scripts). For icegridregistry
 and icegridnode, you also need to create 'data' directories with the 
 proper permissions (refer to the .conf files).
 
@@ -267,7 +277,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
diff --git a/cpp/install/unix/README.RHEL b/cpp/install/unix/README.RHEL
index 6b08f80828a..8a36d146cb6 100644
--- a/cpp/install/unix/README.RHEL
+++ b/cpp/install/unix/README.RHEL
@@ -49,9 +49,9 @@ This distribution depends on a number of third-party libraries:
 All of these libraries are included with your RHEL4 distribution in the
 following RPMs:
 
-expat 	       expat
-OpenSSL	       openssl
-bzip2          bzip2-libs
+expat:	       expat
+OpenSSL:       openssl
+bzip2:         bzip2-libs
 
 
 Java
@@ -60,40 +60,45 @@ Java
 Ice for Java requires Java 1.4.2, 1.5.0 or 1.6.0. RPMs can be obtained 
 from Sun Microsystems at http://java.sun.com.
 
+
 Python
 ------
 
 The Ice extension for Python included in this distribution requires
 the installation of the RHEL4 python RPM.
 
+
 C#
 --
 
-Ice for C# requires Mono 1.2.2 or later. You can download the corresponding
-RPM at:
-http://www.go-mono.com/download/x86/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.i586.rpm
-http://www.go-mono.com/download/x86_64/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.x86_64.rpm
+Ice for C# requires Mono 1.2.2 or later. You can download an RPM at:
+
+  http://www.go-mono.com/download/x86/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.i586.rpm
+  http://www.go-mono.com/download/x86_64/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.x86_64.rpm
 
 
 Ruby
 ----
-The Ice extension for Ruby included in this distribution requires
-the installation of the RHEL4 ruby RPM.
+
+The Ice extension for Ruby included in this distribution requires the
+installation of the RHEL4 ruby RPM.
+
 
 PHP
 ---
 
 The Ice extension for PHP included in this distribution requires
-PHP 5.1.6. You can download the corresponding RPM from the Centos Plus
+PHP 5.1.6. You can download the appropriate RPMs from the Centos Plus
 repository:
 
-http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-pear-1.4.9-1.2.centos.noarch.rpm
+  http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-pear-1.4.9-1.2.centos.noarch.rpm
+
+  http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-5.1.6-1.2.1.centos.i386.rpm
+  http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-devel-5.1.6-1.2.1.centos.i386.rpm
 
-http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-5.1.6-1.2.1.centos.i386.rpm
-http://mirror.centos.org/centos/4/centosplus/i386/RPMS/php-devel-5.1.6-1.2.1.centos.i386.rpm
+  http://mirror.centos.org/centos/4/centosplus/x86_64/RPMS/php-5.1.6-1.2.1.centos.x86_64.rpm
+  http://mirror.centos.org/centos/4/centosplus/x86_64/RPMS/php-devel-5.1.6-1.2.1.centos.x86_64.rpm
 
-http://mirror.centos.org/centos/4/centosplus/x86_64/RPMS/php-5.1.6-1.2.1.centos.x86_64.rpm
-http://mirror.centos.org/centos/4/centosplus/x86_64/RPMS/php-devel-5.1.6-1.2.1.centos.x86_64.rpm
 
 ======================================================================
 Berkeley DB
@@ -103,6 +108,7 @@ This distribution includes the C++ and Java runtime for Berkeley DB
 4.5.20. The Berkeley DB license is provided in the file 
 THIRD_PARTY_LICENSE.
 
+
 ======================================================================
 Setting up your environment to use Ice
 ======================================================================
@@ -121,17 +127,24 @@ below:
 $ export PATH=$ICE_HOME/bin:$PATH
 
 Ice shared libraries and executables in this distribution contain 
-/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services 
-and tools, you can either:
- - create a symbolic link /opt/Ice-@mmver@ that points to your Ice
-   installation.
-     $ ln -s $ICE_HOME /opt/Ice-@mmver@
- - or add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable 
-     $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+/opt/Ice-@mmver@/lib as the embedded runpath. In order to run Ice
+services and tools, you can do one of the following:
+
+ - Create a symbolic link /opt/Ice-@mmver@ that points to your Ice
+   installation:
+
+   $ ln -s $ICE_HOME /opt/Ice-@mmver@
+
+ - Add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable:
+
+   $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+
    With the x86_64 distribution, libraries are installed in 
    $ICE_HOME/lib64; if you use this distribution, set your 
    LD_LIBRARY_PATH as follows:
-     $ export LD_LIBRARY_PATH=$ICE_HOME/lib64:$LD_LIBRARY_PATH
+
+   $ export LD_LIBRARY_PATH=$ICE_HOME/lib64:$LD_LIBRARY_PATH
+
 
 C++
 ---
@@ -214,11 +227,12 @@ mono. For example,
 
 $ mono server.exe
 
+
 Ruby
 ---
 
-To use Ice for Ruby, the RUBYLIB environment variable must be
-updated so that the interpreter can locate the Ruby extension.
+To use Ice for Ruby, the RUBYLIB environment variable must be updated
+so that the interpreter can locate the Ruby extension.
 
 $ export RUBYLIB=$ICE_HOME/ruby:$RUBYLIB
 
@@ -226,8 +240,8 @@ $ export RUBYLIB=$ICE_HOME/ruby:$RUBYLIB
 PHP
 ---
 
-The Ice extension for PHP must be added to your PHP configuration
-by editing php.ini and adding the following lines:
+The Ice extension for PHP must be added to your PHP configuration by
+editing php.ini and adding the following lines:
 
 extension_dir = <ICE_HOME>/lib
 extension = IcePHP.so
@@ -244,7 +258,9 @@ You can verify that the Ice extension is installed properly by
 examining the output of the "php -m" command, or by calling the
 phpinfo() function from a script.
 
-SELinux Notes:
+
+SELinux Notes
+-------------
 
 SELinux augments the traditional Unix permissions with a number of
 new features. In particular, SELinux can prevent the httpd daemon from
@@ -252,7 +268,7 @@ opening network connections and reading files without the proper
 SELinux types.
 
 If you suspect that your IcePHP application does not work due to
-SELinux restrictions, we recommend that you first try with SELinux
+SELinux restrictions, we recommend that you first try it with SELinux
 disabled. As root, run:
 
 # setenforce 0
@@ -274,9 +290,10 @@ the following:
 
   # chcon -R -t httpd_sys_content_t /opt/MyApp/slice 
 
-See this FAQ for more information on SELinux:
+For more information on SELinux in Red Hat Enterprise Linux 4, refer
+to the link below:
 
-http://fedora.redhat.com/docs/selinux-faq/
+  http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
 
 
 ======================================================================
@@ -302,7 +319,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
diff --git a/cpp/install/unix/README.SLES b/cpp/install/unix/README.SLES
index eab27fc6888..fb870200a04 100644
--- a/cpp/install/unix/README.SLES
+++ b/cpp/install/unix/README.SLES
@@ -49,9 +49,9 @@ This distribution depends on a number of third-party libraries:
 All of these libraries are included with your SLES10 distribution in the
 following RPMs:
 
-expat 	       expat
-OpenSSL	       openssl
-bzip2          bzip2
+expat:	       expat
+OpenSSL:       openssl
+bzip2:         bzip2
 
 
 Java
@@ -60,30 +60,33 @@ Java
 Ice for Java requires Java 1.4.2, 1.5.0 or 1.6.0. RPMs can be obtained 
 from Sun Microsystems at http://java.sun.com.
 
+
 Python
 ------
 
 The Ice extension for Python included in this distribution requires
 the installation of the SLES10 python RPM.
 
+
 C#
 --
 
-Ice for C# requires Mono 1.2.2 or later. You can download the corresponding
-RPM at:
-http://www.go-mono.com/download/x86/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.i586.rpm
-http://www.go-mono.com/download/x86_64/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.x86_64.rpm
+Ice for C# requires Mono 1.2.2 or later. You can download the RPMs at:
+
+  http://www.go-mono.com/download/x86/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.i586.rpm
+  http://www.go-mono.com/download/x86_64/mono/1.2.2.1/mono-core-1.2.2.1-0.novell.x86_64.rpm
 
 
 PHP
 ---
 
-The Ice extension for PHP included in this distribution requires
-the SLES10 php5 RPM, version 5.1.2-29.22 or greater (as long as 
-the greater version maintains binary compatibility). 
+The Ice extension for PHP included in this distribution requires the
+SLES10 php5 RPM, version 5.1.2-29.22 or greater (as long as the
+greater version maintains binary compatibility). 
+
+Note that php5 5.1.2-29.22 is not binary compatible with the php5 RPM
+(version 5.1.2-29.5) included in the original SLES10 distribution.
 
-php5 5.1.2-29.22 is not binary compatible with the php5 RPM (version
-5.1.2-29.5) included in the original SLES10 distribution.
 
 ======================================================================
 Berkeley DB
@@ -93,6 +96,7 @@ This distribution includes the C++ and Java runtime for Berkeley DB
 4.5.20. The Berkeley DB license is provided in the file 
 THIRD_PARTY_LICENSE.
 
+
 ======================================================================
 Setting up your environment to use Ice
 ======================================================================
@@ -111,17 +115,24 @@ below:
 $ export PATH=$ICE_HOME/bin:$PATH
 
 Ice shared libraries and executables in this distribution contain 
-/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services 
-and tools, you can either:
- - create a symbolic link /opt/Ice-@mmver@ that points to your Ice
-   installation.
-     $ ln -s $ICE_HOME /opt/Ice-@mmver@
- - or add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable 
-     $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+/opt/Ice-@mmver@/lib as the embedded runpath. In order to run Ice
+services and tools, you can do one of the following:
+
+ - Create a symbolic link /opt/Ice-@mmver@ that points to your Ice
+   installation:
+
+   $ ln -s $ICE_HOME /opt/Ice-@mmver@
+
+ - Add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable:
+
+   $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+
    With the x86_64 distribution, libraries are installed in 
    $ICE_HOME/lib64; if you use this distribution, set your 
    LD_LIBRARY_PATH as follows:
-     $ export LD_LIBRARY_PATH=$ICE_HOME/lib64:$LD_LIBRARY_PATH
+
+   $ export LD_LIBRARY_PATH=$ICE_HOME/lib64:$LD_LIBRARY_PATH
+
 
 C++
 ---
@@ -181,7 +192,9 @@ java.net.preferIPv4Stack to true. For example:
 
 $ java -Djava.net.preferIPv4Stack=true MyClass ...
 
-See also: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6483406
+For more information on this issue, refer to Sun's bug database:
+
+  http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6483406
 
 
 Python
@@ -226,6 +239,7 @@ mono. For example,
 
 $ mono server.exe
 
+
 PHP
 ---
 
@@ -247,6 +261,7 @@ You can verify that the Ice extension is installed properly by
 examining the output of the "php -m" command, or by calling the
 phpinfo() function from a script.
 
+
 ======================================================================
 Using the IceGrid Administrative Console
 ======================================================================
@@ -270,7 +285,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
diff --git a/cpp/install/unix/README.SunOS b/cpp/install/unix/README.SunOS
index 9de92d56cd6..88e19d1cf17 100644
--- a/cpp/install/unix/README.SunOS
+++ b/cpp/install/unix/README.SunOS
@@ -42,18 +42,24 @@ version 5.8.
 
 The following Solaris 10 binary packages are required to use 
 this distribution:
+
 - bzip2 (Sun package SUNWbzip)
 - libexpat (Sun package SUNWlexpt)
 - openssl (Sun packages SUNWopenssl-libraries SUNWopenssl-commands)
 
-We also recommend to install the Solaris 10 Encryption Kit (Sun packages 
-SUNWcry and SUNWcryr) available at http://www.sun.com/download/index.jsp?cat=Security&tab=3&subcat=Cryptography%20%26%20Encryption
+We also recommend that you install the Solaris 10 Encryption Kit (Sun
+packages SUNWcry and SUNWcryr) available at
+
+  http://www.sun.com/download/index.jsp?cat=Security&tab=3&subcat=Cryptography%20%26%20Encryption
+
 
 Java
 ----
 
 Ice for Java requires J2SE 1.4.2, 1.5.0 or 1.6.0. RPMs can be obtained
-from Sun Microsystems at http://java.sun.com
+from Sun Microsystems at
+
+  http://java.sun.com
 
 
 ======================================================================
@@ -64,6 +70,7 @@ This distribution includes the C++ and Java runtime for Berkeley DB
 4.5.20. The C++ runtime was built using Sun CC version 5.8. The
 Berkeley DB license is provided in the file THIRD_PARTY_LICENSE.
 
+
 ======================================================================
 Ice extension for Python
 ======================================================================
@@ -73,12 +80,14 @@ included in this distribution because there is no suitable binary
 distribution for Python itself available from Sun or 
 www.sunfreeware.com. 
 
-If you want to use Ice for Python on Solaris, you can build Ice for 
-Python using its source distribution, available at 
-http://www.zeroc.com/download.html.
+If you want to use Ice for Python on Solaris, you can build a source
+distribution available at 
+
+  http://www.zeroc.com/download.html
+
 
 ======================================================================
-64 bit builds
+64-bit builds
 ======================================================================
 
 This distribution only contains 32-bit binaries. If you need a 64-bit
@@ -105,13 +114,18 @@ below:
 $ export PATH=$ICE_HOME/bin:$PATH
 
 Ice shared libraries and executables in this distribution contain 
-/opt/Ice-@mmver@/lib as embedded runpath. In order to run Ice services 
-and tools, you can either:
- - create a symbolic link /opt/Ice-@mmver@ that points to your Ice
-   installation.
-     $ ln -s $ICE_HOME /opt/Ice-@mmver@
- - or add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable 
-     $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+/opt/Ice-@mmver@/lib as the embedded runpath. In order to run Ice
+services and tools, you can do one of the following:
+
+ - Create a symbolic link /opt/Ice-@mmver@ that points to your Ice
+   installation:
+
+   $ ln -s $ICE_HOME /opt/Ice-@mmver@
+
+ - Add $ICE_HOME/lib to your LD_LIBRARY_PATH environment variable:
+
+   $ export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH
+
 
 C++
 ---
@@ -149,6 +163,7 @@ In addition, the JVM requires that the directory containing the
 Berkeley DB libraries be listed in java.library.path, therefore you
 must add this directory to LD_LIBRARY_PATH.
 
+
 ======================================================================
 Using the IceGrid Administrative Console
 ======================================================================
@@ -172,7 +187,7 @@ Demos and documentation
 Sample programs are provided in the Ice-@ver@-demos.tar.gz package,
 which can be downloaded from the ZeroC web site at
 
-http://www.zeroc.com/download.html
+  http://www.zeroc.com/download.html
 
 Please refer to the README.DEMOS file included in that package for
 more information.
@@ -194,4 +209,3 @@ With the binary installers, simply uninstall the previous version of
 Ice and install the new one. Already deployed applications that were
 compiled against the <x>.<y>.0 runtime will automatically use the
 <x>.<y>.1 runtime.
-