JDK-8170074 : Typos on "How Classes are Found" web page on Oracle site
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 8,9
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: windows_7
  • CPU: x86_64
  • Submitted: 2016-10-31
  • Updated: 2021-02-16
  • Resolved: 2020-03-20
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8u261 b01Fixed
Description
A DESCRIPTION OF THE PROBLEM :
In the section "How the Java Runtime Finds User Classes", there are several typos that should be corrected to get the details correct:

1) In the second para, the leading [back]slash should be removed from each of the cited Solaris and Windows paths; it is not stated that the myclasses directory is a subfolder of the root directory, which the full pathnames imply/specify.

2) In the third para, the names of the two operating systems should be swapped so that the correct [back]slash-ed pathname is associated.

3) In the first bullet, the name of the folder should be JUST . and not *.* which is in keeping with the rest of the working and the current implementation (as confirmed by the sample demo program I submitted with my earlier bug report today.


EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
See Description
ACTUAL -
See Description

URL OF FAULTY DOCUMENTATION :
http://docs.oracle.com/javase/8/docs/technotes/tools/unix/findingclasses.html
Comments
Fixed the issue. Pushed the doc changes to JDK 8 repo.
20-03-2020
Fixed the issue. Pushed the changes to JDK 8 repo. Changeset: 3246461cd89d Author: pprasad Date: 2020-03-20 11:13 +0530 URL: http://closedjdk.us.oracle.com/jdk8u/jdk8u-cpu/pubs/rev/3246461cd89d
20-03-2020
Looks good. Thanks.
18-03-2020
Thanks David. I have corrected the paths. Please find attached the file findingclasses_Windows_version2.html
18-03-2020
The issues mentioned in this bug report appear to have been resolved in the updated files. However the Windows version also refers to non-Windows paths in the JDK/JRE e.g. jre/lib instead of jre\lib, and /lib/tools.jar instead of lib\tools.jar etc.
18-03-2020
[~dholmes] I have incorporated your feedback. Now, the Unix version has information correctly formatted for that environment and same with the Windows version. PFA the .html files for the respective versions. Please see section: How the Java Runtime Finds User Classes Thanks for your help.
18-03-2020
If there are separate "unix" and Windows versions of this document then the unix version should not mention Windows or any \foo\bar paths; and the Windows version should not mention Oracle Solaris or any /foo/bar paths. Each version of the document should simply have the correctly formatted examples for that environment, with no explicit mention of the actual operating system.
21-11-2019
Hi [~dholmes], I have fixed these typos in both the unix and windows versions. Request you to suggest a reviewer for this bug. Appreciate your help! Note: I have attached the html files (unix and windows versions) with the fixes. Please see section: How the Java Runtime Finds User Classes thanks
21-11-2019
There are 3 issues reported 1) In the second para, the leading [back]slash should be removed from each of the cited Solaris and Windows paths; it is not stated that the myclasses directory is a subfolder of the root directory, which the full pathnames imply/specify. -- When we mention /myclasses it indicates that it starts from root directory, so it has to be corrected to locate the proper directory /[directory]/.../myclasses or simply myclasses/com/mypackage/MyClass.class 2) In the second para, the leading [back]slash should be removed from each of the cited Solaris and Windows paths; it is not stated that the myclasses directory is a subfolder of the root directory, which the full pathnames imply/specify. -- It mentioned about windows path like "com/mypackage/MyClass.class" which is wrong it should be corrected to "com\mypackage\MyClass.class" and vice versa for Oracle Solaris 3) In the first bullet, the name of the folder should be JUST . and not *.* which is in keeping with the rest of the working and the current implementation (as confirmed by the sample demo program I submitted with my earlier bug report today. --"The default value, *.*, which means that user class files are all the class files in or under the current directory". This should be corrected to "The default value, ., which means that user class files are all the class files in or under the current directory". or "The default value, ".", which means that user class files are all the class files in or under the current directory".
21-11-2016