src/share/classes/javax/naming/LinkException.java

*** 24,38 ****
   */
  
  package javax.naming;
  
  /**
!  * This exception is used to describe problems encounter while resolving links.
!  * Addition information is added to the base NamingException for pinpointing
   * the problem with the link.
   *<p>
!  * Analogous to how NamingException captures name resolution information,
   * LinkException captures "link"-name resolution information pinpointing
   * the problem encountered while resolving a link. All these fields may
   * be null.
   * <ul>
   * <li> Link Resolved Name. Portion of link name that has been resolved.
--- 24,38 ----
   */
  
  package javax.naming;
  
  /**
!  * This exception is used to describe problems encountered while resolving links.
!  * Additional information is added to the base NamingException for pinpointing
   * the problem with the link.
   *<p>
!  * Analogously to how NamingException captures name resolution information,
   * LinkException captures "link"-name resolution information pinpointing
   * the problem encountered while resolving a link. All these fields may
   * be null.
   * <ul>
   * <li> Link Resolved Name. Portion of link name that has been resolved.
*** 109,119 ****
       * @see #setLinkExplanation
       */
      protected String linkExplanation;
  
      /**
!       * Constructs a new instance of LinkException with an explanation
        * All the other fields are initialized to null.
        * @param  explanation     A possibly null string containing additional
        *                         detail about this exception.
        * @see java.lang.Throwable#getMessage
        */
--- 109,119 ----
       * @see #setLinkExplanation
       */
      protected String linkExplanation;
  
      /**
!       * Constructs a new instance of LinkException with an explanation.
        * All the other fields are initialized to null.
        * @param  explanation     A possibly null string containing additional
        *                         detail about this exception.
        * @see java.lang.Throwable#getMessage
        */
*** 174,184 ****
      public Object getLinkResolvedObj() {
          return this.linkResolvedObj;
      }
  
      /**
!       * Retrieves the explanation associated with the problem encounter
        * when resolving a link.
        *
        * @return The possibly null detail string explaining more about the problem
        * with resolving a link.
        *         If null, it means there is no
--- 174,184 ----
      public Object getLinkResolvedObj() {
          return this.linkResolvedObj;
      }
  
      /**
!       * Retrieves the explanation associated with the problem encountered
        * when resolving a link.
        *
        * @return The possibly null detail string explaining more about the problem
        * with resolving a link.
        *         If null, it means there is no
*** 188,198 ****
      public String getLinkExplanation() {
          return this.linkExplanation;
      }
  
      /**
!       * Sets the explanation associated with the problem encounter
        * when resolving a link.
        *
        * @param msg The possibly null detail string explaining more about the problem
        * with resolving a link. If null, it means no detail will be recorded.
        * @see #getLinkExplanation
--- 188,198 ----
      public String getLinkExplanation() {
          return this.linkExplanation;
      }
  
      /**
!       * Sets the explanation associated with the problem encountered
        * when resolving a link.
        *
        * @param msg The possibly null detail string explaining more about the problem
        * with resolving a link. If null, it means no detail will be recorded.
        * @see #getLinkExplanation
*** 209,219 ****
       * "stringify" the compound name, and create a composite
       * name with a single component using the string. You can then
       * invoke this method using the resulting composite name.
       *<p>
       * A copy of <code>name</code> is made and stored.
!      * Subsequent changes to <code>name</code> does not
       * affect the copy in this NamingException and vice versa.
       *
       *
       * @param name The name to set resolved link name to. This can be null.
       *          If null, it sets the link resolved name field to null.
--- 209,219 ----
       * "stringify" the compound name, and create a composite
       * name with a single component using the string. You can then
       * invoke this method using the resulting composite name.
       *<p>
       * A copy of <code>name</code> is made and stored.
!      * Subsequent changes to <code>name</code> do not
       * affect the copy in this NamingException and vice versa.
       *
       *
       * @param name The name to set resolved link name to. This can be null.
       *          If null, it sets the link resolved name field to null.
*** 235,245 ****
       * "stringify" the compound name, and create a composite
       * name with a single component using the string. You can then
       * invoke this method using the resulting composite name.
       *<p>
       * A copy of <code>name</code> is made and stored.
!      * Subsequent changes to <code>name</code> does not
       * affect the copy in this NamingException and vice versa.
       *
       * @param name The name to set remaining link name to. This can be null.
       *  If null, it sets the remaining name field to null.
       * @see #getLinkRemainingName
--- 235,245 ----
       * "stringify" the compound name, and create a composite
       * name with a single component using the string. You can then
       * invoke this method using the resulting composite name.
       *<p>
       * A copy of <code>name</code> is made and stored.
!      * Subsequent changes to <code>name</code> do not
       * affect the copy in this NamingException and vice versa.
       *
       * @param name The name to set remaining link name to. This can be null.
       *  If null, it sets the remaining name field to null.
       * @see #getLinkRemainingName