src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java

*** 41,53 ****
   * Access Protocol (v3): Extension for Transport Layer Security</a>
   *
   * The object identifier for StartTLS is 1.3.6.1.4.1.1466.20037
   * and no extended request value is defined.
   *<p>
!  * <tt>StartTlsRequest</tt>/<tt>StartTlsResponse</tt> are used to establish
   * a TLS connection over the existing LDAP connection associated with
!  * the JNDI context on which <tt>extendedOperation()</tt> is invoked.
   * Typically, a JNDI program uses these classes as follows.
   * <blockquote><pre>
   * import javax.naming.ldap.*;
   *
   * // Open an LDAP association
--- 41,53 ----
   * Access Protocol (v3): Extension for Transport Layer Security</a>
   *
   * The object identifier for StartTLS is 1.3.6.1.4.1.1466.20037
   * and no extended request value is defined.
   *<p>
!  * {@code StartTlsRequest}/{@code StartTlsResponse} are used to establish
   * a TLS connection over the existing LDAP connection associated with
!  * the JNDI context on which {@code extendedOperation()} is invoked.
   * Typically, a JNDI program uses these classes as follows.
   * <blockquote><pre>
   * import javax.naming.ldap.*;
   *
   * // Open an LDAP association
*** 125,144 ****
       * The result must be a concrete subclass of StartTlsResponse
       * and must have a public zero-argument constructor.
       * <p>
       * This method locates the implementation class by locating
       * configuration files that have the name:
!      * <blockquote><tt>
       *     META-INF/services/javax.naming.ldap.StartTlsResponse
!      * </tt></blockquote>
       * The configuration files and their corresponding implementation classes must
       * be accessible to the calling thread's context class loader.
       * <p>
       * Each configuration file should contain a list of fully-qualified class
       * names, one per line.  Space and tab characters surrounding each name, as
!      * well as blank lines, are ignored.  The comment character is <tt>'#'</tt>
!      * (<tt>0x23</tt>); on each line all characters following the first comment
       * character are ignored.  The file must be encoded in UTF-8.
       * <p>
       * This method will return an instance of the first implementation
       * class that it is able to load and instantiate successfully from
       * the list of class names collected from the configuration files.
--- 125,144 ----
       * The result must be a concrete subclass of StartTlsResponse
       * and must have a public zero-argument constructor.
       * <p>
       * This method locates the implementation class by locating
       * configuration files that have the name:
!      * <blockquote>{@code 
       *     META-INF/services/javax.naming.ldap.StartTlsResponse
!      * }</blockquote>
       * The configuration files and their corresponding implementation classes must
       * be accessible to the calling thread's context class loader.
       * <p>
       * Each configuration file should contain a list of fully-qualified class
       * names, one per line.  Space and tab characters surrounding each name, as
!      * well as blank lines, are ignored.  The comment character is {@code '#'}
!      * ({@code 0x23}); on each line all characters following the first comment
       * character are ignored.  The file must be encoded in UTF-8.
       * <p>
       * This method will return an instance of the first implementation
       * class that it is able to load and instantiate successfully from
       * the list of class names collected from the configuration files.