8199176: Accessibility issues in java.base docs

Reviewed-by: lancea, alanb, jjg, rriggs
This commit is contained in:
Joe Wang 2018-04-02 16:39:17 -07:00
parent 87e7768a1c
commit dd67e0fa16
10 changed files with 49 additions and 51 deletions

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -90,7 +90,7 @@
* The calendar neutral API should be reserved for interactions with users.
* </p>
*
* <h3>Dates and Times</h3>
* <h2>Dates and Times</h2>
* <p>
* {@link java.time.Instant} is essentially a numeric timestamp.
* The current Instant can be retrieved from a {@link java.time.Clock}.
@ -118,7 +118,7 @@
* The widespread use of time-zones tends to add considerable complexity to an application.
* </p>
*
* <h3>Duration and Period</h3>
* <h2>Duration and Period</h2>
* <p>
* Beyond dates and times, the API also allows the storage of periods and durations of time.
* A {@link java.time.Duration} is a simple measure of time along the time-line in nanoseconds.
@ -126,7 +126,7 @@
* to humans, such as years or days.
* </p>
*
* <h3>Additional value types</h3>
* <h2>Additional value types</h2>
* <p>
* {@link java.time.Month} stores a month on its own.
* This stores a single month-of-year in isolation, such as 'DECEMBER'.
@ -160,7 +160,7 @@
* but contains less information than a full time-zone.
* </p>
*
* <h3>Package specification</h3>
* <h2>Package specification</h2>
* <p>
* Unless otherwise noted, passing a null argument to a constructor or method in any class or interface
* in this package will cause a {@link java.lang.NullPointerException NullPointerException} to be thrown.
@ -172,7 +172,7 @@
* or a {@link java.time.DateTimeException}.
* </p>
*
* <h3>Design notes (non normative)</h3>
* <h2>Design notes (non normative)</h2>
* <p>
* The API has been designed to reject null early and to be clear about this behavior.
* A key exception is any method that takes an object and returns a boolean, for the purpose