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

@ -1,3 +1,12 @@
2008-09-06 Sven Herzberg <sven@imendio.com>
Bug 551063 deprecated marking without a link to what new code should
use
* gdk/gdkevents.c: added inline documentation for gdk_input_add() and
gdk_input_add_full(); added replacement hints into the deprecation
message
2008-09-05 Michael Natterer <mitch@imendio.com>
* gtk/gtkfilechooserdefault.c (file_list_drag_data_received_cb):

View File

@ -1,3 +1,11 @@
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()
2008-09-06 Stefan Kost <ensonic@users.sf.net>
* gdk-pixbuf/gdk-pixbuf-csource.xml:

View File

@ -35,19 +35,14 @@ callbacks.</para></listitem>
<!-- ##### FUNCTION gdk_input_add_full ##### -->
<para>
Establish a callback when a condition becomes true on
a file descriptor.
</para>
@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.
@Returns: a tag that can later be used as an argument to
gdk_input_remove().
@source:
@condition:
@function:
@data:
@destroy:
@Returns:
<!-- ##### ENUM GdkInputCondition ##### -->
@ -88,17 +83,6 @@ structure or object that @data points to.
<!-- ##### FUNCTION gdk_input_add ##### -->
<para>
Establish a callback when a condition becomes true on
a file descriptor.
</para>
@source: a file descriptor.
@condition: the condition.
@function: the callback function.
@data: callback data passed to @function.
@Returns: a tag that can later be used as an argument to
gdk_input_remove().
<!-- ##### FUNCTION gdk_input_remove ##### -->

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,