javadoc crash on JDK 11 caused by @SuppressWarnings annotations

2021-06-16 Thread Rick Hillegas
I work on Apache Derby. Derby is one of the applications which receive advance notice of new Open JDK distributions. We then build our application with the new JDK's javac and javadoc tools and we run our full test suite against the new JVM. As a canary in the mineshaft, we noticed the followin

Re: best practice for including images in the javadoc headers of module descriptors

2019-01-15 Thread Rick Hillegas
f you are not using the -html4 option, and are using the default (-html5), then you're probably generating bad HTML which may not pass a conformance checker and/or may not display correctly in all browsers. -- Jon On 01/12/2019 09:23 AM, Rick Hillegas wrote: I would appreciate y

best practice for including images in the javadoc headers of module descriptors

2019-01-12 Thread Rick Hillegas
I would appreciate your advice about the best practice for handling the following problem. The structure of the generated javadoc tree appears to have changed substantially between Java 9 and Java 11. I noticed this because my module descriptors include tags, which pull corresponding module

Re: generating module-aware javadoc for internal packages

2018-06-19 Thread Rick Hillegas
e module's API. You may also want to note that package names can be specified in the form module/package if you wish to disambiguate the module containing a specific package. -- Jon On 06/17/2018 03:45 PM, Rick Hillegas wrote: I would appreciate your advice about how to genera

a second question: running javadoc against multiple modules

2018-06-18 Thread Rick Hillegas
Hi Jon, Thanks again for answering my first question. I have made some progress toward generating module-aware javadoc for the Apache Derby project. Now I have a second problem which puzzles me. The following command successfully generates module-aware javadoc for almost all of the packages

generating module-aware javadoc for internal packages

2018-06-18 Thread Rick Hillegas
I would appreciate your advice about how to generate module-aware documentation for internal packages which have not been exported by the corresponding module info. Given the attached project, the following command works fine... javadoc -d ./build/javadoc \   -Xdoclint:none \   --module-sour

Re: Fwd: Re: running javadoc against multiple modules

2018-06-04 Thread Rick Hillegas
would be         --patch-module org.test.firstmodule=./java/firstmodule     And you would repeat that as needed for all the other modules you want to pass to javadoc -- Jon On 5/30/18 4:08 PM, Rick Hillegas wrote: Thanks for that explanation, Jon. I'm asking these questions because

Re: Fwd: Re: running javadoc against multiple modules

2018-05-30 Thread Rick Hillegas
ween the module directory and the root of the package hierarchy. The module paths are described in JEP 261. http://openjdk.java.net/jeps/261 Although that JEP does not call out javadoc, the description for javac essentially applies to javadoc as well. -- Jon On 5/29/18 4:02 PM, Rick Hillegas

Fwd: Re: running javadoc against multiple modules

2018-05-30 Thread Rick Hillegas
ource-path ./java -d build/javadoc --module firstmodule,secondmodule -- Jon On 05/20/2018 04:45 PM, Rick Hillegas wrote: I hope that someone can point me at the right documentation for how to create javadoc on a multi-module project. My naive googling does not find any pertinent examples for how

running javadoc against multiple modules

2018-05-24 Thread Rick Hillegas
I hope that someone can point me at the right documentation for how to create javadoc on a multi-module project. My naive googling does not find any pertinent examples for how to do this from the command line via the javadoc tool. I have looked through the Java 9 tools documents titled "Javadoc

Re: primer for writing Java 9 taglets

2016-08-01 Thread Rick Hillegas
On 7/12/16 7:22 PM, Jonathan Gibbons wrote: On 07/12/2016 06:45 PM, Rick Hillegas wrote: Hi Jon, Thanks for replying. Some comments inline... On 7/11/16 7:00 PM, Jonathan Gibbons wrote: On 07/11/2016 06:28 PM, Rick Hillegas wrote: Hey folks, Is there a primer for writing Java 9 Taglets

Re: primer for writing Java 9 taglets

2016-08-01 Thread Rick Hillegas
https://issues.apache.org/jira/browse/DERBY-6856 Thanks again for your help, -Rick On 7/16/16, 8:30 AM, Rick Hillegas wrote: On 7/12/16 7:22 PM, Jonathan Gibbons wrote: On 07/12/2016 06:45 PM, Rick Hillegas wrote: Hi Jon, Thanks for replying. Some comments inline... On 7/11/16 7:00 PM, Jonathan Gibbons

Re: primer for writing Java 9 taglets

2016-07-12 Thread Rick Hillegas
Hi Jon, Thanks for replying. Some comments inline... On 7/11/16 7:00 PM, Jonathan Gibbons wrote: On 07/11/2016 06:28 PM, Rick Hillegas wrote: Hey folks, Is there a primer for writing Java 9 Taglets which is similar to the primer for writing old-style Taglets found here: http

primer for writing Java 9 taglets

2016-07-11 Thread Rick Hillegas
Hey folks, Is there a primer for writing Java 9 Taglets which is similar to the primer for writing old-style Taglets found here: http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/taglet/overview.html. I am trying to get a clean, warning-free build of Apache Derby using b124 of JDK