Improve doc of gtk_text_buffer_paste_clipboard()

It didn't explain the behavior when there is a non-empty buffer
selection.

https://bugzilla.gnome.org/show_bug.cgi?id=339539
This commit is contained in:
Sébastien Wilmet
2013-09-15 01:07:36 +02:00
parent 7e8bd7c43d
commit 310179176c

View File

@ -3764,14 +3764,16 @@ remove_all_selection_clipboards (GtkTextBuffer *buffer)
* gtk_text_buffer_paste_clipboard:
* @buffer: a #GtkTextBuffer
* @clipboard: the #GtkClipboard to paste from
* @override_location: (allow-none): location to insert pasted text, or %NULL for
* at the cursor
* @override_location: (allow-none): location to insert pasted text, or %NULL
* @default_editable: whether the buffer is editable by default
*
* Pastes the contents of a clipboard at the insertion point, or
* at @override_location. (Note: pasting is asynchronous, that is,
* we'll ask for the paste data and return, and at some point later
* after the main loop runs, the paste data will be inserted.)
* Pastes the contents of a clipboard. If @override_location is %NULL, the
* pasted text will be inserted at the cursor position, or the buffer selection
* will be replaced if the selection is non-empty.
*
* Note: pasting is asynchronous, that is, we'll ask for the paste data and
* return, and at some point later after the main loop runs, the paste data will
* be inserted.
**/
void
gtk_text_buffer_paste_clipboard (GtkTextBuffer *buffer,