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

[Julien Fischer]

On Wed, 11 Jan 2023, Peter Wang wrote:

> 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.

Some of the trailing whitespace is required to force line breaks
in Markdown; I've fixed the spots where it isn't.

Julien.