On Fri, 9 Apr 2021 21:50:39 GMT, Alexey Ushakov <a...@openjdk.org> wrote:

> Implemented apple.awt.windowTitleVisible property to control window title 
> visibility

> _Mailing list message from [Alan Snyder](mailto:javali...@cbfiddle.com) on 
> [awt-dev](mailto:awt-...@mail.openjdk.java.net):_
> 
> > No, AFAIK, we don't have any javadoc cocerning these properties. I suppose 
> > it's OK because they control platform specific window properties and rich 
> > client applications heavily depend on them. Without such properties java 
> > client applications use some hacks with JNA library to change native peers.
> 
> I do not understand this as a justification for a lack of documentation.
> 
> What is it about rich client applications that makes it OK for application 
> developers to have to view internal JDK source code to find the property 
> names or even to know which properties are supported?
> 
> In the old days (when Apple owned this code), they had a tech report that 
> documented the properties.
> Something is needed to replace that (long gone and now incomplete) tech 
> report.
> 
> Alan
> 
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL: 
> <https://mail.openjdk.java.net/pipermail/awt-dev/attachments/20210427/5fef7516/attachment-0001.htm>

Yes, I think it's a good idea. I'll file a separate CR on this. We need some 
info about the properties at least on awt/2d OpenJDK wiki.

-------------

PR: https://git.openjdk.java.net/jdk/pull/3425

Reply via email to