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.

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 Moose-dev(a)list.inf.unibe.ch https://www.list.inf.unibe.ch/listinfo/moose-dev

On Sep 2, 2017, at 5:57 PM, H. Hirzel <hannes.hirzel(a)gmail.com&gt; wrote: Hello Doru I understand that I load this into Pharo6.0/6.1 with Gofer new smalltalkhubUser: 'Moose' project: 'GToolkit'; configuration; loadDevelopment. [1] Is the documenter included And that the screen shot http://gtoolkit.org/pictures/examples.png showing many pragmas no longer applies.... Regards Hannes [1] taken from http://gtoolkit.org/#install On 9/2/17, Thierry Goubier <thierry.goubier(a)gmail.com&gt; 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... > > 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 >> Moose-dev(a)list.inf.unibe.ch >> https://www.list.inf.unibe.ch/listinfo/moose-dev >> > > _______________________________________________ > Moose-dev mailing list > Moose-dev(a)list.inf.unibe.ch > https://www.list.inf.unibe.ch/listinfo/moose-dev > _______________________________________________ Moose-dev mailing list Moose-dev(a)list.inf.unibe.ch https://www.list.inf.unibe.ch/listinfo/moose-dev

Hi, > On Sep 2, 2017, at 5:43 PM, Thierry Goubier <thierry.goubier(a)gmail.com&gt; 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.

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 >> Moose-dev(a)list.inf.unibe.ch >> https://www.list.inf.unibe.ch/listinfo/moose-dev > > _______________________________________________ > Moose-dev mailing list > Moose-dev(a)list.inf.unibe.ch > 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 Moose-dev(a)list.inf.unibe.ch https://www.list.inf.unibe.ch/listinfo/moose-dev

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. 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 Moose-dev(a)list.inf.unibe.ch https://www.list.inf.unibe.ch/listinfo/moose-dev