JDK-8062803 : 'principal' should be 'principle' in java.time package description
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.time
  • Affected Version: 8,9
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: windows_7
  • CPU: x86_64
  • Submitted: 2014-10-31
  • Updated: 2015-09-29
  • Resolved: 2015-06-17
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 JDK 9
8u60 b22Fixed 9Fixed
Description
A DESCRIPTION OF THE PROBLEM :
The two words are confused in the following:

"The first principal is that most users want the standard ISO calendar system. As such, the main classes are ISO-only. The second principal is that..."

'Principal' means first or primary as an adjective, and refers to a person as a noun, while 'principle' means rule or guideline, which is the intended meaning in the lines quoted above.

see http://www.oxforddictionaries.com/us/words/principal-or-principle

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
"The first principle is that most users want the standard ISO calendar system. As such, the main classes are ISO-only. The second principle is that..."

URL OF FAULTY DOCUMENTATION :
http://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html#package.description