Fix javadocs formatting for modern javadocs tool

[realityforge]

@jDramaix Any changes need to be made to this to get it accepted?

[jDramaix]

SGTM

[jDramaix]

Note: We don't close <p> tags. I removed </p> during the import

[jDramaix]

We have also decided to go with

<pre>{@code
// non escaped java code
}</pre>

Because it keep the code in the javadoc readable for human when you read the code and Intellij is able to display correctly the javadocs.

Let me know if that break some modern tools

[realityforge]

I will do. Next time I package it up I will try and verify it all still works.

Thanks

[realityforge]

Closing this as it is no longer uptodate