This is a placeholder bug for a major change in the JSSE API's.
During the merge of JSSE into merlin (4286923), we have the chance to update
the API's, so we will do that now.

        1) All of the com.sun.net.ssl.* are promoted to the javax.net.ssl
        packages.

            Interfaces:
            ===========
            HostnameVerifier
            KeyManager
            TrustManager
            X509KeyManager
            X509TrustManager
     
            Classes:
            ========
            HttpsURLConnection
            KeyManagerFActory
            KeyManagerFActorySpi
            SSLContext
            SSLContextSpi
            SSLPermission
            TrustManagerFactory
            TrustManagerFactorySpi

The following work is being done as part of 4286923, but I'll
mention it here for completeness.

        2) JSSE was developed before the java.security.certs package
        was widely available, so a supplemental certificate package was
        introduced in JSSE called javax.security.cert. Since JSSE is
        now bundled into JDK, we want to take advantage of the base
        certificates, and thus three new methods are introduced:
     
        OLD: public javax.security.cert.X509Certificate[]
                javax.net.ssl.getPeerCertificateChain()
                throws SSLPeerUnverifiedException
        ADD: public java.security.cert.X509Certificate[]
                javax.net.ssl.getPeerCertificates()
                throws SSLPeerUnverifiedException
     
        OLD: public javax.security.cert.X509Certificate[]
                javax.net.ssl.getPeerCertificateChain()
                throws SSLPeerUnverifiedException
        ADD: public java.security.cert.X509Certificate[]
                javax.net.ssl.getPeerCertificates()
                throws SSLPeerUnverifiedException
     
        OLD: public abstract javax.security.cert.X509Certificate[]
                com.sun.net.ssl.HttpsURLConnection.getServerCertificateChain()
        ADD: public abstract java.security.cert.X509Certificate[]
                com.sun.net.ssl.HttpsURLConnection.getServerCertificates()
                throws SSLPeerUnverifiedException
     
        The old methods are left for compatability reasons.

bradford.wetmore@eng 2000-10-26