gtk:text-buffer-create-mark (buffer name pos &optional gravity)

buffer -- a gtk:text-buffer object
name -- a string with the name for the mark, or nil
pos -- a gtk:text-iter iterator with the location to place the mark
gravity -- a boolean whether the mark has left gravity, the default is true

The new gtk:text-mark object.

Creates a mark at position pos. If the mark argument is nil, the mark is anonymous. Otherwise, the mark can be retrieved by name using the gtk:text-buffer-mark function. If a mark has left gravity, and text is inserted at the current location of the mark, the mark will be moved to the left of the newly inserted text. If the mark has right gravity, the mark will end up on the right of newly inserted text. The standard left-to-right cursor is a mark with right gravity, when you type, the cursor stays on the right side of the text you are typing.

The caller of this function does not own a reference to the returned gtk:text-mark object, so you can ignore the return value if you like. Marks are owned by the text buffer and go away when the text buffer does.

Emits the "mark-set" signal as notification of the initial placement of the mark.