The new standard SSL/TLS-based RMI Socket Factory classes should be documented
as part of the new RMI and Security features.

The following pages in the doc set need to be updated to reflect this fact:

1/ --------------------------------------------------------------------------
Add an entry in the Security Enhancements in the Java 2 SDK, v1.5.0 and point
to the SSL/TLS RMI Socket Factories javadoc.

URL: http://java.sun.com/j2se/1.5.0/docs/guide/security/enhancements15.html

Text: Support for the SSL/TLS-based RMI Socket Factories. For details see the
      SSL/TLS-based RMI Socket Factory classes. (link to javadoc javax.rmi.ssl)
-----------------------------------------------------------------------------

2/ --------------------------------------------------------------------------
Add an entry in the Security API Specification section named
"SSL/TLS RMI Socket Factories" with the javax.rmi.ssl package.

http://java.sun.com/j2se/1.5.0/docs/guide/security/index.html
-----------------------------------------------------------------------------

3/ --------------------------------------------------------------------------
The RMI tutorials about "Using Java RMI with SSL" publish a link to a JSSE
example that uses custom SSL RMI socket factories.

URL: http://java.sun.com/j2se/1.5.0/docs/guide/rmi/socketfactory/SSLInfo.html

Append at the end of A3 as part of the answer to Q3 the following text:

Beginning with v1.5, the Java 2 SDK provides a standard implementation of
SSL/TLS-based RMI Socket Factories. See the javax.rmi.ssl package javadoc
(link) for more detailed information on the features of these new factories.
-----------------------------------------------------------------------------

4/ --------------------------------------------------------------------------
In http://java.sun.com/j2se/1.5.0/docs/guide/security/jsse/samples/index.html
modify the README.txt file
(http://java.sun.com/j2se/1.5.0/docs/guide/security/jsse/samples/README.txt)
to add at the end of the rmi example section the following text:

This example can be easily updated to run with the new standard SSL/TLS-based
RMI Socket Factories. In order to do that modify the HelloImpl.java file to use

    javax.rmi.ssl.SslRMIClientSocketFactory
    javax.rmi.ssl.SslRMIServerSocketFactory

instead of

    RMISSLClientSocketFactory
    RMISSLServerSocketFactory

and supply the system properties

  -Djavax.net.ssl.keyStore=testkeys -Djavax.net.ssl.keyStorePassword=passphrase

in the command-line when running the HelloImpl java application.
-----------------------------------------------------------------------------