Re: RFR: 8319324: FFM: Reformat javadocs [v3]

2023-11-06 Thread Per Minborg
On Mon, 6 Nov 2023 11:41:23 GMT, Maurizio Cimadamore wrote: > You might also want to look into the MethodHandles XYZCoordinates combinators > (as they have also been added as part of FFM). And, also, > `ModuleLayer::Controller::enableNativeAccess`, > `Module::isNativeAccessEnabled` and `FileC

Re: RFR: 8319324: FFM: Reformat javadocs [v3]

2023-11-06 Thread Per Minborg
On Mon, 6 Nov 2023 13:27:40 GMT, Jorn Vernee wrote: > FWIW, I've been sticking to a soft 120 character limit per line when writing > javadoc. Why should we use 90 columns specifically? > > > It is also customary to use double spaces when starting a new sentence. > > I thought this was the exce

Re: RFR: 8319324: FFM: Reformat javadocs [v3]

2023-11-06 Thread Jorn Vernee
On Mon, 6 Nov 2023 10:10:41 GMT, Per Minborg wrote: >> This PR proposes to reformat all the JavaDocs for the FFM API. This would >> bring the FFM API docs more in line with the existing Java documentation >> (see below). Occasional drive-by fixes are also included in this PR (such >> as spell

Re: RFR: 8319324: FFM: Reformat javadocs [v3]

2023-11-06 Thread Maurizio Cimadamore
On Mon, 6 Nov 2023 10:10:41 GMT, Per Minborg wrote: >> This PR proposes to reformat all the JavaDocs for the FFM API. This would >> bring the FFM API docs more in line with the existing Java documentation >> (see below). Occasional drive-by fixes are also included in this PR (such >> as spell

Re: RFR: 8319324: FFM: Reformat javadocs [v3]

2023-11-06 Thread Per Minborg
> This PR proposes to reformat all the JavaDocs for the FFM API. This would > bring the FFM API docs more in line with the existing Java documentation (see > below). Occasional drive-by fixes are also included in this PR (such as > spelling and capitalization). > > I am aware this PR will (if