After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 640165 - Confusing documentation in GtkWidget draw signal
Confusing documentation in GtkWidget draw signal
Status: RESOLVED INVALID
Product: gtk-doc
Classification: Platform
Component: general
1.16
Other All
: Normal normal
: ---
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2011-01-21 11:30 UTC by Jan Horak
Modified: 2013-05-31 14:51 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Jan Horak 2011-01-21 11:30:21 UTC 
Documentation shows GdkRectangle *cr as second parameter, but it should be cairo_cr (or cr parameter description is wrong).

http://library.gnome.org/devel/gtk/unstable/GtkWidget.html#GtkWidget-draw
Comment 1 Matthias Clasen 2011-01-21 13:46:32 UTC 
gtk-doc issue, and has been fixed already. The next release will have better docs.
Still not 100% correct, unfortunately :-(

gboolean  user_function   (GtkWidget    *widget,
                           CairoContext *cr,
                           gpointer      user_data)      : Run Last

CairoContext should really be cairo_t here.
Comment 2 Stefan Sauer (gstreamer, gtkdoc dev) 2013-05-31 14:27:40 UTC 
Hmm, the CairoContext is what I get from
g_signal_query (signal_id, &query_info);
I guess CairoContext is the boxed type for cairo_t, right?
Comment 3 Stefan Sauer (gstreamer, gtkdoc dev) 2013-05-31 14:51:04 UTC 
Okay, thats to help on irc, we tracked this to
http://cgit.freedesktop.org/cairo/tree/util/cairo-gobject/cairo-gobject-structs.c#n57

I don't think there is much we can do right now. Ideally a boxed could tell whats in there. If anyone has a good idea, please reopen.