From 2074c5381906d8f958722727b07d0fcb7bbff57f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 29 Jun 2003 21:16:06 +0000 Subject: [PATCH] More formatting fixes for docs. --- ChangeLog | 3 ++- ChangeLog.pre-2-10 | 3 ++- ChangeLog.pre-2-4 | 3 ++- ChangeLog.pre-2-6 | 3 ++- ChangeLog.pre-2-8 | 3 ++- gtk/gtkwidget.c | 27 ++++++++++++++------------- 6 files changed, 24 insertions(+), 18 deletions(-) diff --git a/ChangeLog b/ChangeLog index cb5aed0788..e6b8609b28 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,7 @@ 2003-06-29 Matthias Clasen - * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs. + * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs, some more formatting + fixes. 2003-06-28 Tor Lillqvist diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index cb5aed0788..e6b8609b28 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,6 +1,7 @@ 2003-06-29 Matthias Clasen - * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs. + * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs, some more formatting + fixes. 2003-06-28 Tor Lillqvist diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index cb5aed0788..e6b8609b28 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,6 +1,7 @@ 2003-06-29 Matthias Clasen - * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs. + * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs, some more formatting + fixes. 2003-06-28 Tor Lillqvist diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index cb5aed0788..e6b8609b28 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,6 +1,7 @@ 2003-06-29 Matthias Clasen - * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs. + * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs, some more formatting + fixes. 2003-06-28 Tor Lillqvist diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index cb5aed0788..e6b8609b28 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,6 +1,7 @@ 2003-06-29 Matthias Clasen - * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs. + * gtk/gtkwidget.c (gtk_widget_class_init): Remove a duplicate parameter from docs, some more formatting + fixes. 2003-06-28 Tor Lillqvist diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 71e87a3be2..ea60d51452 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1013,13 +1013,13 @@ gtk_widget_class_init (GtkWidgetClass *klass) * setting the success parameter depending on whether the * data was processed successfully. * - * The handler may inspect and modify context->action + * The handler may inspect and modify @drag_context->action * before calling gtk_drag_finish(), e.g. to implement %GTK_ACTION_ASK as * shown in the following example: * * void * drag_data_received (GtkWidget *widget, - * GdkDragContext *context, + * GdkDragContext *drag_context, * gint x, * gint y, * GtkSelectionData *data, @@ -1028,7 +1028,7 @@ gtk_widget_class_init (GtkWidgetClass *klass) * { * if ((data->length >= 0) && (data->format == 8)) * { - * if (context->action == GDK_ACTION_ASK) + * if (drag_context->action == GDK_ACTION_ASK) * { * GtkWidget *dialog; * gint response; @@ -1043,16 +1043,16 @@ gtk_widget_class_init (GtkWidgetClass *klass) * gtk_widget_destroy (dialog); * * if (response == GTK_RESPONSE_YES) - * context->action = GDK_ACTION_MOVE; + * drag_context->action = GDK_ACTION_MOVE; * else - * context->action = GDK_ACTION_COPY; + * drag_context->action = GDK_ACTION_COPY; * } * - * gtk_drag_finish (context, TRUE, FALSE, time); + * gtk_drag_finish (drag_context, TRUE, FALSE, time); * return; * } * - * gtk_drag_finish (context, FALSE, FALSE, time); + * gtk_drag_finish (drag_context, FALSE, FALSE, time); * } * */ @@ -2202,7 +2202,7 @@ gtk_widget_queue_draw (GtkWidget *widget) * @width: width of region to draw * @height: height of region to draw * - * DEPRECATED. This function is no longer different from + * This function is no longer different from * gtk_widget_queue_draw_area(), though it once was. Now it just calls * gtk_widget_queue_draw_area(). Originally * gtk_widget_queue_clear_area() would force a redraw of the @@ -2210,6 +2210,7 @@ gtk_widget_queue_draw (GtkWidget *widget) * gtk_widget_queue_draw_area() would not. Now both functions ensure * the background will be redrawn. * + * @Deprecated: Use gtk_widget_queue_draw_area() instead. **/ void gtk_widget_queue_clear_area (GtkWidget *widget, @@ -2227,7 +2228,9 @@ gtk_widget_queue_clear_area (GtkWidget *widget, * gtk_widget_queue_clear: * @widget: a #GtkWidget * - * DEPRECATED. Use gtk_widget_queue_draw() instead. + * This function does the same as gtk_widget_queue_draw(). + * + * @Deprecated: Use gtk_widget_queue_draw() instead. **/ void gtk_widget_queue_clear (GtkWidget *widget) @@ -2270,7 +2273,7 @@ gtk_widget_queue_resize (GtkWidget *widget) * @widget: a #GtkWidget * @area: area to draw * - * DEPRECATED. In GTK+ 1.2, this function would immediately render the + * In GTK+ 1.2, this function would immediately render the * region @area of a widget, by invoking the virtual draw method of a * widget. In GTK+ 2.0, the draw method is gone, and instead * gtk_widget_draw() simply invalidates the specified region of the @@ -5192,9 +5195,6 @@ gtk_widget_set_usize_internal (GtkWidget *widget, * @width: minimum width, or -1 to unset * @height: minimum height, or -1 to unset * - * This function is deprecated; use gtk_widget_set_size_request() - * instead. - * * Sets the minimum size of a widget; that is, the widget's size * request will be @width by @height. You can use this function to * force a widget to be either larger or smaller than it is. The @@ -5213,6 +5213,7 @@ gtk_widget_set_usize_internal (GtkWidget *widget, * basically impossible to hardcode a size that will always be * correct. * + * @Deprecated: Use gtk_widget_set_size_request() instead. **/ void gtk_widget_set_usize (GtkWidget *widget,