RFR: JDK-8179022 Add serialization spec as markdown

Magnus Ihse Bursie magnus.ihse.bursie at oracle.com
Thu Apr 20 13:49:14 UTC 2017


Here's the first step towards fixing JDK-8177434 
<https://bugs.openjdk.java.net/browse/JDK-8177434>. A framework is added 
for converting markdown specs to html using pandoc. The Java 
serialization spec is added in markdown format as a proof of concept. I 
also reintroduced the functionality to enable full docs if all 
prerequisites are present.

Note that this fix is dependent on the patch for JDK-8178038 et al that 
is currently out for review. The webrev is created with that patch as 
baseline.

This fix is part of JEP 299. I intend to push it to jdk9.

Here's an example of the generated output:
http://cr.openjdk.java.net/~ihse/JDK-8179022-javadoc-output-demo/specs/serialization/

Bug: https://bugs.openjdk.java.net/browse/JDK-8179022
WebRev: 
http://cr.openjdk.java.net/~ihse/JDK-8179022-add-markdown-serialization-spec/webrev.01

/Magnus



More information about the build-dev mailing list