GNOME Bugzilla – Bug 306214
gdk_window_set_back_pixmap() has confusing documentation
Last modified: 2010-09-27 04:19:49 UTC
Section: GDK Reference manual, "Windows" section
"The windowing system will NORMALLY fill a window with its background when the
window is obscured then exposed, ..."
The windowing system DOES fill a window with its background under these
The windowing system DOES NOT fill a window with its background under these
How useful is it to use the word "normally" in a functions documentation? Its
like using the words "sometimes" or "occaisionally" or "if you're very very lucky".
I would have thought its the windowing systems responsibility to ALWAYS fill a
window with its background when the window is obscured then exposed, and if it
does not do this its a gtk+ bug.
However, if there are any special exceptions they should be clearly documented.
This function has been removed in GTK3