[jfx15] RFR: 8228570: Add various documentation clarifications [v4]

[Nir Lisker]

On Tue, 11 Aug 2020 20:37:54 GMT, Kevin Rushforth <kcr at openjdk.org> wrote:

>> Nir Lisker has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Reverted transforms-related changes and added API note for getProperties
>
> modules/javafx.controls/src/main/java/javafx/scene/control/Pagination.java line 90:
> 
>> 89:  *     public Node call(Integer pageIndex) {
>> 90:  *         return new Label(pageIndex + 1 + ". Lorem ipsum dolor sit amet,\n"
>> 91:  *                      + "consectetur adipiscing elit,\n"
> 
> Do you think we need keep the non-lambda version of the example? It's up to you.

Other controls have them, so I kept it.

-------------

PR: https://git.openjdk.java.net/jfx/pull/276