Add automatic initialization of SecureSocket library.

sdk/lib/io/secure_socket.dart

Index: sdk/lib/io/secure_socket.dart
diff --git a/sdk/lib/io/secure_socket.dart b/sdk/lib/io/secure_socket.dart
index 1dd433e7b0d687fcd107d1e26c85794c4bdff2be..2ece3c92d3ac6d2d6ef6431ec6f0ad63b8979ed3 100644
--- a/sdk/lib/io/secure_socket.dart
+++ b/sdk/lib/io/secure_socket.dart
@@ -7,7 +7,7 @@ part of dart.io;
 /**
  * SecureSocket provides a secure (SSL or TLS) client connection to a server.
  * The certificate provided by the server is checked
- * using the certificate database provided in setCertificateDatabase.
+ * using the certificate database (optionally) provided in initialize().
  */
 abstract class SecureSocket implements Socket {
   /**
@@ -49,12 +49,16 @@ abstract class SecureSocket implements Socket {
   X509Certificate get peerCertificate;
 
    /**
-   * Initializes the NSS library with the path to a certificate database
+   * Initializes the NSS library.  If [initialize] is not called, the library
+   * is automatically initialized as if [initialize] were called with no
+   * arguments.
+   *
+   * The optional argument [database] is the path to a certificate database
    * containing root certificates for verifying certificate paths on
    * client connections, and server certificates to provide on server
-   * connections.  The password argument should be used when creating
+   * connections.  The argument [password] should be used when creating
    * secure server sockets, to allow the private key of the server
-   * certificate to be fetched.  If useBuiltinRoots is true (the default),
+   * certificate to be fetched.  If [useBuiltinRoots] is true (the default),
    * then a built-in set of root certificates for trusted certificate
    * authorities is merged with the certificates in the database.
    *
@@ -75,7 +79,7 @@ abstract class SecureSocket implements Socket {
    * containing a cert9.db file, not a cert8.db file.  This version of
    * the database can be created using the NSS certutil tool with "sql:" in
    * front of the absolute path of the database directory, or setting the
-   * environment variable NSS_DEFAULT_DB_TYPE to "sql".
+   * environment variable [[NSS_DEFAULT_DB_TYPE]] to "sql".
    */
   external static void initialize({String database,
                                    String password,