[m-rev.] for review: update and rewrite README.Java

[Peter Wang]

On Tue, 10 Jan 2023 19:45:11 +1100 Julien Fischer <jfischer at opturion.com> wrote:
> 
> For review by anyone.
> 
> I've attached both the diff and the updated version of README.Java.
> 
> -------------------------------------------
> 
> Update and rewrite README.Java.
> 
> Convert it to Markdown.
> 
> README.Java:
>      Add a .md extension.
> 
>      Update many of the details in this file.
> 
>      Add a table-of-contents.
> 
>      Break up the FAQ into separate named sections.
> 
> README.md:
>      Conform to the above change of name.
> 

That's fine. There are trailing spaces on a few lines.

Peter