On Thu, 1 Nov 2018 at 01:34, <commits@source.squeak.org> wrote:
Eliot Miranda uploaded a new version of VMMaker to project VM Maker:

==================== Summary ====================

Name: VMMaker.oscog-eem.2480
Author: eem
Time: 31 October 2018, 10:33:03.858395 am
UUID: bb3ffda7-8241-4dea-b886-d656e474b6c1
Ancestors: VMMaker.oscog-eem.2479

Provide simulation stubs for the B3DAcceleratorPlugin C api.

Item was added:
+ ----- Method: B3DAcceleratorPlugin>>b3dDrawArrays:_:_:_: (in category 'simulation') -----
+ b3dDrawArrays: handle _: mode _: minIdx _: maxIdx
+       "int b3dDrawArrays(int handle, int mode, int minIdx, int maxIdx)"
+       <doNotGenerate>
+       ^false!

Not actually a request to change anything since <doNotGenerate> is a well established convention,  but just sharing a thought that occurs to me because I like to understand conventions rather than take them for granted.

For someone naively looking through the code for the first time, 
<doNotGenerate> indicates what it "doesn't" but not what it "does"
and <simulation> might be more intuitive for newcomers to understand.

Its a question of which is better to be explicit and which implicit. Two sides of the same coin...
<doNotGenerate> - explicit about code generation, implicit about simulation
<simulation> - explicit about simulation, implicit about code generation.

cheers -ben