gnucash/README.gnome-hackers
Linas Vepstas c60fa5190a patches from rob browning
1999-08-25  Rob Browning  <rlb@cs.utexas.edu>

        * Add this file (./ChangeLog).  I'm planning to add change
        information here, and I invite others to do the same.  For those
        that use emacs, 'C-x 4 a' adds a new entry.  If people don't like
        this idea, we can drop it.

        * Add new scheme function gnc:choose-item-from-list-dialog.  There
        is C side code, but it's only meant to be called from scheme.
        This function is quite flexible in handles selections.  Eventually
        we might want to generalize this even more, but there are some GC
        issues to consider.  See src/gnome/query-user.c and gnc.gwp for
        details, and see src/scm/extensions.scm for an example usage.

        * IMPORTANT: queryBox signature has changed.  See the docs in
        src/gnome/query-user.c and in gnc.gwp for details.

        * Remove queryBox stubs from Motif side.  Motif doesn't support it
        (yet), and with gnc.gwp conditional inclusion we can just ignore
        it on the motif side.

        * Add function (current-gnc-compile-flavor) to gnc.gwp so that we
        can have conditional blocks.  Possible return values are 'gnome
        and 'motif.


git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@1930 57a11ea4-9604-0410-9ed3-97b8803252fd
1999-08-27 05:06:27 +00:00

35 lines
1.2 KiB
Plaintext

-*-text-*-
This file is intended to contain information for those interested in
working on the GNOME bits of GnuCash.
Memory Management (care with reference counting):
-------------------------------------------------
I was unsure about when you're supposed to _unref widgets, etc., and
getting this right is critical to avoiding memory leaks on the one
hand and dangling pointers on the other. So I asked on the gtk list,
and here was the result:
On 16 Aug 1999, Rob Browning wrote:
>
> I've been poking around the gtk web site and in the docs for
> information on when you're supposed to call gtk_widget_unref. I want
> to make sure I'm handling this right so I don't introduce memory
> leaks, but so far I haven't found anything describing the rules.
> Actually I'd like to know what the guidelines are for all the *_unref
> functions...
>
Read gtk+/docs/refcounting.txt (or something like that).
Also I think some babble about object finalization at
http://pobox.com/~hp/gnome-app-devel.html (follow link to sample
chapters) might be helpful.
Basically you have to unref a widget you never use, but if you put it
in a container the container "assumes" the initial refcount of 1 and
the widget will be deleted along with the container.
Havoc