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!Nt46yROIsMrLvPBMvzgG
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 o
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 ah
"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
make/CompileJavaModules.gmk:java.desktop_ADD_JAVAC_FL
http://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/pa
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-info.java.udiff.html
Previously, it was a mixture of and , suggesting that the
were subheadings of the enclosing logical section.
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 inlin
se ..
-phil.
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
;d want it 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
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 fa
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 n
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:
https://www.w3.org/TR/html
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 ver
I'll try and get the example fixed.
-- Jon
On May 21, 2009, at 10:15 AM, Andrew John Hughes wrote:
2009/5/21 Jonathan Gibbons :
Andrew,
Yes, Contributed-by: just takes a simple email address. It'll be
munged (@
-> " at ") automatically on web pages.
-- Jon
U
Andrew,
Yes, Contributed-by: just takes a simple email address. It'll be
munged (@ -> " at ") automatiocally on web pages.
-- Jon
On May 21, 2009, at 8:51 AM, Andrew John Hughes wrote:
2009/5/21 Mark Reinhold :
Date: Mon, 18 May 2009 19:17:21 +0100
From: Andrew John Hughes
Ok, new
On May 15, 2009, at 9:00 AM, Mark Reinhold wrote:
Date: Fri, 15 May 2009 16:30:04 +0100
From: Andrew John Hughes
I was thinking this as I read your mail. It should be easy enough to
add this as an #else clause to the existing patch in Sanity.gmk.
What's the best way to handle updating the
22 matches
Mail list logo