Changeset 95d54e6


Ignore:
Timestamp:
Jun 15, 2010, 1:05:52 AM (11 years ago)
Author:
David Benjamin <davidben@mit.edu>
Branches:
master, release-1.7, release-1.8, release-1.9
Children:
58ea109
Parents:
33b64f22
Message:
Document the glib function casts
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/owl-window.txt

    rea7daa8 r95d54e6  
    174174  for the repaints to occur correctly. This is rather poor and should
    175175  be refactored later.
     176
     177- The code fairly routinely does casts to add extra throw-away
     178  parameters to functions. Most notably, casting functions of type
     179
     180      void do_something(void *obj)
     181
     182  to something of type
     183
     184      void do_something(void *obj, void *user_data)
     185
     186  (the latter is a GFunc) with the expectation that the user_data
     187  argument is discarded. While calling with this cast is undefined by
     188  the standard and depends on calling convention, glib uses it
     189  internally /everywhere/ and much of glib and gobject API heavily
     190  depends on it. As BarnOwl already depends on glib, we implicitly
     191  assume this cast works.
Note: See TracChangeset for help on using the changeset viewer.