Re: Gdk::AppLaunchContext::set_display() missing

[Kjell Ahlstedt <kjell ahlstedt bredband net>]

Den 2016-08-10 kl. 00:39, skrev Phil Wolff:
> The docs for GdkAppLaunchContext show a function called 
> gdk_app_launch_context_set_display(), with the note "Since: 2.14".
>
> The GTKMM-3.0 docs for Gdk::AppLaunchContext::set_screen() contain 
> "See also set_display()", but set_display() isn't documented, and it 
> isn't declared in applaunchcontext.h. It is also missing from GTKMM-2.4.
>
> Oops?
No oops! I think the omission is deliberate. The description of 
gdk_app_launch_context_set_display() in gtk+ contains

  * Deprecated: 3.0: Use gdk_display_get_app_launch_context() instead

gdk_app_launch_context_set_display() doesn't really set anything. This 
is the complete code:

void
gdk_app_launch_context_set_display (GdkAppLaunchContext *context,
                                    GdkDisplay          *display)
{
  g_return_if_fail (GDK_IS_APP_LAUNCH_CONTEXT (context));
  g_return_if_fail (display == NULL || GDK_IS_DISPLAY (display));

  g_warn_if_fail (display == NULL || display == context->display);
}

The reference in the description of set_screen() is unfortunate. It's 
copied from the gtk+'s description of gdk_app_launch_context_set_screen().

Kjell