Doc change

[Niclas Hedhman <ni...@hedhman.org>]

Gang,

IIUIC, the Bindable class and related support in WTKX is gone (why?).
That would mean that the FlowPane tutorial would change. I have tried
to make that change on
http://cwiki.apache.org/confluence/display/PIVOT/Flow+Panes, and would
like to hear if it is correct...


Cheers
-- 
Niclas Hedhman, Software Developer
http://www.qi4j.org - New Energy for Java

I  live here; http://tinyurl.com/2qq9er
I  work here; http://tinyurl.com/2ymelc
I relax here; http://tinyurl.com/2cgsug

Re: Doc change

[Greg Brown <gk...@mac.com>]

Moving forward, the tutorials will be stored in SVN. This will allow  
us to version the docs along with the releases. The FlowPane tutorial  
in SVN should be up to date.


On Aug 3, 2009, at 11:15 PM, Niclas Hedhman wrote:

> Gang,
>
> IIUIC, the Bindable class and related support in WTKX is gone (why?).
> That would mean that the FlowPane tutorial would change. I have tried
> to make that change on
> http://cwiki.apache.org/confluence/display/PIVOT/Flow+Panes, and would
> like to hear if it is correct...
>
>
> Cheers
> -- 
> Niclas Hedhman, Software Developer
> http://www.qi4j.org - New Energy for Java
>
> I  live here; http://tinyurl.com/2qq9er
> I  work here; http://tinyurl.com/2ymelc
> I relax here; http://tinyurl.com/2cgsug

Re: Doc change

[Todd Volkert <tv...@gmail.com>]

Yeah WTKX binding changed significantly from 1.2 to 1.3.  Greg's been
working through migrating the documentation from the Wiki into SVN so that
we can deploy it to our site in a folder hierarchy that takes versioning
into account.  Then we'll effectively deprecate our Wiki documentation and
use site documentation.

1.2 WTKX binding had some design flaws.  Foremost, it only worked for
classes that extended Bindable, which didn't work for the fairly common use
case of extending a class like Window, or Dialog (or any application in
which you had to extend some other base class).  It also caused problems if
you had multiple levels of hierarchy beneath Bindable, because each subclass
could trigger the binding process with a call to bind(), and that process
would blow away the private member variables of the other classes in the
hierarchy, effectively taking away control those classes had of when they
wanted to perform their local binding.

The new binding API (a) doesn't require you to extend any specific base
class, and (b) requires that you specify which class you're binding from so
that you don't stomp on others' toes.  It only works in a trusted context
(desktop or signed applet), but so be it -- the compile-time annotation
processing was a maintenance nightmare and had its own complications.

-T

On Mon, Aug 3, 2009 at 11:50 PM, Niclas Hedhman <ni...@hedhman.org> wrote:

> On Tue, Aug 4, 2009 at 11:15 AM, Niclas Hedhman<ni...@hedhman.org> wrote:
> > IIUIC, the Bindable class and related support in WTKX is gone (why?).
> > That would mean that the FlowPane tutorial would change. I have tried
> > to make that change on
> > http://cwiki.apache.org/confluence/display/PIVOT/Flow+Panes, and would
> > like to hear if it is correct...
>
> Alright, I now realize that this is a 1.2 -> 1.3 change, and that
> raises another question; How are we going to organize the correct
> documentation to the people running their version?
>
> Meanwhile, I am reverting my changes...
>
> Cheers
> --
> Niclas Hedhman, Software Developer
> http://www.qi4j.org - New Energy for Java
>
> I  live here; http://tinyurl.com/2qq9er
> I  work here; http://tinyurl.com/2ymelc
> I relax here; http://tinyurl.com/2cgsug
>

Re: Doc change

[Greg Brown <gk...@mac.com>]

> Alright, I now realize that this is a 1.2 -> 1.3 change, and that
> raises another question; How are we going to organize the correct
> documentation to the people running their version?

See previous emails.  :-)

> Meanwhile, I am reverting my changes...


Thanks.

Re: Doc change

[Niclas Hedhman <ni...@hedhman.org>]

On Tue, Aug 4, 2009 at 11:15 AM, Niclas Hedhman<ni...@hedhman.org> wrote:
> IIUIC, the Bindable class and related support in WTKX is gone (why?).
> That would mean that the FlowPane tutorial would change. I have tried
> to make that change on
> http://cwiki.apache.org/confluence/display/PIVOT/Flow+Panes, and would
> like to hear if it is correct...

Alright, I now realize that this is a 1.2 -> 1.3 change, and that
raises another question; How are we going to organize the correct
documentation to the people running their version?

Meanwhile, I am reverting my changes...

Cheers
-- 
Niclas Hedhman, Software Developer
http://www.qi4j.org - New Energy for Java

I  live here; http://tinyurl.com/2qq9er
I  work here; http://tinyurl.com/2ymelc
I relax here; http://tinyurl.com/2cgsug