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 306214 - gdk_window_set_back_pixmap() has confusing documentation
gdk_window_set_back_pixmap() has confusing documentation
Status: RESOLVED OBSOLETE
Product: gtk+
Classification: Platform
Component: Documentation
2.4.x
Other All
: Normal minor
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2005-06-02 04:15 UTC by Steve Chaplin
Modified: 2010-09-27 04:19 UTC
See Also:
GNOME target: ---
GNOME version: 2.7/2.8



Description Steve Chaplin 2005-06-02 04:15:38 UTC
Documentation bug
Section: GDK Reference manual, "Windows" section
"The windowing system will NORMALLY fill a window with its background when the
window is obscured then exposed, ..."

Correct version:
The windowing system DOES fill a window with its background under these
conditions ...
The windowing system DOES NOT fill a window with its background under these
conditions ...

Other information:
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.
Comment 1 Matthias Clasen 2010-09-27 04:19:49 UTC
This function has been removed in GTK3