markdown source for manpages in the jdk source tree

Jonathan Dowland jdowland at
Mon Oct 12 13:48:51 UTC 2020


I was investigating some bugs in manpages in the backports projects
(jdk8u, jdk11) and I was very pleased to discover that the main project
sources had moved to a Pandoc-based generation scheme¹ in 2018.

I started exploring the feasibility of backporting this to jdk11 (and/or
jdk8u) when I realised that the Markdown sources for the documentation
were not committed at the same time. And as best as I can determine, or
since. However: the *output* of the Pandoc generation process has had
patches applied to them². (I don't know whether those changes are
reflected in the Markdown sources).

Can anyone tell me please whether this is by accident, or design? And in
either case, are the Markdown sources publically available somewhere, or
could they be?

¹ git commit 2ddd78e8259652c7c88a5bb7150d7b6ab0e089e2
² e.g. 27c77d3d29184fb052a3803984222ac2ea10a816,


���� Jonathan Dowland <jdowland at>
Senior Software Engineer, OpenJDK, Red Hat

More information about the jdk-dev mailing list