From 5278ec98df557c7167ca50b81ec142050b782eea Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 15 Apr 2023 10:37:46 +0200 Subject: m + add man page: LIBAXL_REQUEST_CHANGE_SAVE_SET.3 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.3 | 90 +++++++++++++++++++++++++++++++++++ man3/LIBAXL_REQUEST_LIST_FONTS.3 | 2 +- 2 files changed, 91 insertions(+), 1 deletion(-) create mode 100644 man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.3 diff --git a/man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.3 b/man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.3 new file mode 100644 index 0000000..08b476c --- /dev/null +++ b/man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.3 @@ -0,0 +1,90 @@ +.TH LIBAXL_REQUEST_CHANGE_SAVE_SET 3 libaxl +.SH NAME +LIBAXL_REQUEST_CHANGE_SAVE_SET - Add or remove window from save-set +.SH SYNOPSIS +.nf +#include + +#define LIBAXL_REQUEST_CHANGE_SAVE_SET 6 +struct libaxl_request_change_save_set { + uint8_t \fIopcode\fP; + uint8_t \fImode\fP; + uint16_t \fI_request_length\fP; + libaxl_window_t \fIwindow\fP; +}; +.fi +.SH DESCRIPTION +The display server shall either add or remove +a window, created by some other client, from +the client's save-set. +.PP +The value of the +.I opcode +field shall be +.I LIBAXL_REQUEST_LIST_FONTS +to signify that the request is of the +request described in this document. +.PP +The value of the +.I mode +field shall be either +.I LIBAXL_INSERT +.RI (= 0 ) +or +.I LIBAXL_DELETE +.RI (= 1 ). +If +.I LIBAXL_INSERT +is specified, the window is added to the +client's save-set. If +.I LIBAXL_DELETE +is specified, the window is remove from +the client's save-set. Windows are automatically +removed from the save-set when they are destroyed. +.PP +The value of the +.I window +field shall the window to add to or remove from +the client's save-set. The window must have been +created by some other client. +.PP +Other fields are filled in automatically by the +.BR libaxl_send_request (3) +function. +.SH EXTENDED DESCRIPTION +When a client's resources are destroyed, a save-set +processing is performed for each window in the client's +save-set. Windows in the save-set that are inferiors of +a window created by the client are reparented to its +closest ancestor that is not created by the client, +For unmapped windows in the save-set (regardless of +whether it is an inferior to one of the client's +windows), the display server sends a +.BR LIBAXL_REQUEST_MAP_WINDOW (3) +request. +.PP +When save-set windows are reparented during this +process, the coordinates of the upper-left outer +corner is unchanged with respect to the root window. +.SH ERRORS +.TP +.BR LIBAXL_ERROR_MATCH (3) +.I window +refers to a window that was +.I not +created by another client. +.TP +.BR LIBAXL_ERROR_VALUE (3) +.I mode +is neither +.I LIBAXL_INSERT +nor +.IR LIBAXL_DELETE . +.TP +.BR LIBAXL_ERROR_WINDOW (3) +.I window +does not refer to an existing window. +.SH REPLIES +None. +.SH SEE ALSO +.BR libaxl_send_request (3) diff --git a/man3/LIBAXL_REQUEST_LIST_FONTS.3 b/man3/LIBAXL_REQUEST_LIST_FONTS.3 index 10a1ac0..1b4455b 100644 --- a/man3/LIBAXL_REQUEST_LIST_FONTS.3 +++ b/man3/LIBAXL_REQUEST_LIST_FONTS.3 @@ -6,7 +6,7 @@ LIBAXL_REQUEST_LIST_FONTS - List fonts #include #define LIBAXL_REQUEST_LIST_FONTS 49 -struct libaxl_request_open_font { +struct libaxl_request_list_fonts { uint8_t \fIopcode\fP; uint8_t \fI__pad\fP; uint16_t \fI_request_length\fP; -- cgit v1.2.3-70-g09d2