aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2023-04-15 10:37:46 +0200
committerMattias Andrée <maandree@kth.se>2023-04-15 11:03:06 +0200
commit5278ec98df557c7167ca50b81ec142050b782eea (patch)
treeff81f2d3e830efd251c98f6b326d6bce1705cb90 /man3
parentAdd man page: LIBAXL_REQUEST_GET_INPUT_FOCUS.3 (diff)
downloadlibaxl-5278ec98df557c7167ca50b81ec142050b782eea.tar.gz
libaxl-5278ec98df557c7167ca50b81ec142050b782eea.tar.bz2
libaxl-5278ec98df557c7167ca50b81ec142050b782eea.tar.xz
m + add man page: LIBAXL_REQUEST_CHANGE_SAVE_SET.3
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r--man3/LIBAXL_REQUEST_CHANGE_SAVE_SET.390
-rw-r--r--man3/LIBAXL_REQUEST_LIST_FONTS.32
2 files changed, 91 insertions, 1 deletions
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 <libaxl.h>
+
+#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 <libaxl.h>
#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;