From 0007c3f8d17fb4b397d6d4e42b10f2ceee5b0d6a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 21 Jun 2020 12:09:51 +0200 Subject: Move man pages into a separate directory MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3 | 85 +++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3 (limited to 'man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3') diff --git a/man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3 b/man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3 new file mode 100644 index 0000000..e276613 --- /dev/null +++ b/man3/LIBAXL_REQUEST_SET_SELECTION_OWNER.3 @@ -0,0 +1,85 @@ +.TH LIBAXL_REQUEST_SET_SELECTION_OWNER 3 libaxl +.SH NAME +LIBAXL_REQUEST_SET_SELECTION_OWNER - Change ownership of a selection +.SH SYNOPSIS +.nf +#include + +#define LIBAXL_REQUEST_SET_SELECTION_OWNER 22 +struct libaxl_request_set_selection_owner { + uint8_t \fIopcode\fP; + uint8_t \fI__pad\fP; + uint16_t \fI_request_length\fP; + libaxl_window_t \fIowner\fP; + libaxl_atom_t \fIselection\fP; + libaxl_timestamp_t \fItime\fP; +}; +.fi +.SH DESCRIPTION +This request changes the owner window, and last-change +time of the selection specified in the +.I selection +field to the window and time specifed in the +.I owner +and +.I time +fields, and the owner of the selection to the client +making the request. However the request has no effect +if the request new last-change time is less than the +current last-change time or greater than the current +time according to the server. +.PP +The constant +.I LIBAXL_CURRENT_TIME +can be specified in the +.I time +field for the current server time. +.PP +If the constant +.I LIBAXL_NONE +is specified in the +.I owner +field, the owner window and the owner are both set to +.I LIBAXL_NONE +(none). +.PP +The value of the +.I opcode +field shall be +.I LIBAXL_REQUEST_SET_SELECTION_OWNER +to signify that the request is of the +request described in this document. +.PP +Other fields are filled in automatically by the +.BR libaxl_send_request (3) +function. +.PP +If the new owner is not the same as the +current owner, and the current owner is not +.BR LIBAXL_NONE , +a +.BR LIBAXL_EVENT_SELECTION_CLEAR (3) +event is sent to the current owner. +.PP +If the owner of a selection is terminated, +or the owner window is destroyed, the owner +and owner window revers to +.BR LIBAXL_NONE , +but the last-change time remains as is. +.SH ERRORS +.TP +.BR LIBAXL_ERROR_WINDOW (3) +The specified window ID does not exist. +.TP +.BR LIBAXL_ERROR_ATOM (3) +The specified atom ID does not exist. +.SH REPLIES +None. +.SH NOTES +Selections are global to the display. +.SH SEE ALSO +.BR libaxl_send_request (3), +.BR LIBAXL_REQUEST_GET_SELECTION_OWNER (3), +.BR LIBAXL_REQUEST_CONVERT_SELECTION (3), +.BR LIBAXL_EVENT_SELECTION_REQUEST (3), +.BR LIBAXL_EVENT_SELECTION_CLEAR (3) -- cgit v1.2.3-70-g09d2