Posted by
Thierry Goubier on
Sep 02, 2017; 5:15pm
URL: https://forum.world.st/ann-moldable-editor-documenter-and-examples-without-pragma-magic-tp4966246p4966331.html
Hi Doru,
Le 02/09/2017 à 18:22, Tudor Girba a écrit :
> Hi,
>
>> On Sep 2, 2017, at 5:43 PM, Thierry Goubier <
[hidden email]> wrote:
>>
>> Hi Doru,
>>
>> Le 01/09/2017 à 23:51, Tudor Girba a écrit :
>>> Hi,
>>> When we announced the GT Documenter as an application for the moldable editor, one of the remarks was that GT Examples implementation relies too much on pragma magic.
>>> We are now happy to announce that this is no longer the case because Andrei did a great job and rebuilt examples without the need for static pragmas for specifying dependencies.
>>
>> Thinking of it, I'm sure that analysis is nearly able to establish something is a proper example without even the <gtExample> tag…
>
> Not all returning unary methods are meaningful examples. <gtExample> denotes the intention of using a certain code and returning object as an example.
Does that means that even if the analysis would have been able to
determine if it was an example, you would insist on the <gtExample> tag?
Regards,
Thierry
> Doru
>
>> Regards,
>>
>> Thierry
>>
>>> So, now we can example dependencies simply through normal calls:
>>> emptyView
>>> <gtExample>
>>> ^ GtMondrian new
>>> twoNodes
>>> <gtExamples>
>>> view := self emptyView
>>> view nodes with: {1 . 2}
>>> ... and the engine can figure out the static dependencies. This means that examples can be used both as plain unary methods, and as replacement for tests. We think this should address the worry of examples being too heavy (the current implementation is ~350 lines).
>>> With a bit of extra effort, we also adapted GT Documenter to expand the example dependencies as seen below. This means that examples can now be used directly as units of documentation as well.
>>> We think this is significant.
>>> Cheers,
>>> The feenk team
>>> --
>>> www.tudorgirba.com <
http://www.tudorgirba.com>
>>> www.feenk.com
>>> "We are all great at making mistakes."
>>> _______________________________________________
>>> Moose-dev mailing list
>>>
[hidden email]
>>>
https://www.list.inf.unibe.ch/listinfo/moose-dev>>
>> _______________________________________________
>> Moose-dev mailing list
>>
[hidden email]
>>
https://www.list.inf.unibe.ch/listinfo/moose-dev>
> --
> www.tudorgirba.com
> www.feenk.com
>
> "We cannot reach the flow of things unless we let go."
>
>
>
>
> _______________________________________________
> Moose-dev mailing list
>
[hidden email]
>
https://www.list.inf.unibe.ch/listinfo/moose-dev>
_______________________________________________
Moose-dev mailing list
[hidden email]
https://www.list.inf.unibe.ch/listinfo/moose-dev