Compare commits

...

1 Commits

Author SHA1 Message Date
Christopher Davis
564822f63e gtkwindow: Change present documentation
The way present is used doesn't line up with the ideal
use case, and in most instances a developer won't
actually have a timestamp to pass. `present()` is
what should be used for cases when you don't have a
timestamp, but the current docs have caused
a lot of confusion.

Instead of saying `present()` shouldn't be used,
say when it should be used since there are still
valid uses.
2021-10-21 16:28:53 -07:00

View File

@@ -5192,9 +5192,8 @@ _gtk_window_unset_focus_and_default (GtkWindow *window,
*
* Presents a window to the user.
*
* This function should not be used as when it is called,
* it is too late to gather a valid timestamp to allow focus
* stealing prevention to work correctly.
* This should be used when you want to present a window
* and do not have an event timestamp.
*/
void
gtk_window_present (GtkWindow *window)