[Cuis-dev] Comments on TextModelMorph

[Juan Vuletich]

Hi Hilaire,

On 3/28/2025 12:51 PM, Hilaire Fernandes via Cuis-dev wrote:
>
> Hi folks,
>
> This class urgently needs a minimum survival comments . There are many 
> aspects of this class which are obscure. I hope Juan is not the only 
> person knowing about it and that other people can comment it.
>
> Current comment is: "The main morph for text editors"
>
> Information needed on :
>
>     * #changed: complete list and meaning of symbol
>     * what methods do?
>     * what the inner morph does?
>     * what
>
> We are trying to document it in the booklet and it is painful and 
> behavior is strange or unknown.
>
> If you have knowledge, share it there then we can elaborate a useful 
> comment.
>
> Thanks
>
> -- 
> http://mamot.fr/@drgeo

Yes. True.

I think that the whole PluggableMorph hierarchy needs better class 
comments. All these classes have a model, and they are "pluggable" in 
the sense that they don't know mucho about their model. This makes it 
possible to use them in different situations. For instance, 
TextModelMorph. The name tries to tell that this is a morph intended to 
be used with a TextModel as a model. Compare, for instance, with 
EntryFieldMorph, that can be used without a model at all.

I think that the internals of TextModelMorph / InnerTextMorph are not 
really important. What matters is how they interact with a TextModel. 
See that a basic TextModel only holds a Text and the undo/redo stuff. 
But a PluggableTextModel is more powerful. It can interact with some 
application level object that stores the text, and accepts the new 
contents. For instance, the textProvider of a PluggableTextModel may be 
a FileList (to view and edit text files) or a Browser (to view and edit 
methods).

I hope this quick description makes sense. A lot more is needed, no doubt.
Cheers,

-- 
Juan Vuletich
cuis.st
github.com/jvuletich
researchgate.net/profile/Juan-Vuletich
independent.academia.edu/JuanVuletich
patents.justia.com/inventor/juan-manuel-vuletich
linkedin.com/in/juan-vuletich-75611b3
twitter.com/JuanVuletich

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20250330/914913ee/attachment-0001.htm>