Bug 551063 – deprecated marking without a link to what new code should

2008-09-06  Sven Herzberg  <sven@imendio.com>

        Bug 551063 – deprecated marking without a link to what new code should
        use

        * gdk/tmpl/input.sgml: dropped tmpl documentation for gdk_input_add()
        and gdk_input_add_full()
        * gdk/gdkevents.c: added inline documentation for gdk_input_add() and
        gdk_input_add_full(); added replacement hints into the deprecation
        message

svn path=/trunk/; revision=21305
This commit is contained in:
Sven Herzberg
2008-09-06 17:26:33 +00:00
committed by Sven Herzberg
parent 9e90452bac
commit ad7880a590
4 changed files with 56 additions and 23 deletions

View File

@ -1015,6 +1015,23 @@ gdk_io_invoke (GIOChannel *source,
return TRUE;
}
/**
* gdk_input_add_full:
* @source: a file descriptor.
* @condition: the condition.
* @function: the callback function.
* @data: callback data passed to @function.
* @destroy: callback function to call with @data when the input
* handler is removed.
*
* Establish a callback when a condition becomes true on
* a file descriptor.
*
* Returns: a tag that can later be used as an argument to
* gdk_input_remove().
*
* Deprecated: Use g_io_add_watch_full() on a #GIOChannel
*/
gint
gdk_input_add_full (gint source,
GdkInputCondition condition,
@ -1048,6 +1065,21 @@ gdk_input_add_full (gint source,
return result;
}
/**
* gdk_input_add:
* @source: a file descriptor.
* @condition: the condition.
* @function: the callback function.
* @data: callback data passed to @function.
*
* Establish a callback when a condition becomes true on
* a file descriptor.
*
* Returns: a tag that can later be used as an argument to
* gdk_input_remove().
*
* Deprecated: Use g_io_add_watch() on a #GIOChannel
*/
gint
gdk_input_add (gint source,
GdkInputCondition condition,