g-wrap NEWS -- history of user-visible changes. Copyright (C) 2000 Rob Browning Initially created by Christopher Lee. See the end for copying conditions. Version 1.1.11 - added beta changes to info pages -- they're unfinished and still partially document the old interface, but I'm going under the assumption that something is better than nothing. - automake's "make check" now runs the tests in ./test. - gw_wct_p now recognizes #f as a wcp. - missing string.h problems should be fixed. Version 1.1.10 - for enumerations, the automatically generated val->sym funcs now always return a list if show-all? is not #f, but the list may be empty. This is better for memq, map, etc. Version 0.9.8 - Fixed bug which prevented inclusion of new m4 macros into tarfile. Version 0.9.7 - Fixed guile-1.3 problems. NOTE: Broken release - do not use! Version 0.9.6 - Fixed const-string bug (thanks to Robert Merkel). Guile version problem still not fixed - stay tuned. Version 0.9.5 - fixed problems with guile-1.4. Version 0.9.4 - Pointer tokens and pointer token arrays have changed semantics. Now if a return value of one of these types would contain a NULL pointer, g-wrap just returns #f, and on the other side, passing in #f as an argument to a function expecting a pointer token or pointer token array will result in NULL being passed to the underlying C function. As a result of these changes, pointer-token-null? is gone. If you still need it, you can just (define (pointer-token-null? x) (eq? x #f)). Version 0.9.3 - RPM spec file available now as rpm/spec Version 0.9.2 - fixed --version command line arg. Version 0.9.1 - New development version. - Start officially using something like the linux kernel version numbering scheme. This means that there will be three digits in the version number where the first digit is the major version number. It changes whenever there's a large-scale change, like a serious backward-incompatibility, the second digit indicates whether this is considered a stable or development version. When this is odd, it's a development version. The last digit is the minor version number. It gets bumped with every release. - Guile is now required. Even if you're just going to be wrapping functions for languages other than guile, guile is now the implementation language of g-wrap itself. - added new top-level script, g-wrap. This replaces all of the target language specific scripts. See the info pages for usage details. - added conditionally compiled long long support for guile wrappers. - added g-wrap-config script to provide appropriate compile options for programs using g-wrap. See the info pages for usage details. - added support for handling pointers to C structs on the guile side. This is in flux, so don't use it unless you're prepared to possibly rewrite everything when things settle. See the info pages for details. - added support for a 'cleanup option to new types that lets you specify how an argument should be cleaned up (generally this means something like "free" for C APIs) whenever cleanup is needed. This works in conjunction with a new ability to enable/disable cleanup for types by default, and for arguments/return values on a per-function basis. See the info pages for details. - Add support for automatically generating a C header from the g-wrap spec file. This can be useful if you want the g-wrap file to be the ultmate authority about the API. See the info documentation for gwrap-generate-wrapped-header. - Add support for a guile-prefix to the gwrap-open-module call. This option will allow you to specify a prefix that will be appended to the guile-side names. This may be useful if you don't want to create a module (which you can do with the (guile-module #f) option to gwrap-open-module. Version 0.8.1 - Updates to get G-Wrap to build equivalent modules for RScheme and Guile from the same specification file - now, pointer '*'s are not assumed to be necessary when converting Guile smob-values to native C types Version 0.8.0 - Support added for RScheme - Changes in the name of some functions gwrap-scan-source-file (was gwrap-c-scan-source-file) gwrap-open-module (was gwrap-c-open-file) gwrap-assume-types-wrapped (was gwrap-c-assume-types-wrapped) gwrap-close-module (was gwrap-c-close-file) - Some functions are removed: gwrap-c-output-c gwrap-c-output-h gwrap-c-output-doc Version 0.3.9 - Prettier and more useful html documentation is generated from input files - Better C++ support Version 0.3.8 - Better ANISfication - Better C++ support Version 0.3.7: - Improved configuration process - Integrated g-translate into g-wrap Version 0.3.6: - Switched to automake/autoconf/libtool configuration Version 0.3.5: - Generates an html file describing wrapped library Version 0.3.4: - Option call-on-init in gwrap-c-open-file allows a function to be called upon intialization of the library wrapper. Version 0.3: - A capability for generating dynamically-linkable Guile modules - Automatic support for exporting functions with more than 10 arguments, without modification of libguile. - No longer relies on Slib (slib dependencies removed from output-file.scm, and g-wrap.scm) - Made generated *.h files more C++ friendly - New options for wrapping structures which are passed by value rather than by reference, and for generating C++ code. - new-function: New interface, automatically adds description to an assq list in variable "*gw:descriptions*", complete with a prototype and list of parameter and return types. - Renamed many functions -- the interface is pretty new overall. define-constant --> new-constant c-file-include-local-header --> gwrap-c-include-local-header c-file-include-global-header --> gwrap-c-include-global-header open-c-file --> gwrap-c-open-file output-c --> gwrap-c-output-c output-h --> gwrap-c-output-h make-wrapper-c-type --> gwrap-c-assume-types-wrapped (simpler interface) - Code for generating Guile wrapper code is now a Guile module - g-wrap-guile is now written to use Guile interpreter rather than SCM - types are now given symbolic keys rather than being returned in structures - new function formats: (add-type scheme-sym c-type-str fn-to-scm fn-from-scm fn-isa) (add-new-type scheme-sym the-type) (new-type scheme-sym c-name c-print-name c-die-name c-eq-name . options) - If options contains (c-gc-name "fname"), fname is called for protecting objects from GC - If options contains (pass-c-ptr? #f), type is passed as struct rather than pointer to struct - gwrap-c-open-file: Accepts options telling it to generate a C++ file and/or code for a dynamically linkable module For older news, see the file ONEWS. ---------------------------------------------------------------------- Copyright information: Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc. Permission is granted to anyone to make or distribute verbatim copies of this document as received, in any medium, provided that the copyright notice and this permission notice are preserved, thus giving the recipient permission to redistribute in turn. Permission is granted to distribute modified versions of this document, or of portions of it, under the above conditions, provided also that they carry prominent notices stating who last changed them. ^L Local variables: mode: indented-text end: