gtkdnd: Clean up the doc comment of gtk_drag_begin

This commit is contained in:
Jasper St. Pierre 2013-08-07 08:22:51 -04:00
parent 0c49f734a2
commit b9d85b9412

View File

@ -2653,16 +2653,15 @@ gtk_drag_begin_internal (GtkWidget *widget,
* @button: The button the user clicked to start the drag. * @button: The button the user clicked to start the drag.
* @event: The event that triggered the start of the drag. * @event: The event that triggered the start of the drag.
* *
* Initiates a drag on the source side. The function * Initiates a drag on the source side. The function only needs to be used
* only needs to be used when the application is * when the application is starting drags itself, and is not needed when
* starting drags itself, and is not needed when
* gtk_drag_source_set() is used. * gtk_drag_source_set() is used.
* *
* The @event is used to retrieve the timestamp that will be used internally to * The @event is used to retrieve the timestamp that will be used internally to
* grab the pointer. If @event is #NULL, then GDK_CURRENT_TIME will be used. * grab the pointer. If @event is %NULL, then %GDK_CURRENT_TIME will be used.
* However, you should try to pass a real event in all cases, since that can be * However, you should try to pass a real event in all cases, since that can be
* used by GTK+ to get information about the start position of the drag, for * used by GTK+ to get information about the start position of the drag, for
* example if the @event is a %GDK_MOTION_NOTIFY. * example if the @event is a motion event.
* *
* Generally there are three cases when you want to start a drag by hand by * Generally there are three cases when you want to start a drag by hand by
* calling this function: * calling this function: