Hello Experts,
I have discovered a nice side-effect of deploying our artifacts to a
Sonatype nexus server: web browsable -javadoc.jars. Apologies if this
is already common knowledge.
To see this in action, go to maven.java.net and type "javax.faces-api"
into the search bar, then select the 2.2-SNAPSHOT row in the table in
the top panel.
With that selected, go to the tree viewer and select the
2.2-SNAPSHOT-javadoc.jar. Then, in the bottom right panel use the
"Archive Browser" tab to expose the "index.html" [1]. Clicking on this
lets you browse the entire generated javadoc/vdldoc/jsdoc/renderkitdoc
of the JSF spec. It wouldn't be hard to have the PDF in there as well.
Thankfully, it preserves the color coded changebars so that you can see,
for each spec area, what is new. I even put a cheesy watermark there to
make it clear this is an Expert Draft version.
The next step is to hook this up to a nightly hudson job.
[1]
https://maven.java.net/service/local/repositories/snapshots/archive/javax/faces/javax.faces-api/2.2-SNAPSHOT/javax.faces-api-2.2-20110815.153114-4-javadoc.jar/!/index.html
--
| edward.burns_at_oracle.com | office: +1 407 458 0017
| homepage: | http://ridingthecrest.com/
| 27 business days until JSF 2.2 Early Draft Review
| 31 business days until JavaOne 2011