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

2019-01-15 Thread Rick Hillegas
Thanks for that advice, Jon. On 1/15/19 4:22 PM, Jonathan Gibbons wrote: Rick, I found your Derby documentation online with the module diagrams. Very nice! I don't know how much you have looked at how we insert the module diagrams into the JDK API documentation, but we do it with a custom

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

2019-01-15 Thread Jonathan Gibbons
Rick, I found your Derby documentation online with the module diagrams. Very nice! I don't know how much you have looked at how we insert the module diagrams into the JDK API documentation, but we do it with a custom taglet, which gives us the flexibility to vary the output. For example, if t

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

2019-01-15 Thread Jonathan Gibbons
Rick, There is, temporarily, an option to javadoc called --no-module-directories, which in JDK 11 will give you the same directory layout as in JDK 9. However, the layout in JDK 9 is bad insofar as like-named packages in different modules will overwrite each other, and so, in time, the layou

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