UseJava: add_jar documentation requires re-organization
I find the current layout of the documentation UseJava to be confusing, distracting and irritating.
As you can see there have been quite a few changes for CMake 3.4, 3.7. 3.9, 3.11, etc.. These appear in a kind of random order. This makes reading and understanding the documentation tedious.
I think it makes sense to list changes in reverse Chronological order. So, the most recent changes are listed first, and so on. Since there have been so many changes, I suggest placing them all at the end. Show the current behaviour first, perhaps with an asterix to indicate that there is changed behavior for a specific feature/option, without New in version X.Y: scattered throughout the text. Then include a list of changes in a section entitled "Changes" or something similar.
This should really be a part of the documentation Style Guide (when finally agreed upon)
I'm open to improvements to my suggestion. I am happy to work on this once an agreed standard is developed.