Re: [Pharo-dev] Bloc Documentation

2016-02-10 Thread Sean P. DeNigris
Aliaksei Syrel wrote > Bloc does not have examples yet. > What classes/methods do you need to be commented first to understand the > system? I think for me the most important thing would be to have a short description of the overall design, especially if it included the rationale. One thing I thin

Re: [Pharo-dev] Bloc Documentation

2016-02-10 Thread Aliaksei Syrel
> > I'm looking at the examples of BlElement for upgrading Bloc-DragPanels. > I'd expect BlElement to have a default eventlistener that allows moving the > morphs around? There is a bug and I disabled this behaviour. If you want to enable it uncomment line in BlPasteUpEventListener>>startSlide: o

Re: [Pharo-dev] Bloc Documentation

2016-02-10 Thread Stephan Eggermont
On 09-02-16 09:15, Aliaksei Syrel wrote: Bloc does not have examples yet. What classes/methods do you need to be commented first to understand the system? In BlElement class>exampleAdvancedClipping there is twice addEventListener: (BlPluggableEventListener new whenMouseMoveDo: [ :event

Re: [Pharo-dev] Bloc Documentation

2016-02-10 Thread Stephan Eggermont
On 09-02-16 09:15, Aliaksei Syrel wrote: Bloc does not have examples yet. What classes/methods do you need to be commented first to understand the system? I'm looking at the examples of BlElement for upgrading Bloc-DragPanels. I'd expect BlElement to have a default eventlistener that allows mo

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Alain Plantec via Pharo-dev
--- Begin Message --- and please, do not ask too much to Alex. Alex is doing a pass (great job), and (I guess) he is doing it alone. I will come back to Pharo and Bloc in two weeks, reimplement examples and adapt the first Bloc documentation that we did with Stephane. Then it will be easier for th

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Alain Plantec via Pharo-dev
--- Begin Message --- > On 9 févr. 2016, at 13:24, Stephan Eggermont wrote: > > On 09/02/16 11:53, Aliaksei Syrel wrote: >> So I'm asking: what parts of Bloc do you find especially complicated to >> understand. so we could concentrate on them? Root class >> BlElement(methods) has good doc, so pl

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Alain Plantec via Pharo-dev
--- Begin Message --- Hello, yes, #formerOwner: and #formerPosition: are here for compatibility with Morphic. and it will be like that for a while :) The bloc drag&drop mechanism is implemented differently with the help of events. Cheers Alain > On 9 févr. 2016, at 13:25, Aliaksei Syrel wrote: >

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Ben Coman
On Tue, Feb 9, 2016 at 4:15 PM, Aliaksei Syrel wrote: > Bloc does not have examples yet. > What classes/methods do you need to be commented first to understand the > system? > > On Feb 9, 2016 4:46 AM, "Sean P. DeNigris" wrote: >> >> I realize it's a fast-moving work in progress, but what's the b

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Aliaksei Syrel
> > Please add a comment in the method stating it. > People are not reading your mind. I know :) I'm arguing that some classes/method could wait. We need to concentrate on most important ones. And then come to the rest. On Tue, Feb 9, 2016 at 1:52 PM, stepharo wrote: > Please add a comment in

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread stepharo
Please add a comment in the method stating it. People are not reading your mind. Stef Le 9/2/16 13:25, Aliaksei Syrel a écrit : formerOwner: anElementOrNil "Set my former or remove property of argument is nil" anElementOrNil ifNil: [ self remove

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread stepharo
Le 9/2/16 11:53, Aliaksei Syrel a écrit : On Tue, Feb 9, 2016 at 11:39 AM, Esteban Lorenzano mailto:esteba...@gmail.com>> wrote: mmm… that’s a bad question because I would answer “all of them”, but I understand you want to do a step to make easy for us to understand so my answer h

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Aliaksei Syrel
> > A lot of confusing comes from BlMorphXX things still being around all over > the place. I prefer good examples as a starting point. Making > Bloc-DragPanels work again? Exactly! :) We just physically can't do everything so fast. It will come! Patience, patience :) Nevertheless pointing to issu

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Aliaksei Syrel
> > formerOwner: anElementOrNil > "Set my former or remove property of argument is nil" > > anElementOrNil > ifNil: [ self removeProperty: #formerOwner ] > ifNotNil: [ self setProperty: #formerOwner toValue: > anElementOrNil ] I hate this method :)

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Stephan Eggermont
On 09/02/16 11:53, Aliaksei Syrel wrote: So I'm asking: what parts of Bloc do you find especially complicated to understand. so we could concentrate on them? Root class BlElement(methods) has good doc, so please use it to start your exploration journey. A lot of confusing comes from BlMorphXX t

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Stephan Eggermont
formerOwner: anElementOrNil "Set my former or remove property of argument is nil" anElementOrNil ifNil: [ self removeProperty: #formerOwner ] ifNotNil: [ self setProperty: #formerOwner toValue: anElementOrNil ] I'd prefer to see a #setProp

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Aliaksei Syrel
On Tue, Feb 9, 2016 at 11:39 AM, Esteban Lorenzano wrote: > mmm… that’s a bad question because I would answer “all of them”, but I > understand you want to do a step to make easy for us to understand so my > answer has to be “the important ones”, but since there is no > documentation/class commen

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Esteban Lorenzano
> On 09 Feb 2016, at 09:15, Aliaksei Syrel wrote: > > Bloc does not have examples yet. > What classes/methods do you need to be commented first to understand the > system? > mmm… that’s a bad question because I would answer “all of them”, but I understand you want to do a step to make easy fo

Re: [Pharo-dev] Bloc Documentation

2016-02-09 Thread Aliaksei Syrel
Bloc does not have examples yet. What classes/methods do you need to be commented first to understand the system? On Feb 9, 2016 4:46 AM, "Sean P. DeNigris" wrote: > I realize it's a fast-moving work in progress, but what's the best way to > try > to understand the system? > > For example, I saw

[Pharo-dev] Bloc Documentation

2016-02-08 Thread Sean P. DeNigris
I realize it's a fast-moving work in progress, but what's the best way to try to understand the system? For example, I saw class comments, some of which seem to be out of date, and I no longer see many of the examples I remember from last year - maybe I have to load them separately? - Cheer