src/java.base/share/classes/java/lang/Boolean.java

*** 115,125 ****
  
      /**
       * Parses the string argument as a boolean.  The {@code boolean}
       * returned represents the value {@code true} if the string argument
       * is not {@code null} and is equal, ignoring case, to the string
!      * {@code "true"}. <p>
       * Example: {@code Boolean.parseBoolean("True")} returns {@code true}.<br>
       * Example: {@code Boolean.parseBoolean("yes")} returns {@code false}.
       *
       * @param      s   the {@code String} containing the boolean
       *                 representation to be parsed
--- 115,127 ----
  
      /**
       * Parses the string argument as a boolean.  The {@code boolean}
       * returned represents the value {@code true} if the string argument
       * is not {@code null} and is equal, ignoring case, to the string
!      * {@code "true"}. 
!      * Otherwise, a false value is returned, including for a null
!      * argument.<p>
       * Example: {@code Boolean.parseBoolean("True")} returns {@code true}.<br>
       * Example: {@code Boolean.parseBoolean("yes")} returns {@code false}.
       *
       * @param      s   the {@code String} containing the boolean
       *                 representation to be parsed
*** 163,172 ****
--- 165,176 ----
      /**
       * Returns a {@code Boolean} with a value represented by the
       * specified string.  The {@code Boolean} returned represents a
       * true value if the string argument is not {@code null}
       * and is equal, ignoring case, to the string {@code "true"}.
+      * Otherwise, a false value is returned, including for a null
+      * argument.
       *
       * @param   s   a string.
       * @return  the {@code Boolean} value represented by the string.
       */
      public static Boolean valueOf(String s) {
*** 239,256 ****
          return false;
      }
  
      /**
       * Returns {@code true} if and only if the system property named
!      * by the argument exists and is equal to the string {@code
!      * "true"}. (Beginning with version 1.0.2 of the Java&trade;
!      * platform, the test of this string is case insensitive.) A
!      * system property is accessible through {@code getProperty}, a
!      * method defined by the {@code System} class.
!      * <p>
!      * If there is no property with the specified name, or if the specified
!      * name is empty or null, then {@code false} is returned.
       *
       * @param   name   the system property name.
       * @return  the {@code boolean} value of the system property.
       * @throws  SecurityException for the same reasons as
       *          {@link System#getProperty(String) System.getProperty}
--- 243,258 ----
          return false;
      }
  
      /**
       * Returns {@code true} if and only if the system property named
!      * by the argument exists and is equal to, ignoring case, the
!      * string {@code "true"}.
!      * A system property is accessible through {@code getProperty}, a
!      * method defined by the {@code System} class.  <p> If there is no
!      * property with the specified name, or if the specified name is
!      * empty or null, then {@code false} is returned.
       *
       * @param   name   the system property name.
       * @return  the {@code boolean} value of the system property.
       * @throws  SecurityException for the same reasons as
       *          {@link System#getProperty(String) System.getProperty}