-
Bug
-
Resolution: Fixed
-
P3
-
9
-
b161
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8176908 | 10 | Magnus Ihse Bursie | P3 | Resolved | Fixed | b03 |
JDK-8320062 | openjdk8u402 | Zdenek Zambersky | P3 | Resolved | Fixed | b03 |
Since JDK-8139668, the build README html file has been generated from a markdown source.
Unfortunately, this implementation used the original markdown (from https://daringfireball.net/projects/markdown/), which was quite limited, and did not for instance allow for tables.
Now that JEP 299 is about to standardize on using pandoc to convert markdown to man pages, I think it would be reasonable to use it to convert the build README to html as well.
I also used this opportunity to clean up redundant and/or incorrect information spread in the READMEs all over the forest, and to move the build READMEs to a better location.
Please note that the *content* of the README file is severly outdated (not to mention unstructured and sometimes irrelevant), but updating that is not part of the scope for this bug. I will follow up on it, though.
Unfortunately, this implementation used the original markdown (from https://daringfireball.net/projects/markdown/), which was quite limited, and did not for instance allow for tables.
Now that JEP 299 is about to standardize on using pandoc to convert markdown to man pages, I think it would be reasonable to use it to convert the build README to html as well.
I also used this opportunity to clean up redundant and/or incorrect information spread in the READMEs all over the forest, and to move the build READMEs to a better location.
Please note that the *content* of the README file is severly outdated (not to mention unstructured and sometimes irrelevant), but updating that is not part of the scope for this bug. I will follow up on it, though.
- backported by
-
JDK-8176908 Use pandoc for converting build readme to html
-
- Resolved
-
-
JDK-8320062 Use pandoc for converting build readme to html
-
- Resolved
-
- duplicates
-
JDK-8140394 Sub-repo README files are not up to date
-
- Closed
-