Details
-
Enhancement
-
Resolution: Fixed
-
P3
-
9
-
b167
Backports
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8179712 | 10 | Magnus Ihse Bursie | P3 | Resolved | Fixed | b07 |
Description
The proposal is to add a configure option to generate .png files from .dot files. This should be enabled when generating the docs bundle for Oracle build.
The input file is $BUILD_OUTPUTDIR/images/spec-dotfiles/$MODULE.dot
The output file for the docs bundle is:
$BUILD_OUTPUTDIR/images/docs/api/$MODULE-graph.png
This is the path where @moduleGraph taglet will depend on.
$BUILD_OUTPUTDIR/spec-dotfiles/*.dot files are generated during the `images` target using GenGraphs build tool. That can be refactored if desired but this can only be done after the exploded image is built.
This is not required byJDK-8173303 but a nice-to-have feature. When the build is configured to run `dot` to generate .png files, it would be nice to provide a make target to generate .png files in $BUILD_OUTPUTDIR/images/gengraphs and spec-dotfiles (dot -Tpng -o $MODULE.png $MODULE.dot). JDK developer can run that target when we want to look at the graph rather than invoking `dot` ourselves. I mention this because that may influence the decision in the build logic whether the build will generate .png files and do the copying to `docs/api` directory.
The input file is $BUILD_OUTPUTDIR/images/spec-dotfiles/$MODULE.dot
The output file for the docs bundle is:
$BUILD_OUTPUTDIR/images/docs/api/$MODULE-graph.png
This is the path where @moduleGraph taglet will depend on.
$BUILD_OUTPUTDIR/spec-dotfiles/*.dot files are generated during the `images` target using GenGraphs build tool. That can be refactored if desired but this can only be done after the exploded image is built.
This is not required by
Attachments
Issue Links
- backported by
-
JDK-8179712 Add build support to generate PNG file from .dot file
-
- Resolved
-
- is blocked by
-
JDK-8172312 Update docs target and image for new combined docs
-
- Resolved
-
-
JDK-8173303 Add module-subgraph images to main platform documentation
-
- Resolved
-
- relates to
-
JDK-8173303 Add module-subgraph images to main platform documentation
-
- Resolved
-