Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-24 Thread Kevin Rushforth
On Sat, 24 Jul 2021 12:56:32 GMT, Michael Strauß wrote: > I think it might be better to expand the scope of the issue to not only > include the documentation changes, but also the implementation changes as > discussed in this PR. In this case, I will mark this as a Draft PR and target > it to

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-24 Thread Michael Strauß
On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß wrote: >> * Expand the `Property.bind` and `Property.bindBidirectional` documentation >> * Change the name of the formal parameter of `Property.bind` to "source" >> (currently, it is inconsistently named "observable", "rawObservable" or >> "newOb

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-15 Thread Kevin Rushforth
On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß wrote: >> * Expand the `Property.bind` and `Property.bindBidirectional` documentation >> * Change the name of the formal parameter of `Property.bind` to "source" >> (currently, it is inconsistently named "observable", "rawObservable" or >> "newOb

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-13 Thread Nir Lisker
On Mon, 12 Jul 2021 22:27:12 GMT, Kevin Rushforth wrote: >> The following unit test demonstrated the *current* behavior, though maybe >> it's not the desired one: >> >> >> import static org.junit.Assert.*; >> >> import javafx.beans.property.IntegerProperty; >> import javafx.beans.property.Sim

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-12 Thread Kevin Rushforth
On Sat, 10 Jul 2021 12:33:52 GMT, Nir Lisker wrote: >> Maybe we could simply the mental model of the property specification by >> making it illegal in all cases to use unidirectional and bidirectional >> bindings at the same time. The specification would be reduced to "it's >> illegal", instea

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-10 Thread Nir Lisker
On Sat, 10 Jul 2021 01:44:43 GMT, Michael Strauß wrote: >> modules/javafx.base/src/main/java/javafx/beans/property/Property.java line >> 111: >> >>> 109: * established. However, doing so is not a meaningful use of this >>> API, because the >>> 110: * unidirectionally bound property w

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-09 Thread Michael Strauß
On Fri, 9 Jul 2021 22:17:21 GMT, Kevin Rushforth wrote: >> Michael Strauß has updated the pull request incrementally with one >> additional commit since the last revision: >> >> changes as per review > > modules/javafx.base/src/main/java/javafx/beans/property/Property.java line > 111: > >>

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-09 Thread Kevin Rushforth
On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß wrote: >> * Expand the `Property.bind` and `Property.bindBidirectional` documentation >> * Change the name of the formal parameter of `Property.bind` to "source" >> (currently, it is inconsistently named "observable", "rawObservable" or >> "newOb

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-09 Thread Kevin Rushforth
On Thu, 24 Jun 2021 01:17:55 GMT, Nir Lisker wrote: >> Michael Strauß has updated the pull request incrementally with one >> additional commit since the last revision: >> >> changes as per review > > modules/javafx.base/src/main/java/javafx/beans/property/Property.java line > 120: > >> 118:

Re: [jfx17] RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-09 Thread Kevin Rushforth
On Thu, 24 Jun 2021 02:35:37 GMT, Nir Lisker wrote: >> That's an interesting observation. The way I read it, "the" sounds very >> specific, like we're talking about a particular binding to a particular >> source. However, `unbind()` doesn't only remove _one_ particular binding, it >> removes _

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-07-08 Thread Kevin Rushforth
On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß wrote: >> * Expand the `Property.bind` and `Property.bindBidirectional` documentation >> * Change the name of the formal parameter of `Property.bind` to "source" >> (currently, it is inconsistently named "observable", "rawObservable" or >> "newOb

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-06-28 Thread Marius Hanl
On Thu, 24 Jun 2021 01:53:53 GMT, Michael Strauß wrote: >> * Expand the `Property.bind` and `Property.bindBidirectional` documentation >> * Change the name of the formal parameter of `Property.bind` to "source" >> (currently, it is inconsistently named "observable", "rawObservable" or >> "newOb

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-06-23 Thread Nir Lisker
On Thu, 24 Jun 2021 02:20:09 GMT, Michael Strauß wrote: >> modules/javafx.base/src/main/java/javafx/beans/property/Property.java line >> 68: >> >>> 66: >>> 67: /** >>> 68: * Removes a unidirectional binding that was established with >>> {@link #bind(ObservableValue)}. >> >> Why "**a

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-06-23 Thread Michael Strauß
On Thu, 24 Jun 2021 01:00:54 GMT, Nir Lisker wrote: >> Michael Strauß has updated the pull request incrementally with one >> additional commit since the last revision: >> >> changes as per review > > modules/javafx.base/src/main/java/javafx/beans/property/Property.java line 68: > >> 66: >>

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation [v2]

2021-06-23 Thread Michael Strauß
> * Expand the `Property.bind` and `Property.bindBidirectional` documentation > * Change the name of the formal parameter of `Property.bind` to "source" > (currently, it is inconsistently named "observable", "rawObservable" or > "newObservable") Michael Strauß has updated the pull request increm

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation

2021-06-23 Thread Nir Lisker
On Mon, 14 Jun 2021 17:06:34 GMT, Michael Strauß wrote: > * Expand the `Property.bind` and `Property.bindBidirectional` documentation > * Change the name of the formal parameter of `Property.bind` to "source" > (currently, it is inconsistently named "observable", "rawObservable" or > "newObserv

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation

2021-06-15 Thread Nir Lisker
On Mon, 14 Jun 2021 17:06:34 GMT, Michael Strauß wrote: > * Expand the `Property.bind` and `Property.bindBidirectional` documentation > * Change the name of the formal parameter of `Property.bind` to "source" > (currently, it is inconsistently named "observable", "rawObservable" or > "newObserv

Re: RFR: 8268642: Expand the javafx.beans.property.Property documentation

2021-06-14 Thread Kevin Rushforth
On Mon, 14 Jun 2021 17:06:34 GMT, Michael Strauß wrote: > * Expand the `Property.bind` and `Property.bindBidirectional` documentation > * Change the name of the formal parameter of `Property.bind` to "source" > (currently, it is inconsistently named "observable", "rawObservable" or > "newObserv

RFR: 8268642: Expand the javafx.beans.property.Property documentation

2021-06-14 Thread Michael Strauß
* Expand the `Property.bind` and `Property.bindBidirectional` documentation * Change the name of the formal parameter of `Property.bind` to "source" (currently, it is inconsistently named "observable", "rawObservable" or "newObservable") - Commit messages: - Expanded Property docum