many security classes have javadocs like the following:

 * The Java security properties file is located in the file named
 * <JAVA_HOME>/lib/security/java.security, where <JAVA_HOME>
 * refers to the directory where the SDK was installed.

technically speaking, that is misleading. the directory where the SDK was installed is a directory i may have created myself. JAVA_HOME actually refers to the java.home system property value - something like:

  /net/jre.sfbay/p/v08/jdk/6.0/ea/b32/binaries/solaris-sparc/jre

the "jre" directory is technically "inside" the installation - it isn't the directory that i created. the javadocs should be clarified to:

 * The Java security properties file is located in the file named
 * <JAVA_HOME>/lib/security/java.security. <JAVA_HOME>
 * refers to the value of the java.home system property,
 * and specifies the directory where the JRE is installed.
###@###.### 2005-04-21 17:43:00 GMT