G-Wrap NEWS -- history of user-visible changes.
Copyright (C) 2003-2005 Andreas Rottmann
Copyright (C) 2000-2002 Rob Browning <rlb@defaultvalue.org>
Initially created by Christopher Lee.
See the end for copying conditions.

Version 1.9.6

  - Support for size_t and ssize_t data types.

Version 1.9.5

  - Bugfixes
    + The minimal GLib wrappers are now installed as (g-wrap gw-glib), 
      as expected by GnuCash.
    + A problem with generic specializer class lookup has been fixed.
    + A problem with generics specialization and default arguments has
      been fixed.
    + A problem with default arguments, when combined with 
      invisible arguments (such as output arguments) has been fixed.

Version 1.9.4

  - Enhanced generics support: now all arguments of methods are 
    specialized, not only the first one.

  - Bugfixes
    + Now ships with (g-wrap gw-wct) compatibilty module needed by 
      GnuCash at runtime.
    + Fixes for handling output arguments:
      - Wrapped functions with void return value and output arguments 
	now return expected results
      - Optional argument count is now correctly computed in the 
        presence of output arguments
    + The libffi alignment requirements are now honored. This fixes bus 
      errors on many non-x86 architectures.
    + On big-endian architectures libffi-wrapped functions that return
      char now work correctly.
    + Some "uninitialized variable" warnings were fixed in generated code
      which caused compiles with GCC 4.0 to fail (Debian Bug#290305).

Version 1.9.3

  - Comes with a compatibility layer that allows GnuCash to be built
    with it.

  - Reverts the enhanced generics support, which was introduced in
    1.9.2, since that currently breaks guile-gnome

  - Bugfixes
    + g-wrap-2.0-guile.pc is now generated correctly, even if the 
      internal libffi is used.
    + Types used by constants are now considered when calculating the 
      set of referenced types in a wrapset. This bug led to missing code
      and compile errors when a type defined in another wrapset was used 
      by only by a constant.
    + On platforms which lack alloca(), the version shipped with 
      G-Wrap should now build correctly.

Version 1.9.2

  - Now comes with libffi included, for systems which lack an libffi
    installation

  - SRFI module checks now work correctly, even if you do an in-tree build

Version 1.9.1

 - API change: destruct-value-cg is now named destroy-value-cg

 - Bugfixes
   + A bug in the latent generic code has been fixed
   + The error message for WCP type errors has been fixed

Version 1.9.0

 - Complete rewrite; too many changes to list, see the manual for the
   new GOOPS-based API and the guile-gnome project for an extended
   example.

  - New features:
    + Output arguments
    + Default arguments

  - G-Wrap should be target-language agnostic, like it was in its
    early days.

Version 1.3.3

 - Support has been added for GSlists via gw:gslist-of.

 - g-wrap's license has been changed to the Lesser GNU Public License.

 - g-wrap's code generation has been reworked to eliminate all of the
   -Wall warnings when compiling with gcc 3.2.

Version 1.3.2

 - Note that this version represents a major overhaul and is quite
   incompatible with previous versions -- such is life on the unstable
   branch.  I plan to rework the docs again shortly, but for now, use
   the existing -spec files as examples and send me email when you're
   confused.

 - Note that all wrapset names starting with "gw-" are reserved by
   g-wrap.  DON'T use them.

Version 1.3.1

 - Version numbers for g-wrap have been rearranged.  We'll be using
   the Linux kernel version numbering scheme from now on.  Stable
   versions have even "middle" numbers, i.e. 1.2.1, and unstable
   versions have odd middle numbers, i.e. 1.3.4.  Note that there was
   briefly a 1.1.12 which is actually "newer" than 1.2.1, but that
   version is what became 1.3.1.  The other reason for the change was
   that in 1.3.1 g-wrap's handling of Guile modules changed
   substantially, and in a somewhat backward incompatible way.

 - g-wrap has been rewritten to drop support for earlier Guile
   version's "automagic loading a shared library as a module".  When
   asked to generate a Guile module for a given g-wrap module, g-wrap
   will generate a plain Scheme file that will export all of the
   g-wrapped symbols and load the required g-wrap shared library to
   provide the wrapped function bindings.  This should work across
   guile 1.3.4, guile 1.4, and the forthcoming guile 1.6.  Note that
   the Scheme file must be found in an appropriate place via the
   %load-path just like any other guile module, and the directory
   containing the g-wrap shared library representing the wrapped code
   must be somewhere in LD_LIBRARY_PATH (for Guile 1.3.4), and
   LD_LIBRARY_PATH or LTDL_LIBRARY_PATH for newer Guiles.

 - Support has been added for a pre-c-lib-scmcodegen for both g-wrap
   modules and types.  If registered, the code generated will be
   inserted into the Scheme file generated (if any) for the Guile
   module representing the g-wrapped code.

 - g-wrap has now dropped official support for Guile versions earlier
   than 1.3.4.

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:
