GPSEE-core C API Change

[Wes Garland]

All:

I have changed GPSEE's native-language module API, effective as of GPSEE-0.2.1.  This change does not match our official versioning guidelines, however:
1) Most modules will be unaffected
2) GPSEE-0.3 has already been branched, and this really needs to go into 0.2
3) We're not at 1.0 yet :)

The change is that native-language modules which use the _FiniModule() API now have a third option; JSBool force.  This is set to JS_FALSE when GPSEE asks to shutdown the module because the garbage collector says its exports are no longer reachable from the global object.  This parameter is set to JS_TRUE when we are shutting down the JS engine for a given realm, guarantee that no more JS code will execute (in that realm), and the GC has already run with the global object and GC callbacks dropped.

Note that this API change won't trigger any compiler warnings, so you need to review your modules carefully.

This is to address the GC reachability bug with GFFI WillFinalize objects.

Wes

--
Wesley W. Garland
Director, Product Development
PageMail, Inc.
+1 613 542 2787 x 102