Re: RFR: JDK-8275518: accessibility issue in Inet6Address docs

2021-10-26 Thread Daniel Fuchs
On Tue, 19 Oct 2021 13:50:20 GMT, Ludvig Janiuk wrote: > Single-row table was being used as a hack here, a description list > seems more appropriate Hi Ludwik, it's the first time I see ``, ``, and `` being used in API documentation so I'd like to see some confirmation from the javadoc team th

Re: RFR: JDK-8269401: Merge "Exceptions" and "Errors" into "Exception Classes" [v2]

2021-10-26 Thread Jonathan Gibbons
On Tue, 26 Oct 2021 12:57:22 GMT, Pavel Rappo wrote: >> Separately, I have *long* wanted a general clean up on resource naming, >> replacing the pervasive boring ubiquitous less-than-helpful `doclet.` prefix >> with something more informative. I would like to see a prefix that indicates >> the

Re: JEP 413 Questions

2021-10-26 Thread Jonathan Gibbons
On 10/26/21 5:46 AM, Pavel Rappo wrote: * When not explicitly specifying the snippet path, where will JavaDoc look for the default exactly? Say I'm following the standard Maven project structure with a source dir under src/main/java, where would the snippet directory be expected by default? I'

Re: RFR: JDK-8275518: accessibility issue in Inet6Address docs

2021-10-26 Thread Ludvig Janiuk
On Tue, 26 Oct 2021 12:44:38 GMT, Pavel Rappo wrote: >> Single-row table was being used as a hack here, a description list >> seems more appropriate > > Would it be possible to build documentation for that page to see how it looks? @pavelrappo here's a screengrab from my local build. It doesn't

Re: RFR: JDK-8269401: Merge "Exceptions" and "Errors" into "Exception Classes" [v2]

2021-10-26 Thread Pavel Rappo
On Tue, 26 Oct 2021 00:11:02 GMT, Jonathan Gibbons wrote: >> There's old naming and new naming. We still use old naming for older >> releases, and use the new naming for recent releases. There's low-level code >> to select the right form, depending on the version. >> >> So yes, for now, the i

Re: JEP 413 Questions

2021-10-26 Thread Pavel Rappo
> On 18 Oct 2021, at 16:32, Gunnar Morling wrote: > > > > I've had a few questions about things which were not quite clear to me from > the JEP: > > * When not explicitly specifying the snippet path, where will JavaDoc look > for the default exactly? Say I'm following the standard Maven pr