<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="overflow-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;">
Hi Ethan,
<div><br>
</div>
<div>JavaDoc does support different output formats through the Doclet interface. </div>
<div><br>
</div>
<div><a href="https://docs.oracle.com/en/java/javase/24/docs/api/jdk.javadoc/jdk/javadoc/doclet/package-summary.html#package-description">https://docs.oracle.com/en/java/javase/24/docs/api/jdk.javadoc/jdk/javadoc/doclet/package-summary.html#package-description</a></div>
<div><a href="https://docs.oracle.com/en/java/javase/24/docs/api/jdk.javadoc/jdk/javadoc/doclet/Doclet.html">https://docs.oracle.com/en/java/javase/24/docs/api/jdk.javadoc/jdk/javadoc/doclet/Doclet.html</a></div>
<div><br>
</div>
<div>So what you describe should be possible to do with JavaDoc.</div>
<div><br>
</div>
<div>Hannes</div>
<div><br id="lineBreakAtBeginningOfMessage">
<div><br>
<blockquote type="cite">
<div>On 20.08.2025, at 15:20, Ethan McCue <ethan@mccue.dev> wrote:</div>
<br class="Apple-interchange-newline">
<div>
<div dir="ltr">Apologies in advance for the shallowness of thought.<br>
<br>
Javadoc takes as input sources and produces as output html. When you get the docs for your JDK it comes with a nice index page documenting all the modules within.<br>
<br>
<a href="https://docs.oracle.com/en/java/javase/24/docs/api/index.html">https://docs.oracle.com/en/java/javase/24/docs/api/index.html</a><br>
<br>
When you make docs for a library, however, it starts to get a lot more split up.<br>
<br>
Is it at all feasible for javadoc to not produce html as its output but to instead produce a serialized representation of the doc-info extracted from sources? So instead of running javadoc on all the sources in the jdk and then in libraries you could have jmods<br>
<br>
<font face="monospace">java.base.jmod/</font><br>
<font face="monospace"> classes/</font><br>
<font face="monospace"> ...</font><br>
<font face="monospace"> ...</font><br>
<font face="monospace"> docs/</font><br>
<font face="monospace"> java.base.docinfo.json</font><br>
<font face="monospace">other.library/</font><br>
<font face="monospace"> ...</font><br>
<font face="monospace"> docs/</font><br>
<font face="monospace"> other.library.docinfo.json</font><br>
<br>
<font face="arial, sans-serif">And as part of a linkage step produce one mega page with all the javadoc info from all the libraries you are using.</font></div>
</div>
</blockquote>
</div>
<br>
</div>
</body>
</html>