gtk:text-buffer-begin-user-action (buffer)

buffer -- a gtk:text-buffer object

Called to indicate that the text buffer operations between here and a call to the gtk:text-buffer-end-user-action function are part of a single user visible operation. The operations between the gtk:text-buffer-begin-user-action and gtk:text-buffer-end-user-action functions can then be grouped when creating an undo stack. The text buffer maintains a count of calls to the gtk:text-buffer-begin-user-action function that have not been closed with a call to the gtk:text-buffer-end-user-action function, and emits the "begin-user-action" and "end-user-action" signals only for the outermost pair of calls. This allows you to build user actions from other user actions.

The "interactive" text buffer mutation functions automatically call begin/end user action around the text buffer operations they perform, so there is no need to add extra calls if the user action consists solely of a single call to one of those functions.