On Wed, 7 Apr 2021 20:34:22 GMT, Alexey Ivanov wrote:
>>> I dont see any update in JDK-8264217. Is this then considered to be a
>>> javadoc bug?
>>
>> It does not matter is it a JavaDoc bug or feature. If it is a bug it will be
>> fixed and spec will be returned for the current method. If it
> On 4/1/21 5:43 AM, Kevin Rushforth wrote:
>>>
>>> The |javadoc| tool (or the standard doclet) used to automatically copy
>>> the description from the superclass, and it seems that it no longer
>>> does. Perhaps @jonathan-gibbons
>>> <h
The |javadoc| tool (or the standard doclet) used to automatically copy
> the description from the superclass, and it seems that it no longer
> does. Perhaps @jonathan-gibbons
> <https://urldefense.com/v3/__https://github.com/jonathan-gibbons__;!!GqivPVa7Brio!Nt46yROIsMrLvPBMvzgGTeSnh
On Tue, 26 Jan 2021 18:33:48 GMT, Alexey Ivanov wrote:
>>> Probably we can import the CSS used by the javadoc itself?
>>
>> We do. For example, [AWT Modality in JDK
>> 15](https://docs.oracle.com/en/java/javase/15/docs/api/java.desktop/java/awt/doc-files/Modality.html)
>> has borders because
On Thu, 10 Sep 2020 12:04:48 GMT, Dmitriy Dumanskiy
wrote:
> I have in mind dozens of improvements all over the code like this one.
That sounds scary. Broad updates like these cause unnecessary churn in the
codebase, and can make merging and back
porting harder. Changes should be discussed
"Invisible" captions need to be discussed for our documentation in general.
Although is optional for HTML 5, the accessibility guidelines
that we follow require that we use it. We need to work to provide useful
(and visible) captions on tables.
-- Jon
On 06/21/2019 01:54 PM, Alexey Ivanov
Sounds good; note you should cc: build-dev@ojn for changes to build files.
-- Jon
On 3/21/19 3:23 AM, Prasanta Sadhukhan wrote:
FYI...it does build fine with this build change.
Regards
Prasanta
On 19-Mar-19 10:58 PM, Jonathan Gibbons wrote:
Prasanta,
Note that if you believe you have fixed
Prasanta,
Note that if you believe you have fixed all the heading issues in the
java.desktop module,
you can re-enable the doclint checks for the module by removing
"-accessibility" from
the java.desktop line in make/CompileJavaModules.gmk
://cr.openjdk.java.net/~psadhukhan/8220250/webrev.2/
Any more comments?
Regards
Prasanta
On 09-Mar-19 2:24 AM, Jonathan Gibbons wrote:
Prasanta,
You should double check this file:
http://cr.openjdk.java.net/~psadhukhan/8220250/webrev.1/src/java.desktop/share/classes/javax/print/attribute/package
Hi Prasanta,
You mentioned the tool I was using to find the issues with headings...
It's a bit of a hack -- it's an annotation processor that can be run by
javac --
but while it is reasonably good at _detecting, it is not good at
checking that
you have fixed them _correctly_. This is because
This is an FYI to announce some initial, long-overdue support in javadoc
for documenting system properties (JDK-5076751).
Currently, system properties are just documented using ad-hoc narrative
text, which is fine if you know where to look for any given property.
JDK 12 introduces a new
On 05/17/2017 11:52 AM, Jonathan Gibbons wrote:
Phil,
The bottom line is that in the JDK docs, tables should not have a
summary attribute and should have a caption. This comes down to
accessibility requirements, where we are slowly raising the bar on
our docs, to be in accordance with Oracle
to be
visible when we were fine without.
But being there and invisible may be pointless unless screen readers
look for it even if invisible.
But if its not doing any harm I guess we can leave it as proposed
I still need to look at the rest of the changes.
-phil.
On 05/12/2017 05:11 PM, Jo
Sergey,
FWIW, the invisible caption should be regarded as a temporary solution,
until content authors can review/update the text of the caption and make
it visible.
The general guideline in this conversion work has been to avoid changing
the visible text of the specification, and captions
On 05/12/2017 05:03 PM, Philip Race wrote:
On 5/12/17, 4:58 PM, Jonathan Gibbons wrote:
Phil,
1. javadoc now provides support for 3 named styles in the default
stylesheet:
borderless: no borders
plain: simple 1px borders around tables and cells
striped: reduced
Phil,
1. javadoc now provides support for 3 named styles in the default
stylesheet:
borderless: no borders
plain: simple 1px borders around tables and cells
striped: reduced borders; rows have alternating white and light
grey backgrounds
2. summary attributes are
Sergey,
This is not a comment on the content of the review; it is a minor
comment on your interpretation of .
is a block-level tag that is implicitly terminated by any of many
block-level tags. For the full list, see the W3C definition of the p
element in HTML 5:
There is no issue here and the tests that used to work with jtreg b05
didn't do what you thought they did. Just look at the .jtr file and see
what jtreg actually did before.
First, you need to realize that @build is a shorthand for @run
build.The section on shorthands is in the very next
18 matches
Mail list logo
