From 5c18894ab9c2b3beb20a616fc4328381ee59786a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 14 Jan 2023 17:04:48 +0000
Subject: [PATCH 001/157] WIP - rewrite requests

---
 src/lib.rs              |    2 +-
 src/x11/request.rs      |   37 ++
 src/x11/requests/mod.rs | 1190 ---------------------------------------
 3 files changed, 38 insertions(+), 1191 deletions(-)
 create mode 100644 src/x11/request.rs
 delete mode 100644 src/x11/requests/mod.rs

diff --git a/src/lib.rs b/src/lib.rs
index 7aa51e58..eba27893 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -62,7 +62,7 @@ pub mod message;
 /// Implementation of the core X11 protocol.
 pub mod x11 {
 	pub mod event;
-	// pub mod request;
+	pub mod request;
 }
 
 pub use common::*;
diff --git a/src/x11/request.rs b/src/x11/request.rs
new file mode 100644
index 00000000..4d8dd94d
--- /dev/null
+++ b/src/x11/request.rs
@@ -0,0 +1,37 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! Requests: commands to the X server.
+//!
+//! Requests are messages sent _from_ the client _to_ the X server. They are
+//! commands for the X server to carry out. Some requests generate replies
+//! that are sent back to the client.
+
+use crate::{Inheritable, VisualId, Window, WindowClass};
+use bytes::BufMut;
+use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, Readable, Writable, WriteResult, X11Size};
+
+use crate::mask::AttributeMask;
+
+use xrbk_macro::derive_xrb;
+extern crate self as xrb;
+
+derive_xrb! {
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateWindow: Request(1) {
+		#[metabyte]
+		pub depth: u8,
+
+		pub window_id: Window,
+		pub parent: Window,
+		pub x: i16,
+		pub y: i16,
+		pub width: u16,
+		pub height: u16,
+		pub border_width: u16,
+		//pub class: Inheritable<WindowClass, u16>,
+		//pub visual: Inheritable<VisualId, u32>,
+		pub attribute_mask: AttributeMask,
+	}
+}
diff --git a/src/x11/requests/mod.rs b/src/x11/requests/mod.rs
deleted file mode 100644
index cf4d5b57..00000000
--- a/src/x11/requests/mod.rs
+++ /dev/null
@@ -1,1190 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-
-use crate::x11::*;
-use xrb_proc_macros::messages;
-
-messages! {
-	/// Creates an unmapped window with the given `window_id`.
-	///
-	/// # Events
-	/// - [CreateNotify]
-	///
-	/// # Errors
-	/// - [Alloc]
-	/// - [Colormap]
-	/// - [Cursor]
-	/// - [IdChoice]
-	/// - [Match] -- Generated if the `class` is [`InputOutput`] and the `visual`
-	///   type and `depth` are not a combination supported by the screen, or if
-	///   the `class` is [`InputOnly`] and the `depth` is not [`CopyFromParent`]
-	///   or `0`.
-	/// - [Pixmap]
-	/// - [Value]
-	/// - [Window]
-	///
-	/// [Alloc]: crate::x11::errors::Alloc
-	/// [Colormap]: crate::x11::errors::Colormap
-	/// [Cursor]: crate::x11::errors::Cursor
-	/// [IdChoice]: crate::x11::errors::IdChoice
-	/// [Match]: crate::x11::errors::Match
-	/// [Pixmap]: crate::x11::errors::Pixmap
-	/// [Value]: crate::x11::errors::Value
-	/// [Window]: crate::x11::errors::Window
-	pub struct CreateWindow<'a>(1) {
-		/// The resource ID given to the window.
-		pub window_id: Window,
-		/// The parent of which the window will be created as a child of.
-		pub parent: Window,
-		/// The [window class] of the window.
-		///
-		/// For [`InputOutput`], the `visual` type and `depth` must be a
-		/// combination supported by the screen, else a [`Match`] error occurs.
-		///
-		/// For [`InputOnly`], the `depth` must be [`CopyFromParent`] (or `0`).
-		///
-		/// [`InputOutput`]: WindowClass::InputOutput
-		/// [`InputOnly`]: WindowClass::InputOnly
-		/// [window class]: WindowClass
-		/// [`Match`]: crate::x11::errors::Match
-		pub class: Inheritable<WindowClass>,
-		/// The color depth of the window in bits per pixel.
-		///
-		/// If the class is not [`InputOnly`], [`CopyFromParent`] will copy the
-		/// `depth` from the parent. __If the class is [`InputOnly`], this must
-		/// be set to [`CopyFromParent`]__, else a [`Match`] error shall occur.
-		///
-		/// [`InputOnly`]: WindowClass::InputOnly
-		/// [`CopyFromParent`]: Inherit::CopyFromParent
-		/// [`Match`]: crate::x11::errors::Match
-		pub $depth: Inheritable<u8>,
-		pub visual: Inheritable<VisualId>,
-		/// The initial x-coordinate of the window relative to its parent's
-		/// top-left corner.
-		pub x: i16,
-		/// The initial y-coordinate of the window relative to its parent's
-		/// top-right corner.
-		pub y: i16,
-		/// The width of the window.
-		pub width: u16,
-		/// The height of the window.
-		pub height: u16,
-		pub border_width: u16,
-		pub value_mask: AttributeMask,
-		/// A list of [window attributes] that are to configured for the window.
-		///
-		/// [window attributes]: Attribute
-		pub values: &'a [Attribute], // Window is a placeholder until WinAttr is done
-	}
-
-	pub struct ChangeWindowAttributes<'a>(2) {
-		pub target: Window,
-		pub value_mask: AttributeMask,
-		pub values: &'a [Attribute],
-	}
-
-	pub struct GetWindowAttributes(3) -> GetWindowAttributesReply {
-		pub target: Window,
-	}
-
-	pub struct GetWindowAttributesReply for GetWindowAttributes {
-		pub $backing_store: BackingStore,
-		pub visual: VisualId,
-		pub class: WindowClass,
-		pub bit_gravity: BitGravity,
-		pub win_gravity: WinGravity,
-		pub backing_planes: u32,
-		pub backing_pixel: u32,
-		pub save_under: bool,
-		pub map_is_installed: bool,
-		pub map_state: MapState,
-		pub override_redirect: bool,
-		pub colormap: Option<Colormap>,
-		pub all_event_masks: EventMask,
-		pub your_event_mask: EventMask,
-		pub do_not_propagate_mask: DeviceEventMask,
-		[(); 2],
-	}
-
-	pub struct DestroyWindow(4): pub target: Window;
-	pub struct DestroySubwindows(5): pub target: Window;
-
-	pub struct ChangeSaveSet(6) {
-		pub $mode: EditMode,
-		pub target: Window,
-	}
-
-	pub struct ReparentWindow(7) {
-		pub target: Window,
-		pub new_parent: Window,
-		pub new_x: i16,
-		pub new_y: i16,
-	}
-
-	pub struct MapWindow(8): pub target: Window;
-	pub struct MapSubwindows(9): pub target: Window;
-
-	pub struct UnmapWindow(10): pub target: Window;
-	pub struct UnmapSubwindows(11): pub target: Window;
-
-	pub struct ConfigureWindow<'a>(12) {
-		pub target: Window,
-		pub value_mask: ConfigureWindowMask,
-		pub values: &'a [ConfigureWindowValue],
-	}
-
-	pub struct CirculateWindow(13) {
-		pub $direction: CirculateDirection,
-		pub target: Window,
-	}
-
-	pub struct GetGeometry(14) -> GetGeometryReply: pub target: Box<dyn Drawable>;
-
-	pub struct GetGeometryReply for GetGeometry {
-		pub $depth: u8,
-		pub root: Window,
-		pub x: i16,
-		pub y: i16,
-		pub width: u16,
-		pub height: u16,
-		pub border_width: u16,
-		[(); 10],
-	}
-
-	pub struct QueryTree(15) -> QueryTreeReply: pub target: Window;
-
-	pub struct QueryTreeReply for QueryTree {
-		pub root: Window,
-		pub parent: Option<Window>,
-		#children: u16,
-		[(); 14],
-		pub children: Vec<Window>,
-	}
-
-	pub struct InternAtom(16) -> InternAtomReply {
-		pub $only_if_exists: bool,
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	pub struct InternAtomReply for InternAtom {
-		pub atom: Option<Atom>,
-		[(); 20],
-	}
-
-	pub struct GetAtomName(17) -> GetAtomNameReply: pub atom: Atom;
-
-	pub struct GetAtomNameReply for GetAtomName {
-		#name: u16,
-		[(); 22],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	// The property requests (`ChangeProperty(18)`, `DeleteProperty(19)`,
-	// `GetProperty(20)`, and `ListProperties(21)`) are special cases and need
-	// to be defined manually. You can find them in `mod properties;`.
-
-	pub struct SetSelectionOwner(22) {
-		pub $owner: Option<Window>,
-		pub selection: Atom,
-		pub time: Time,
-	}
-
-	pub struct GetSelectionOwner(23) -> GetSelectionOwnerReply {
-		pub selection: Atom,
-	}
-
-	pub struct GetSelectionOwnerReply for GetSelectionOwner {
-		pub owner: Option<Window>,
-		[(); 20],
-	}
-
-	pub struct ConvertSelection(24) {
-		pub requestor: Window,
-		pub selection: Atom,
-		pub target: Atom,
-		pub property: Option<Atom>,
-		pub time: Time,
-	}
-
-	pub struct SendEvent(25) {
-		pub $propagate: bool,
-		pub destination: Destination,
-		pub event_mask: EventMask,
-		//pub event: Box<dyn Event>,
-	}
-
-	pub struct GrabPointer(26) -> GrabPointerReply {
-		pub $owner_events: bool,
-		pub target_window: Window,
-		pub event_mask: PointerEventMask,
-		pub pointer_mode: GrabMode,
-		pub keyboard_mode: GrabMode,
-		pub confine_to: Option<Window>,
-		pub cursor_override: Option<Cursor>,
-		pub time: Time,
-	}
-
-	pub struct GrabPointerReply for GrabPointer {
-		pub $status: GrabStatus,
-		[(); 24],
-	}
-
-	pub struct UngrabPointer(27): pub time: Time;
-
-	pub struct GrabButton(28) {
-		pub $owner_events: bool,
-		pub target_window: Window,
-		pub event_mask: PointerEventMask,
-		pub pointer_mode: GrabMode,
-		pub keyboard_mode: GrabMode,
-		pub confine_to: Option<Window>,
-		pub cursor_override: Option<Cursor>,
-		pub button: Any<Button>,
-		(),
-		pub modifiers: AnyModifierKeyMask,
-	}
-
-	pub struct UngrabButton(29) {
-		pub $button: Any<Button>,
-		pub target_window: Window,
-		[(); 2],
-	}
-
-	pub struct ChangeActivePointerGrab(30) {
-		pub cursor_override: Option<Cursor>,
-		pub time: Time,
-		pub event_mask: PointerEventMask,
-		[(); 2],
-	}
-
-	pub struct GrabKeyboard(31) -> GrabKeyboardReply {
-		pub $owner_events: bool,
-		pub target_window: Window,
-		pub time: Time,
-		pub pointer_mode: GrabMode,
-		pub keyboard_mode: GrabMode,
-		[(); 2],
-	}
-
-	pub struct GrabKeyboardReply for GrabKeyboard {
-		pub $status: GrabStatus,
-		[(); 24],
-	}
-
-	pub struct UngrabKeyboard(32): pub time: Time;
-
-	pub struct GrabKey(33) {
-		pub $owner_events: bool,
-		pub target_window: Window,
-		pub modifiers: AnyModifierKeyMask,
-		pub key: Any<Keycode>,
-		pub pointer_mode: GrabMode,
-		pub keyboard_mode: GrabMode,
-		[(); 3],
-	}
-
-	pub struct UngrabKey(34) {
-		pub $key: Any<Keycode>,
-		pub target_window: Window,
-		pub modifiers: AnyModifierKeyMask,
-		[(); 2],
-	}
-
-	pub struct AllowEvents(35) {
-		pub $mode: AllowEventsMode,
-		pub time: Time,
-	}
-
-	pub struct GrabServer(36);
-	pub struct UngrabSever(37);
-
-	pub struct QueryPointer(38) -> QueryPointerReply: pub target: Window;
-
-	pub struct QueryPointerReply for QueryPointer {
-		pub $same_screen: bool,
-		pub root: Window,
-		pub child: Option<Window>,
-		pub root_x: i16,
-		pub root_y: i16,
-		pub win_x: i16,
-		pub win_y: i16,
-		pub mask: ModifierMask,
-		[(); 6],
-	}
-
-	pub struct GetMotionEvents(39) -> GetMotionEventsReply {
-		pub target: Window,
-		pub start: Time,
-		pub stop: Time,
-	}
-
-	pub struct GetMotionEventsReply for GetMotionEvents {
-		#events: u32,
-		[(); 20],
-		pub events: Vec<(Timestamp, (i16, i16))>,
-	}
-
-	pub struct TranslateCoordinates(40) -> TranslateCoordinatesReply {
-		pub source: Window,
-		pub destination: Window,
-		pub src_x: u16,
-		pub src_y: u16,
-	}
-
-	pub struct TranslateCoordinatesReply for TranslateCoordinates {
-		pub $same_screen: bool,
-		pub child: Option<Window>,
-		pub dest_x: i16,
-		pub dest_y: i16,
-		[(); 16],
-	}
-
-	pub struct WarpPointer(41) {
-		pub source: Option<Window>,
-		pub destination: Option<Window>,
-		pub src_x: i16,
-		pub src_y: i16,
-		pub src_width: u16,
-		pub src_height: u16,
-		pub dest_x: u16,
-		pub dest_y: u16,
-	}
-
-	pub struct SetInputFocus(42) {
-		//pub $revert_to: Option<RevertTo>,
-		pub focus: Option<InputFocus>,
-		pub time: Time,
-	}
-
-	pub struct GetInputFocus(43) -> GetInputFocusReply;
-
-	pub struct GetInputFocusReply for GetInputFocus {
-		pub $revert_to: RevertTo,
-		pub focus: Option<InputFocus>,
-		[(); 20],
-	}
-
-	pub struct QueryKeymap(44) -> QueryKeymapReply;
-
-	pub struct QueryKeymapReply for QueryKeymap {
-		pub keys: [u8; 32],
-	}
-
-	pub struct OpenFont(45) {
-		pub font_id: Font,
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	pub struct CloseFont(46): pub font: Font;
-
-	pub struct QueryFont<'a>(47) -> QueryFontReply: pub font: &'a dyn Fontable;
-
-	pub struct QueryFontReply for QueryFont<'_> {
-		pub min_bounds: CharInfo,
-		[(); 4],
-		pub max_bounds: CharInfo,
-		[(); 4],
-		pub min_char_or_byte2: u16,
-		pub max_char_or_byte2: u16,
-		#properties: u16,
-		pub draw_direction: DrawDirection,
-		pub min_byte1: u8,
-		pub max_byte1: u8,
-		pub all_chars_exist: bool,
-		pub font_ascent: i16,
-		pub font_descent: i16,
-		#charinfos: u32,
-		pub properties: Vec<FontProperty>,
-		pub charinfos: Vec<CharInfo>,
-	}
-
-	pub struct QueryTextExtents(48) -> QueryTextExtentsReply {
-		pub $odd_length: bool,
-		pub font: Box<dyn Fontable>,
-		pub string: String16,
-		[(); {string}],
-	}
-
-	pub struct QueryTextExtentsReply for QueryTextExtents {
-		pub $draw_direction: DrawDirection,
-		pub font_ascent: i16,
-		pub font_descent: i16,
-		pub overall_ascent: i16,
-		pub overall_descent: i16,
-		pub overall_width: i32,
-		pub overall_left: i32,
-		pub overall_right: i32,
-		[(); 4],
-	}
-
-	pub struct ListFonts(49) -> ListFontsReply {
-		pub max_names: u16,
-		#pattern: u16,
-		pub pattern: String8,
-		[(); {pattern}],
-	}
-
-	pub struct ListFontsReply for ListFonts {
-		#names: u32,
-		[(); 22],
-		pub names: Vec<LenString8>,
-		[(); {names}],
-	}
-
-	// ListFontsWithInfo has a special format for its reply that needs to be
-	// done manually, so both the request and the reply are contained within the
-	// `mod list_fonts_with_info;` module.
-
-	pub struct SetFontPath<'a>(51) {
-		#path: u16,
-		[(); 2],
-		pub path: &'a [LenString8],
-		[(); {path}],
-	}
-
-	// GetFontPath has a special format for its request. Both the request and
-	// the reply are done manually and can be found in the `mod get_font_path;`
-	// module.
-
-	pub struct CreatePixmap<'a>(53) {
-		pub $depth: u8,
-		pub pixmap_id: Pixmap,
-		pub drawable: &'a dyn Drawable,
-		pub width: u16,
-		pub height: u16,
-	}
-
-	pub struct FreePixmap(54): pub pixmap: Pixmap;
-
-	pub struct CreateGraphicsContext<'a>(55) {
-		pub context_id: GraphicsContext,
-		pub drawable: &'a dyn Drawable,
-		pub value_mask: GraphicsContextMask,
-		pub values: &'a [GraphicsContextValue],
-	}
-
-	pub struct ChangeGraphicsContext<'a>(56) {
-		pub context: GraphicsContext,
-		pub value_mask: GraphicsContextMask,
-		pub values: &'a [GraphicsContextValue],
-	}
-
-	pub struct CopyGraphicsContext(57) {
-		pub source: GraphicsContext,
-		pub destination: GraphicsContext,
-		pub value_mask: GraphicsContextMask,
-	}
-
-	pub struct SetDashes<'a>(58) {
-		pub context: GraphicsContext,
-		pub dash_offset: u16,
-		#dashes: u16,
-		pub dashes: &'a [u8],
-		[(); {dashes}],
-	}
-
-	pub struct SetClipRectangles<'a>(59) {
-		pub $ordering: Ordering,
-		pub context: GraphicsContext,
-		pub clip_x_origin: i16,
-		pub clip_y_origin: i16,
-		pub rectangles: &'a [Rectangle],
-	}
-
-	pub struct FreeGraphicsContext(60): pub context: GraphicsContext;
-
-	pub struct ClearArea(61) {
-		pub $exposures: bool,
-		pub target_window: Window,
-		pub x: i16,
-		pub y: i16,
-		pub width: u16,
-		pub height: u16,
-	}
-
-	pub struct CopyArea<'a>(62) {
-		pub source: &'a dyn Drawable,
-		pub destination: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub src_x: i16,
-		pub src_y: i16,
-		pub dest_x: i16,
-		pub dest_y: i16,
-		pub width: u16,
-		pub height: u16,
-	}
-
-	pub struct CopyPlane<'a>(63) {
-		pub source: &'a dyn Drawable,
-		pub destination: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub src_x: i16,
-		pub src_y: i16,
-		pub dest_x: i16,
-		pub dest_y: i16,
-		pub width: u16,
-		pub height: u16,
-		pub bit_plane: u32,
-	}
-
-	pub struct PolyPoint<'a>(64) {
-		pub $coordinate_mode: CoordinateMode,
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub points: &'a [(i16, i16)],
-	}
-
-	pub struct PolyLine<'a>(65) {
-		pub $coordinate_mode: CoordinateMode,
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub points: &'a [(i16, i16)],
-	}
-
-	pub struct PolySegment<'a>(66) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub segments: &'a [Segment],
-	}
-
-	pub struct PolyRectangle<'a>(67) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub rectangles: &'a [Rectangle],
-	}
-
-	pub struct PolyArc<'a>(68) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub arcs: &'a [GeomArc],
-	}
-
-	pub struct FillPoly<'a>(69) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub shape: Shape,
-		pub coordinate_mode: CoordinateMode,
-		[(); 2],
-		pub points: &'a [(i16, i16)],
-	}
-
-	pub struct PolyFillRectangle<'a>(70) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub rectangles: &'a [Rectangle],
-	}
-
-	pub struct PolyFillArc<'a>(71) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub arcs: &'a [GeomArc],
-	}
-
-	pub struct PutImage<'a>(72) {
-		pub $format: BitmapFormat,
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub width: u16,
-		pub height: u16,
-		pub dest_x: i16,
-		pub dest_y: i16,
-		pub left_padding: u8,
-		pub depth: u8,
-		[(); 2],
-		pub data: &'a [u8],
-		[(); {data}],
-	}
-
-	pub struct GetImage<'a>(73) -> GetImageReply {
-		pub $format: Format,
-		pub drawable: &'a dyn Drawable,
-		pub x: i16,
-		pub y: i16,
-		pub width: u16,
-		pub height: u16,
-		pub plane_mask: u32,
-	}
-
-	pub struct GetImageReply for GetImage<'_> {
-		pub $depth: u8,
-		pub visual: Option<VisualId>,
-		[(); 20],
-		pub data: Vec<u8>,
-		[(); {data}],
-	}
-
-	pub struct PolyText8<'a>(74) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub x: i16,
-		pub y: i16,
-		//pub items: &'a [TextItem8], // TODO: TextItem8 and TextItem16 need to be done separately
-		//[(); {items}],
-	}
-
-	pub struct PolyText16<'a>(75) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub x: i16,
-		pub y: i16,
-		//pub items: [TextItem16], // TODO: TextItem8 and TextItem16 need to be done separately
-		//[(); {items}],
-	}
-
-	pub struct ImageText8<'a>(76) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub x: i16,
-		pub y: i16,
-		pub string: String8,
-		[(); {string}],
-	}
-
-	pub struct ImageText16<'a>(77) {
-		pub drawable: &'a dyn Drawable,
-		pub context: GraphicsContext,
-		pub x: i16,
-		pub y: i16,
-		pub string: String16,
-		[(); {string}],
-	}
-
-	pub struct CreateColormap(78) {
-		pub $alloc: ColormapAlloc,
-		pub colormap_id: Colormap,
-		pub window: Window,
-		pub visual: VisualId,
-	}
-
-	pub struct FreeColormap(79): pub colormap: Colormap;
-
-	pub struct CopyColormapAndFree(80) {
-		pub colormap_id: Colormap,
-		pub source: Colormap,
-	}
-
-	pub struct InstallColormap(81): pub colormap: Colormap;
-	pub struct UninstallColormap(82): pub colormap: Colormap;
-
-	pub struct ListInstalledColormaps(73) -> ListInstalledColormapsReply {
-		pub target_window: Window,
-	}
-
-	pub struct ListInstalledColormapsReply for ListInstalledColormaps {
-		#colormaps: u16,
-		[(); 22],
-		pub colormaps: Vec<Colormap>,
-	}
-
-	pub struct AllocColor(84) -> AllocColorReply {
-		pub colormap: Colormap,
-		pub color: (u16, u16, u16),
-		[(); 2],
-	}
-
-	pub struct AllocColorReply for AllocColor {
-		pub color: (u16, u16, u16),
-		[(); 2],
-		pub pixel: u32,
-		[(); 12],
-	}
-
-	pub struct AllocNamedColor(85) -> AllocNamedColorReply {
-		pub colormap: Colormap,
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	pub struct AllocNamedColorReply for AllocNamedColor {
-		pub pixel: u32,
-		pub exact_color: (u16, u16, u16),
-		pub visual_color: (u16, u16, u16),
-		[(); 8],
-	}
-
-	pub struct AllocColorCells(86) -> AllocColorCellsReply {
-		pub $contiguous: bool,
-		pub colormap: Colormap,
-		pub num_colors: u16, // TODO: its just called `colors`... is it the number?
-		pub planes: u16,
-	}
-
-	pub struct AllocColorCellsReply for AllocColorCells {
-		#pixels: u16,
-		#masks: u16,
-		[(); 20],
-		pub pixels: Vec<u32>,
-		pub masks: Vec<u32>,
-	}
-
-	pub struct AllocColorPlanes(87) -> AllocColorPlanesReply {
-		pub $contiguous: bool,
-		pub colormap: Colormap,
-		pub num_colors: u16, // TODO: its just called `colors`... is it the number?
-		pub colors: (u16, u16, u16),
-	}
-
-	pub struct AllocColorPlanesReply for AllocColorPlanes {
-		#pixels: u16,
-		[(); 2],
-		pub color_mask: (u16, u16, u16),
-		[(); 8],
-		pub pixels: Vec<u32>,
-	}
-
-	pub struct FreeColors<'a>(88) {
-		pub colormap: Colormap,
-		pub plane_mask: u32,
-		pub pixels: &'a [u32],
-	}
-
-	pub struct StoreColors(89) {
-		pub colormap: Colormap,
-		//pub items: [ColorItem], // ColorItems need to be done separately
-	}
-
-	pub struct StoreNamedColor(90) {
-		pub $channel_mask: ColorChannelMask,
-		pub colormap: Colormap,
-		pub pixel: u32,
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	// The QueryColorsReply for the QueryColors request uses a special format
-	// for its list of colors, and so the reply must be done manually. The
-	// reply and request have been put in `mod query_colors;`.
-
-	pub struct LookupColor(92) -> LookupColorReply {
-		pub colormap: Colormap,
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	pub struct LookupColorReply for LookupColor {
-		pub exact_color: (u16, u16, u16),
-		pub visual_color: (u16, u16, u16),
-		[(); 12],
-	}
-
-	pub struct CreateCursor(93) {
-		pub cursor_id: Cursor,
-		pub source: Pixmap,
-		pub mask: Option<Pixmap>,
-		pub foreground_color: (u16, u16, u16),
-		pub background_color: (u16, u16, u16),
-		pub x: u16,
-		pub y: u16,
-	}
-
-	pub struct CreateGlyphCursor(94) {
-		pub cursor_id: Cursor,
-		pub source_font: Font,
-		pub mask_font: Option<Font>,
-		pub source_char: u16,
-		pub mask_char: u16,
-		pub foreground_color: (u16, u16, u16),
-		pub background_color: (u16, u16, u16),
-	}
-
-	pub struct FreeCursor(95): pub cursor: Cursor;
-
-	/// Changes the color of the given `cursor`.
-	///
-	/// If the `cursor` is currently being displayed on a screen, the change is
-	/// visible immediately.
-	///
-	/// # Errors
-	/// - [`Cursor`]
-	///
-	/// [`Cursor`]: crate::x11::errors::Cursor
-	pub struct RecolorCursor(96) {
-		pub cursor: Cursor,
-		/// The tint to apply to the cursor's foreground.
-		///
-		/// This is in RGB format (i.e. `(red, green, blue)`).
-		pub foreground_color: (u16, u16, u16),
-		/// The tint to apply to the cursor's background.
-		///
-		/// This is in RGB format (i.e. `(red, green, blue)`).
-		pub background_color: (u16, u16, u16),
-	}
-
-	/// Gets the closest ideal size to the given `width` and `height`.
-	///
-	/// For [`Cursor`], this is the largest size that can be fully displayed
-	/// within `width` and `height`. For [`Tile`], this is the size that can be
-	/// tiled fastest. For [`Stipple`], this is the size that can be stippled
-	/// fastest.
-	///
-	/// # Errors
-	/// - [`Drawable`]
-	/// - [`Match`] -- Generated if an [`InputOnly`] [window] is used with the
-	///   [`Tile`] or [`Stipple`] classes.
-	/// - [`Value`]
-	///
-	/// # Reply
-	/// This request generates a [`QueryBestSizeReply`].
-	///
-	/// [`Cursor`]: query_best_size::Class::Cursor
-	/// [`Tile`]: query_best_size::Class::Tile
-	/// [`Stipple`]: query_best_size::Class::Stipple
-	/// [`Drawable`]: crate::x11::errors::Drawable
-	/// [`Match`]: crate::x11::errors::Match
-	/// [`Value`]: crate::x11::errors::Value
-	/// [window]: Window
-	/// [`InputOnly`]: WindowClass::InputOnly
-	pub struct QueryBestSize<'a>(97) -> QueryBestSizeReply {
-		/// The 'type' of 'best size' being queried.
-		pub $class: QueryBestSizeClass,
-		/// Indicates the desired screen.
-		///
-		/// For [`Tile`] and [`Stipple`], the `drawable` indicates the screen
-		/// and also possibly the window class and depth.
-		///
-		/// An [`InputOnly`] [`Window`] cannot be used as the drawable for
-		/// [`Tile`] or [`Stipple`], else a [`Match`] error occurs.
-		///
-		/// [`Tile`]: query_best_size::Class::Tile
-		/// [`Stipple`]: query_best_size::Class::Stipple
-		/// [`InputOnly`]: query_best_size::Class::InputOnly
-		pub drawable: &'a dyn Drawable,
-		/// The given width to find an ideal size for.
-		pub width: u16,
-		/// The given height to find an ideal size for.
-		pub height: u16,
-	}
-
-	/// The reply for the [`QueryBestSize`] request.
-	///
-	/// This contains the closest ideal size to the `width` and `height` that
-	/// was given in the [`QueryBestSize`] request. See the request's docs for
-	/// more information.
-	pub struct QueryBestSizeReply for QueryBestSize<'_> {
-		/// The width of the ideal size found.
-		pub width: u16,
-		/// The height of the ideal size found.
-		pub height: u16,
-		[(); 20],
-	}
-
-	pub struct QueryExtension(98) -> QueryExtensionReply {
-		#name: u16,
-		[(); 2],
-		pub name: String8,
-		[(); {name}],
-	}
-
-	pub struct QueryExtensionReply for QueryExtension {
-		pub $present: bool,
-		pub major_opcode: u8,
-		pub first_event: u8,
-		pub first_error: u8,
-		[(); 20],
-	}
-
-	pub struct ListExtensions(99) -> ListExtensionsReply;
-
-	pub struct ListExtensionsReply for ListExtensions {
-		$#names: u8,
-		[(); 24],
-		pub names: Vec<LenString8>,
-		[(); {names}],
-	}
-
-	// The `ChangeKeyboardMapping` and `GetKeyboardMapping` requests, as well as
-	// the `GetKeyboardMappingReply`, used a special format for the size of
-	// their lists of keysyms, and so have to be done manually. They can be
-	// found in the `mod keyboard_mapping;` module.
-
-	// The `ChangeKeyboardControl` request uses a special format for its values
-	// list, so it has to be done manually. It can be found in the
-	// `mod change_keyboard_control;` module.
-
-	pub struct GetKeyboardControl(103) -> GetKeyboardControlReply;
-
-	pub struct GetKeyboardControlReply for GetKeyboardControl {
-		pub $global_auto_repeat: bool,
-		pub led_mask: u32,
-		pub key_click_percent: u8,
-		pub bell_percent: u8,
-		pub bell_pitch: u16,
-		pub bell_duration: u16,
-		[(); 2],
-		pub auto_repeats: [u8; 32],
-	}
-
-	pub struct Bell(104): pub $percent: i8;
-
-	pub struct ChangePointerControl(105) {
-		pub acceleration_numerator: i16,
-		pub acceleration_denominator: i16,
-		pub threshold: i16,
-		pub accelerate: bool,
-		pub enable_threshold: bool,
-	}
-
-	pub struct GetPointerControl(106) -> GetPointerControlReply;
-
-	pub struct GetPointerControlReply for GetPointerControl {
-		pub acceleration_numerator: i16,
-		pub acceleration_denominator: u16,
-		pub threshold: u16,
-		[(); 18],
-	}
-
-	pub struct SetScreenSaver(107) {
-		pub timeout: i16,
-		pub interval: i16,
-		pub prefer_blanking: Defaultable<bool>,
-		pub allow_exposures: Defaultable<bool>,
-		[(); 2],
-	}
-
-	pub struct GetScreenSaver(108) -> GetScreenSaverReply;
-
-	pub struct GetScreenSaverReply for GetScreenSaver {
-		pub timeout: i16,
-		pub interval: i16,
-		pub prefer_blanking: bool,
-		pub allow_exposures: bool,
-		[(); 18],
-	}
-
-	pub struct ChangeHosts<'a>(109) {
-		pub $mode: EditMode,
-		pub family: HostFamilyA,
-		[(); 1],
-		#address: u16,
-		pub address: &'a [u8],
-		[(); {address}],
-	}
-
-	pub struct ListHosts(110) -> ListHostsReply;
-
-	pub struct ListHostsReply for ListHosts {
-		pub $enabled: bool,
-		#hosts: u16,
-		[(); 22],
-		pub hosts: Vec<Host>,
-	}
-
-	pub struct SetAccessControl(111): pub $enabled: bool;
-
-	pub struct SetCloseDownMode(112): pub $mode: CloseDownMode;
-
-	//pub struct KillClient(113): pub resource: AllTemp<u32>;
-
-	pub struct RotateProperties<'a>(114) {
-		pub target: Window,
-		#properties: u16,
-		pub delta: i16,
-		pub properties: &'a [Atom],
-	}
-
-	pub struct ForceScreenSaver(115): pub $mode: ScreenSaverMode;
-
-	pub struct SetPointerMapping<'a>(116) -> SetPointerMappingReply {
-		$#map: u8,
-		pub map: &'a [u8],
-		[(); {map}],
-	}
-
-	pub struct SetPointerMappingReply for SetPointerMapping<'_> {
-		pub $status: Status,
-		[(); 24],
-	}
-
-	pub struct GetPointerMapping(117) -> GetPointerMappingReply;
-
-	pub struct GetPointerMappingReply for GetPointerMapping {
-		$#map: u8,
-		[(); 24],
-		pub map: Vec<u8>,
-		[(); {map}],
-	}
-
-	// `SetModifierMapping` and `GetModifierMappingReply` both use a special
-	// format for the list of keycodes, so the `SetModifierMapping` request,
-	// the `GetModifierMapping` request, the `SetModifierMappingReply`, and the
-	// `GetModifierMappingReply` messages are contained in the
-	// `mod modifier_mappings;` module.
-
-	// The `NoOperation` request uses a unique variable unused bytes length
-	// format, so it has to be done manually. It is therefore found in the
-	// `mod no_operation;` module.
-}
-
-#[cfg(test)]
-mod tests {
-	use super::*;
-	use crate::traits::*;
-
-	#[test]
-	fn create_window_length_is_correct() {
-		let create_window = CreateWindow {
-			window_id: Window::empty(),
-			parent: Window::empty(),
-			class: Inheritable::CopyFromParent,
-			depth: Inheritable::CopyFromParent,
-			visual: Inheritable::CopyFromParent,
-			x: 0,
-			y: 0,
-			width: 1,
-			height: 1,
-			border_width: 0,
-			value_mask: AttributeMask::empty(),
-			values: &[Attribute::BackingPixel(0), Attribute::Cursor(None)],
-		};
-
-		assert_eq!(create_window.length(), 10);
-	}
-
-	#[test]
-	fn change_window_attributes_length_is_correct() {
-		let change_window_attributes = ChangeWindowAttributes {
-			target: Window::new(0),
-			value_mask: AttributeMask::empty(),
-			values: &[],
-		};
-
-		assert_eq!(change_window_attributes.length(), 3);
-	}
-
-	#[test]
-	fn get_window_attributes_length_is_correct() {
-		let get_window_attributes = GetWindowAttributes {
-			target: Window::new(0),
-		};
-
-		assert_eq!(get_window_attributes.length(), 2);
-	}
-
-	#[test]
-	fn get_window_attributes_reply_length_is_correct() {
-		let get_window_attributes_reply = GetWindowAttributesReply {
-			__sequence: 0,
-			__major_opcode: None,
-			__minor_opcode: None,
-			backing_store: BackingStore::Always,
-			visual: VisualId::new(0),
-			class: WindowClass::InputOnly,
-			bit_gravity: BitGravity::West,
-			win_gravity: WinGravity::West,
-			backing_planes: 0,
-			backing_pixel: 0,
-			save_under: false,
-			map_is_installed: false,
-			map_state: MapState::Unmapped,
-			override_redirect: false,
-			colormap: None,
-			all_event_masks: EventMask::empty(),
-			your_event_mask: EventMask::empty(),
-			do_not_propagate_mask: DeviceEventMask::empty(),
-		};
-
-		assert_eq!(get_window_attributes_reply.length(), 0);
-	}
-
-	#[test]
-	fn destroy_window_length_is_correct() {
-		let destroy_window = DestroyWindow {
-			target: Window::new(0),
-		};
-
-		assert_eq!(destroy_window.length(), 2);
-	}
-
-	#[test]
-	fn destroy_subwindows_length_is_correct() {
-		let destroy_subwindows = DestroySubwindows {
-			target: Window::new(0),
-		};
-
-		assert_eq!(destroy_subwindows.length(), 2);
-	}
-
-	#[test]
-	fn change_save_set_length_is_correct() {
-		let change_save_set = ChangeSaveSet {
-			mode: EditMode::Insert,
-			target: Window::new(0),
-		};
-
-		assert_eq!(change_save_set.length(), 2);
-	}
-
-	#[test]
-	fn reparent_window_length_is_correct() {
-		let reparent_window = ReparentWindow {
-			target: Window::new(0),
-			new_parent: Window::new(0),
-			new_x: 0,
-			new_y: 0,
-		};
-
-		assert_eq!(reparent_window.length(), 4);
-	}
-
-	#[test]
-	fn convert_selection_length_is_correct() {
-		let convert_selection = ConvertSelection {
-			requestor: Window::new(0),
-			selection: Atom::new(0),
-			target: Atom::new(0),
-			property: None,
-			time: Time::Current,
-		};
-
-		assert_eq!(convert_selection.length(), 6);
-	}
-
-	#[test]
-	fn grab_pointer_length_is_correct() {
-		let grab_pointer = GrabPointer {
-			owner_events: false,
-			target_window: Window::new(0),
-			event_mask: PointerEventMask::empty(),
-			pointer_mode: GrabMode::Asynchronous,
-			keyboard_mode: GrabMode::Asynchronous,
-			confine_to: None,
-			cursor_override: None,
-			time: Time::Current,
-		};
-
-		assert_eq!(grab_pointer.length(), 6);
-	}
-
-	#[test]
-	fn grab_pointer_reply_length_is_correct() {
-		let grab_pointer_reply = GrabPointerReply {
-			__sequence: 0,
-			__major_opcode: None,
-			__minor_opcode: None,
-			status: GrabStatus::Success,
-		};
-
-		assert_eq!(grab_pointer_reply.length(), 0);
-	}
-
-	#[test]
-	fn grab_server_length_is_correct() {
-		let grab_server = GrabServer {};
-
-		assert_eq!(grab_server.length(), 1);
-	}
-}

From 1b2acf2b7cb0b3e9a6f16c7d69d2d0aaff1a5615 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 16 Jan 2023 12:38:58 +0000
Subject: [PATCH 002/157] [CI501] applied recommended clippy fixes

---
 src/x11/request.rs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 4d8dd94d..70de351a 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -8,9 +8,9 @@
 //! commands for the X server to carry out. Some requests generate replies
 //! that are sent back to the client.
 
-use crate::{Inheritable, VisualId, Window, WindowClass};
+use crate::{Window};
 use bytes::BufMut;
-use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, Readable, Writable, WriteResult, X11Size};
+use xrbk::{Buf};
 
 use crate::mask::AttributeMask;
 

From cc1b2dd056a514e64afac4558a5375f216bf32b1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 16 Jan 2023 12:38:59 +0000
Subject: [PATCH 003/157] [CI501] formatted code with rustfmt

---
 src/lib.rs         | 2 +-
 src/x11/request.rs | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 0c652588..38dd888d 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -61,9 +61,9 @@ pub mod message;
 
 /// Implementation of the core X11 protocol.
 pub mod x11 {
+	pub mod error;
 	pub mod event;
 	pub mod request;
-	pub mod error;
 }
 
 pub use common::*;
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 70de351a..18b4e01a 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -8,9 +8,9 @@
 //! commands for the X server to carry out. Some requests generate replies
 //! that are sent back to the client.
 
-use crate::{Window};
+use crate::Window;
 use bytes::BufMut;
-use xrbk::{Buf};
+use xrbk::Buf;
 
 use crate::mask::AttributeMask;
 

From 71600c8514606481be8c9a9e2eb4c58b97855247 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 16:55:39 +0000
Subject: [PATCH 004/157] =?UTF-8?q?=F0=9F=91=80=20CreateWindow=20request?=
 =?UTF-8?q?=20with=20docs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/common/wrapper.rs |  20 ++++++
 src/x11.rs            |   2 +-
 src/x11/request.rs    | 160 +++++++++++++++++++++++++++++++++++++-----
 3 files changed, 162 insertions(+), 20 deletions(-)

diff --git a/src/common/wrapper.rs b/src/common/wrapper.rs
index 69002f29..7d5cf674 100644
--- a/src/common/wrapper.rs
+++ b/src/common/wrapper.rs
@@ -167,6 +167,26 @@ impl_writable!(CopyableFromParent<Colormap>: &self, buf {
 		Self::Other(val) => val.write_to(buf)?,
 	}
 
+	Ok(())
+});
+
+impl_constant_x11_size!(CopyableFromParent<u8> {
+	u8::X11_SIZE
+});
+
+impl_readable!(CopyableFromParent<u8>: buf {
+	Ok(match buf.get_u8() {
+		discrim if discrim == 0 => Self::CopyFromParent,
+		val => Self::Other(val),
+	})
+});
+
+impl_writable!(CopyableFromParent<u8>: &self, buf {
+	match self {
+		Self::CopyFromParent => buf.put_u32(0),
+		Self::Other(val) => val.write_to(buf)?,
+	}
+	
 	Ok(())
 }); // }}}
 
diff --git a/src/x11.rs b/src/x11.rs
index b74db23d..d0b422c9 100644
--- a/src/x11.rs
+++ b/src/x11.rs
@@ -13,4 +13,4 @@
 pub mod error;
 pub mod event;
 // pub mod reply;
-// pub mod request;
+pub mod request;
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 18b4e01a..3e227abc 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -2,36 +2,158 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-//! Requests: commands to the X server.
+//! [Requests] defined in the [core X11 protocol].
 //!
-//! Requests are messages sent _from_ the client _to_ the X server. They are
-//! commands for the X server to carry out. Some requests generate replies
-//! that are sent back to the client.
-
-use crate::Window;
-use bytes::BufMut;
-use xrbk::Buf;
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: super
 
-use crate::mask::AttributeMask;
+use crate::{unit::Px, visual::VisualId, CopyableFromParent, Rectangle, Window, WindowClass};
 
+use crate::{set::Attributes, x11::error};
 use xrbk_macro::derive_xrb;
+
 extern crate self as xrb;
 
+/// An error generated because of a failed [`CreateWindow` request].
+///
+/// [`CreateWindow` request]: CreateWindow
+pub enum CreateWindowError {
+	/// A [`Colormap` error].
+	///
+	/// [`Colormap` error]: error::Colormap
+	Colormap(error::Colormap),
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	CursorAppearance(error::CursorAppearance),
+	/// A [`ResourceIdChoice` error].
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	ResourceIdChoice(error::ResourceIdChoice),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Pixmap` error].
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	Pixmap(error::Pixmap),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
 derive_xrb! {
+	/// A [request] that creates a new unmapped [window] and assigns the
+	/// provided [`Window` ID][window] to it.
+	///
+	/// [request]: crate::message::Request
+	/// [window]: Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct CreateWindow: Request(1) {
+	pub struct CreateWindow: Request(1, CreateWindowError) {
 		#[metabyte]
-		pub depth: u8,
+		/// The [window]'s depth.
+		///
+		/// For a `class` of [`CopyFromParent`] or
+		/// <code>[Other]\([InputOutput])</code>, [`CopyFromParent`] for `depth`
+		/// means that the depth is copied from the `parent`.
+		///
+		/// # Errors
+		/// For a `class` of <code>[Other]\([InputOnly])</code>, however,
+		/// [`CopyFromParent`] is *required*, else a [`Match` error] is
+		/// generated, and _does not_ mean that the depth is copied from the
+		/// `parent`.
+		///
+		/// [window]: Window
+		///
+		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
+		/// [Other]: CopyableFromParent::Other
+		/// [InputOutput]: WindowClass::InputOutput
+		/// [InputOnly]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub depth: CopyableFromParent<u8>,
 
+		/// The [`Window` ID][window] which is to be assigned to the [window].
+		///
+		/// # Errors
+		/// If the provided [`Window` ID][window] is already used or it is not
+		/// allocated to this client, a [`ResourceIdChoice` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
 		pub window_id: Window,
+		/// The [window] which should be used as the new [window]'s parent.
+		///
+		/// # Errors
+		/// For a `class` of [`InputOutput`], the parent cannot be an
+		/// [`InputOnly`] [window], else a [`Match` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`InputOutput`]: WindowClass::InputOutput
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
 		pub parent: Window,
-		pub x: i16,
-		pub y: i16,
-		pub width: u16,
-		pub height: u16,
-		pub border_width: u16,
-		//pub class: Inheritable<WindowClass, u16>,
-		//pub visual: Inheritable<VisualId, u32>,
-		pub attribute_mask: AttributeMask,
+
+		/// The coordinates and dimensions of the [window].
+		///
+		/// The coordinates are of the top-left corner of the [window], and are
+		/// relative to the top-left corner of the [window]'s `parent`.
+		///
+		/// [window]: Window
+		pub geometry: Rectangle,
+		/// The width of the [window]'s border.
+		///
+		/// [window]: Window
+		pub border_width: Px<u16>,
+
+		/// The [window]'s [class].
+		///
+		/// [`CopyFromParent`] means the class is taken from the `parent`.
+		///
+		/// # Errors
+		/// For [`InputOutput`], the `visual` type and `depth` must be
+		/// combination supported by the [screen], else a [`Match` error] is
+		/// generated.
+		///
+		/// For [`InputOnly`], the `visual` must be one supported by the
+		/// [screen], else a [`Match` error] is generated.
+		///
+		/// [window]: Window
+		/// [class]: WindowClass
+		/// [screen]: crate::visual::Screen
+		///
+		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
+		/// [`InputOutput`]: WindowClass::InputOutput
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub class: CopyableFromParent<WindowClass>,
+		/// The visual used by the [window].
+		///
+		/// See [`VisualType`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`VisualType`]: crate::visual::VisualType
+		pub visual: CopyableFromParent<VisualId>,
+
+		/// Additional [attributes] configured for the [window].
+		///
+		/// See [`Attributes`] for more information.
+		///
+		/// [window]: Window
+		/// [attributes]: Attributes
+		pub attributes: Attributes,
 	}
 }

From 6d195522414c5c732ec5bc900ec70ab02121460c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 22 Jan 2023 17:27:56 +0000
Subject: [PATCH 005/157] [CI685] formatted code with rustfmt

---
 src/common/wrapper.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/common/wrapper.rs b/src/common/wrapper.rs
index 7d5cf674..cbbabfe1 100644
--- a/src/common/wrapper.rs
+++ b/src/common/wrapper.rs
@@ -186,7 +186,7 @@ impl_writable!(CopyableFromParent<u8>: &self, buf {
 		Self::CopyFromParent => buf.put_u32(0),
 		Self::Other(val) => val.write_to(buf)?,
 	}
-	
+
 	Ok(())
 }); // }}}
 

From 5b7da46fd58de338ef363ac4ea2bd3e56397e2e9 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 17:38:32 +0000
Subject: [PATCH 006/157] ChangeWindowAttributes request with docs

---
 src/x11/request.rs | 64 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 3e227abc..8a07c842 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -157,3 +157,67 @@ derive_xrb! {
 		pub attributes: Attributes,
 	}
 }
+
+/// An error generated because of a failed [`ChangeWindowAttributes` request].
+///
+/// [`ChangeWindowAttributes` request]: ChangeWindowAttributes
+pub enum ChangeWindowAttributesError {
+	/// An [`Access` error].
+	///
+	/// [`Access` error]: error::Access
+	Access(error::Access),
+	/// A [`Colormap` error].
+	///
+	/// [`Colormap` error]: error::Colormap
+	Colormap(error::Colormap),
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	CursorAppearance(error::CursorAppearance),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Pixmap` error].
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	Pixmap(error::Pixmap),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that configures the [attributes] of a [window].
+	///
+	/// The [`event_mask`] attribute on the [window] is not shared between
+	/// clients: one client modifying the [`event_mask`] only selects interest
+	/// in the relevant events for that client. There are three exceptions to
+	/// this: only one client at a time may select [`SUBSTRUCTURE_REDIRECT`],
+	/// [`RESIZE_REDIRECT`], or [`BUTTON_PRESS`] on the [window].
+	///
+	/// [request]: crate::message::Request
+	/// [window]: Window
+	/// [attributes]: Attributes
+	///
+	/// [`event_mask`]: Attributes::event_mask
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	/// [`RESIZE_REDIRECT`]: crate::EventMask::RESIZE_REDIRECT
+	/// [`BUTTON_PRESS`]: crate::EventMask::BUTTON_PRESS
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeWindowAttributes: Request(2) {
+		/// The [window] which the `attributes` are changed on.
+		///
+		/// [window]: Window
+		pub window: Window,
+		/// The [attributes] which are changed.
+		///
+		/// [attributes]: Attributes
+		pub attributes: Attributes,
+	}
+}

From 62ebeb4b1cea149852e599ad355bca32045e86b4 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 19:04:07 +0000
Subject: [PATCH 007/157] GetWindowAttributes request + reply with docs

---
 src/x11.rs                                    |   2 +-
 src/x11/reply.rs                              | 215 ++++++++++++++++++
 src/x11/request.rs                            |  28 ++-
 .../src/definition/expansion/message_trait.rs |   2 +-
 .../src/definition/expansion/x11_size.rs      |   5 +
 5 files changed, 248 insertions(+), 4 deletions(-)
 create mode 100644 src/x11/reply.rs

diff --git a/src/x11.rs b/src/x11.rs
index d0b422c9..55dad0ee 100644
--- a/src/x11.rs
+++ b/src/x11.rs
@@ -12,5 +12,5 @@
 
 pub mod error;
 pub mod event;
-// pub mod reply;
+pub mod reply;
 pub mod request;
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
new file mode 100644
index 00000000..fae4d3e3
--- /dev/null
+++ b/src/x11/reply.rs
@@ -0,0 +1,215 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: super
+
+use super::request;
+use crate::{
+	visual::{Color, VisualId},
+	BitGravity,
+	Colormap,
+	DeviceEventMask,
+	EventMask,
+	MaintainContents,
+	WindowClass,
+	WindowGravity,
+};
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+extern crate self as xrb;
+
+/// The state of the [window] regarding how it is mapped.
+///
+/// [window]: crate::Window
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum MapState {
+	/// The [window] is not mapped.
+	///
+	/// [window]: crate::Window
+	Unmapped,
+
+	/// The [window] is mapped but one of its ancestors is unmapped.
+	///
+	/// [window]: crate::Window
+	Unviewable,
+
+	/// The [window] is mapped and all of its ancestors are mapped.
+	///
+	/// [window]: crate::Window
+	Viewable,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`GetWindowAttributes` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetWindowAttributes: Reply for request::GetWindowAttributes {
+		#[sequence]
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		pub sequence: u16,
+
+		#[metabyte]
+		/// The conditions under which the X server should maintain the obscured
+		/// [regions] of the [window].
+		///
+		/// See [`Attributes::maintain_contents`] for more information.
+		///
+		/// [regions]: crate::Region
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
+		pub maintain_contents: MaintainContents,
+
+		/// The visual used by the [window].
+		///
+		/// See [`VisualType`] for more information.
+		///
+		/// [window]: crate::Window
+		///
+		/// [`VisualType`]: crate::visual::VisualType
+		pub visual: VisualId,
+		/// The [window]'s [class].
+		///
+		/// [window]: crate::Window
+		/// [class]: WindowClass
+		pub class: WindowClass,
+
+		/// Defines the [region] of the [window] which is retained when the
+		/// [window] is resized.
+		///
+		/// See [`Attributes::bit_gravity`] for more information.
+		///
+		/// [region]: crate::Region
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::bit_gravity`]: crate::set::Attributes::bit_gravity
+		pub bit_gravity: BitGravity,
+		/// Defines how the [window] is repositioned if its parent is resized.
+		///
+		/// See [`Attributes::window_gravity`] for more information.
+		///
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::window_gravity`]: crate::set::Attributes::window_gravity
+		pub window_graivty: WindowGravity,
+
+		/// Defines which bit planes of the [window] hold dynamic data which is
+		/// maintained for `maintain_contents` and `maintain_windows_under`.
+		///
+		/// See [`Attributes::maintained_planes`] for more information.
+		///
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::maintained_planes`]: crate::set::Attributes::maintained_planes
+		pub maintained_planes: u32,
+		/// Defines the [color] used for bit planes which are not preserved for
+		/// `maintain_contents` and `maintain_windows_under` (see
+		/// `maintained_planes`).
+		///
+		/// See [`Attributes::maintenance_fallback_color`] for more information.
+		///
+		/// [color]: Color
+		///
+		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
+		pub maintenance_fallback_color: Color,
+		/// Whether the X server should maintain the contents of [windows] under
+		/// this [window].
+		///
+		/// See [`Attributes::maintain_windows_under`] for more information.
+		///
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::maintain_windows_under`]: crate::set::Attributes::maintain_windows_under
+		pub maintain_windows_under: bool,
+
+		// TODO
+		pub map_installed: bool,
+		/// The [window]'s [map state].
+		///
+		/// See [`MapState`] for more information.
+		///
+		/// [window]: crate::Window
+		/// [map state]: MapState
+		pub map_state: MapState,
+
+		/// Whether [`MapWindow`] and [`ConfigureWindow`] requests on the
+		/// [window] override a [`SUBSTRUCTURE_REDIRECT`] selection on its
+		/// parent.
+		///
+		/// This is typically used to inform a window manager not to tamper with
+		/// the [window].
+		///
+		/// See [`Attributes::override_redirect`] for more information.
+		///
+		/// [window]: crate::Window
+		///
+		/// [`MapWindow`]: request::MapWindow
+		/// [`ConfigureWindow`]: request::ConfigureWindow
+		///
+		/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
+		///
+		/// [`Attributes::override_redirect`]: crate::set::Attributes::override_redirect
+		pub override_redirect: bool,
+
+		/// The [colormap] which best reflects the true colors of the [window].
+		///
+		/// See [`Attributes::colormap`] for more information.
+		///
+		/// [window]: crate::Window
+		/// [colormap]: Colormap
+		///
+		/// [`Attributes::colormap`]: crate::set::Attributes::colormap
+		pub colormap: Option<Colormap>,
+
+		/// All of the [events] selected by all clients on the [window].
+		///
+		/// This is the bitwise OR of every client's [`event_mask`] on the
+		/// [window].
+		///
+		/// [window]: crate::Window
+		/// [events]: crate::message::Event
+		///
+		/// [`event_mask`]: crate::set::Attributes::event_mask
+		pub all_event_masks: EventMask,
+		/// The [events] selected by you on the [window].
+		///
+		/// This is your [`event_mask`] on the [window].
+		///
+		/// [window]: crate::Window
+		/// [events]: crate::message::Event
+		///
+		/// [`event_mask`]: crate::set::Attributes::event_mask
+		pub your_event_mask: EventMask,
+		/// Defines the [events][event] which should not be propagated to
+		/// ancestors of the [window] if no client has selected the [event] on
+		/// the [window].
+		///
+		/// See [`Attributes::do_not_propagate_mask`] for more information.
+		///
+		/// [event]: crate::message::Event
+		/// [window]: crate::Window
+		///
+		/// [`Attributes::do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
+		pub do_not_propagate_mask: DeviceEventMask,
+		[_; ..],
+	}
+}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 8a07c842..f2bb2259 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -9,9 +9,18 @@
 //! [Requests]: crate::message::Request
 //! [core X11 protocol]: super
 
-use crate::{unit::Px, visual::VisualId, CopyableFromParent, Rectangle, Window, WindowClass};
+use crate::{
+	set::Attributes,
+	unit::Px,
+	visual::VisualId,
+	x11::error,
+	CopyableFromParent,
+	Rectangle,
+	Window,
+	WindowClass,
+};
 
-use crate::{set::Attributes, x11::error};
+use crate::x11::reply;
 use xrbk_macro::derive_xrb;
 
 extern crate self as xrb;
@@ -220,4 +229,19 @@ derive_xrb! {
 		/// [attributes]: Attributes
 		pub attributes: Attributes,
 	}
+
+	/// A [request] that returns the current [attributes] of the [window].
+	///
+	/// [request]: crate::message::Request
+	/// [attributes]: Attributes
+	/// [window]: Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetWindowAttributes: Request(3, error::Window) -> reply::GetWindowAttributes {
+		/// The [window] for which this [request] gets the [attributes].
+		///
+		/// [request]: crate::message::Request
+		/// [attributes]: Attributes
+		/// [window]: Window
+		pub window: Window,
+	}
 }
diff --git a/xrbk_macro/src/definition/expansion/message_trait.rs b/xrbk_macro/src/definition/expansion/message_trait.rs
index a5b95926..06c9e4b8 100644
--- a/xrbk_macro/src/definition/expansion/message_trait.rs
+++ b/xrbk_macro/src/definition/expansion/message_trait.rs
@@ -85,7 +85,7 @@ impl Reply {
 
 					#[allow(clippy::cast_possible_truncation)]
 					fn length(&self) -> u32 {
-						((<Self as ::xrbk::X11Size>::x11_size(&self) / 4) - 8) as u32
+						((<Self as ::xrbk::X11Size>::x11_size(self) / 4) - 8) as u32
 					}
 
 					fn sequence(&self) -> u16 {
diff --git a/xrbk_macro/src/definition/expansion/x11_size.rs b/xrbk_macro/src/definition/expansion/x11_size.rs
index 24f6aa54..6dfb1317 100644
--- a/xrbk_macro/src/definition/expansion/x11_size.rs
+++ b/xrbk_macro/src/definition/expansion/x11_size.rs
@@ -34,6 +34,7 @@ impl Struct {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn x11_size(&self) -> usize {
 					let mut size: usize = 0;
@@ -78,6 +79,7 @@ impl Request {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn x11_size(&self) -> usize {
 					// The size starts at `4` to account for the size
@@ -124,6 +126,7 @@ impl Reply {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn x11_size(&self) -> usize {
 					// The size starts at `8` to account for the size
@@ -176,6 +179,7 @@ impl Event {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn x11_size(&self) -> usize {
 					// The size starts at either `4` or `1`, depending
@@ -224,6 +228,7 @@ impl Error {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn x11_size(&self) -> usize {
 					// At least 11 bytes including all the required fields.

From 1abece3c38acacab15dbbc097379b2983d4627cb Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 19:58:59 +0000
Subject: [PATCH 008/157] DestroyWindow, DestroyChildren, ChangeSavedWindows
 requests

---
 src/common/set/graphics_options.rs |  76 ++++++++-------
 src/x11/request.rs                 | 148 ++++++++++++++++++++++++++++-
 2 files changed, 185 insertions(+), 39 deletions(-)

diff --git a/src/common/set/graphics_options.rs b/src/common/set/graphics_options.rs
index ae8ec2e9..cfb549ef 100644
--- a/src/common/set/graphics_options.rs
+++ b/src/common/set/graphics_options.rs
@@ -237,7 +237,7 @@ pub enum FillRule {
 ///
 /// [window]: crate::Window
 #[derive(Copy, Clone, Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum SubwindowMode {
+pub enum ChildMode {
 	/// Both source and destination [windows] are additionally clipped by all
 	/// viewable [`InputOutput`] children.
 	///
@@ -297,7 +297,7 @@ pub type ClipMask = Option<Pixmap>;
 /// |[`tile_stipple_x`]       |`0`                                          |
 /// |[`tile_stipple_y`]       |`0`                                          |
 /// |[`font`]                 |Depends on the server                        |
-/// |[`subwindow_mode`]       |[`SubwindowMode::ClipByChildren`]            |
+/// |[`child_mode`]           |[`ChildMode::ClipByChildren`]                |
 /// |[`graphics_exposure`]    |`true`                                       |
 /// |[`clip_x`]               |`0`                                          |
 /// |[`clip_y`]               |`0`                                          |
@@ -323,7 +323,7 @@ pub type ClipMask = Option<Pixmap>;
 /// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
 /// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
 /// [`font`]: GraphicsOptions::font
-/// [`subwindow_mode`]: GraphicsOptions::subwindow_mode
+/// [`child_mode`]: GraphicsOptions::child_mode
 /// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
 /// [`clip_x`]: GraphicsOptions::clip_x
 /// [`clip_y`]: GraphicsOptions::clip_y
@@ -358,7 +358,7 @@ pub struct GraphicsOptions {
 
 	font: Option<Font>,
 
-	subwindow_mode: Option<__SubwindowMode>,
+	child_mode: Option<__ChildMode>,
 
 	graphics_exposures: Option<__bool>,
 
@@ -418,7 +418,7 @@ pub struct GraphicsOptionsBuilder {
 
 	font: Option<Font>,
 
-	subwindow_mode: Option<SubwindowMode>,
+	child_mode: Option<ChildMode>,
 
 	graphics_exposures: Option<bool>,
 
@@ -470,7 +470,7 @@ impl GraphicsOptionsBuilder {
 
 			font: None,
 
-			subwindow_mode: None,
+			child_mode: None,
 
 			graphics_exposures: None,
 
@@ -519,7 +519,7 @@ impl GraphicsOptionsBuilder {
 
 			font: self.font,
 
-			subwindow_mode: self.subwindow_mode.map(__SubwindowMode),
+			child_mode: self.child_mode.map(__ChildMode),
 
 			graphics_exposures: self.graphics_exposures.map(__bool),
 
@@ -776,16 +776,16 @@ impl GraphicsOptionsBuilder {
 	/// Configures whether descendent [windows] are included or masked out when
 	/// considering graphics operations.
 	///
-	/// See [`GraphicsOptions::subwindow_mode`] for more information.
+	/// See [`GraphicsOptions::child_mode`] for more information.
 	///
 	/// [windows]: crate::Window
-	pub fn subwindow_mode(&mut self, subwindow_mode: SubwindowMode) -> &mut Self {
-		if self.subwindow_mode.is_none() {
+	pub fn child_mode(&mut self, child_mode: ChildMode) -> &mut Self {
+		if self.child_mode.is_none() {
 			self.x11_size += 4;
 		}
 
-		self.subwindow_mode = Some(subwindow_mode);
-		self.mask |= GraphicsOptionsMask::SUBWINDOW_MODE;
+		self.child_mode = Some(child_mode);
+		self.mask |= GraphicsOptionsMask::CHILD_MODE;
 
 		self
 	}
@@ -1045,14 +1045,14 @@ impl GraphicsOptions {
 	/// Whether descendent [windows] are included or masked out when applying
 	/// graphics operations.
 	///
-	/// See [`SubwindowMode`] for more information.
+	/// See [`ChildMode`] for more information.
 	///
 	/// [windows]: crate::Window
 	#[must_use]
-	pub fn subwindow_mode(&self) -> Option<&SubwindowMode> {
-		self.subwindow_mode
+	pub fn child_mode(&self) -> Option<&ChildMode> {
+		self.child_mode
 			.as_ref()
-			.map(|__SubwindowMode(subwindow_mode)| subwindow_mode)
+			.map(|__ChildMode(child_mode)| child_mode)
 	}
 
 	/// Whether [`GraphicsExposure` events] are generated.
@@ -1255,14 +1255,14 @@ bitflags! {
 		/// [`GraphicsContext`]: crate::GraphicsContext
 		const FONT = 0x0000_4000;
 
-		/// Whether the [descendent windows being clipped when applying graphics options][subwindow]
+		/// Whether the[descendent windows being clipped when applying graphics options][child]
 		/// is configured in a [`GraphicsContext`].
 		///
-		/// See [`GraphicsOptions::subwindow_mode`] for more information.
+		/// See [`GraphicsOptions::child_mode`] for more information.
 		///
-		/// [subwindow]: GraphicsOptions::subwindow_mode
+		/// [child]: GraphicsOptions::child_mode
 		/// [`GraphicsContext`]: crate::GraphicsContext
-		const SUBWINDOW_MODE = 0x0000_8000;
+		const CHILD_MODE = 0x0000_8000;
 
 		/// Whether [`GraphicsExposure` events] are configured in a [`GraphicsContext`].
 		///
@@ -1417,10 +1417,10 @@ impl Readable for GraphicsOptions {
 		let font =
 			super::read_set_value(buf, &mut x11_size, mask.contains(GraphicsOptionsMask::FONT))?;
 
-		let subwindow_mode = super::read_set_value(
+		let child_mode = super::read_set_value(
 			buf,
 			&mut x11_size,
-			mask.contains(GraphicsOptionsMask::SUBWINDOW_MODE),
+			mask.contains(GraphicsOptionsMask::CHILD_MODE),
 		)?;
 
 		let graphics_exposures = super::read_set_value(
@@ -1490,7 +1490,7 @@ impl Readable for GraphicsOptions {
 
 			font,
 
-			subwindow_mode,
+			child_mode,
 
 			graphics_exposures,
 
@@ -1563,8 +1563,8 @@ impl Writable for GraphicsOptions {
 			font.write_to(buf)?;
 		}
 
-		if let Some(subwindow_mode) = &self.subwindow_mode {
-			subwindow_mode.write_to(buf)?;
+		if let Some(child_mode) = &self.child_mode {
+			child_mode.write_to(buf)?;
 		}
 
 		if let Some(graphics_exposures) = &self.graphics_exposures {
@@ -1688,6 +1688,10 @@ impl X11Size for __LineWidth {
 }
 
 impl Readable for __LineWidth {
+	#[allow(
+		clippy::cast_possible_truncation,
+		reason = "truncation is intended behavior"
+	)]
 	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
 	where
 		Self: Sized,
@@ -1925,39 +1929,39 @@ impl Writable for __FillRule {
 }
 
 #[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
-struct __SubwindowMode(SubwindowMode);
+struct __ChildMode(ChildMode);
 
-impl ConstantX11Size for __SubwindowMode {
+impl ConstantX11Size for __ChildMode {
 	const X11_SIZE: usize = 4;
 }
 
-impl X11Size for __SubwindowMode {
+impl X11Size for __ChildMode {
 	fn x11_size(&self) -> usize {
 		Self::X11_SIZE
 	}
 }
 
-impl Readable for __SubwindowMode {
+impl Readable for __ChildMode {
 	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
 	where
 		Self: Sized,
 	{
 		Ok(Self(match buf.get_u32() {
-			discrim if discrim == 0 => SubwindowMode::ClipByChildren,
-			discrim if discrim == 1 => SubwindowMode::IncludeDescendents,
+			discrim if discrim == 0 => ChildMode::ClipByChildren,
+			discrim if discrim == 1 => ChildMode::IncludeDescendents,
 
 			other_discrim => return Err(UnrecognizedDiscriminant(other_discrim as usize)),
 		}))
 	}
 }
 
-impl Writable for __SubwindowMode {
+impl Writable for __ChildMode {
 	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		let Self(subwindow_mode) = self;
+		let Self(child_mode) = self;
 
-		match subwindow_mode {
-			SubwindowMode::ClipByChildren => buf.put_u32(0),
-			SubwindowMode::IncludeDescendents => buf.put_u32(1),
+		match child_mode {
+			ChildMode::ClipByChildren => buf.put_u32(0),
+			ChildMode::IncludeDescendents => buf.put_u32(1),
 		}
 
 		Ok(())
diff --git a/src/x11/request.rs b/src/x11/request.rs
index f2bb2259..4222ba5c 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -21,7 +21,7 @@ use crate::{
 };
 
 use crate::x11::reply;
-use xrbk_macro::derive_xrb;
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 extern crate self as xrb;
 
@@ -219,11 +219,12 @@ derive_xrb! {
 	/// [`RESIZE_REDIRECT`]: crate::EventMask::RESIZE_REDIRECT
 	/// [`BUTTON_PRESS`]: crate::EventMask::BUTTON_PRESS
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ChangeWindowAttributes: Request(2) {
+	pub struct ChangeWindowAttributes: Request(2, ChangeWindowAttributesError) {
 		/// The [window] which the `attributes` are changed on.
 		///
 		/// [window]: Window
-		pub window: Window,
+		pub target: Window,
+
 		/// The [attributes] which are changed.
 		///
 		/// [attributes]: Attributes
@@ -242,6 +243,147 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		/// [attributes]: Attributes
 		/// [window]: Window
+		pub target: Window,
+	}
+
+	/// A [request] that destroys the given [window] and all its descendents.
+	///
+	/// If the `target` [window] is mapped, an [`UnmapWindow` request] is
+	/// automatically performed.
+	///
+	/// The ordering of [`Destroy` events][event] is such that a
+	/// [`Destroy` event][event] is generated on every descendent of the target
+	/// [window] before being generated on the [window] itself.
+	///
+	/// This [request] has no effect on root [windows][window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [event]: super::event::Destroy
+	///
+	/// [`UnmapWindow` request]: UnmapWindow
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DestroyWindow: Request(4, error::Window) {
+		/// The [window] which is the target of the `DestroyWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
+
+	/// A [request] that destroys every child of the given [window] in
+	/// bottom-to-top stacking order.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DestroyChildren: Request(5, error::Window) {
+		/// The [window] which will have its children destroyed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
+}
+
+/// An error generated because of a failed [`ChangeSavedWindows` request].
+///
+/// [`ChangeSavedWindows` request]: ChangeSavedWindows
+pub enum ChangeSavedWindowsError {
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+/// Whether something is added or removed.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ChangeMode {
+	/// The change is achieved by adding the thing.
+	Add,
+	/// The change is achieved by removing the thing.
+	Remove,
+}
+
+derive_xrb! {
+	/// A [request] that [adds] or [removes] the specified [window] from the
+	/// set of [windows][window] which you have chosen to save.
+	///
+	/// When a client's resources are destroyed, each of the client's saved
+	/// [windows] which are descendents of [windows] created by the client is
+	/// [reparented] to the closest ancestor which is not created by the client.
+	///
+	/// # Errors
+	/// The given `window` must not be a [window] created by you, else a
+	/// [`Match` error] is generated.
+	///
+	/// A [`Window` error] is generated if the `window` does not refer to a
+	/// defined [window].
+	///
+	/// A [`Value` error] is generated if the `change_mode` is encoded
+	/// incorrectly. It is a bug in X Rust Bindings if that happens.
+	///
+	/// [window]: Window
+	/// [windows]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [adds]: ChangeMode::Add
+	/// [removes]: ChangeMode::Remove
+	///
+	/// [reparented]: ReparentWindow
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeSavedWindows: Request(6, ChangeSavedWindowsError) {
+		#[metabyte]
+		/// Whether the `window` is added to or removed from your saved
+		/// [windows].
+		///
+		/// [windows]: Window
+		pub change_mode: ChangeMode,
+
+		/// The [window] which is added to or removed from your saved
+		/// [windows][window].
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if you created this [window].
+		///
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Match` error]: error::Match
+		/// [`Window` error]: error::Window
 		pub window: Window,
 	}
 }

From 54fda0f33ca9f55df4e29aa362dd309a553ae9f8 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 20:15:24 +0000
Subject: [PATCH 009/157] ReparentWindow request

---
 src/x11/request.rs | 84 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 4222ba5c..f7f095b0 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -15,6 +15,7 @@ use crate::{
 	visual::VisualId,
 	x11::error,
 	CopyableFromParent,
+	Point,
 	Rectangle,
 	Window,
 	WindowClass,
@@ -387,3 +388,86 @@ derive_xrb! {
 		pub window: Window,
 	}
 }
+
+/// An error generated because of a failed [`ReparentWindow` request].
+///
+/// [`ReparentWindow` request]: ReparentWindow
+pub enum ReparentWindowError {
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that changes a [window]'s parent to a different one.
+	///
+	/// If the [window] is mapped, an [`UnmapWindow` request] is first
+	/// automatically performed. The [window] is then removed from its current
+	/// parent and inserted as a child of the `new_parent`. If the [window] was
+	/// mapped originally, then a [`MapWindow` request] is then automatically
+	/// performed to map it again.
+	///
+	/// # Errors
+	/// A [`Match` error] is generated if the `new_parent` is not on the same
+	/// [screen] as the old parent.
+	///
+	/// A [`Match` error] is generated if the `new_parent` is the `target`
+	/// [window] itself, or a descendent of the `target` [window].
+	///
+	/// A [`Match` error] is generated if the `new_parent` is [`InputOnly`] but
+	/// the `target` [window] is not.
+	///
+	/// A [`Match` error] is generated if the `target` [window] has a
+	/// [`ParentRelative`] [`background_pixmap`] and the `new_parent` does not
+	/// have the same depth as the `target` [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	/// [screen]: crate::visual::Screen
+	///
+	/// [`UnmapWindow` request]: UnmapWindow
+	/// [`MapWindow` request]: MapWindow
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	/// [`ParentRelative`]: crate::ParentRelatable::ParentRelative
+	///
+	/// [`background_pixmap`]: Attributes::background_pixmap
+	///
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ReparentWindow: Request(7, ReparentWindowError) {
+		/// The [window] which will be transferred to be a child of the
+		/// `new_parent`.
+		///
+		/// [window]: Window
+		pub target: Window,
+		/// The `target`'s new parent [window].
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if this [window] is not on the same
+		/// [screen] as the `target` [window].
+		///
+		/// A [`Match` error] is generated if this [window] is the same [window]
+		/// as the `target`, or is a descendent of the `target` [window].
+		///
+		/// A [`Match` error] is generated if this [window] is [`InputOnly`] but
+		/// the `target` [window] is not.
+		///
+		/// [window]: Window
+		/// [screen]: crate::visual::Screen
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub new_parent: Window,
+
+		/// The `target`'s new coordinates relative to its `new_parent`'s
+		/// top-left corner.
+		pub coords: Point,
+	}
+}

From 845fc0d89240a841dba855731a8669e7314aaaf0 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 20:26:32 +0000
Subject: [PATCH 010/157] MapWindow request

---
 src/x11/event.rs   |  2 +-
 src/x11/request.rs | 54 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index d4e33159..de2cd9cd 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -1569,7 +1569,7 @@ derive_xrb! {
 	/// [`MapWindow` request]: super::request::MapWindow
 	///
 	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
-	pub struct MapRequest: Event(20) {
+	pub struct MapWindowRequest: Event(20) {
 		#[sequence]
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
diff --git a/src/x11/request.rs b/src/x11/request.rs
index f7f095b0..484b4a12 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -413,6 +413,9 @@ derive_xrb! {
 	/// performed to map it again.
 	///
 	/// # Errors
+	/// A [`Window` error] is generated if either the `target` or the
+	/// `new_parent` do not refer to defined [windows][window].
+	///
 	/// A [`Match` error] is generated if the `new_parent` is not on the same
 	/// [screen] as the old parent.
 	///
@@ -439,16 +442,26 @@ derive_xrb! {
 	/// [`background_pixmap`]: Attributes::background_pixmap
 	///
 	/// [`Match` error]: error::Match
+	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ReparentWindow: Request(7, ReparentWindowError) {
 		/// The [window] which will be transferred to be a child of the
 		/// `new_parent`.
 		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
 		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
 		pub target: Window,
 		/// The `target`'s new parent [window].
 		///
 		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
 		/// A [`Match` error] is generated if this [window] is not on the same
 		/// [screen] as the `target` [window].
 		///
@@ -464,10 +477,51 @@ derive_xrb! {
 		/// [`InputOnly`]: WindowClass::InputOnly
 		///
 		/// [`Match` error]: error::Match
+		/// [`Window` error]: error::Window
 		pub new_parent: Window,
 
 		/// The `target`'s new coordinates relative to its `new_parent`'s
 		/// top-left corner.
 		pub coords: Point,
 	}
+
+	/// A [request] that maps the given [window].
+	///
+	/// If the [window]'s [`override_redirect` attribute] is `false` and some
+	/// other client has selected [`SUBSTRUCTURE_REDIRECT`] on its parent, then
+	/// a [`MapWindowRequest` event] is generated, but the [window] remains
+	/// unmapped. Otherwise, the [window] is mapped and a [`Map` event] is
+	/// generated.
+	///
+	/// If the [window] is already mapped, this [request] has no effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Map` event]: super::event::Map
+	/// [`MapWindowRequest` event]: super::event::MapWindowRequest
+	///
+	/// [`override_redirect` attribute]: Attributes::override_redirect
+	///
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct MapWindow: Request(8, error::Window) {
+		/// The [window] which the target of the `MapWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From a8e6cefb7fe721ce0789bbac4c6aed26d1940efe Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 20:31:03 +0000
Subject: [PATCH 011/157] MapChildren request

---
 src/x11/request.rs | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 484b4a12..68a0248d 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -284,7 +284,7 @@ derive_xrb! {
 		pub target: Window,
 	}
 
-	/// A [request] that destroys every child of the given [window] in
+	/// A [request] that [destroys] every child of the given [window] in
 	/// bottom-to-top stacking order.
 	///
 	/// # Errors
@@ -294,10 +294,12 @@ derive_xrb! {
 	/// [window]: Window
 	/// [request]: crate::message::Request
 	///
+	/// [destroys]: DestroyWindow
+	///
 	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct DestroyChildren: Request(5, error::Window) {
-		/// The [window] which will have its children destroyed.
+		/// The [window] which will have its children [destroyed].
 		///
 		/// # Errors
 		/// A [`Window` error] is generated if this does not refer to a defined
@@ -305,6 +307,8 @@ derive_xrb! {
 		///
 		/// [window]: Window
 		///
+		/// [destroyed]: DestroyWindow
+		///
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
@@ -524,4 +528,33 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that [maps] every unmapped child of the given [window] in
+	/// top-to-bottom stacking order.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [maps]: MapWindow
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct MapChildren: Request(9, error::Window) {
+		/// The [window] which will have its unmapped children [mapped].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [mapped]: MapWindow
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From d89cd8e37c665e0376f546fbfffe3f29746f4c89 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 20:35:42 +0000
Subject: [PATCH 012/157] UnmapWindow request

---
 src/x11/request.rs | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 68a0248d..7ea00cdd 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -516,7 +516,7 @@ derive_xrb! {
 	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct MapWindow: Request(8, error::Window) {
-		/// The [window] which the target of the `MapWindow` [request].
+		/// The [window] which is the target of the `MapWindow` [request].
 		///
 		/// # Errors
 		/// A [`Window` error] is generated if this does not refer to a defined
@@ -557,4 +557,36 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that unmaps the given [window].
+	///
+	/// If the [window] is currently mapped, the [window] is unmapped and an
+	/// [`Unmap` event] is generated.
+	///
+	/// If the [window] is already unmapped, this [request] has no effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Unmap` event]: super::event::Unmap
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UnmapWindow: Request(10, error::Window) {
+		/// The [window] which is the target of the `UnmapWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From 783816bc43471c1f5be246db54d523736bbe465b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 20:41:55 +0000
Subject: [PATCH 013/157] UnmapChildren request

---
 src/x11/request.rs | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 7ea00cdd..7ac41112 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -287,6 +287,8 @@ derive_xrb! {
 	/// A [request] that [destroys] every child of the given [window] in
 	/// bottom-to-top stacking order.
 	///
+	/// A [`DestroyWindow` request][destroys] is performed on each child.
+	///
 	/// # Errors
 	/// A [`Window` error] is generated if the `target` does not refer to a
 	/// defined [window].
@@ -532,6 +534,8 @@ derive_xrb! {
 	/// A [request] that [maps] every unmapped child of the given [window] in
 	/// top-to-bottom stacking order.
 	///
+	/// A [`MapWindow` request][maps] is performed on each unmapped child.
+	///
 	/// # Errors
 	/// A [`Window` error] is generated if the `target` does not refer to a
 	/// defined [window].
@@ -541,6 +545,7 @@ derive_xrb! {
 	///
 	/// [maps]: MapWindow
 	///
+	///
 	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct MapChildren: Request(9, error::Window) {
@@ -589,4 +594,35 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that [unmaps] every mapped child of the
+	/// given [window] in bottom-to-top stacking order.
+	///
+	/// An [`UnmapWindow` request][unmaps] is performed on each mapped child.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [unmaps]: UnmapWindow
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UnmapChildren: Request(11, error::Window) {
+		/// The [window] which will have its mapped children [unmapped].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [unmapped]: UnmapWindow
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From 8a79fdfba37ef5863c2db7140065c9aaa1195807 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 21:01:56 +0000
Subject: [PATCH 014/157] ConfigureWindow request

---
 src/x11/reply.rs   |   2 +-
 src/x11/request.rs | 122 +++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 118 insertions(+), 6 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index fae4d3e3..0b89c0cb 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -53,7 +53,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, X11Size, Readable, Writable)]
 	pub struct GetWindowAttributes: Reply for request::GetWindowAttributes {
 		#[sequence]
 		/// The sequence number identifying the [request] that generated this
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 7ac41112..0e2ac3c6 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -21,12 +21,14 @@ use crate::{
 	WindowClass,
 };
 
-use crate::x11::reply;
+use crate::{set::WindowConfig, x11::reply};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 extern crate self as xrb;
 
-/// An error generated because of a failed [`CreateWindow` request].
+/// An [error] generated because of a failed [`CreateWindow` request].
+///
+/// [error]: crate::message::Error
 ///
 /// [`CreateWindow` request]: CreateWindow
 pub enum CreateWindowError {
@@ -168,7 +170,9 @@ derive_xrb! {
 	}
 }
 
-/// An error generated because of a failed [`ChangeWindowAttributes` request].
+/// An [error] generated because of a failed [`ChangeWindowAttributes` request].
+///
+/// [error]: crate::message::Error
 ///
 /// [`ChangeWindowAttributes` request]: ChangeWindowAttributes
 pub enum ChangeWindowAttributesError {
@@ -316,7 +320,9 @@ derive_xrb! {
 	}
 }
 
-/// An error generated because of a failed [`ChangeSavedWindows` request].
+/// An [error] generated because of a failed [`ChangeSavedWindows` request].
+///
+/// [error]: crate::message::Error
 ///
 /// [`ChangeSavedWindows` request]: ChangeSavedWindows
 pub enum ChangeSavedWindowsError {
@@ -395,7 +401,9 @@ derive_xrb! {
 	}
 }
 
-/// An error generated because of a failed [`ReparentWindow` request].
+/// An [error] generated because of a failed [`ReparentWindow` request].
+///
+/// [error]: crate::message::Error
 ///
 /// [`ReparentWindow` request]: ReparentWindow
 pub enum ReparentWindowError {
@@ -626,3 +634,107 @@ derive_xrb! {
 		pub target: Window,
 	}
 }
+
+/// An [error] generated because of a failed [`ConfigureWindow` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`ConfigureWindow` request]: ConfigureWindow
+pub enum ConfigureWindowError {
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that [configures] a [window].
+	///
+	/// See [`WindowConfig`] for more information.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// A [`Match` error] is generated if either the [`width`] or [`height`] is
+	/// configured to be zero.
+	///
+	/// A [`Match` error] is generated if the [`border_width`] is configured to
+	/// be anything other than zero if the `target` [window] is [`InputOnly`].
+	///
+	/// A [`Match` error] is generated if [`sibling`] is configured without a
+	/// specified [`stack_mode`].
+	///
+	/// A [`Match` error] is generated if [`sibling`] is specified but that
+	/// specified [window] is not actually a sibling of the `target` [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [configures]: WindowConfig
+	///
+	/// [`width`]: WindowConfig::width
+	/// [`height`]: WindowConfig::height
+	/// [`border_width`]: WindowConfig::border_width
+	/// [`sibling`]: WindowConfig::sibling
+	/// [`stack_mode`]: WindowConfig::stack_mode
+	///
+	/// [`Window` error]: error::Window
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ConfigureWindow: Request(12, ConfigureWindowError) {
+		/// The [window] which is the target of the `ConfigureWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The changes to the `target` [window]'s [configuration].
+		///
+		/// See [`WindowConfig`] for more information.
+		///
+		/// If the `target` [window] is a root [window], this [request] has no
+		/// effect.
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if either the [`width`] or the
+		/// [`height`] is zero.
+		///
+		/// A [`Match` error] is generated if the [`border_width`] is set to
+		/// zero if the `target` [window] is [`InputOnly`].
+		///
+		/// A [`Match` error] is generated if [`sibling`] is configured without
+		/// a specified [`stack_mode`].
+		///
+		/// A [`Match` error] is generated if [`sibling`] is specified but that
+		/// specified [window] is not actually a sibling of the `target`
+		/// [window].
+		///
+		/// [configuration]: WindowConfig
+		///
+		/// [`width`]: WindowConfig::width
+		/// [`height`]: WindowConfig::height
+		/// [`border_width`]: WindowConfig::border_width
+		/// [`sibling`]: WindowConfig::sibling
+		/// [`stack_mode`]: WindowConfig::stack_mode
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub config: WindowConfig,
+	}
+}

From fc20fe431cb87a85fd2de2b34da4ed321cf98363 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 21:30:32 +0000
Subject: [PATCH 015/157] CirculateWindow request

---
 src/x11/event.rs   |  6 ++--
 src/x11/request.rs | 81 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 3 deletions(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index de2cd9cd..07d07f83 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -1944,7 +1944,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
 	/// [`CirculateWindow` request]: super::request::CirculateWindow
-	pub struct CirculateRequest: Event(27) {
+	pub struct CirculateWindowRequest: Event(27) {
 		#[sequence]
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
@@ -1957,8 +1957,8 @@ derive_xrb! {
 		/// The parent of the `window` the [`CirculateWindow` request] applies
 		/// to.
 		///
-		/// This is the window that this `CirculateRequest` event was generated
-		/// on.
+		/// This is the window that this `CirculateWindowRequest` event was
+		/// generated on.
 		///
 		/// [`CirculateWindow` request]: super::request::CirculateWindow
 		pub parent: Window,
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 0e2ac3c6..af318f55 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -738,3 +738,84 @@ derive_xrb! {
 		pub config: WindowConfig,
 	}
 }
+
+/// An [error] generated because of a failed [`CirculateWindow` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`CirculateWindow` request]: CirculateWindow
+pub enum CirculateWindowError {
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+/// The direction with which a [window]'s mapped children are circulated in
+/// their stacking order.
+///
+/// This is used in the [`CirculateWindow` request].
+///
+/// [window]: Window
+///
+/// [`CirculateWindow` request]: CirculateWindow
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum CirculateDirection {
+	/// Raises the lowest mapped child that is occluded by another child, if
+	/// any, to the top of the stack.
+	RaiseLowest,
+
+	/// Lowers the highest mapped child that occludes another child, if any, to
+	/// the bottom of the stack.
+	LowerHighest,
+}
+
+derive_xrb! {
+	/// A [request] that [circulates] the mapped children of the given [window].
+	///
+	/// If some other client has selected [`SUBSTRUCTURE_REDIRECT`] on the
+	/// `target` [window], then a [`CirculateWindowRequest` event] is generated
+	/// and no further processing occurs. Otherwise, a [`Circulate` event] is
+	/// generated if one of the [window]'s children is actually restacked.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [circulates]: CirculateDirection
+	///
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	///
+	/// [`CirculateWindowRequest` event]: super::event::CirculateWindowRequest
+	/// [`Circulate` event]: super::event::Circulate
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CirculateWindow: Request(13, CirculateWindowError) {
+		#[metabyte]
+		/// Which of the [window]'s children might be circulated and in which
+		/// direction.
+		///
+		/// [window]: Window
+		pub direction: CirculateDirection,
+
+		/// The [window] which is the target of the `CirculateWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window error]: error::Window
+		pub target: Window,
+	}
+}

From ddfeb165e7b30318c5935d5ff34af99444b00dc1 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 21:44:58 +0000
Subject: [PATCH 016/157] GetGeometry request + reply

---
 src/x11/reply.rs   | 90 +++++++++++++++++++++++++++++++++++++---------
 src/x11/request.rs | 36 +++++++++++++++++++
 2 files changed, 109 insertions(+), 17 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 0b89c0cb..f647c186 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -19,31 +19,35 @@ use crate::{
 	DeviceEventMask,
 	EventMask,
 	MaintainContents,
+	Rectangle,
+	Window,
 	WindowClass,
 	WindowGravity,
 };
 
+use crate::unit::Px;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
 extern crate self as xrb;
 
 /// The state of the [window] regarding how it is mapped.
 ///
-/// [window]: crate::Window
+/// [window]: Window
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub enum MapState {
 	/// The [window] is not mapped.
 	///
-	/// [window]: crate::Window
+	/// [window]: Window
 	Unmapped,
 
 	/// The [window] is mapped but one of its ancestors is unmapped.
 	///
-	/// [window]: crate::Window
+	/// [window]: Window
 	Unviewable,
 
 	/// The [window] is mapped and all of its ancestors are mapped.
 	///
-	/// [window]: crate::Window
+	/// [window]: Window
 	Viewable,
 }
 
@@ -74,7 +78,7 @@ derive_xrb! {
 		/// See [`Attributes::maintain_contents`] for more information.
 		///
 		/// [regions]: crate::Region
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
 		pub maintain_contents: MaintainContents,
@@ -83,13 +87,13 @@ derive_xrb! {
 		///
 		/// See [`VisualType`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`VisualType`]: crate::visual::VisualType
 		pub visual: VisualId,
 		/// The [window]'s [class].
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		/// [class]: WindowClass
 		pub class: WindowClass,
 
@@ -99,7 +103,7 @@ derive_xrb! {
 		/// See [`Attributes::bit_gravity`] for more information.
 		///
 		/// [region]: crate::Region
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::bit_gravity`]: crate::set::Attributes::bit_gravity
 		pub bit_gravity: BitGravity,
@@ -107,7 +111,7 @@ derive_xrb! {
 		///
 		/// See [`Attributes::window_gravity`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::window_gravity`]: crate::set::Attributes::window_gravity
 		pub window_graivty: WindowGravity,
@@ -117,7 +121,7 @@ derive_xrb! {
 		///
 		/// See [`Attributes::maintained_planes`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::maintained_planes`]: crate::set::Attributes::maintained_planes
 		pub maintained_planes: u32,
@@ -136,7 +140,7 @@ derive_xrb! {
 		///
 		/// See [`Attributes::maintain_windows_under`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::maintain_windows_under`]: crate::set::Attributes::maintain_windows_under
 		pub maintain_windows_under: bool,
@@ -147,7 +151,7 @@ derive_xrb! {
 		///
 		/// See [`MapState`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		/// [map state]: MapState
 		pub map_state: MapState,
 
@@ -160,7 +164,7 @@ derive_xrb! {
 		///
 		/// See [`Attributes::override_redirect`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`MapWindow`]: request::MapWindow
 		/// [`ConfigureWindow`]: request::ConfigureWindow
@@ -174,7 +178,7 @@ derive_xrb! {
 		///
 		/// See [`Attributes::colormap`] for more information.
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		/// [colormap]: Colormap
 		///
 		/// [`Attributes::colormap`]: crate::set::Attributes::colormap
@@ -185,7 +189,7 @@ derive_xrb! {
 		/// This is the bitwise OR of every client's [`event_mask`] on the
 		/// [window].
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		/// [events]: crate::message::Event
 		///
 		/// [`event_mask`]: crate::set::Attributes::event_mask
@@ -194,7 +198,7 @@ derive_xrb! {
 		///
 		/// This is your [`event_mask`] on the [window].
 		///
-		/// [window]: crate::Window
+		/// [window]: Window
 		/// [events]: crate::message::Event
 		///
 		/// [`event_mask`]: crate::set::Attributes::event_mask
@@ -206,10 +210,62 @@ derive_xrb! {
 		/// See [`Attributes::do_not_propagate_mask`] for more information.
 		///
 		/// [event]: crate::message::Event
-		/// [window]: crate::Window
+		/// [window]: Window
 		///
 		/// [`Attributes::do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
 		pub do_not_propagate_mask: DeviceEventMask,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GetGeometry` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetGeometry` request]: request::GetGeometry
+	#[derive(Debug, X11Size, Readable, Writable)]
+	pub struct GetGeometry: Reply for request::GetGeometry {
+		#[sequence]
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		pub sequence: u16,
+
+		#[metabyte]
+		/// The number of bits per pixel for the [drawable].
+		///
+		/// [drawable]: crate::Drawable
+		pub depth: u8,
+
+		/// The [drawable]'s root [window].
+		///
+		/// [window]: Window
+		/// [drawable]: crate::Drawable
+		pub root: Window,
+
+		/// The [drawable]'s geometry.
+		///
+		/// For a [pixmap], the `x` and `y` coordinates will always be zero.
+		///
+		/// For a [window], the coordinates are relative to the top-left corner
+		/// of the [window]'s parent.
+		///
+		/// [window]: Window
+		/// [pixmap]: create::Pixmap
+		/// [drawable]: crate::Drawable
+		pub geometry: Rectangle,
+		/// The width of the [drawable]'s border.
+		///
+		/// For a [pixmap], this will always be zero.
+		///
+		/// [pixmap]: crate::Pixmap
+		/// [drawable]: crate::Drawable
+		pub border_width: Px<u16>,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index af318f55..da3425a4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -15,6 +15,7 @@ use crate::{
 	visual::VisualId,
 	x11::error,
 	CopyableFromParent,
+	Drawable,
 	Point,
 	Rectangle,
 	Window,
@@ -818,4 +819,39 @@ derive_xrb! {
 		/// [`Window error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that returns the root [window] and current geometry of the
+	/// given [drawable].
+	///
+	/// It is legal to pass an [`InputOnly`] [window] as a [drawable] to this
+	/// [request].
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if the `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [window]: Window
+	/// [pixmap]: crate::Pixmap
+	/// [drawable]: Drawable
+	/// [request]: crate::message::Request
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	///
+	/// [`Drawable` error]: error::Drawable
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetGeometry: Request(14, error::Drawable) -> reply::GetGeometry {
+		/// The [drawable] for which this [request] gets its geometry.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [window]: Window
+		/// [pixmap]: crate::Pixmap
+		/// [drawable]: Drawable
+		/// [request]: crate::message::Request
+		///
+		/// [`Drawable` error]: Error::Drawable
+		pub target: Drawable,
+	}
 }

From 2a82b407dd08e07bfe9ba835c2dafdb5c96977d4 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 22 Jan 2023 22:06:44 +0000
Subject: [PATCH 017/157] QueryWindowTree request + reply

---
 src/x11/reply.rs   | 40 ++++++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 77 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index f647c186..ab51380f 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -268,4 +268,44 @@ derive_xrb! {
 		pub border_width: Px<u16>,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`QueryWindowTree` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryWindowTree` request]: request::QueryWindowTree
+	#[derive(Debug, X11Size, Readable, Writable)]
+	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
+		#[sequence]
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		pub sequence: u16,
+
+		/// The `target` [window]'s root [window].
+		///
+		/// [window]: Window
+		pub root: Window,
+		/// The `target` [window]'s parent.
+		///
+		/// [window]: Window
+		pub parent: Option<Window>,
+
+		// The length of `children`.
+		#[allow(clippy::cast_possible_truncation)]
+		let children_len: u16 = children => children.len() as u16,
+		[_; 14],
+
+		/// The `target` [window]'s children.
+		///
+		/// [window]: Window
+		#[context(children_len => usize::from(*children_len))]
+		pub children: Vec<Window>,
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index da3425a4..1960a556 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -826,6 +826,9 @@ derive_xrb! {
 	/// It is legal to pass an [`InputOnly`] [window] as a [drawable] to this
 	/// [request].
 	///
+	/// # Reply
+	/// This [request] generates a [`GetGeometry` reply].
+	///
 	/// # Errors
 	/// A [`Drawable` error] is generated if the `target` does not refer to a
 	/// defined [window] nor [pixmap].
@@ -837,6 +840,8 @@ derive_xrb! {
 	///
 	/// [`InputOnly`]: WindowClass::InputOnly
 	///
+	/// [`GetGeometry` reply]: reply::GetGeometry
+	///
 	/// [`Drawable` error]: error::Drawable
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetGeometry: Request(14, error::Drawable) -> reply::GetGeometry {
@@ -854,4 +859,36 @@ derive_xrb! {
 		/// [`Drawable` error]: Error::Drawable
 		pub target: Drawable,
 	}
+
+	/// A [request] that returns the root [window], the parent, and the children
+	/// of the given [window].
+	///
+	/// # Reply
+	/// This [request] generates a [`QueryWindowTree` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
+		/// The [window] for which this [request] gets its root [window],
+		/// parent, and children.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From cad79ff3ad47a06a20cb76ee2e2a99d082c0f289 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 08:48:02 +0000
Subject: [PATCH 018/157] GetAtom request + reply

---
 src/x11/reply.rs   | 30 ++++++++++++++++++++++++++++
 src/x11/request.rs | 50 +++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 79 insertions(+), 1 deletion(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index ab51380f..c8deb193 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -14,6 +14,7 @@
 use super::request;
 use crate::{
 	visual::{Color, VisualId},
+	Atom,
 	BitGravity,
 	Colormap,
 	DeviceEventMask,
@@ -308,4 +309,33 @@ derive_xrb! {
 		#[context(children_len => usize::from(*children_len))]
 		pub children: Vec<Window>,
 	}
+
+	/// The [reply] to a [`GetAtom` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetAtom` request]: request::GetAtom
+	#[derive(Debug, X11Size, Readable, Writable)]
+	pub struct GetAtom: Reply for request::GetAtom {
+		#[sequence]
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		pub sequence: u16,
+
+		/// The returned [atom].
+		///
+		/// If `no_creation` was set to `true` and an [atom] by the given `name`
+		/// didn't already exist, this will be [`None`].
+		///
+		/// [atom]: Atom
+		pub atom: Option<Atom>,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 1960a556..ce157fd4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -18,6 +18,7 @@ use crate::{
 	Drawable,
 	Point,
 	Rectangle,
+	String8,
 	Window,
 	WindowClass,
 };
@@ -816,7 +817,7 @@ derive_xrb! {
 		/// [window]: Window
 		/// [request]: crate::message::Request
 		///
-		/// [`Window error]: error::Window
+		/// [`Window error`]: error::Window
 		pub target: Window,
 	}
 
@@ -891,4 +892,51 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that returns the [atom] with the given `name`.
+	///
+	/// If `no_creation` is false and an [atom] by the specified `name` does not
+	/// already exist, a new [atom] will be created and then returned. If an
+	/// [atom] by the specified `name` already exists, that [atom] will be
+	/// returned.
+	///
+	/// # Reply
+	/// This [request] generates a [`GetAtom` reply].
+	///
+	/// [atom]: crate::Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`GetAtom` reply]: reply::GetAtom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetAtom: Request(16, error::Value) -> reply::GetAtom {
+		#[metabyte]
+		/// Whether the X server should avoid creating a new [atom] for an
+		/// unrecognised `name`.
+		///
+		/// If this is `true`, the X server won't create a new [atom] for a
+		/// `name` which doesn't already refer to an [atom]. If it is `false`,
+		/// the X server will create a new [atom] for the given `name`.
+		///
+		/// [atom]: crate::Atom
+		pub no_creation: bool,
+
+		// Encodes the length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// The name of the [atom] to either create or retrieve.
+		///
+		/// If an [atom] by this name does not already exist and `no_creation`
+		/// is `false`, a new [atom] with this name will be created and
+		/// returned.
+		///
+		/// If an [atom] by this name already exists, that [atom] will be
+		/// returned.
+		///
+		/// [atom]: crate::Atom
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; ..],
+	}
 }

From a20ee8728f12dfb4f02e1dc1cdd678ca38736550 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 09:14:44 +0000
Subject: [PATCH 019/157] GetAtomName request + reply

---
 src/x11/reply.rs   | 31 +++++++++++++++++++++++++++++++
 src/x11/request.rs | 32 +++++++++++++++++++++++++++++---
 2 files changed, 60 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index c8deb193..29e6eab3 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -21,6 +21,7 @@ use crate::{
 	EventMask,
 	MaintainContents,
 	Rectangle,
+	String8,
 	Window,
 	WindowClass,
 	WindowGravity,
@@ -338,4 +339,34 @@ derive_xrb! {
 		pub atom: Option<Atom>,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GetAtomName` request].
+	///
+	/// [reply]: crate::message
+	#[derive(Debug, X11Size, Readable, Writable)]
+	pub struct GetAtomName: Reply for request::GetAtomName {
+		#[sequence]
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		pub sequence: u16,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 22],
+
+		/// The name of the [atom].
+		///
+		/// [atom]: Atom
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index ce157fd4..0991a895 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -14,6 +14,7 @@ use crate::{
 	unit::Px,
 	visual::VisualId,
 	x11::error,
+	Atom,
 	CopyableFromParent,
 	Drawable,
 	Point,
@@ -903,7 +904,7 @@ derive_xrb! {
 	/// # Reply
 	/// This [request] generates a [`GetAtom` reply].
 	///
-	/// [atom]: crate::Atom
+	/// [atom]: Atom
 	/// [request]: crate::message::Request
 	///
 	/// [`GetAtom` reply]: reply::GetAtom
@@ -917,7 +918,7 @@ derive_xrb! {
 		/// `name` which doesn't already refer to an [atom]. If it is `false`,
 		/// the X server will create a new [atom] for the given `name`.
 		///
-		/// [atom]: crate::Atom
+		/// [atom]: Atom
 		pub no_creation: bool,
 
 		// Encodes the length of `name`.
@@ -934,9 +935,34 @@ derive_xrb! {
 		/// If an [atom] by this name already exists, that [atom] will be
 		/// returned.
 		///
-		/// [atom]: crate::Atom
+		/// [atom]: Atom
 		#[context(name_len => usize::from(*name_len))]
 		pub name: String8,
 		[_; ..],
 	}
+
+	/// A [request] that returns the name of the given [atom].
+	///
+	/// # Errors
+	/// An [`Atom` error] is generated if the `target` does not refer to a
+	/// defined [atom].
+	///
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetAtomName: Request(17, error::Atom) -> reply::GetAtomName {
+		/// The [atom] for which this [request] gets its name.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub target: Atom,
+	}
 }

From 40109e3f712376aac596c3bf7f07d0adb00cb134 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 11:44:25 +0000
Subject: [PATCH 020/157] ModifyProperty request

---
 src/x11/request.rs | 245 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 239 insertions(+), 6 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 0991a895..94082708 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -23,6 +23,7 @@ use crate::{
 	Window,
 	WindowClass,
 };
+use xrbk::{Buf, BufMut, ReadResult, ReadableWithContext, Writable, WriteResult, X11Size};
 
 use crate::{set::WindowConfig, x11::reply};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
@@ -345,10 +346,10 @@ pub enum ChangeSavedWindowsError {
 
 /// Whether something is added or removed.
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum ChangeMode {
-	/// The change is achieved by adding the thing.
+pub enum AddOrRemove {
+	/// The thing is added.
 	Add,
-	/// The change is achieved by removing the thing.
+	/// The thing is removed.
 	Remove,
 }
 
@@ -374,8 +375,8 @@ derive_xrb! {
 	/// [windows]: Window
 	/// [request]: crate::message::Request
 	///
-	/// [adds]: ChangeMode::Add
-	/// [removes]: ChangeMode::Remove
+	/// [adds]: AddOrRemove::Add
+	/// [removes]: AddOrRemove::Remove
 	///
 	/// [reparented]: ReparentWindow
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
@@ -385,7 +386,7 @@ derive_xrb! {
 		/// [windows].
 		///
 		/// [windows]: Window
-		pub change_mode: ChangeMode,
+		pub change_mode: AddOrRemove,
 
 		/// The [window] which is added to or removed from your saved
 		/// [windows][window].
@@ -966,3 +967,235 @@ derive_xrb! {
 		pub target: Atom,
 	}
 }
+
+/// An [error] generated because a [`ModifyProperty` request] failed.
+///
+/// [error]: crate::message::Error
+///
+/// [`ModifyProperty` request]: ModifyProperty
+pub enum ModifyPropertyError {
+	/// An [`Atom` error].
+	///
+	/// [`Atom` error]: error::Atom
+	Atom(error::Atom),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+/// Whether a property is [replaced], [prepended] to a [window]'s list of
+/// properties, or [appended] to the [window]'s list of properties.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ModifyPropertyMode {
+	/// The property replaces an existing property; the previous value is
+	/// discarded.
+	Replace,
+
+	/// The property is prepended to the list of properties.
+	Prepend,
+
+	/// The property is appended to the list of properties.
+	Append,
+}
+
+/// Whether a [`DataList`] is formatted as a list of `i8` values, `i16` values,
+/// or `i32` values.
+#[derive(Copy, Clone, Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum DataFormat {
+	/// The list is formatted as `i8` values.
+	I8 = 8,
+	/// The list is formatted as `i16` values.
+	I16 = 16,
+	/// The list is formatted as `i32` values.
+	I32 = 32,
+}
+
+/// A list of either `i8` values, `i16` values, or `i32` values.
+///
+/// This represents uninterpreted 'raw' data.
+#[derive(Clone, Debug, Hash, PartialEq, Eq)]
+pub enum DataList {
+	/// A list of `i8` values.
+	I8(Vec<i8>),
+	/// A list of `i16` values.
+	I16(Vec<i16>),
+	/// A list of `i32` values.
+	I32(Vec<i32>),
+}
+
+impl DataList {
+	/// The length of the data.
+	///
+	/// This is how many values there are - not the number of bytes.
+	#[must_use]
+	pub fn len(&self) -> usize {
+		match self {
+			Self::I8(list) => list.len(),
+			Self::I16(list) => list.len(),
+			Self::I32(list) => list.len(),
+		}
+	}
+
+	/// Whether the `DataList` is empty.
+	#[must_use]
+	pub fn is_empty(&self) -> bool {
+		match self {
+			Self::I8(list) => list.is_empty(),
+			Self::I16(list) => list.is_empty(),
+			Self::I32(list) => list.is_empty(),
+		}
+	}
+}
+
+impl X11Size for DataList {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::I8(list) => list.x11_size(),
+			Self::I16(list) => list.x11_size(),
+			Self::I32(list) => list.x11_size(),
+		}
+	}
+}
+
+impl ReadableWithContext for DataList {
+	type Context = (DataFormat, u32);
+
+	fn read_with(buf: &mut impl Buf, (format, length): &(DataFormat, u32)) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		let length = &(*length as usize);
+
+		Ok(match format {
+			DataFormat::I8 => Self::I8(<Vec<i8>>::read_with(buf, length)?),
+			DataFormat::I16 => Self::I16(<Vec<i16>>::read_with(buf, length)?),
+			DataFormat::I32 => Self::I32(<Vec<i32>>::read_with(buf, length)?),
+		})
+	}
+}
+
+impl Writable for DataList {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::I8(list) => list.write_to(buf)?,
+			Self::I16(list) => list.write_to(buf)?,
+			Self::I32(list) => list.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that modifies the given `property` for the [window].
+	///
+	/// A [`Property` event] is generated on the `target` [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// An [`Atom` error] is generated if either `property` or `type` do not
+	/// refer to defined [windows][window].
+	///
+	/// If the `change_mode` is [`Prepend`] or [`Append`], the `type` and
+	/// `format` must match that of the existing property's value, else a
+	/// [`Match` error] is generated.
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Property` event]: super::event::Property
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ModifyProperty: Request(18, ModifyPropertyError) {
+		#[metabyte]
+		/// Whether the `property` is prepended to the [window]'s list of
+		/// properties, appended to the [window]'s list of properties, or
+		/// replaces the value of an existing property.
+		///
+		/// If the mode is [`Replace`], the previous property value is
+		/// discarded.
+		///
+		/// # Errors
+		/// If the mode is [`Prepend`] or [`Append`], the `type` and `format`
+		/// must match that of the existing property's value, else a
+		/// [`Match` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`Prepend`]: ModifyPropertyMode::Prepend
+		/// [`Append`]: ModifyPropertyMode::Append
+		///
+		/// [`Match` error]: error::Match
+		pub change_mode: ModifyPropertyMode,
+
+		/// The [window] which the `property` is modified for.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The property which is modified.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		///
+		/// [`Atom` error]: error::Atom
+		pub property: Atom,
+		/// The type of the property's data.
+		///
+		/// For example, if the property is of type [`Window`], then this would
+		/// be [`atom::WINDOW`].
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [`atom::WINDOW`]: crate::atom::WINDOW
+		///
+		/// [`Atom` error]: error::Atom
+		pub r#type: Atom,
+
+		// Whether the `data` is formatted as `i8` values, `i16` values, or
+		// `i32` values.
+		let format: DataFormat = data => match data {
+			DataList::I8(_) => DataFormat::I8,
+			DataList::I16(_) => DataFormat::I16,
+			DataList::I32(_) => DataFormat::I32,
+		},
+		[_; 3],
+
+		// The length of `data` in number of values (i.e., an `i32` value is
+		// counted as one, rather than the number of bytes).
+		#[allow(clippy::cast_possible_truncation)]
+		let data_len: u32 = data => data.len() as u32,
+
+		/// The property's value.
+		///
+		/// See [`DataList`] for information on the format of this data.
+		#[context(format, data_len => (*format, *data_len))]
+		pub data: DataList,
+	}
+}

From de752e074edd48886ad702a0539a46cd4a2f787d Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 11:55:00 +0000
Subject: [PATCH 021/157] DeleteProperty request

---
 src/x11/request.rs | 65 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 94082708..cd785a20 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -1199,3 +1199,68 @@ derive_xrb! {
 		pub data: DataList,
 	}
 }
+
+/// An [error] generated because of a failed [`DeleteProperty` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`DeleteProperty` request]: DeleteProperty
+pub enum DeletePropertyError {
+	/// An [`Atom` error].
+	///
+	/// [`Atom` error]: error::Atom
+	Atom(error::Atom),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that removes the given `property` from a [window].
+	///
+	/// If the `property` does not exist on the [window], this [request] has no
+	/// effect. Otherwise, a [`Property` event] is generated on the [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Atom` error] is generated if the `property` does not refer to a
+	/// defined [atom].
+	///
+	/// [window]: Window
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`Property` event]: super::event::Property
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DeleteProperty: Request(19, DeletePropertyError) {
+		/// The [window] for which this [request] removes the `property`.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The property which is to be removed from the `target` [window].
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [window]: Window
+		///
+		/// [`Atom` error]: error::Atom
+		pub property: Atom,
+	}
+}

From ef8761b2db5b86b843838b0965da7a8d30b67cca Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 12:32:23 +0000
Subject: [PATCH 022/157] use derivative for replies

---
 src/x11/reply.rs   | 37 +++++++++++++++++++++++++------------
 src/x11/request.rs |  8 +++++---
 2 files changed, 30 insertions(+), 15 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 29e6eab3..6bd0d936 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -26,6 +26,7 @@ use crate::{
 	WindowClass,
 	WindowGravity,
 };
+use derivative::Derivative;
 
 use crate::unit::Px;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
@@ -59,9 +60,9 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
-	#[derive(Debug, X11Size, Readable, Writable)]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetWindowAttributes: Reply for request::GetWindowAttributes {
-		#[sequence]
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
@@ -71,9 +72,10 @@ derive_xrb! {
 		/// [reply]: crate::message::Reply
 		///
 		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
-		#[metabyte]
 		/// The conditions under which the X server should maintain the obscured
 		/// [regions] of the [window].
 		///
@@ -83,6 +85,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
+		#[metabyte]
 		pub maintain_contents: MaintainContents,
 
 		/// The visual used by the [window].
@@ -224,9 +227,9 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetGeometry` request]: request::GetGeometry
-	#[derive(Debug, X11Size, Readable, Writable)]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetGeometry: Reply for request::GetGeometry {
-		#[sequence]
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
@@ -236,12 +239,14 @@ derive_xrb! {
 		/// [reply]: crate::message::Reply
 		///
 		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
-		#[metabyte]
 		/// The number of bits per pixel for the [drawable].
 		///
 		/// [drawable]: crate::Drawable
+		#[metabyte]
 		pub depth: u8,
 
 		/// The [drawable]'s root [window].
@@ -276,9 +281,9 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`QueryWindowTree` request]: request::QueryWindowTree
-	#[derive(Debug, X11Size, Readable, Writable)]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
 	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
-		#[sequence]
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
@@ -288,6 +293,8 @@ derive_xrb! {
 		/// [reply]: crate::message::Reply
 		///
 		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
 		/// The `target` [window]'s root [window].
@@ -316,9 +323,9 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetAtom` request]: request::GetAtom
-	#[derive(Debug, X11Size, Readable, Writable)]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetAtom: Reply for request::GetAtom {
-		#[sequence]
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
@@ -328,6 +335,8 @@ derive_xrb! {
 		/// [reply]: crate::message::Reply
 		///
 		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
 		/// The returned [atom].
@@ -343,9 +352,11 @@ derive_xrb! {
 	/// The [reply] to a [`GetAtomName` request].
 	///
 	/// [reply]: crate::message
-	#[derive(Debug, X11Size, Readable, Writable)]
+	///
+	/// [`GetAtomName` request]: request::GetAtomName
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetAtomName: Reply for request::GetAtomName {
-		#[sequence]
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
@@ -355,6 +366,8 @@ derive_xrb! {
 		/// [reply]: crate::message::Reply
 		///
 		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
 		// The length of `name`.
diff --git a/src/x11/request.rs b/src/x11/request.rs
index cd785a20..c35213d0 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -1122,13 +1122,15 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ModifyProperty: Request(18, ModifyPropertyError) {
 		#[metabyte]
-		/// Whether the `property` is prepended to the [window]'s list of
-		/// properties, appended to the [window]'s list of properties, or
-		/// replaces the value of an existing property.
+		/// The way in which the property is modified.
 		///
 		/// If the mode is [`Replace`], the previous property value is
 		/// discarded.
 		///
+		/// If the mode is [`Prepend`], the data is prepended to the existing
+		/// data. If the mode is [`Append`], the data is appended to the
+		/// existing data.
+		///
 		/// # Errors
 		/// If the mode is [`Prepend`] or [`Append`], the `type` and `format`
 		/// must match that of the existing property's value, else a

From c19bc080f6a84b6382a4daeafbb55a73665e2dd2 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 17:10:03 +0000
Subject: [PATCH 023/157] ListProperty + GetProperty requests

---
 src/x11/reply.rs   |  97 +++++++++++++++++++++++++-
 src/x11/request.rs | 169 ++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 262 insertions(+), 4 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 6bd0d936..7138be8e 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -11,9 +11,10 @@
 //! [request]: crate::message::Request
 //! [core X11 protocol]: super
 
-use super::request;
 use crate::{
+	unit::Px,
 	visual::{Color, VisualId},
+	x11::request::{self, DataFormat, DataList},
 	Atom,
 	BitGravity,
 	Colormap,
@@ -28,9 +29,7 @@ use crate::{
 };
 use derivative::Derivative;
 
-use crate::unit::Px;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
-
 extern crate self as xrb;
 
 /// The state of the [window] regarding how it is mapped.
@@ -382,4 +381,96 @@ derive_xrb! {
 		pub name: String8,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GetProperty` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetProperty` request]: request::GetProperty
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetProperty: Reply for request::GetProperty {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the `value` is empty ([`None`]), or made up of `i8` values,
+		/// `i16` values, or `i32` values.
+		#[metabyte]
+		pub format: Option<DataFormat>,
+
+		/// The actual type of the property.
+		pub r#type: Option<Atom>,
+		/// The number of bytes remaining in the `property`'s data.
+		///
+		/// If the specified `property` does not exist for the `target`
+		/// [window], this is zero.
+		///
+		/// If the specified `property` exists but its `type` does not match the
+		/// specified type, this is the size of the property's data in bytes.
+		///
+		/// If the specified `property` exists and the type is either [`Any`] or
+		/// matches the actual `type` of the property, this is the number of
+		/// bytes remaining in the `property`'s data after the end of the
+		/// returned `value`.
+		///
+		/// [window]: Window
+		///
+		/// [`Any`]: crate::Any::Any
+		pub bytes_remaining: u32,
+
+		// The length of `value`.
+		#[allow(clippy::cast_possible_truncation)]
+		let value_len: u32 = value => value.len() as u32,
+		[_; 12],
+
+		/// The property's value.
+		///
+		/// If `format` is [`None`], this will be [`DataList::I8`], but with an
+		/// empty list.
+		#[context(format, value_len => (format.unwrap_or(DataFormat::I8), *value_len))]
+		pub value: DataList,
+	}
+
+	/// The [reply] for a [`ListProperties` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`ListProperties` request]: request::ListProperties
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListProperties: Reply for request::ListProperties {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `properties`.
+		#[allow(clippy::cast_possible_truncation)]
+		let properties_len: u16 = properties => properties.len() as u16,
+		[_; 22],
+
+		/// The properties defined for the given [window].
+		///
+		/// [window]: Window
+		#[context(properties_len => usize::from(*properties_len))]
+		pub properties: Vec<Atom>,
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index c35213d0..6485b30b 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -14,6 +14,7 @@ use crate::{
 	unit::Px,
 	visual::VisualId,
 	x11::error,
+	Any,
 	Atom,
 	CopyableFromParent,
 	Drawable,
@@ -23,7 +24,19 @@ use crate::{
 	Window,
 	WindowClass,
 };
-use xrbk::{Buf, BufMut, ReadResult, ReadableWithContext, Writable, WriteResult, X11Size};
+use xrbk::{
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadError::UnrecognizedDiscriminant,
+	ReadResult,
+	ReadableWithContext,
+	Wrap,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 
 use crate::{set::WindowConfig, x11::reply};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
@@ -1019,6 +1032,38 @@ pub enum DataFormat {
 	I32 = 32,
 }
 
+impl ConstantX11Size for DataFormat {
+	const X11_SIZE: usize = 1;
+}
+
+impl Wrap for DataFormat {
+	type Integer = u8;
+}
+
+impl TryFrom<u8> for DataFormat {
+	type Error = ReadError;
+
+	fn try_from(value: u8) -> Result<Self, Self::Error> {
+		match value {
+			i8 if i8 == 8 => Ok(Self::I8),
+			i16 if i16 == 16 => Ok(Self::I16),
+			i32 if i32 == 32 => Ok(Self::I32),
+
+			other => Err(UnrecognizedDiscriminant(usize::from(other))),
+		}
+	}
+}
+
+impl From<DataFormat> for u8 {
+	fn from(format: DataFormat) -> Self {
+		match format {
+			DataFormat::I8 => 8,
+			DataFormat::I16 => 16,
+			DataFormat::I32 => 32,
+		}
+	}
+}
+
 /// A list of either `i8` values, `i16` values, or `i32` values.
 ///
 /// This represents uninterpreted 'raw' data.
@@ -1266,3 +1311,125 @@ derive_xrb! {
 		pub property: Atom,
 	}
 }
+
+/// An [error] generated because of a failed [`GetProperty` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`GetProperty` request]: GetProperty
+pub enum GetPropertyError {
+	/// An [`Atom` error].
+	///
+	/// [`Atom` error]: error::Atom
+	Atom(error::Atom),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that gets the value of the given `property` on the given
+	/// [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// An [`Atom` error] is generated if either `property` or `type` do not
+	/// refer to defined [atoms].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	/// [atoms]: Atom
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetProperty: Request(20, GetPropertyError) -> reply::GetProperty {
+		/// Whether the `property` should be deleted from the `target` [window].
+		///
+		/// If the `type` matches the `property`'s actual type (or is [`Any`]),
+		/// the property is removed from the [window]. Otherwise, this is
+		/// ignored.
+		///
+		/// [window]: Window
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub delete: bool,
+
+		/// The [window] on which the requested `property` is found.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The property for which this [request] gets its value.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [request]: crate::message::Request
+		pub property: Atom,
+		/// The property type to filter the [window]'s properties by.
+		///
+		/// This specifies that specifically a `property` of this type is
+		/// requested. If the type does not match, the value is not provided in
+		/// [the reply].
+		///
+		/// [window]: Window
+		///
+		/// [the reply]: reply::GetProperty
+		pub r#type: Any<Atom>,
+
+		/// The offset of the value of the `property` that is requested in
+		/// 4-byte units.
+		///
+		/// This offset is multiplied by 4 when applied to the start of the
+		/// `property`'s data.
+		pub offset: u32,
+		/// The length of the value of the `property` that is requested in
+		/// 4-byte units.
+		///
+		/// This length is multiplied by 4 and added to the `offset` to find the
+		/// endpoint of the value that is requested.
+		pub length: u32,
+	}
+
+	/// A [request] that returns the list of properties defined for the given
+	/// [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListProperties: Request(21, error::Window) -> reply::ListProperties {
+		/// The [window] for which this [request] returns its properties.
+		///
+		/// # Errors
+		/// A [`Window` error] is returned if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
+}

From c0327928801aaf89db335eb7f3488d87878a6db6 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 17:26:41 +0000
Subject: [PATCH 024/157] add docs aliases for requests and replies

These are for the names as they appear in the X11 protocol.
---
 src/x11/reply.rs   | 10 ++++++++++
 src/x11/request.rs | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 7138be8e..1bf7e397 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -84,6 +84,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
+		#[doc(alias = "backing_store")]
 		#[metabyte]
 		pub maintain_contents: MaintainContents,
 
@@ -118,6 +119,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Attributes::window_gravity`]: crate::set::Attributes::window_gravity
+		#[doc(alias = "win_gravity")]
 		pub window_graivty: WindowGravity,
 
 		/// Defines which bit planes of the [window] hold dynamic data which is
@@ -128,6 +130,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Attributes::maintained_planes`]: crate::set::Attributes::maintained_planes
+		#[doc(alias = "backing_planes")]
 		pub maintained_planes: u32,
 		/// Defines the [color] used for bit planes which are not preserved for
 		/// `maintain_contents` and `maintain_windows_under` (see
@@ -138,6 +141,7 @@ derive_xrb! {
 		/// [color]: Color
 		///
 		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
+		#[doc(alias = "backing_pixel")]
 		pub maintenance_fallback_color: Color,
 		/// Whether the X server should maintain the contents of [windows] under
 		/// this [window].
@@ -147,6 +151,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Attributes::maintain_windows_under`]: crate::set::Attributes::maintain_windows_under
+		#[doc(alias = "save_under")]
 		pub maintain_windows_under: bool,
 
 		// TODO
@@ -264,6 +269,7 @@ derive_xrb! {
 		/// [window]: Window
 		/// [pixmap]: create::Pixmap
 		/// [drawable]: crate::Drawable
+		#[doc(alias = "x", alias = "y", alias = "width", alias = "height")]
 		pub geometry: Rectangle,
 		/// The width of the [drawable]'s border.
 		///
@@ -280,6 +286,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`QueryWindowTree` request]: request::QueryWindowTree
+	#[doc(alias = "QueryTree")]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
@@ -322,6 +329,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetAtom` request]: request::GetAtom
+	#[doc(alias = "InternAtom")]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetAtom: Reply for request::GetAtom {
@@ -426,6 +434,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Any`]: crate::Any::Any
+		#[doc(alias = "bytes_after")]
 		pub bytes_remaining: u32,
 
 		// The length of `value`.
@@ -470,6 +479,7 @@ derive_xrb! {
 		/// The properties defined for the given [window].
 		///
 		/// [window]: Window
+		#[doc(alias = "atoms")]
 		#[context(properties_len => usize::from(*properties_len))]
 		pub properties: Vec<Atom>,
 	}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6485b30b..7b24fa75 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -119,6 +119,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias = "wid")]
 		pub window_id: Window,
 		/// The [window] which should be used as the new [window]'s parent.
 		///
@@ -183,6 +184,7 @@ derive_xrb! {
 		///
 		/// [window]: Window
 		/// [attributes]: Attributes
+		#[doc(alias = "values")]
 		pub attributes: Attributes,
 	}
 }
@@ -245,11 +247,13 @@ derive_xrb! {
 		/// The [window] which the `attributes` are changed on.
 		///
 		/// [window]: Window
+		#[doc(alias = "window")]
 		pub target: Window,
 
 		/// The [attributes] which are changed.
 		///
 		/// [attributes]: Attributes
+		#[doc(alias = "values")]
 		pub attributes: Attributes,
 	}
 
@@ -265,6 +269,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		/// [attributes]: Attributes
 		/// [window]: Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -302,6 +307,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -320,6 +326,7 @@ derive_xrb! {
 	/// [destroys]: DestroyWindow
 	///
 	/// [`Window` error]: error::Window
+	#[doc(alias = "DestroySubwindows")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct DestroyChildren: Request(5, error::Window) {
 		/// The [window] which will have its children [destroyed].
@@ -333,6 +340,7 @@ derive_xrb! {
 		/// [destroyed]: DestroyWindow
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 }
@@ -392,6 +400,7 @@ derive_xrb! {
 	/// [removes]: AddOrRemove::Remove
 	///
 	/// [reparented]: ReparentWindow
+	#[doc(alias = "ChangeSaveSet")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ChangeSavedWindows: Request(6, ChangeSavedWindowsError) {
 		#[metabyte]
@@ -399,6 +408,7 @@ derive_xrb! {
 		/// [windows].
 		///
 		/// [windows]: Window
+		#[doc(alias = "mode")]
 		pub change_mode: AddOrRemove,
 
 		/// The [window] which is added to or removed from your saved
@@ -486,6 +496,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 		/// The `target`'s new parent [window].
 		///
@@ -509,10 +520,12 @@ derive_xrb! {
 		///
 		/// [`Match` error]: error::Match
 		/// [`Window` error]: error::Window
+		#[doc(alias = "parent")]
 		pub new_parent: Window,
 
 		/// The `target`'s new coordinates relative to its `new_parent`'s
 		/// top-left corner.
+		#[doc(alias = "x", alias = "y")]
 		pub coords: Point,
 	}
 
@@ -553,6 +566,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -572,6 +586,7 @@ derive_xrb! {
 	///
 	///
 	/// [`Window` error]: error::Window
+	#[doc(alias = "MapSubwindows")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct MapChildren: Request(9, error::Window) {
 		/// The [window] which will have its unmapped children [mapped].
@@ -585,6 +600,7 @@ derive_xrb! {
 		/// [mapped]: MapWindow
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -617,6 +633,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -635,6 +652,7 @@ derive_xrb! {
 	/// [unmaps]: UnmapWindow
 	///
 	/// [`Window` error]: error::Window
+	#[doc(alias = "UnmapSubwindows")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UnmapChildren: Request(11, error::Window) {
 		/// The [window] which will have its mapped children [unmapped].
@@ -648,6 +666,7 @@ derive_xrb! {
 		/// [unmapped]: UnmapWindow
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 }
@@ -718,6 +737,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 
 		/// The changes to the `target` [window]'s [configuration].
@@ -752,6 +772,7 @@ derive_xrb! {
 		/// [`InputOnly`]: WindowClass::InputOnly
 		///
 		/// [`Match` error]: error::Match
+		#[doc(alias = "values")]
 		pub config: WindowConfig,
 	}
 }
@@ -833,6 +854,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window error`]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -873,6 +895,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Drawable` error]: Error::Drawable
+		#[doc(alias = "drawable")]
 		pub target: Drawable,
 	}
 
@@ -892,6 +915,7 @@ derive_xrb! {
 	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
 	///
 	/// [`Window` error]: error::Window
+	#[doc(alias = "QueryTree")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
 		/// The [window] for which this [request] gets its root [window],
@@ -905,6 +929,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 
@@ -922,6 +947,7 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	///
 	/// [`GetAtom` reply]: reply::GetAtom
+	#[doc(alias = "InternAtom")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetAtom: Request(16, error::Value) -> reply::GetAtom {
 		#[metabyte]
@@ -933,6 +959,7 @@ derive_xrb! {
 		/// the X server will create a new [atom] for the given `name`.
 		///
 		/// [atom]: Atom
+		#[doc(alias = "only_if_exists")]
 		pub no_creation: bool,
 
 		// Encodes the length of `name`.
@@ -977,6 +1004,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Atom` error]: error::Atom
+		#[doc(alias = "atom")]
 		pub target: Atom,
 	}
 }
@@ -986,6 +1014,7 @@ derive_xrb! {
 /// [error]: crate::message::Error
 ///
 /// [`ModifyProperty` request]: ModifyProperty
+#[doc(alias = "ChangePropertyError")]
 pub enum ModifyPropertyError {
 	/// An [`Atom` error].
 	///
@@ -1007,6 +1036,7 @@ pub enum ModifyPropertyError {
 
 /// Whether a property is [replaced], [prepended] to a [window]'s list of
 /// properties, or [appended] to the [window]'s list of properties.
+#[doc(alias = "ChangePropertyMode")]
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub enum ModifyPropertyMode {
 	/// The property replaces an existing property; the previous value is
@@ -1164,6 +1194,7 @@ derive_xrb! {
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
 	/// [`Match` error]: error::Match
+	#[doc(alias = "ChangeProperty")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ModifyProperty: Request(18, ModifyPropertyError) {
 		#[metabyte]
@@ -1187,6 +1218,7 @@ derive_xrb! {
 		/// [`Append`]: ModifyPropertyMode::Append
 		///
 		/// [`Match` error]: error::Match
+		#[doc(alias = "mode")]
 		pub change_mode: ModifyPropertyMode,
 
 		/// The [window] which the `property` is modified for.
@@ -1198,6 +1230,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 
 		/// The property which is modified.
@@ -1296,6 +1329,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 
 		/// The property which is to be removed from the `target` [window].
@@ -1372,6 +1406,7 @@ derive_xrb! {
 		/// [window]: Window
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 
 		/// The property for which this [request] gets its value.
@@ -1398,12 +1433,14 @@ derive_xrb! {
 		///
 		/// This offset is multiplied by 4 when applied to the start of the
 		/// `property`'s data.
+		#[doc(alias = "long_offset")]
 		pub offset: u32,
 		/// The length of the value of the `property` that is requested in
 		/// 4-byte units.
 		///
 		/// This length is multiplied by 4 and added to the `offset` to find the
 		/// endpoint of the value that is requested.
+		#[doc(alias = "long_length")]
 		pub length: u32,
 	}
 
@@ -1430,6 +1467,7 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
 		pub target: Window,
 	}
 }

From 42ef80984cbe952d8efe129439de586bf2d06a0a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 17:41:41 +0000
Subject: [PATCH 025/157] SetSelectionOwner request

---
 src/x11/request.rs | 81 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 7b24fa75..5f382b5e 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -17,6 +17,7 @@ use crate::{
 	Any,
 	Atom,
 	CopyableFromParent,
+	CurrentableTime,
 	Drawable,
 	Point,
 	Rectangle,
@@ -1471,3 +1472,83 @@ derive_xrb! {
 		pub target: Window,
 	}
 }
+
+/// An [error] generated because of a failed [`SetSelectionOwner` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`SetSelectionOwner` request]: SetSelectionOwner
+pub enum SetSelectionOwnerError {
+	/// An [`Atom` error].
+	///
+	/// [`Atom` error]: error::Atom
+	Atom(error::Atom),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that changes the owner of the given selection.
+	///
+	/// If the `new_owner` is different to the previous owner of the selection,
+	/// and the previous owner was not [`None`], then a [`SelectionClear` event]
+	/// is sent to the previous owner.
+	///
+	/// If the given `time` is earlier than time of the previous owner change or
+	/// is later than the X server's [current time], this [request] has no
+	/// effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `owner` is [`Some`] but does not
+	/// refer to a defined [window].
+	///
+	/// An [`Atom` error] is generated if `selection` does not refer to a
+	/// defined [atom].
+	///
+	/// [window]: Window
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [current time]: CurrentableTime::CurrentTime
+	///
+	/// [`SelectionClear` event]: super::event::SelectionClear
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetSelectionOwner: Request(22, SetSelectionOwnerError) {
+		/// Sets the new owner of the `selection`.
+		///
+		/// [`None`] specifies that the `selection` is to have no owner.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "owner")]
+		pub new_owner: Option<Window>,
+		/// The selection for which this [request] changes its owner.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub selection: Atom,
+
+		/// The time at which this change is recorded to occur at.
+		///
+		/// If this time is earlier than the server's current 'last-change' time
+		/// for the selection's owner, or this time is later than the server's
+		/// current time, this [request] has no effect.
+		pub time: CurrentableTime,
+	}
+}

From 4897ae985b2826b00b59eae96a8c61c4135b360a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 17:54:09 +0000
Subject: [PATCH 026/157] GetSelectionOwner request + reply

---
 src/x11/reply.rs   | 28 ++++++++++++++++++++++++++++
 src/x11/request.rs | 24 ++++++++++++++++++++++++
 2 files changed, 52 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 1bf7e397..1b75eea9 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -483,4 +483,32 @@ derive_xrb! {
 		#[context(properties_len => usize::from(*properties_len))]
 		pub properties: Vec<Atom>,
 	}
+
+	/// The [reply] to a [`GetSelectionOwner` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetSelectionOwner` request]: request::GetSelectionOwner
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetSelectionOwner: Reply for request::GetSelectionOwner {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The owner of the given `selection`.
+		///
+		/// If this is [`None`], then the selection has no owner.
+		pub owner: Option<Window>,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 5f382b5e..97725464 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -1551,4 +1551,28 @@ derive_xrb! {
 		/// current time, this [request] has no effect.
 		pub time: CurrentableTime,
 	}
+
+	/// A [request] that returns the owner of a given selection.
+	///
+	/// # Errors
+	/// An [`Atom` error] is generated if `target` does not refer to a defined
+	/// [atom].
+	///
+	/// [atom]: Atom
+	///
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetSelectionOwner: Request(23) -> reply::GetSelectionOwner {
+		/// The selection for which this [request] returns its owner.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub target: Atom,
+	}
 }

From 93dfefdbb7ce5b632046acf70ce53766884dd7fd Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 19:12:28 +0000
Subject: [PATCH 027/157] ConvertSelection + SendEvent requests

cc https://github.com/rust-lang/rust/issues/92827 - would be nice to be able to ensure a generic event is absolutely 32 bytes in ConstantX11Size::X11_SIZE, it could be very easy to wreak havoc by accidentally having an incorrectly sized event in SendEvent.
---
 src/x11/request.rs | 180 ++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 171 insertions(+), 9 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 97725464..d1d6a286 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -10,15 +10,18 @@
 //! [core X11 protocol]: super
 
 use crate::{
-	set::Attributes,
+	message::Event,
+	set::{Attributes, WindowConfig},
 	unit::Px,
 	visual::VisualId,
-	x11::error,
+	x11::{error, reply},
 	Any,
 	Atom,
 	CopyableFromParent,
 	CurrentableTime,
+	DestinationWindow,
 	Drawable,
+	EventMask,
 	Point,
 	Rectangle,
 	String8,
@@ -39,9 +42,7 @@ use xrbk::{
 	X11Size,
 };
 
-use crate::{set::WindowConfig, x11::reply};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
-
 extern crate self as xrb;
 
 /// An [error] generated because of a failed [`CreateWindow` request].
@@ -240,9 +241,9 @@ derive_xrb! {
 	/// [attributes]: Attributes
 	///
 	/// [`event_mask`]: Attributes::event_mask
-	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
-	/// [`RESIZE_REDIRECT`]: crate::EventMask::RESIZE_REDIRECT
-	/// [`BUTTON_PRESS`]: crate::EventMask::BUTTON_PRESS
+	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
+	/// [`RESIZE_REDIRECT`]: EventMask::RESIZE_REDIRECT
+	/// [`BUTTON_PRESS`]: EventMask::BUTTON_PRESS
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ChangeWindowAttributes: Request(2, ChangeWindowAttributesError) {
 		/// The [window] which the `attributes` are changed on.
@@ -552,7 +553,7 @@ derive_xrb! {
 	///
 	/// [`override_redirect` attribute]: Attributes::override_redirect
 	///
-	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
 	///
 	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
@@ -830,7 +831,7 @@ derive_xrb! {
 	///
 	/// [circulates]: CirculateDirection
 	///
-	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
 	///
 	/// [`CirculateWindowRequest` event]: super::event::CirculateWindowRequest
 	/// [`Circulate` event]: super::event::Circulate
@@ -1576,3 +1577,164 @@ derive_xrb! {
 		pub target: Atom,
 	}
 }
+
+/// An [error] generated because of a failed [`ConvertSelection` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`ConvertSelection` request]: ConvertSelection
+pub enum ConvertSelectionError {
+	/// An [`Atom` error].
+	///
+	/// [`Atom` error]: error::Atom
+	Atom(error::Atom),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that asks the given selection's owner to convert it to the
+	/// given `target_type`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `requester` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Atom` error] is generated if any `selection`, `target_type`, or
+	/// `property` do not refer to defined [atoms].
+	///
+	/// [window]: Window
+	/// [atoms]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ConvertSelection: Request(24, ConvertSelectionError) {
+		/// Your [window] which is requesting this conversion.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub requester: Window,
+
+		/// The selection which this [request] asks to be converted.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub selection: Atom,
+
+		/// The type which the selection should be converted into.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		///
+		/// [`Atom` error]: error::Atom
+		pub target_type: Atom,
+		pub property: Option<Atom>,
+
+		/// The time at which this conversion is recorded as having taken place.
+		pub time: CurrentableTime,
+	}
+}
+
+/// An [error] generated because of a failed [`SendEvent` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`SendEvent` request]: SendEvent
+pub enum SendEventError {
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that sends the given [event] to the given [window].
+	///
+	/// If the `event_mask` is empty, the [event] is sent to the client that
+	/// created the [window] - if that client no longer exists, the [event] is
+	/// not sent.
+	///
+	/// If `propagate` is `false`, the [event] is sent to every client selecting
+	/// any of the [events][event] indicated in the `event_mask`.
+	///
+	/// If `propagate` is `true` and no clients have selected any of the
+	/// [events][event] indicated in the `event_mask` on the [window], the
+	/// [event] is sent to the closest ancestor [window] of the [window] which
+	/// some client has selected at least one of the indicated [events][event]
+	/// for (provided no [window] between the original destination and the
+	/// closest ancestor have that [event] in their [`do_not_propagate_mask`]).
+	/// The [event] is sent to every client selecting any of the [events][event]
+	/// indicated in the `event_mask` on the final destination.
+	///
+	/// Active [grabs] are ignored for this [request].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `destination` is [`DestinationWindow::Other`] and the
+	/// specified [window] is not defined.
+	///
+	/// [window]: Window
+	/// [event]: Event
+	/// [request]: crate::message::Request
+	/// [grabs]: crate::GrabMode
+	///
+	/// [`Window` error]: error::Window
+	// FIXME: this requires that the event is absolutely 32 bytes, which is
+	//        currently not bounded.
+	//
+	// This feature would be nice for this:
+	// <https://github.com/rust-lang/rust/issues/92827>
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SendEvent<E: Event>: Request(25, SendEventError) {
+		/// Whether the `event` should be propagated to the closest appropriate
+		/// ancestor, if necessary.
+		///
+		/// That is, whether the `event` should be propagated to the closest
+		/// ancestor of the `destination` [window] which some client has
+		/// selected any of the [events] indicated in the `event_mask` on if no
+		/// clients have selected any of the [events] in the `event_mask` on the
+		/// `destination` [window].
+		///
+		/// [window]: Window
+		/// [events]: Event
+		#[metabyte]
+		pub propagate: bool,
+
+		/// The destination [window] for the `event`.
+		///
+		/// [window]: Window
+		pub destination: DestinationWindow,
+
+		/// The mask of [events][event] which should be selected for the [event]
+		/// to be sent to the selecting clients.
+		///
+		/// [event]: Event
+		pub event_mask: EventMask,
+
+		/// The [event] that is sent.
+		///
+		/// [event]: Event
+		pub event: E,
+	}
+}

From c4b94de7cb177442a0fede656071626d5c40c7ce Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 19:27:31 +0000
Subject: [PATCH 028/157] docs - fix some request links

---
 src/x11.rs         |  8 ++++----
 src/x11/request.rs | 40 +++++++++++++++++++++++++++++++++-------
 2 files changed, 37 insertions(+), 11 deletions(-)

diff --git a/src/x11.rs b/src/x11.rs
index 55dad0ee..5afd28a7 100644
--- a/src/x11.rs
+++ b/src/x11.rs
@@ -5,10 +5,10 @@
 //! Messages defined in the core X11 protocol: [requests], [replies], [events],
 //! and [errors].
 //!
-//! [requests]: x11::request
-//! [replies]: x11::reply
-//! [events]: x11::event
-//! [errors]: x11::error
+//! [requests]: request
+//! [replies]: reply
+//! [events]: event
+//! [errors]: error
 
 pub mod error;
 pub mod event;
diff --git a/src/x11/request.rs b/src/x11/request.rs
index d1d6a286..5e42c8bb 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -866,7 +866,7 @@ derive_xrb! {
 	/// It is legal to pass an [`InputOnly`] [window] as a [drawable] to this
 	/// [request].
 	///
-	/// # Reply
+	/// # Replies
 	/// This [request] generates a [`GetGeometry` reply].
 	///
 	/// # Errors
@@ -904,7 +904,7 @@ derive_xrb! {
 	/// A [request] that returns the root [window], the parent, and the children
 	/// of the given [window].
 	///
-	/// # Reply
+	/// # Replies
 	/// This [request] generates a [`QueryWindowTree` reply].
 	///
 	/// # Errors
@@ -942,7 +942,7 @@ derive_xrb! {
 	/// [atom] by the specified `name` already exists, that [atom] will be
 	/// returned.
 	///
-	/// # Reply
+	/// # Replies
 	/// This [request] generates a [`GetAtom` reply].
 	///
 	/// [atom]: Atom
@@ -986,6 +986,9 @@ derive_xrb! {
 
 	/// A [request] that returns the name of the given [atom].
 	///
+	/// # Replies
+	/// This [request] generates a [`GetAtomName` reply].
+	///
 	/// # Errors
 	/// An [`Atom` error] is generated if the `target` does not refer to a
 	/// defined [atom].
@@ -993,6 +996,8 @@ derive_xrb! {
 	/// [atom]: Atom
 	/// [request]: crate::message::Request
 	///
+	/// [`GetAtomName` reply]: reply::GetAtomName
+	///
 	/// [`Atom` error]: error::Atom
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetAtomName: Request(17, error::Atom) -> reply::GetAtomName {
@@ -1372,6 +1377,9 @@ derive_xrb! {
 	/// A [request] that gets the value of the given `property` on the given
 	/// [window].
 	///
+	/// # Replies
+	/// This [request] generates a [`GetProperty` reply].
+	///
 	/// # Errors
 	/// A [`Window` error] is generated if `target` does not refer to a defined
 	/// [window].
@@ -1383,6 +1391,8 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	/// [atoms]: Atom
 	///
+	/// [`GetProperty` reply]: reply::GetProperty
+	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
@@ -1449,6 +1459,9 @@ derive_xrb! {
 	/// A [request] that returns the list of properties defined for the given
 	/// [window].
 	///
+	/// # Replies
+	/// This [request] generates a [`ListProperties` reply].
+	///
 	/// # Errors
 	/// A [`Window` error] is generated if `target` does not refer to a defined
 	/// [window].
@@ -1456,6 +1469,8 @@ derive_xrb! {
 	/// [window]: Window
 	/// [request]: crate::message::Request
 	///
+	/// [`ListProperties` reply]: reply::ListProperties
+	///
 	/// [`Window` error]: error::Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ListProperties: Request(21, error::Window) -> reply::ListProperties {
@@ -1550,16 +1565,24 @@ derive_xrb! {
 		/// If this time is earlier than the server's current 'last-change' time
 		/// for the selection's owner, or this time is later than the server's
 		/// current time, this [request] has no effect.
+		///
+		/// [request]: crate::message::Request
 		pub time: CurrentableTime,
 	}
 
 	/// A [request] that returns the owner of a given selection.
 	///
+	/// # Replies
+	/// This [request] generates a [`GetSelectionOwner` reply].
+	///
 	/// # Errors
 	/// An [`Atom` error] is generated if `target` does not refer to a defined
 	/// [atom].
 	///
 	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`GetSelectionOwner` reply]: reply::GetSelectionOwner
 	///
 	/// [`Atom` error]: error::Atom
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
@@ -1683,10 +1706,11 @@ derive_xrb! {
 	/// [events][event] indicated in the `event_mask` on the [window], the
 	/// [event] is sent to the closest ancestor [window] of the [window] which
 	/// some client has selected at least one of the indicated [events][event]
-	/// for (provided no [window] between the original destination and the
-	/// closest ancestor have that [event] in their [`do_not_propagate_mask`]).
-	/// The [event] is sent to every client selecting any of the [events][event]
-	/// indicated in the `event_mask` on the final destination.
+	/// for (provided no [windows][window] between the original destination and
+	/// the closest ancestor have that [event] in their
+	/// [`do_not_propagate_mask`]). The [event] is sent to every client
+	/// selecting any of the [events][event] indicated in the `event_mask` on
+	/// the final destination.
 	///
 	/// Active [grabs] are ignored for this [request].
 	///
@@ -1699,6 +1723,8 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	/// [grabs]: crate::GrabMode
 	///
+	/// [`do_not_propagate_mask`]: Attributes::do_not_propagate_mask
+	///
 	/// [`Window` error]: error::Window
 	// FIXME: this requires that the event is absolutely 32 bytes, which is
 	//        currently not bounded.

From 7c66e2500996027a43e721b149c892334104159d Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 20:40:12 +0000
Subject: [PATCH 029/157] GrabCursor request + reply, UngrabCursor request

---
 src/common.rs      |  26 +++++++
 src/x11/reply.rs   |  33 +++++++++
 src/x11/request.rs | 172 ++++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 230 insertions(+), 1 deletion(-)

diff --git a/src/common.rs b/src/common.rs
index 92156c49..1ddaee4a 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -165,6 +165,32 @@ pub enum GrabMode {
 	Ungrab,
 }
 
+/// The status of an attempted grab.
+#[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
+pub enum GrabStatus {
+	/// The grab was successful.
+	Success,
+
+	/// Another client already had a grab.
+	AlreadyGrabbed,
+	/// Another client already had an active grab and had frozen [event]
+	/// processing.
+	///
+	/// [event]: crate::message::Event
+	Frozen,
+	/// The given time was either earlier than the previous grab, or later than
+	/// the X server's [current time].
+	///
+	/// [current time]: CurrentableTime::CurrentTime
+	InvalidTime,
+	/// The grabbed [window] or the [window] which the cursor was confined to is
+	/// not viewable, or the [window] which the cursor was confined to is
+	/// completely outside of the root [window].
+	///
+	/// [window]: Window
+	NotViewable,
+}
+
 #[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
 pub enum StackMode {
 	Above,
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 1b75eea9..8f4df67a 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -20,6 +20,7 @@ use crate::{
 	Colormap,
 	DeviceEventMask,
 	EventMask,
+	GrabStatus,
 	MaintainContents,
 	Rectangle,
 	String8,
@@ -511,4 +512,36 @@ derive_xrb! {
 		pub owner: Option<Window>,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GrabCursor` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GrabCursor` request]: request::GrabCursor
+	#[doc(alias = "GrabPointer")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GrabCursor: Reply for request::GrabCursor {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The status of the attempted grab.
+		///
+		/// See [`GrabStatus`] for more information.
+		#[doc(alias = "status")]
+		#[metabyte]
+		pub grab_status: GrabStatus,
+
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 5e42c8bb..aaf91a73 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -19,9 +19,12 @@ use crate::{
 	Atom,
 	CopyableFromParent,
 	CurrentableTime,
+	CursorAppearance,
+	CursorEventMask,
 	DestinationWindow,
 	Drawable,
 	EventMask,
+	GrabMode,
 	Point,
 	Rectangle,
 	String8,
@@ -1721,7 +1724,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [event]: Event
 	/// [request]: crate::message::Request
-	/// [grabs]: crate::GrabMode
+	/// [grabs]: GrabMode
 	///
 	/// [`do_not_propagate_mask`]: Attributes::do_not_propagate_mask
 	///
@@ -1764,3 +1767,170 @@ derive_xrb! {
 		pub event: E,
 	}
 }
+
+/// An [error] generated because of a failed [`GrabCursor` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`GrabCursor` request]: GrabCursor
+#[doc(alias = "GrabPointerError")]
+pub enum GrabCursorError {
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[doc(alias = "Cursor")]
+	CursorAppearance(error::CursorAppearance),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] to actively grab control of the cursor.
+	///
+	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
+	///
+	/// # Replies
+	/// This [request] generates a [`GrabCursor` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `grab_window` or the
+	/// `confine_to` [window] do not refer to defined [windows][window].
+	///
+	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
+	/// [`Some`] and does not refer to a defined [cursor appearance].
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`EnterWindow`]: super::event::EnterWindow
+	/// [`LeaveWindow`]: super::event::LeaveWindow
+	/// [`GrabCursor` reply]: reply::GrabCursor
+	///
+	/// [`Window` error]: error::Window
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[doc(alias = "GrabPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GrabCursor: Request(26, GrabCursorError) -> reply::GrabCursor {
+		/// Whether cursor [events] which would normally be reported to this
+		/// client are reported normally.
+		///
+		/// [events]: Event
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the cursor is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// grabbing client.
+		///
+		/// [events]: Event
+		pub event_mask: CursorEventMask,
+
+		/// The [grab mode] applied to the cursor.
+		///
+		/// For [`GrabMode::Asynchronous`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`GrabMode::Synchronous`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: Event
+		/// [grab mode]: GrabMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "pointer_mode")]
+		pub cursor_grab_mode: GrabMode,
+		/// The [grab mode] applied to the keyboard.
+		///
+		/// For [`GrabMode::Asynchronous`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`GrabMode::Synchronous`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: Event
+		/// [grab mode]: GrabMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_grab_mode: GrabMode,
+
+		/// Optionally confines the cursor to the given [window].
+		///
+		/// This [window] does not need to have any relation to the
+		/// `grab_window`.
+		///
+		/// The cursor will be warped to the closest edge of this [window] if it
+		/// is not already within it. Subsequent changes to the configuration of
+		/// the [window] which cause the cursor to be outside of the [window]
+		/// will also trigger the cursor to be warped to the [window] again.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] and does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub confine_to: Option<Window>,
+
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias = "cursor")]
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The time at which this grab is recorded as having initiated.
+		pub time: CurrentableTime,
+	}
+
+	/// A [request] that ends a cursor grab if this client has it actively
+	/// grabbed.
+	///
+	/// Any queued [events] are released.
+	///
+	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
+	///
+	/// [request]: crate::message::Request
+	/// [events]: Event
+	///
+	/// [`EnterWindow`]: super::event::EnterWindow
+	/// [`LeaveWindow`]: super::event::LeaveWindow
+	#[doc(alias = "UngrabPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UngrabCursor: Request(27) {
+		/// The time at which the grab is recorded as having ceased.
+		pub time: CurrentableTime,
+	}
+}

From 0d3e97e1a196b30819255227dd3fec6fe9cae33b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 23 Jan 2023 21:17:48 +0000
Subject: [PATCH 030/157] FreezeMode for grabs

---
 src/common.rs      | 16 ++++++++++++++++
 src/x11/request.rs | 25 ++++++++++++-------------
 2 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 1ddaee4a..bbe28c6c 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -165,6 +165,22 @@ pub enum GrabMode {
 	Ungrab,
 }
 
+/// Whether a grab causes a freeze in [event] processing.
+///
+/// [event]: crate::message::Event
+#[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
+pub enum FreezeMode {
+	/// [Event] processing is not frozen.
+	///
+	/// [Event]: crate::message::Event
+	Unfrozen,
+
+	/// [Event] processing is frozen.
+	///
+	/// [Event]: crate::message::Event
+	Frozen,
+}
+
 /// The status of an attempted grab.
 #[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
 pub enum GrabStatus {
diff --git a/src/x11/request.rs b/src/x11/request.rs
index aaf91a73..7326e967 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -24,7 +24,7 @@ use crate::{
 	DestinationWindow,
 	Drawable,
 	EventMask,
-	GrabMode,
+	FreezeMode,
 	Point,
 	Rectangle,
 	String8,
@@ -1715,7 +1715,7 @@ derive_xrb! {
 	/// selecting any of the [events][event] indicated in the `event_mask` on
 	/// the final destination.
 	///
-	/// Active [grabs] are ignored for this [request].
+	/// Active grabs are ignored for this [request].
 	///
 	/// # Errors
 	/// A [`Window` error] is generated if the `destination` is [`DestinationWindow::Other`] and the
@@ -1724,7 +1724,6 @@ derive_xrb! {
 	/// [window]: Window
 	/// [event]: Event
 	/// [request]: crate::message::Request
-	/// [grabs]: GrabMode
 	///
 	/// [`do_not_propagate_mask`]: Attributes::do_not_propagate_mask
 	///
@@ -1842,40 +1841,40 @@ derive_xrb! {
 		/// [events]: Event
 		pub event_mask: CursorEventMask,
 
-		/// The [grab mode] applied to the cursor.
+		/// The [freeze mode] applied to the cursor.
 		///
-		/// For [`GrabMode::Asynchronous`], cursor [event] processing continues
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
 		/// as normal.
 		///
-		/// For [`GrabMode::Synchronous`], cursor [event] processing appears to
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
 		/// freeze - cursor [events][event] generated during this time are not
 		/// lost: they are queued to be processed later. The freeze ends when
 		/// either the grabbing client sends an [`AllowEvents` request], or when
 		/// the cursor grab is released.
 		///
 		/// [event]: Event
-		/// [grab mode]: GrabMode
+		/// [freeze mode]: FreezeMode
 		///
 		/// [`AllowEvents` request]: AllowEvents
 		#[doc(alias = "pointer_mode")]
-		pub cursor_grab_mode: GrabMode,
-		/// The [grab mode] applied to the keyboard.
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
 		///
-		/// For [`GrabMode::Asynchronous`], keyboard [event] processing
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
 		/// continues as normal.
 		///
-		/// For [`GrabMode::Synchronous`], keyboard [event] processing appears
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
 		/// to freeze - keyboard [events][event] generated during this time are
 		/// not lost: they are queued to be processed later. The freeze ends
 		/// when either the grabbing client sends an [`AllowEvents` request], or
 		/// when the keyboard grab is released.
 		///
 		/// [event]: Event
-		/// [grab mode]: GrabMode
+		/// [freeze mode]: FreezeMode
 		///
 		/// [`AllowEvents` request]: AllowEvents
 		#[doc(alias = "keyboard_mode")]
-		pub keyboard_grab_mode: GrabMode,
+		pub keyboard_freeze: FreezeMode,
 
 		/// Optionally confines the cursor to the given [window].
 		///

From 63da40128ceb4cc563add900af3552f7d22ecac4 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 09:24:31 +0000
Subject: [PATCH 031/157] Update src/x11/request.rs

---
 src/x11/request.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 7326e967..e9d866bd 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -530,7 +530,7 @@ derive_xrb! {
 
 		/// The `target`'s new coordinates relative to its `new_parent`'s
 		/// top-left corner.
-		#[doc(alias = "x", alias = "y")]
+		#[doc(alias("x", "y"))]
 		pub coords: Point,
 	}
 

From 25388e0a769ff16cd6c2e89f5593a18d198b49fa Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 09:24:51 +0000
Subject: [PATCH 032/157] Update src/x11/request.rs

---
 src/x11/request.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index e9d866bd..6149bd24 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -777,7 +777,7 @@ derive_xrb! {
 		/// [`InputOnly`]: WindowClass::InputOnly
 		///
 		/// [`Match` error]: error::Match
-		#[doc(alias = "values")]
+		#[doc(alias("values", "value_mask", "value_list", "window_config"))]
 		pub config: WindowConfig,
 	}
 }

From d75065e0dad6151b28b3e6f087bfb25e1f5e103f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 11:47:09 +0000
Subject: [PATCH 033/157] GrabButton and UngrabButton requests

---
 src/common.rs                      |   2 +
 src/x11/request.rs                 | 255 ++++++++++++++++++++++++++++-
 xrbk_macro/src/source/expansion.rs |   1 +
 3 files changed, 257 insertions(+), 1 deletion(-)

diff --git a/src/common.rs b/src/common.rs
index bbe28c6c..8d59dcb8 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -173,11 +173,13 @@ pub enum FreezeMode {
 	/// [Event] processing is not frozen.
 	///
 	/// [Event]: crate::message::Event
+	#[doc(alias = "Asynchronous")]
 	Unfrozen,
 
 	/// [Event] processing is frozen.
 	///
 	/// [Event]: crate::message::Event
+	#[doc(alias = "Synchronous")]
 	Frozen,
 }
 
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6149bd24..62bf3b4c 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -16,7 +16,9 @@ use crate::{
 	visual::VisualId,
 	x11::{error, reply},
 	Any,
+	AnyModifierKeyMask,
 	Atom,
+	Button,
 	CopyableFromParent,
 	CurrentableTime,
 	CursorAppearance,
@@ -1929,7 +1931,258 @@ derive_xrb! {
 	#[doc(alias = "UngrabPointer")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UngrabCursor: Request(27) {
-		/// The time at which the grab is recorded as having ceased.
+		/// The time at which the grab is recorded as having been released.
 		pub time: CurrentableTime,
 	}
 }
+
+/// An [error] generated because of a failed [`GrabButton` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`GrabButton` request]: GrabButton
+pub enum GrabButtonError {
+	/// An [`Access` error].
+	///
+	/// [`Access` error]: error::Access
+	Access(error::Access),
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	CursorAppearance(error::CursorAppearance),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that establishes a passive cursor grab.
+	///
+	/// If the following conditions are true, the grab is converted into an
+	/// active cursor grab (as described in the [`GrabCursor` request]):
+	/// - the cursor is not already actively grabbed; and
+	/// - the specified `button` and specified `modifiers` are held; and
+	/// - the cursor is within the `grab_window`; and
+	/// - if the `confine_to` [window] is specified, it is viewable; and
+	/// - a passive grab for the same `button` and `modifiers` combination does
+	///   not exist for any ancestor of the `grab_window`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `grab_window` or the
+	/// `confine_to` [window] do not refer to defined [windows][window].
+	///
+	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
+	/// [`Some`] and does not refer to a defined [cursor appearance].
+	///
+	/// An [`Access` error] is generated if some other client has already sent a
+	/// `GrabButton` [request] with the same `button` and `modifiers`
+	/// combination on the same `grab_window`.
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GrabCursor` request]: GrabCursor
+	///
+	/// [`Access` error]: error::Access
+	/// [`Window` error]: error::Window
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GrabButton: Request(28, GrabButtonError) {
+		/// Whether cursor [events] which would normally be reported to this
+		/// client are reported normally.
+		///
+		/// [events]: Event
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the `button` is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// grabbing client.
+		///
+		/// [events]: Event
+		pub event_mask: CursorEventMask,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "pointer_mode")]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+
+		/// Optionally confines the cursor to the given [window].
+		///
+		/// This [window] does not need to have any relation to the
+		/// `grab_window`.
+		///
+		/// The cursor will be warped to the closest edge of this [window] if it
+		/// is not already within it. Subsequent changes to the configuration of
+		/// the [window] which cause the cursor to be outside of the [window]
+		/// will also trigger the cursor to be warped to the [window] again.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] and does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub confine_to: Option<Window>,
+
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The [button] for which this grab is established.
+		///
+		/// [`Any`] means that the grab is effectively established for all
+		/// possible [buttons][button].
+		///
+		/// When this button and the given `modifiers`,
+		///
+		/// [button]: Button
+		///
+		/// [`Any`]: Any::Any
+		pub button: Any<Button>,
+		_,
+
+		/// The combination of modifiers which must be held for a press of the
+		/// `button` to activate the active cursor grab.
+		///
+		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
+		/// at all.
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+	}
+}
+
+/// An [error] generated because of a failed [`UngrabButton` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`UngrabButton` request]: UngrabButton
+pub enum UngrabButtonError {
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] which releases a [passive button grab] by this client on the
+	/// specified `grab_window` if the grab was established by your client.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [passive button grab]: GrabButton
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UngrabButton: Request(29, UngrabButtonError) {
+		/// The [button] which the [passive button grab] was established for.
+		///
+		/// [`Any`] matches any `button` specified in the [passive button grab].
+		/// It is equivalent to sending this `UngrabButton` [request] for all
+		/// possible [buttons][button].
+		///
+		/// [button]: Button
+		/// [request]: crate::message::Request
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub button: Any<Button>,
+
+		/// The [window] on which the [passive button grab] was established.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The modifier combination specified by the [passive button grab].
+		///
+		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
+		/// [passive button grab] (including no modifiers). It is equivalent to
+		/// sending this `UngrabButton` [request] for all possible `modifiers`
+		/// combinations.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		[_; 2],
+	}
+}
diff --git a/xrbk_macro/src/source/expansion.rs b/xrbk_macro/src/source/expansion.rs
index 16ad05b8..c558aec4 100644
--- a/xrbk_macro/src/source/expansion.rs
+++ b/xrbk_macro/src/source/expansion.rs
@@ -84,6 +84,7 @@ impl Source {
 
 		tokens.append_tokens({
 			quote_spanned!(ident.span()=>
+				#[inline]
 				fn #ident(#args) -> #return_type {
 					#expr
 				}

From 85833553fc7ae5fd3c51dff5c88352acd98c3e8e Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 11:55:49 +0000
Subject: [PATCH 034/157] improve doc aliases for requests + replies

---
 src/x11/reply.rs   |  9 ++++++---
 src/x11/request.rs | 14 ++++++++------
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 8f4df67a..d3597817 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -232,6 +232,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetGeometry` request]: request::GetGeometry
+	#[doc(alias("GetX", "GetY", "GetWidth", "GetHeight", "GetBorderWidth"))]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetGeometry: Reply for request::GetGeometry {
@@ -270,7 +271,7 @@ derive_xrb! {
 		/// [window]: Window
 		/// [pixmap]: create::Pixmap
 		/// [drawable]: crate::Drawable
-		#[doc(alias = "x", alias = "y", alias = "width", alias = "height")]
+		#[doc(alias("x", "y", "width", "height"))]
 		pub geometry: Rectangle,
 		/// The width of the [drawable]'s border.
 		///
@@ -287,7 +288,9 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`QueryWindowTree` request]: request::QueryWindowTree
-	#[doc(alias = "QueryTree")]
+	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
+	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
+	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
@@ -330,7 +333,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetAtom` request]: request::GetAtom
-	#[doc(alias = "InternAtom")]
+	#[doc(alias("InternAtom", "CreateAtom"))]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetAtom: Reply for request::GetAtom {
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 62bf3b4c..67fc9746 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -191,7 +191,7 @@ derive_xrb! {
 		///
 		/// [window]: Window
 		/// [attributes]: Attributes
-		#[doc(alias = "values")]
+		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
 		pub attributes: Attributes,
 	}
 }
@@ -260,7 +260,7 @@ derive_xrb! {
 		/// The [attributes] which are changed.
 		///
 		/// [attributes]: Attributes
-		#[doc(alias = "values")]
+		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
 		pub attributes: Attributes,
 	}
 
@@ -922,7 +922,9 @@ derive_xrb! {
 	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
 	///
 	/// [`Window` error]: error::Window
-	#[doc(alias = "QueryTree")]
+	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
+	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
+	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
 		/// The [window] for which this [request] gets its root [window],
@@ -954,7 +956,7 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	///
 	/// [`GetAtom` reply]: reply::GetAtom
-	#[doc(alias = "InternAtom")]
+	#[doc(alias("InternAtom", "CreateAtom"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetAtom: Request(16, error::Value) -> reply::GetAtom {
 		#[metabyte]
@@ -1194,7 +1196,7 @@ derive_xrb! {
 	/// An [`Atom` error] is generated if either `property` or `type` do not
 	/// refer to defined [windows][window].
 	///
-	/// If the `change_mode` is [`Prepend`] or [`Append`], the `type` and
+	/// If the `modify_mode` is [`Prepend`] or [`Append`], the `type` and
 	/// `format` must match that of the existing property's value, else a
 	/// [`Match` error] is generated.
 	///
@@ -1231,7 +1233,7 @@ derive_xrb! {
 		///
 		/// [`Match` error]: error::Match
 		#[doc(alias = "mode")]
-		pub change_mode: ModifyPropertyMode,
+		pub modify_mode: ModifyPropertyMode,
 
 		/// The [window] which the `property` is modified for.
 		///

From ec95d2ab94a991f8e947d11cb6a727a23e3a45f4 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 12:45:37 +0000
Subject: [PATCH 035/157] ChangeActiveCursorGrab  request

---
 src/x11/reply.rs   |   6 +--
 src/x11/request.rs | 101 ++++++++++++++++++++++++++++++++++++++++-----
 2 files changed, 93 insertions(+), 14 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index d3597817..5fca8e97 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -13,7 +13,7 @@
 
 use crate::{
 	unit::Px,
-	visual::{Color, VisualId},
+	visual::{ColorId, VisualId},
 	x11::request::{self, DataFormat, DataList},
 	Atom,
 	BitGravity,
@@ -139,11 +139,11 @@ derive_xrb! {
 		///
 		/// See [`Attributes::maintenance_fallback_color`] for more information.
 		///
-		/// [color]: Color
+		/// [color]: ColorId
 		///
 		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
 		#[doc(alias = "backing_pixel")]
-		pub maintenance_fallback_color: Color,
+		pub maintenance_fallback_color: ColorId,
 		/// Whether the X server should maintain the contents of [windows] under
 		/// this [window].
 		///
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 67fc9746..bb84e35e 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -1519,9 +1519,9 @@ derive_xrb! {
 	/// and the previous owner was not [`None`], then a [`SelectionClear` event]
 	/// is sent to the previous owner.
 	///
-	/// If the given `time` is earlier than time of the previous owner change or
-	/// is later than the X server's [current time], this [request] has no
-	/// effect.
+	/// If the given `time` is earlier than the [time] of the previous owner
+	/// change or is later than the X server's [current time], this [request]
+	/// has no effect.
 	///
 	/// # Errors
 	/// A [`Window` error] is generated if `owner` is [`Some`] but does not
@@ -1532,6 +1532,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [atom]: Atom
+	/// [time]: CurrentableTime
 	/// [request]: crate::message::Request
 	///
 	/// [current time]: CurrentableTime::CurrentTime
@@ -1567,12 +1568,14 @@ derive_xrb! {
 		/// [`Atom` error]: error::Atom
 		pub selection: Atom,
 
-		/// The time at which this change is recorded to occur at.
+		/// The [time] at which this change is recorded to occur at.
 		///
-		/// If this time is earlier than the server's current 'last-change' time
-		/// for the selection's owner, or this time is later than the server's
-		/// current time, this [request] has no effect.
+		/// If this [time] is earlier than the server's current 'last-change'
+		/// [time] for the selection's owner, or this [time] is later than the
+		/// server's [current time], this [request] has no effect.
 		///
+		/// [time]: CurrentableTime
+		/// [current time]: CurrentableTime::CurrentTime
 		/// [request]: crate::message::Request
 		pub time: CurrentableTime,
 	}
@@ -1678,7 +1681,10 @@ derive_xrb! {
 		pub target_type: Atom,
 		pub property: Option<Atom>,
 
-		/// The time at which this conversion is recorded as having taken place.
+		/// The [time] at which this conversion is recorded as having taken
+		/// place.
+		///
+		/// [time]: CurrentableTime
 		pub time: CurrentableTime,
 	}
 }
@@ -1840,7 +1846,7 @@ derive_xrb! {
 		pub grab_window: Window,
 
 		/// A mask of the cursor [events] which are to be reported to the
-		/// grabbing client.
+		/// your client.
 		///
 		/// [events]: Event
 		pub event_mask: CursorEventMask,
@@ -1914,7 +1920,9 @@ derive_xrb! {
 		#[doc(alias = "cursor")]
 		pub cursor_appearance: Option<CursorAppearance>,
 
-		/// The time at which this grab is recorded as having initiated.
+		/// The [time] at which this grab is recorded as having initiated.
+		///
+		/// [time]: CurrentableTime
 		pub time: CurrentableTime,
 	}
 
@@ -1933,7 +1941,9 @@ derive_xrb! {
 	#[doc(alias = "UngrabPointer")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UngrabCursor: Request(27) {
-		/// The time at which the grab is recorded as having been released.
+		/// The [time] at which the grab is recorded as having been released.
+		///
+		/// [time]: CurrentableTime
 		pub time: CurrentableTime,
 	}
 }
@@ -2188,3 +2198,72 @@ derive_xrb! {
 		[_; 2],
 	}
 }
+
+/// An [error] generated because of a failed [`ChangeActiveCursorGrab` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`ChangeActiveCursorGrab` request]: ChangeActiveCursorGrab
+#[doc(alias = "ChangeActivePointerGrabError")]
+pub enum ChangeActiveCursorGrabError {
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	CursorAppearance(error::CursorAppearance),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+}
+
+derive_xrb! {
+	/// A [request] which modifies the `event_mask` or `cursor_appearance` of an
+	/// [active cursor grab].
+	///
+	/// # Errors
+	/// A [`CursorAppearance` error] is generated if `cursor_appearance` does
+	/// not refer to a defined [cursor appearance].
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [request]: crate::message::Request
+	///
+	/// [active cursor grab]: GrabCursor
+	#[doc(alias = "ChangeActivePointerGrab")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeActiveCursorGrab: Request(30, ChangeActiveCursorGrabError) {
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// This replaces the previously specified `cursor_appearance` for the
+		/// grab - [`None`] means that the `cursor_appearance` is no longer
+		/// overridden.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias = "cursor")]
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The [time] at which this change is recorded as having taken place.
+		///
+		/// This must be later than the [time] of the last cursor grab, and
+		/// equal to or earlier than the X server's [current time].
+		///
+		/// [time]: CurrentableTime
+		/// [current time]: CurrentableTime::CurrentTime
+		pub time: CurrentableTime,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// your client.
+		///
+		/// [events]: Event
+		pub event_mask: CursorEventMask,
+		[_; 2],
+	}
+}

From 1c1bc0ba7cf96ffcde127b560651ddd919fa5318 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 13:22:59 +0000
Subject: [PATCH 036/157] GrabKeyboard request + reply & UngrabKeyboard request

---
 src/x11/reply.rs   |  31 +++++++++++
 src/x11/request.rs | 132 +++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 159 insertions(+), 4 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 5fca8e97..3851a981 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -547,4 +547,35 @@ derive_xrb! {
 
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GrabKeyboard` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GrabKeyboard` request]: GrabKeyboard
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GrabKeyboard: Reply for request::GrabKeyboard {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The status of the attempted grab.
+		///
+		/// See [`GrabStatus`] for more information.
+		#[doc(alias = "status")]
+		#[metabyte]
+		pub grab_status: GrabStatus,
+
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index bb84e35e..03eb61ad 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -1866,7 +1866,7 @@ derive_xrb! {
 		/// [freeze mode]: FreezeMode
 		///
 		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "pointer_mode")]
+		#[doc(alias("pointer_mode", "cursor_mode"))]
 		pub cursor_freeze: FreezeMode,
 		/// The [freeze mode] applied to the keyboard.
 		///
@@ -1920,14 +1920,13 @@ derive_xrb! {
 		#[doc(alias = "cursor")]
 		pub cursor_appearance: Option<CursorAppearance>,
 
-		/// The [time] at which this grab is recorded as having initiated.
+		/// The [time] at which this grab is recorded as having been initiated.
 		///
 		/// [time]: CurrentableTime
 		pub time: CurrentableTime,
 	}
 
-	/// A [request] that ends a cursor grab if this client has it actively
-	/// grabbed.
+	/// A [request] that ends an active cursor grab by your client.
 	///
 	/// Any queued [events] are released.
 	///
@@ -2267,3 +2266,128 @@ derive_xrb! {
 		[_; 2],
 	}
 }
+
+/// An [error] generated because of a failed [`GrabKeyboard` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`GrabKeyboard` request]: GrabKeyboard
+pub enum GrabKeyboardError {
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] to actively grab control of the keyboard.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// # Replies
+	/// This [request] generates a [`GrabKeyboard` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Focus`]: super::event::Focus
+	/// [`Unfocus`]: super::event::Unfocus
+	///
+	/// [`GrabKeyboard` reply]: reply::GrabKeyboard
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GrabKeyboard: Request(31, GrabKeyboardError) -> reply::GrabKeyboard {
+		/// Whether key [events] which would normally be reported to this client
+		/// are reported normally.
+		///
+		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
+		/// matter what events you have selected.
+		///
+		/// [events]: Event
+		///
+		/// [`KeyPress`]: super::event::KeyPress
+		/// [`KeyRelease`]: super::event::KeyRelease
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the keyboard is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The [time] at which this grab is recorded as having been initiated.
+		///
+		/// [time]: CurrentableTime
+		pub time: CurrentableTime,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+		[_; 2],
+	}
+
+	/// A [request] that ends an active keyboard grab by your client.
+	///
+	/// Any queued [events] are released.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// [request]: crate::message::Request
+	/// [events]: Event
+	///
+	/// [`Focus`]: super::event::Focus
+	/// [`Unfocus`]: super::event::Unfocus
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UngrabKeyboard: Request(32) {
+		/// The [time] at which the grab is recorded as having been released.
+		///
+		/// [time]: CurrentableTime
+		pub time: CurrentableTime,
+	}
+}

From 4851640707c4b5d9236ea689a3597a155c9fa92f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 14:02:05 +0000
Subject: [PATCH 037/157] GrabKey + UngrabKey requests

---
 src/x11/reply.rs   |   2 +-
 src/x11/request.rs | 232 ++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 231 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 3851a981..e3ceabe2 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -552,7 +552,7 @@ derive_xrb! {
 	///
 	/// [reply]: crate::message::Reply
 	///
-	/// [`GrabKeyboard` request]: GrabKeyboard
+	/// [`GrabKeyboard` request]: request::GrabKeyboard
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GrabKeyboard: Reply for request::GrabKeyboard {
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 03eb61ad..041fe0f1 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -27,6 +27,7 @@ use crate::{
 	Drawable,
 	EventMask,
 	FreezeMode,
+	Keycode,
 	Point,
 	Rectangle,
 	String8,
@@ -1050,6 +1051,12 @@ pub enum ModifyPropertyError {
 
 /// Whether a property is [replaced], [prepended] to a [window]'s list of
 /// properties, or [appended] to the [window]'s list of properties.
+///
+/// [replaced]: ModifyPropertyMode::Replace
+/// [prepended]: ModifyPropertyMode::Prepend
+/// [appended]: ModifyPropertyMode::Append
+///
+/// [window]: Window
 #[doc(alias = "ChangePropertyMode")]
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub enum ModifyPropertyMode {
@@ -1203,6 +1210,9 @@ derive_xrb! {
 	/// [window]: Window
 	/// [request]: crate::message::Request
 	///
+	/// [`Prepend`]: ModifyPropertyMode::Prepend
+	/// [`Append`]: ModifyPropertyMode::Append
+	///
 	/// [`Property` event]: super::event::Property
 	///
 	/// [`Window` error]: error::Window
@@ -1228,6 +1238,7 @@ derive_xrb! {
 		///
 		/// [window]: Window
 		///
+		/// [`Replace`]: ModifyPropertyMode::Replace
 		/// [`Prepend`]: ModifyPropertyMode::Prepend
 		/// [`Append`]: ModifyPropertyMode::Append
 		///
@@ -1434,6 +1445,7 @@ derive_xrb! {
 		/// An [`Atom` error] is generated if this does not refer to a defined
 		/// [atom].
 		///
+		/// [atom]: Atom
 		/// [request]: crate::message::Request
 		pub property: Atom,
 		/// The property type to filter the [window]'s properties by.
@@ -1972,7 +1984,8 @@ pub enum GrabButtonError {
 }
 
 derive_xrb! {
-	/// A [request] that establishes a passive cursor grab.
+	/// A [request] that establishes a passive cursor grab for a given `button`
+	/// and `modifiers` combination.
 	///
 	/// If the following conditions are true, the grab is converted into an
 	/// active cursor grab (as described in the [`GrabCursor` request]):
@@ -2044,7 +2057,7 @@ derive_xrb! {
 		/// [freeze mode]: FreezeMode
 		///
 		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "pointer_mode")]
+		#[doc(alias("pointer_mode", "cursor_mode"))]
 		pub cursor_freeze: FreezeMode,
 		/// The [freeze mode] applied to the keyboard.
 		///
@@ -2227,6 +2240,8 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	///
 	/// [active cursor grab]: GrabCursor
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
 	#[doc(alias = "ChangeActivePointerGrab")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ChangeActiveCursorGrab: Request(30, ChangeActiveCursorGrabError) {
@@ -2391,3 +2406,216 @@ derive_xrb! {
 		pub time: CurrentableTime,
 	}
 }
+
+/// An [error] generated because of a failed [`GrabKey` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`GrabKey` request]: GrabKey
+pub enum GrabKeyError {
+	/// An [`Access` error].
+	///
+	/// [`Access` error]: error::Access
+	Access(error::Access),
+	/// A [`CursorAppearance` error].
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	CursorAppearance(error::CursorAppearance),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] that establishes a passive key grab for a particular `key`
+	/// and `modifiers` combination.
+	///
+	/// If the following conditions are true, the grab is converted into an
+	/// active keyboard grab (as described in the [`GrabKeyboard` request]):
+	/// - the keyboard is not already actively grabbed; and
+	/// - the specified `key` and specified `modifiers` are held; and
+	/// - either the `grab_window` is an ancestor, or is, the currently focused
+	///   [window], or the `grab_window` is a descendent of the currently
+	///   focused [window] and contains the cursor; and
+	/// - a passive grab for the same `key` and `modifiers` combination does
+	///   not exist for any ancestor of the `grab_window`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Access` error] is generated if some other client has already sent a
+	/// `GrabKey` [request] with the same `key` and `modifiers` combination on
+	/// the same `grab_window`.
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GrabKeyboard` request]: GrabKeyboard
+	///
+	/// [`Access` error]: error::Access
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GrabKey: Request(33, GrabKeyError) {
+		/// Whether key [events] which would normally be reported to this client
+		/// are reported normally.
+		///
+		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
+		/// matter what events you have selected.
+		///
+		/// [events]: Event
+		///
+		/// [`KeyPress`]: super::event::KeyPress
+		/// [`KeyRelease`]: super::event::KeyRelease
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the `key` is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The combination of modifiers which must be held for a press of the
+		/// `key` to activate the active key grab.
+		///
+		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
+		/// at all.
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		/// The key for which this grab is established.
+		///
+		/// [`Any`] means that the grab is effectively established for all
+		/// possible keys.
+		///
+		/// When this key and the given `modifiers`,
+		///
+		/// [button]: Button
+		///
+		/// [`Any`]: Any::Any
+		pub key: Any<Keycode>,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+		[_; 3],
+	}
+}
+
+/// An [error] generated because of a failed [`UngrabKey` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`UngrabKey` request]: UngrabKey
+pub enum UngrabKeyError {
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Window),
+}
+
+derive_xrb! {
+	/// A [request] which releases a [passive key grab] on the specified
+	/// `grab_window` if the grab was established by your client.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [passive key grab]: GrabKey
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UngrabKey: Request(34, UngrabKeyError) {
+		/// The key which the [passive key grab] was established for.
+		///
+		/// [`Any`] matches any `key` specified in the [passive key grab].
+		/// It is equivalent to sending this `UngrabKey` [request] for all
+		/// possible keys.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub key: Any<Keycode>,
+
+		/// The [window] on which the [passive key grab] was established.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The modifier combination specified by the [passive key grab].
+		///
+		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
+		/// [passive key grab] (including no modifiers). It is equivalent to
+		/// sending this `UngrabKey` [request] for all possible `modifiers`
+		/// combinations.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		[_; 2],
+	}
+}

From 08b094008bb6e987cc6de7b70ed37e1750dbf1a3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 14:39:01 +0000
Subject: [PATCH 038/157] AllowEvents request

---
 src/x11/request.rs | 101 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 101 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 041fe0f1..e0111758 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -2619,3 +2619,104 @@ derive_xrb! {
 		[_; 2],
 	}
 }
+
+/// Specifies the conditions under which queued events should be released for an
+/// [`AllowEvents` request].
+///
+/// [`AllowEvents` request]: AllowEvents
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum AllowEventsMode {
+	/// Unfreezes the cursor if it is frozen and you have active grab on the
+	/// cursor.
+	UnfreezeCursor,
+	/// Unfreezes the cursor, but freezes it again after the next
+	/// [`ButtonPress`] or [`ButtonRelease`].
+	///
+	/// Your client have an active grab on the cursor.
+	///
+	/// The cursor is frozen again specifically after the next [`ButtonPress`]
+	/// [`ButtonRelease`] event reported to your client which does not cause
+	/// grab to be released.
+	///
+	/// [`ButtonPress`]: super::event::ButtonPress
+	/// [`ButtonRelease`]: super::event::ButtonRelease
+	RefreezeCursor,
+	/// If the cursor is frozen as a result of the activation of a passive grab
+	/// or [`RefreezeCursor`] mode from your client, the grab is released and
+	/// the [event] is completely reprocessed.
+	///
+	/// [`RefreezeCursor`]: AllowEventsMode::RefreezeCursor
+	///
+	/// [event]: Event
+	ReplayCursor,
+
+	/// Unfreezes the keyboard if it is frozen and you have an active grab on
+	/// the keyboard.
+	UnfreezeKeyboard,
+	/// Unfreezes the keyboard, but freezes it again after the next
+	/// [`KeyPress`] or [`KeyPress`].
+	///
+	/// Your client have an active grab on the keyboard.
+	///
+	/// The keyboard is frozen again specifically after the next [`KeyPress`]
+	/// [`KeyRelease`] event reported to your client which does not cause
+	/// grab to be released.
+	///
+	/// [`KeyPress`]: super::event::KeyPress
+	/// [`KeyRelease`]: super::event::KeyRelease
+	RefreezeKeyboard,
+	/// If the keyboard is frozen as a result of the activation of a passive
+	/// grab or [`RefreezeKeyboard`] mode from your client, the grab is released
+	/// and the [event] is completely reprocessed.
+	///
+	/// [`RefreezeKeyboard`]: AllowEventsMode::RefreezeKeyboard
+	///
+	/// [event]: Event
+	ReplayKeyboard,
+
+	/// If both the cursor and the keyboard are frozen by your client, both are
+	/// unfrozen.
+	UnfreezeBoth,
+	/// If both the cursor and the keyboard are frozen by your client, both are
+	/// unfrozen but are both frozen again on the next button or key press or
+	/// release event.
+	///
+	/// Any [`ButtonPress`], [`ButtonRelease`], [`KeyPress`], or [`KeyRelease`]
+	/// event reported to your client will unfreeze both the cursor and the
+	/// keyboard.
+	///
+	/// [`ButtonPress`]: super::event::ButtonPress
+	/// [`ButtonRelease`]: super::event::ButtonRelease
+	///
+	/// [`KeyPress`]: super::event::KeyPress
+	/// [`KeyRelease`]: super::event::KeyRelease
+	RefreezeBoth,
+}
+
+derive_xrb! {
+	/// A [request] that releases some queued events if your client has caused a
+	/// device to be [frozen].
+	///
+	/// [frozen]: FreezeMode::Frozen
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AllowEvents: Request(35, error::Value) {
+		/// The conditions under which the queued [events] are released.
+		///
+		/// [events]: Event
+		#[metabyte]
+		pub mode: AllowEventsMode,
+
+		/// The [time] at which this `AllowEvents` [request] is recorded as
+		/// having taken place.
+		///
+		/// This [request] has no effect if this time is earlier than the time
+		/// of your most recent active grab or later than the X server's
+		/// [current time].
+		///
+		/// [request]: crate::message::Request
+		/// [time]: CurrentableTime
+		/// [current time]: CurrentableTime::CurrentTime
+		pub time: CurrentableTime,
+	}
+}

From 242c89ae23fd8a64ba41eab3dcd6169db2e942e3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 14:42:48 +0000
Subject: [PATCH 039/157] GrabServer + UngrabServer requests

---
 src/x11/request.rs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index e0111758..0a5594f9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -2719,4 +2719,14 @@ derive_xrb! {
 		/// [current time]: CurrentableTime::CurrentTime
 		pub time: CurrentableTime,
 	}
+
+	/// A [request] that freezes processing of [requests][request] and
+	/// connection closes on all other clients' connections.
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GrabServer: Request(36);
+
+	/// A [request] that unfreezes processing of [requests][request] and
+	/// connection closes on all other clients' connections.
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UngrabServer: Request(37);
 }

From 972aad48abe6c72c31e6553adf6783d18cffbb15 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 17:35:36 +0000
Subject: [PATCH 040/157] QueryCursorLocation request + reply

---
 src/common.rs      |  2 +-
 src/x11/event.rs   | 38 ++++++++++++++---------------
 src/x11/reply.rs   | 60 ++++++++++++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 35 +++++++++++++++++++++++----
 4 files changed, 111 insertions(+), 24 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 8d59dcb8..9d1ce918 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -393,7 +393,7 @@ impl ReadableWithContext for String16 {
 	Readable,
 	Writable,
 )]
-pub struct Point {
+pub struct Coords {
 	#[allow(missing_docs)]
 	pub x: Px<i16>,
 	#[allow(missing_docs)]
diff --git a/src/x11/event.rs b/src/x11/event.rs
index 860dff5e..a300c4b6 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -19,7 +19,7 @@ use crate::{
 	GrabMode,
 	Keycode,
 	ModifierMask,
-	Point,
+	Coords,
 	Rectangle,
 	Region,
 	StackMode,
@@ -99,12 +99,12 @@ derive_xrb! {
 		///
 		/// [event]: crate::message::Event
 		/// [window]: Window
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was
 		/// generated, relative to the `event_window`'s origin.
 		///
 		/// [event]: crate::message::Event
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of mouse buttons and modifier keys immediately
 		/// before this [event] was generated.
@@ -181,12 +181,12 @@ derive_xrb! {
 		///
 		/// [window]: Window
 		/// [event]: crate::message::Event
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was
 		/// generated, relative to the `event_window`'s origin.
 		///
 		/// [event]: crate::message::Event
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
@@ -263,12 +263,12 @@ derive_xrb! {
 		///
 		/// [event]: crate::message::Event
 		/// [window]: Window
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
 		/// [event]: crate::message::Event
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
@@ -344,12 +344,12 @@ derive_xrb! {
 		/// relative to the `root` window's origin.
 		///
 		/// [event]: crate::message::Event
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
 		/// [event]: crate::message::Event
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
@@ -393,7 +393,7 @@ pub enum MotionNotificationType {
 	/// [`MOTION_HINT`]: crate::EventMask::MOTION_HINT
 	/// [mouse button]: Button
 	///
-	/// [`QueryCursor`]: super::request::QueryCursor
+	/// [`QueryCursor`]: super::request::QueryCursorLocation
 	/// [`GetMotionEvents`]: super::request::GetMotionEvents
 	Hint,
 }
@@ -435,7 +435,7 @@ derive_xrb! {
 	/// [`MOTION_HINT`]: crate::EventMask::MOTION_HINT
 	///
 	/// [`Hint`]: MotionNotificationType::Hint
-	/// [`QueryCursor`]: super::request::QueryCursor
+	/// [`QueryCursor`]: super::request::QueryCursorLocation
 	/// [`GetMotionEvents`]: super::request::GetMotionEvents
 	///
 	/// [event]: crate::message::Event
@@ -488,12 +488,12 @@ derive_xrb! {
 		///
 		/// [event]: crate::message::Event
 		/// [window]: Window
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
 		/// [event]: crate::message::Event
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
@@ -687,7 +687,7 @@ derive_xrb! {
 		///
 		/// This is always the final position of the cursor, not its initial
 		/// position.
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The position of the cursor at the time this event was generated,
 		/// relative to the `event_window`'s origin, if the `event_window` is on
 		/// the [`SAME_SCREEN`].
@@ -699,7 +699,7 @@ derive_xrb! {
 		/// position.
 		///
 		/// [`SAME_SCREEN`]: EnterLeaveMask::SAME_SCREEN
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of mouse buttons and modifier keys immediately
 		/// before this event was generated.
@@ -781,7 +781,7 @@ derive_xrb! {
 		///
 		/// [event]: crate::message::Event
 		/// [window]: Window
-		pub root_coords: Point,
+		pub root_coords: Coords,
 		/// The position of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin, if the `event_window` is on
 		/// the [`SAME_SCREEN`].
@@ -795,7 +795,7 @@ derive_xrb! {
 		/// [event]: crate::message::Event
 		/// [`SAME_SCREEN`]: EnterLeaveMask::SAME_SCREEN
 		/// [screen]: crate::Screen
-		pub event_coords: Point,
+		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
@@ -1668,7 +1668,7 @@ derive_xrb! {
 		pub new_parent: Window,
 
 		/// The `window`'s new coordinates relative to its `new_parent`'s origin.
-		pub coords: Point,
+		pub coords: Coords,
 
 		/// Whether [`MapWindow`] and [`ConfigureWindow`] requests on the
 		/// `window` should override a [`SUBSTRUCTURE_REDIRECT`] on the
@@ -1871,7 +1871,7 @@ derive_xrb! {
 
 		/// The new coordinates of the `window`, relative to its parent's
 		/// origin.
-		pub coords: Point,
+		pub coords: Coords,
 		[_; ..],
 	}
 
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index e3ceabe2..818a0a13 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -18,10 +18,12 @@ use crate::{
 	Atom,
 	BitGravity,
 	Colormap,
+	Coords,
 	DeviceEventMask,
 	EventMask,
 	GrabStatus,
 	MaintainContents,
+	ModifierMask,
 	Rectangle,
 	String8,
 	Window,
@@ -578,4 +580,62 @@ derive_xrb! {
 
 		[_; ..],
 	}
+
+
+	/// The [reply] to a [`QueryCursorLocation` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryCursorLocation` request]: request::QueryCursorLocation
+	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryCursorLocation: Reply for request::QueryCursorLocation {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the cursor is on the `same_screen` as the given `target`
+		/// [window].
+		#[metabyte]
+		pub same_screen: bool,
+
+		/// The root [window] which the cursor is located within.
+		///
+		/// [window]: Window
+		pub root: Window,
+		/// The child [window] containing the cursor, if any.
+		///
+		/// If the cursor is not on the `same_screen` (i.e., `same_screen` is
+		/// `false`), this will always be [`None`].
+		///
+		/// [window]: Window
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub child: Option<Window>,
+
+		/// The coordinates of the cursor relative to the top-left corner of the
+		/// `root` [window].
+		///
+		/// [window]: Window
+		pub root_coords: Coords,
+		/// The coordinates of the cursor relative to the top-left corner of the
+		/// given `target` [window].
+		///
+		/// [window]: Window
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub target_coords: Coords,
+
+		/// The currently held mouse buttons and modifier keys.
+		pub modifiers: ModifierMask,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 0a5594f9..f06636ef 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -28,7 +28,7 @@ use crate::{
 	EventMask,
 	FreezeMode,
 	Keycode,
-	Point,
+	Coords,
 	Rectangle,
 	String8,
 	Window,
@@ -534,7 +534,7 @@ derive_xrb! {
 		/// The `target`'s new coordinates relative to its `new_parent`'s
 		/// top-left corner.
 		#[doc(alias("x", "y"))]
-		pub coords: Point,
+		pub coords: Coords,
 	}
 
 	/// A [request] that maps the given [window].
@@ -2632,7 +2632,7 @@ pub enum AllowEventsMode {
 	/// Unfreezes the cursor, but freezes it again after the next
 	/// [`ButtonPress`] or [`ButtonRelease`].
 	///
-	/// Your client have an active grab on the cursor.
+	/// Your client must have an active grab on the cursor.
 	///
 	/// The cursor is frozen again specifically after the next [`ButtonPress`]
 	/// [`ButtonRelease`] event reported to your client which does not cause
@@ -2656,7 +2656,7 @@ pub enum AllowEventsMode {
 	/// Unfreezes the keyboard, but freezes it again after the next
 	/// [`KeyPress`] or [`KeyPress`].
 	///
-	/// Your client have an active grab on the keyboard.
+	/// Your client must have an active grab on the keyboard.
 	///
 	/// The keyboard is frozen again specifically after the next [`KeyPress`]
 	/// [`KeyRelease`] event reported to your client which does not cause
@@ -2729,4 +2729,31 @@ derive_xrb! {
 	/// connection closes on all other clients' connections.
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UngrabServer: Request(37);
+
+	/// A [request] that gets the current location of the cursor.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryCursorLocation: Request(38, error::Window) -> reply::QueryCursorLocation {
+		/// Specifies a [window] to receive relative coordinates of the cursor
+		/// in relation to, if the cursor is on the same screen.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
 }

From e3d2da7b5610202190031b05d4564229cd4f5bc3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 24 Jan 2023 17:37:34 +0000
Subject: [PATCH 041/157] [CI765] formatted code with rustfmt

---
 src/x11/event.rs   | 2 +-
 src/x11/request.rs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index a300c4b6..81b2f119 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -14,12 +14,12 @@ use crate::{
 	set::WindowConfigMask,
 	unit::Px,
 	Button,
+	Coords,
 	CurrentableTime,
 	Drawable,
 	GrabMode,
 	Keycode,
 	ModifierMask,
-	Coords,
 	Rectangle,
 	Region,
 	StackMode,
diff --git a/src/x11/request.rs b/src/x11/request.rs
index f06636ef..4d1c624d 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -19,6 +19,7 @@ use crate::{
 	AnyModifierKeyMask,
 	Atom,
 	Button,
+	Coords,
 	CopyableFromParent,
 	CurrentableTime,
 	CursorAppearance,
@@ -28,7 +29,6 @@ use crate::{
 	EventMask,
 	FreezeMode,
 	Keycode,
-	Coords,
 	Rectangle,
 	String8,
 	Window,

From 8118526abf74dbc8932b35eed9878d52f4a9eaf3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 17:52:57 +0000
Subject: [PATCH 042/157] GetMotionHistory request + reply

---
 src/x11/reply.rs   | 55 ++++++++++++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 38 ++++++++++++++++++++++++++++++++
 2 files changed, 93 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 818a0a13..910e5e6f 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -26,6 +26,7 @@ use crate::{
 	ModifierMask,
 	Rectangle,
 	String8,
+	Timestamp,
 	Window,
 	WindowClass,
 	WindowGravity,
@@ -639,3 +640,57 @@ derive_xrb! {
 		[_; ..],
 	}
 }
+
+/// The coordinates of the cursor at a certain [time].
+///
+/// This is used in the [`GetMotionHistory` reply].
+///
+/// [time]: Timestamp
+///
+/// [`GetMotionHistory` reply]: GetMotionHistory
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct TimeCoords {
+	/// The [time] at which the cursor was at the `coords`.
+	///
+	/// [time]: Timestamp
+	pub time: Timestamp,
+	/// The coordinates of the cursor at the `time`.
+	pub coords: Coords,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`GetMotionHistory` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetMotionHistory` request]: request::GetMotionHistory
+	#[doc(alias = "GetMotionEvents")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetMotionHistory: Reply for request::GetMotionHistory {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `motion_history`.
+		#[allow(clippy::cast_possible_truncation)]
+		let motion_history_len: u32 = motion_history => motion_history.len() as u32,
+		[_; 20],
+
+		/// The recorded cursor motion between the `start` and `end` times
+		/// (inclusive) for the given `target` [window].
+		///
+		/// [window]: Window
+		#[context(motion_history_len => *motion_history_len as usize)]
+		pub motion_history: Vec<TimeCoords>,
+	}
+}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 4d1c624d..bca21afb 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -31,6 +31,7 @@ use crate::{
 	Keycode,
 	Rectangle,
 	String8,
+	Timestamp,
 	Window,
 	WindowClass,
 };
@@ -2756,4 +2757,41 @@ derive_xrb! {
 		#[doc(alias = "window")]
 		pub target: Window,
 	}
+
+	/// A [request] that returns the recorded cursor motion between the given
+	/// `start` and `end` times.
+	///
+	/// The `start` and `end` times are inclusive.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "GetMotionEvents")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetMotionHistory: Request(39, error::Window) -> reply::GetMotionHistory {
+		/// The [window] for which the motion history is returned.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The start of the time period for which motion events are returned.
+		///
+		/// This is inclusive.
+		pub start: CurrentableTime,
+		/// The end of the time period for which motion events are returned.
+		///
+		/// This is inclusive.
+		pub end: CurrentableTime,
+	}
 }

From 8244fa2df72a5de764c7c8b7aae6e8bf65a0cfe7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 24 Jan 2023 17:54:35 +0000
Subject: [PATCH 043/157] [CI767] applied recommended clippy fixes

---
 src/x11/request.rs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index bca21afb..70b39e7b 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -31,7 +31,6 @@ use crate::{
 	Keycode,
 	Rectangle,
 	String8,
-	Timestamp,
 	Window,
 	WindowClass,
 };

From be0c7db540ee05a8a85fd649c3cf2026afadd5b8 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 18:16:24 +0000
Subject: [PATCH 044/157] ConvertCoordinates request + reply

---
 src/x11/reply.rs   | 51 ++++++++++++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 49 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 100 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 910e5e6f..1566940b 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -693,4 +693,55 @@ derive_xrb! {
 		#[context(motion_history_len => *motion_history_len as usize)]
 		pub motion_history: Vec<TimeCoords>,
 	}
+
+
+	/// The [reply] to a [`ConvertCoordinates` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`ConvertCoordinates` request]: request::ConvertCoordinates
+	#[doc(alias = "TranslateCoordinates")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ConvertCoordinates: Reply for request::ConvertCoordinates {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the `original` [window] and the `output` [window] are on the
+		/// same [screen].
+		///
+		/// [window]: Window
+		/// [screen]: crate::visual::Screen
+		#[metabyte]
+		pub same_screen: bool,
+
+		/// If the `output_coords` are contained within a mapped child of the
+		/// `output` [window], this is that child.
+		///
+		/// If `same_screen` is `false`, this is always [`None`].
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub child: Option<Window>,
+
+		/// The converted coordinates which are now relative to the top-left
+		/// corner of the `output` [window].
+		///
+		// FIXME: should always be [`None`], but requires overriding the reading
+		//        behavior here
+		/// If `same_screen` is `false`, these are always zero.
+		///
+		/// [window]: Window
+		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
+		pub output_coords: Coords,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 70b39e7b..54742a44 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -2793,4 +2793,53 @@ derive_xrb! {
 		/// This is inclusive.
 		pub end: CurrentableTime,
 	}
+
+	/// Converts coordinates relative to the given `original` [window] to
+	/// `output_coords` relative to the given `output` [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either `original` or `output` do not
+	/// refer to defined [windows][window].
+	///
+	/// [window]: Window
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "TranslateCoordinates")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ConvertCoordinates: Request(40, error::Window) -> reply::ConvertCoordinates {
+		/// The [window] which the `original_coords` are relative to.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("src_window", "source", "input"))]
+		pub original: Window,
+		/// The [window] which the `output_coords` will be relative to.
+		///
+		/// The `original_coords` are converted to coordinates relative to the
+		/// top-left corner of this [window].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("dst_window", "destination"))]
+		pub output: Window,
+
+		/// The coordinates, relative to the `original` [window]'s top-left
+		/// corner, which will be converted.
+		///
+		/// These coordinates will be converted such that the `output_coords`
+		/// are relative to the `output` [window].
+		///
+		/// [window]: Window
+		pub original_coords: Coords,
+	}
 }

From bd8bbf9919eaad8cf68431594d6a1b8666e63f8f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 19:14:39 +0000
Subject: [PATCH 045/157] WarpCursor request

---
 src/x11/request.rs | 125 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 125 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 54742a44..410fcf5b 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -41,6 +41,7 @@ use xrbk::{
 	ReadError,
 	ReadError::UnrecognizedDiscriminant,
 	ReadResult,
+	Readable,
 	ReadableWithContext,
 	Wrap,
 	Writable,
@@ -2843,3 +2844,127 @@ derive_xrb! {
 		pub original_coords: Coords,
 	}
 }
+
+/// Represents dimensions within the `source` [window] of a
+/// [`WarpCursor` request].
+///
+/// [window]: Window
+///
+/// [`WarpCursor` request]: WarpCursor
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum WarpSourceDimension {
+	/// Set the `source_width` to the width of the `source` [window] minus the x
+	/// coordinate or the `source_height` to the height of the `source` [window]
+	/// minus the y coordinate.
+	///
+	/// [window]: Window
+	FillRemaining,
+	/// This specific width or height.
+	Other(u16),
+}
+
+impl ConstantX11Size for WarpSourceDimension {
+	const X11_SIZE: usize = 2;
+}
+
+impl X11Size for WarpSourceDimension {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Readable for WarpSourceDimension {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		Ok(match buf.get_u16() {
+			zero if zero == 0 => Self::FillRemaining,
+			other => Self::Other(other),
+		})
+	}
+}
+
+impl Writable for WarpSourceDimension {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::FillRemaining => buf.put_u16(0),
+			Self::Other(other) => other.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that instantly moves the cursor to a new location.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `source` or the `destination` are [`Some`] and
+	/// do not refer to defined [windows].
+	///
+	/// [windows]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "WarpPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct WarpCursor: Request(41, error::Window) {
+		/// The [window] which the cursor is being warped from.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("src", "src_window"))]
+		pub source: Option<Window>,
+		/// The [window] which the cursor is being warped to.
+		///
+		/// If this is [`None`], the cursor is simply offset by the `coords`. If
+		/// this is [`Some`], the cursor is set to the `coords` relative to this
+		/// [window].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`SOme`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("dst", "dst_window"))]
+		pub destination: Option<Window>,
+
+		/// The coordinates of the top-left corner of the rectangular area
+		/// within the `source` [window] which the cursor must be within for it
+		/// to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias("src_coords", "src_x", "src_y", "source_x", "source_y"))]
+		pub source_coords: Coords,
+		/// The width of the rectangular area within the `source` [window] which
+		/// the cursor must be within for it to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias = "src_width")]
+		pub source_width: WarpSourceDimension,
+		/// The height of the rectangular area within the `source` [window]
+		/// which the cursor must be within for it to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias = "src_height")]
+		pub source_height: WarpSourceDimension,
+
+		/// The coordinates applied to the cursor.
+		///
+		/// If `destination` is [`None`], the cursor is offset by these
+		/// coordinates. Otherwise, the cursor is moved to these coordinates
+		/// relative to the `destination` [window].
+		///
+		/// [window]: Window
+		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
+		pub coords: Coords,
+	}
+}

From 0ea3d25b5f59cbdb44e1eb70754e5ec81a7e6cda Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 19:51:04 +0000
Subject: [PATCH 046/157] SetFocus request

---
 src/x11/request.rs | 97 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 410fcf5b..6320924b 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -27,6 +27,7 @@ use crate::{
 	DestinationWindow,
 	Drawable,
 	EventMask,
+	FocusWindow,
 	FreezeMode,
 	Keycode,
 	Rectangle,
@@ -2968,3 +2969,99 @@ derive_xrb! {
 		pub coords: Coords,
 	}
 }
+
+/// An [error] generated because of a failed [`SetFocus` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`SetFocus` request]: SetFocus
+#[doc(alias = "SetInputFocusError")]
+pub enum SetFocusError {
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+	/// A [`Window` error].
+	///
+	/// [`Window` error]: error::Window
+	Window(error::Value),
+}
+
+/// What the focus should revert to if the focused [window] becomes unviewable.
+///
+/// This is used in the [`SetFocus` request].
+///
+/// [window]: Window
+///
+/// [`SetFocus` request]: SetFocus
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum RevertFocus {
+	/// Revert the focus to no [window].
+	///
+	/// It is recommended to use [`CursorRoot`] in place of this, because at
+	/// least the root [window] will have focus with [`CursorRoot`].
+	///
+	/// [`CursorRoot`]: RevertFocus::CursorRoot
+	///
+	/// [window]: Window
+	None,
+
+	/// Revert the focus to the root [window] which the cursor is on at the
+	/// time.
+	///
+	/// [window]: Window
+	CursorRoot,
+	/// Revert the focus to the parent of the [window] which the cursor is in at
+	/// the time.
+	Parent,
+}
+
+derive_xrb! {
+	/// A [request] which changes the current focus.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// # Errors
+	/// A [`Match` error] is generated of the specified `new_focus` is not
+	/// viewable at the time of the [request].
+	///
+	/// A [`Window` error] is generated if `new_focus` is [`FocusWindow::Other`]
+	/// and does not refer to a defined [window].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`Focus`]: super::event::Focus
+	/// [`Unfocus`]: super::event::Unfocus
+	///
+	/// [`Match` error]: error::Match
+	/// [`Window` error]: error::Window
+	#[doc(alias("SetInputFocus", "Focus", "FocusWindow"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetFocus: Request(42, SetFocusError) {
+		/// What the focus should revert to if the focused [window] becomes
+		/// unviewable.
+		///
+		/// [window]: Window
+		#[metabyte]
+		pub revert_to: RevertFocus,
+
+		/// The new focus.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`FocusWindow::Other`]
+		/// but does not refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "focus")]
+		pub new_focus: FocusWindow,
+
+		/// The [time] at which the focus is recorded as having changed.
+		pub time: CurrentableTime,
+	}
+}

From 96d61e3f8be549990fea553ec6461e5de09019f8 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 20:37:36 +0000
Subject: [PATCH 047/157] GetFocus request + reply

---
 src/x11/reply.rs   | 36 ++++++++++++++++++++++++++++++++++++
 src/x11/request.rs |  7 +++++++
 2 files changed, 43 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 1566940b..7eca8f10 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -21,6 +21,7 @@ use crate::{
 	Coords,
 	DeviceEventMask,
 	EventMask,
+	FocusWindow,
 	GrabStatus,
 	MaintainContents,
 	ModifierMask,
@@ -33,7 +34,9 @@ use crate::{
 };
 use derivative::Derivative;
 
+use crate::x11::request::RevertFocus;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
 extern crate self as xrb;
 
 /// The state of the [window] regarding how it is mapped.
@@ -744,4 +747,37 @@ derive_xrb! {
 		pub output_coords: Coords,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GetFocus` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetFocus` request]: request::GetFocus
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetFocus: Reply for request::GetFocus {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// What the focus will retain to if the focused [window] becomes
+		/// unviewable.
+		///
+		/// [window]: Window
+		#[metabyte]
+		pub revert_to: RevertFocus,
+
+		/// The current focus.
+		pub focus: FocusWindow,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6320924b..985a4a86 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3064,4 +3064,11 @@ derive_xrb! {
 		/// The [time] at which the focus is recorded as having changed.
 		pub time: CurrentableTime,
 	}
+
+	/// A [request] that returns the current focus.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias = "GetInputFocus")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetFocus: Request(43) -> reply::GetFocus;
 }

From 9e90f145edf991d9fba8644b0c27a80bfaa41643 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 20:49:18 +0000
Subject: [PATCH 048/157] QueryKeyboard request + reply

---
 src/common/mask.rs |  2 +-
 src/x11/event.rs   |  8 ++++----
 src/x11/reply.rs   | 29 +++++++++++++++++++++++++++++
 src/x11/request.rs |  8 ++++++++
 4 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/src/common/mask.rs b/src/common/mask.rs
index 428bbdb7..8b80b4a9 100644
--- a/src/common/mask.rs
+++ b/src/common/mask.rs
@@ -74,7 +74,7 @@ bitflags! {
 		///
 		/// [`EnterWindow`]: crate::x11::event::EnterWindow
 		/// [`Focus`]: crate::x11::event::Focus
-		const KEYS_STATE = 0x0000_4000;
+		const KEYBOARD_STATE = 0x0000_4000;
 
 		/// Events generated for arbitrary rectangular areas of windows that
 		/// need to be rendered.
diff --git a/src/x11/event.rs b/src/x11/event.rs
index 81b2f119..cfb37c3f 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -1129,13 +1129,13 @@ derive_xrb! {
 	/// An [event] describing the current state of the keyboard.
 	///
 	/// # Recipients
-	/// This [event] is reported to clients selecting [`KEYS_STATE`] on a [window]
-	/// immediately after every [`EnterWindow`] and [`Focus`] event.
+	/// This [event] is reported to clients selecting [`KEYBOARD_STATE`] on a
+	/// [window] immediately after every [`EnterWindow`] and [`Focus`] event.
 	///
 	/// [event]: crate::message::Event
 	/// [window]: Window
-	/// [`KEYS_STATE`]: crate::EventMask::KEYS_STATE
-	pub struct KeysState: Event(11) {
+	/// [`KEYBOARD_STATE`]: crate::EventMask::KEYBOARD_STATE
+	pub struct KeyboardState: Event(11) {
 		/// A bit vector representing the current keyboard state.
 		///
 		/// Each bit set to 1 indicates that the corresponding key is currently
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 7eca8f10..600313d4 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -753,6 +753,7 @@ derive_xrb! {
 	/// [reply]: crate::message::Reply
 	///
 	/// [`GetFocus` request]: request::GetFocus
+	#[doc(alias = "GetInputFocus")]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct GetFocus: Reply for request::GetFocus {
@@ -780,4 +781,32 @@ derive_xrb! {
 		pub focus: FocusWindow,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`QueryKeyboard` request].
+	///
+	/// [`QueryKeyboard` request]: request::QueryKeyboard
+	#[doc(alias = "QueryKeymap")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryKeyboard: Reply for request::QueryKeyboard {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// A bit vector representing the currently held keys of the keyboard.
+		///
+		/// A bit is `0` if the key is not held, and `1` if it is held. Byte
+		/// `N`, starting at `0`, contains the bits for keys `8N` to `8N + 7`.
+		/// The least significant bit in the byte represents key `8N`.
+		pub keys: [u8; 32],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 985a4a86..8af9d7a4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3071,4 +3071,12 @@ derive_xrb! {
 	#[doc(alias = "GetInputFocus")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetFocus: Request(43) -> reply::GetFocus;
+
+	/// A [request] that returns a bit vector of the currently held keys on the
+	/// keyboard.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias = "QueryKeymap")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
 }

From f5fdf14a6639ff4483cf9e4bbe858ce5aacaf310 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 21:07:42 +0000
Subject: [PATCH 049/157] AssignFont and UnassignFont requests

---
 src/x11/request.rs | 59 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 8af9d7a4..6a62e040 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -28,6 +28,7 @@ use crate::{
 	Drawable,
 	EventMask,
 	FocusWindow,
+	Font,
 	FreezeMode,
 	Keycode,
 	Rectangle,
@@ -3080,3 +3081,61 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
 }
+
+/// An [error] generated because of a failed [`AssignFont` request].
+///
+/// [`AssignFont` request]: AssignFont
+pub enum AssignFontError {
+	/// A [`ResourceIdChoice` error].
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	ResourceIdChoice(error::ResourceIdChoice),
+	/// A [`Name` error].
+	///
+	/// [`Name` error]: error::Name
+	Name(error::Name),
+}
+
+derive_xrb! {
+	/// A [request] that associates the font by the given `name` with the given
+	/// `font_id`.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias("OpenFont", "CreateFont", "LoadFont", "AddFont"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AssignFont: Request(45, AssignFontError) {
+		/// The [`Font` ID] to associate with the font specified by `name`.
+		///
+		/// [`Font` ID]: Font
+		pub font_id: Font,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// A pattern match against the name of the font
+		///
+		/// The name uses ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; ..],
+	}
+
+	/// A [request] that removes the association between a given `font` ID and
+	/// the font it is associated with.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UnassignFont: Request(46) {
+		/// The [`Font` ID] which is having its association with a font removed.
+		///
+		/// [`Font` ID]: Font
+		pub font: Font,
+	}
+}

From 872a9a3357b156069b7aea08d071008901622777 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 21:33:18 +0000
Subject: [PATCH 050/157] fix some request and reply doc links

---
 src/x11/reply.rs   | 2 ++
 src/x11/request.rs | 9 +++++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 600313d4..2f17e827 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -784,6 +784,8 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryKeyboard` request].
 	///
+	/// [reply]: crate::message::Reply
+	///
 	/// [`QueryKeyboard` request]: request::QueryKeyboard
 	#[doc(alias = "QueryKeymap")]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6a62e040..1fbf75b9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -2725,11 +2725,15 @@ derive_xrb! {
 
 	/// A [request] that freezes processing of [requests][request] and
 	/// connection closes on all other clients' connections.
+	///
+	/// [request]: crate::message::Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GrabServer: Request(36);
 
 	/// A [request] that unfreezes processing of [requests][request] and
 	/// connection closes on all other clients' connections.
+	///
+	/// [request]: crate::message::Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UngrabServer: Request(37);
 
@@ -3126,16 +3130,17 @@ derive_xrb! {
 		[_; ..],
 	}
 
-	/// A [request] that removes the association between a given `font` ID and
+	/// A [request] that removes the association between a given [`Font` ID] and
 	/// the font it is associated with.
 	///
 	/// [request]: crate::message::Request
+	/// [`Font` ID]: Font
 	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct UnassignFont: Request(46) {
 		/// The [`Font` ID] which is having its association with a font removed.
 		///
 		/// [`Font` ID]: Font
-		pub font: Font,
+		pub target: Font,
 	}
 }

From c2b45be38b3511b440ae0477ab5e2d40553d95f0 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 24 Jan 2023 21:33:59 +0000
Subject: [PATCH 051/157] WIP - QueryFont request + reply

This is the big one. Documentation will come tomorrow.
---
 src/x11/reply.rs   | 89 ++++++++++++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 13 +++++++
 2 files changed, 102 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 2f17e827..117b521d 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -812,3 +812,92 @@ derive_xrb! {
 		pub keys: [u8; 32],
 	}
 }
+
+/// A property of a font.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct FontProperty {
+	/// The name of the font property.
+	pub name: Atom,
+	/// The value of the property.
+	///
+	/// This is represented as four individual `u8` values because it is not
+	/// necessarily one numerical value; it must not be subject to the byte
+	/// swapping that would occur for a `u32` value.
+	pub value: [u8; 4],
+}
+
+/// Information about a particular character within a font.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct CharacterInfo {
+	pub left_side_bearing: i16,
+	pub right_side_bearing: i16,
+
+	pub character_width: i16,
+
+	pub ascent: i16,
+	pub descent: i16,
+
+	pub attributes: u16,
+}
+
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum DrawDirection {
+	LeftToRight,
+	RightToLeft,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`QueryFont` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryFont` request]: request::QueryFont
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryFont: Reply for request::QueryFont {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		pub min_bounds: CharacterInfo,
+		[_; 4],
+
+		pub max_bounds: CharacterInfo,
+		[_; 4],
+
+		pub min_character_or_byte2: u16,
+		pub max_character_or_byte2: u16,
+
+		pub default_character: u16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let properties_len: u16 = properties => properties.len() as u16,
+
+		pub draw_direction: DrawDirection,
+
+		pub min_byte1: u8,
+		pub max_byte1: u8,
+
+		pub all_characters_exist: bool,
+
+		pub font_ascent: i16,
+		pub font_descent: i16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let character_infos_len: u32 = character_infos => character_infos.len() as u32,
+
+		#[context(properties_len => usize::from(*properties_len))]
+		pub properties: Vec<FontProperty>,
+		#[context(character_infos_len => *character_infos_len as usize)]
+		pub character_infos: Vec<CharacterInfo>,
+	}
+}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 1fbf75b9..ccddd3f9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -29,6 +29,7 @@ use crate::{
 	EventMask,
 	FocusWindow,
 	Font,
+	Fontable,
 	FreezeMode,
 	Keycode,
 	Rectangle,
@@ -3143,4 +3144,16 @@ derive_xrb! {
 		/// [`Font` ID]: Font
 		pub target: Font,
 	}
+
+	/// A [request] that returns information about the given `target`
+	/// font.
+	///
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryFont: Request(47, error::Font) -> reply::QueryFont {
+		/// The font which this [request] returns information about.
+		///
+		/// [request]: crate::message::Request
+		pub target: Fontable,
+	}
 }

From 982b9db5f4b67e2bf608a82aa3f299e3b025aacf Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 09:32:57 +0000
Subject: [PATCH 052/157] finish documenting QueryFont request & reply

---
 src/lib.rs         |   2 +
 src/x11/reply.rs   | 153 +++++++++++++++++++++++++++++++++++++++++----
 src/x11/request.rs |  62 ++++++++++++------
 3 files changed, 185 insertions(+), 32 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 679c1967..70637f4f 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -33,7 +33,9 @@
 #![warn(clippy::complexity)]
 #![warn(clippy::cargo)]
 #![warn(clippy::missing_const_for_fn)]
+// Warn for these doc lints.
 #![warn(missing_docs)]
+#![warn(broken_intra_doc_links)]
 // Allow these lints.
 #![allow(clippy::doc_markdown)]
 #![allow(clippy::wildcard_imports)]
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 117b521d..9b317703 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -11,10 +11,16 @@
 //! [request]: crate::message::Request
 //! [core X11 protocol]: super
 
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
 use crate::{
 	unit::Px,
 	visual::{ColorId, VisualId},
-	x11::request::{self, DataFormat, DataList},
+	x11::request::{self, DataFormat, DataList, RevertFocus},
 	Atom,
 	BitGravity,
 	Colormap,
@@ -32,12 +38,6 @@ use crate::{
 	WindowClass,
 	WindowGravity,
 };
-use derivative::Derivative;
-
-use crate::x11::request::RevertFocus;
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
-
-extern crate self as xrb;
 
 /// The state of the [window] regarding how it is mapped.
 ///
@@ -814,6 +814,8 @@ derive_xrb! {
 }
 
 /// A property of a font.
+///
+/// The value of this property is uninterpreted by XRB.
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub struct FontProperty {
 	/// The name of the font property.
@@ -827,22 +829,53 @@ pub struct FontProperty {
 }
 
 /// Information about a particular character within a font.
+///
+/// For a nonexistent character, all of these fields are zero.
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub struct CharacterInfo {
+	/// The extent of this character's appearance beyond its left edge.
+	///
+	/// If this is negative, the character's appearance extends to the left of
+	/// its x coordinate. If this is positive, the character's appearance starts
+	/// after its x coordinate.
 	pub left_side_bearing: i16,
+	/// The extent of this character's appearance beyond its right edge.
+	///
+	/// If this is negative, the character's appearance ends before its width.
+	/// If this is positive, the character's appearance extends beyond its
+	/// width.
 	pub right_side_bearing: i16,
 
+	/// The width of this character - positive if it is read [`LeftToRight`],
+	/// negative if it is read [`RightToLeft`].
+	///
+	/// [`LeftToRight`]: DrawDirection::LeftToRight
+	/// [`RightToLeft`]: DrawDirection::RightToLeft
 	pub character_width: i16,
 
+	/// The extent of this character above the baseline.
 	pub ascent: i16,
+	/// The extent of this character at or below the baseline.
 	pub descent: i16,
 
+	/// The interpretation of these character attributes depends on the X
+	/// server.
 	pub attributes: u16,
 }
 
+/// A hint as to whether most [`CharacterInfo`]s in a font have a positive or
+/// negative width.
+///
+/// A positive width means the character is [`LeftToRight`]. A negative width
+/// means the character is [`RightToLeft`].
+///
+/// [`LeftToRight`]: DrawDirection::LeftToRight
+/// [`RightToLeft`]: DrawDirection::RightToLeft
 #[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 pub enum DrawDirection {
+	/// Most [`CharacterInfo`]s in the font have a positive width.
 	LeftToRight,
+	/// Most [`CharacterInfo`]s in the font have a negative width.
 	RightToLeft,
 }
 
@@ -868,35 +901,129 @@ derive_xrb! {
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
+		/// A [`CharacterInfo`] representing the minimum bounds of all fields in
+		/// each [`CharacterInfo`] in `character_infos`.
 		pub min_bounds: CharacterInfo,
 		[_; 4],
 
+		/// A [`CharacterInfo`] representing the maximum bounds of all fields in
+		/// each [`CharacterInfo`] in `character_infos`.
 		pub max_bounds: CharacterInfo,
 		[_; 4],
 
-		pub min_character_or_byte2: u16,
-		pub max_character_or_byte2: u16,
-
-		pub default_character: u16,
+		/// If `min_byte1` and `max_byte1` are both zero, this is the character
+		/// index of the first element in `character_infos`. Otherwise, this is
+		/// a [`u8`] value used to index characters.
+		///
+		/// If either `min_major_index` or `max_major_index` aren't zero, the
+		/// two indexes used to retrieve `character_infos` element `i` (counting
+		/// from `i = 0`) are:
+		/// ```
+		/// # let first_character_or_min_minor_index = 0;
+		/// # let last_character_or_max_minor_index = 1;
+		/// #
+		/// # let min_major_index = 2;
+		/// #
+		/// let major_index_range = {
+		///     last_character_or_max_minor_index
+		///     - first_character_or_min_minor_index
+		///     + 1
+		/// };
+		///
+		/// let major_index = i / major_index_range + min_major_index;
+		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+		/// ```
+		#[doc(alias = "min_char_or_byte2")]
+		pub first_character_or_min_minor_index: u16,
+		/// If `min_byte1` and `max_byte1` are both zero, this is the character
+		/// index of the last element in `character_infos`. Otherwise, this is
+		/// a [`u8`] value used to index characters.
+		///
+		/// If either `min_major_index` or `max_major_index` aren't zero, the
+		/// two indexes used to retrieve `character_infos` element `i` (counting
+		/// from `i = 0`) are:
+		/// ```
+		/// # let first_character_or_min_minor_index = 0;
+		/// # let last_character_or_max_minor_index = 1;
+		/// #
+		/// # let min_major_index = 2;
+		/// #
+		/// let major_index_range = {
+		///     last_character_or_max_minor_index
+		///     - first_character_or_min_minor_index
+		///     + 1
+		/// };
+		///
+		/// let major_index = i / major_index_range + min_major_index;
+		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+		/// ```
+		#[doc(alias = "max_char_or_byte2")]
+		pub last_character_or_max_minor_index: u16,
+
+		/// The character used when an undefined or nonexistent character is
+		/// used.
+		///
+		/// If a font uses two bytes to index its characters (such as that used
+		/// for [`Char16`]), the first of the two bytes is found in the most
+		/// significant byte of this `fallback_character`, and the second of the
+		/// two bytes if found in the least significant byte.
+		///
+		/// [`Char16`]: crate::Char16
+		#[doc(alias("default_char", "default_character", "fallback_char"))]
+		pub fallback_character: u16,
 
+		// The length of `properties`.
 		#[allow(clippy::cast_possible_truncation)]
 		let properties_len: u16 = properties => properties.len() as u16,
 
+		/// A hint as to whether most [`CharacterInfo`s] in a font have a positive or
+		/// negative width.
+		///
+		/// See [`DrawDirection`] for more information.
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
 		pub draw_direction: DrawDirection,
 
-		pub min_byte1: u8,
-		pub max_byte1: u8,
+		/// The value of the major index used to retrieve the first element in
+		/// `character_infos`.
+		#[doc(alias = "min_byte1")]
+		pub min_major_index: u8,
+		/// The value of the major index used to retrieve the last element in
+		/// `character_infos`.
+		#[doc(alias = "max_byte1")]
+		pub max_major_index: u8,
 
+		/// Whether all of the [`CharacterInfo`s] in `character_infos` have
+		/// nonzero bounds.
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
 		pub all_characters_exist: bool,
 
+		/// The extent of the font above the baseline, used for determining line
+		/// spacing.
+		///
+		/// Some specific characters may extend above this.
 		pub font_ascent: i16,
+		/// The extent of the font at or below the baseline, used for
+		/// determining line spacing.
+		///
+		/// Some specific characters may extend below this.
 		pub font_descent: i16,
 
+		// The length of `character_infos`.
 		#[allow(clippy::cast_possible_truncation)]
 		let character_infos_len: u32 = character_infos => character_infos.len() as u32,
 
+		/// A list of [`FontProperty`s] associated with the font.
+		///
+		/// [`FontProperty`s]: FontProperty
 		#[context(properties_len => usize::from(*properties_len))]
 		pub properties: Vec<FontProperty>,
+		/// A list of the characters associated with the font, represented by
+		/// [`CharacterInfo`s].
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
+		#[doc(alias = "char_infos")]
 		#[context(character_infos_len => *character_infos_len as usize)]
 		pub character_infos: Vec<CharacterInfo>,
 	}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index ccddd3f9..21efbcf9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -9,6 +9,24 @@
 //! [Requests]: crate::message::Request
 //! [core X11 protocol]: super
 
+extern crate self as xrb;
+
+use xrbk::{
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadError::UnrecognizedDiscriminant,
+	ReadResult,
+	Readable,
+	ReadableWithContext,
+	Wrap,
+	Writable,
+	WriteResult,
+	X11Size,
+};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
 use crate::{
 	message::Event,
 	set::{Attributes, WindowConfig},
@@ -37,23 +55,6 @@ use crate::{
 	Window,
 	WindowClass,
 };
-use xrbk::{
-	Buf,
-	BufMut,
-	ConstantX11Size,
-	ReadError,
-	ReadError::UnrecognizedDiscriminant,
-	ReadResult,
-	Readable,
-	ReadableWithContext,
-	Wrap,
-	Writable,
-	WriteResult,
-	X11Size,
-};
-
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
-extern crate self as xrb;
 
 /// An [error] generated because of a failed [`CreateWindow` request].
 ///
@@ -2802,14 +2803,15 @@ derive_xrb! {
 		pub end: CurrentableTime,
 	}
 
-	/// Converts coordinates relative to the given `original` [window] to
-	/// `output_coords` relative to the given `output` [window].
+	/// A [request] that converts coordinates relative to the given `original`
+	/// [window] to `output_coords` relative to the given `output` [window].
 	///
 	/// # Errors
 	/// A [`Window` error] is generated if either `original` or `output` do not
 	/// refer to defined [windows][window].
 	///
 	/// [window]: Window
+	/// [request]: crate::message::Request
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "TranslateCoordinates")]
@@ -3038,6 +3040,7 @@ derive_xrb! {
 	/// A [`Window` error] is generated if `new_focus` is [`FocusWindow::Other`]
 	/// and does not refer to a defined [window].
 	///
+	/// [window]: Window
 	/// [request]: crate::message::Request
 	///
 	/// [`Focus`]: super::event::Focus
@@ -3148,12 +3151,33 @@ derive_xrb! {
 	/// A [request] that returns information about the given `target`
 	/// font.
 	///
+	/// # Replies
+	/// This [request] generates a [`QueryFont` reply].
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if the `target` does not refer to a
+	/// defined [`Font`] nor [`GraphicsContext`].
+	///
 	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`]: crate::GraphicsContext
+	///
+	/// [`QueryFont` reply]: reply::QueryFont
+	///
+	/// [`Font` error]: error::Font
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryFont: Request(47, error::Font) -> reply::QueryFont {
 		/// The font which this [request] returns information about.
 		///
+		/// # Errors
+		/// A [`Font` error] is generated if this does not refer to a defined
+		/// [`Font`] nor [`GraphicsContext`].
+		///
 		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext`]: crate::GraphicsContext
+		///
+		/// [`Font` error]: error::Font
 		pub target: Fontable,
 	}
 }

From e9355aea3ff7982b0d7fa346f734780141315c2d Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 12:50:38 +0000
Subject: [PATCH 053/157] QueryTextExtents request + reply

---
 src/x11/reply.rs                              | 71 +++++++++++++++++--
 src/x11/request.rs                            | 69 ++++++++++++++++++
 .../src/definition/expansion/x11_size.rs      | 19 +++--
 xrbk_macro/src/element/expansion/xrbk.rs      | 39 ++++------
 xrbk_macro/src/lib.rs                         | 15 ++--
 xrbk_macro/src/source/expansion.rs            |  4 +-
 6 files changed, 173 insertions(+), 44 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 9b317703..17856eba 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -851,7 +851,8 @@ pub struct CharacterInfo {
 	///
 	/// [`LeftToRight`]: DrawDirection::LeftToRight
 	/// [`RightToLeft`]: DrawDirection::RightToLeft
-	pub character_width: i16,
+	#[doc(alias = "character_width")]
+	pub width: i16,
 
 	/// The extent of this character above the baseline.
 	pub ascent: i16,
@@ -935,9 +936,9 @@ derive_xrb! {
 		/// ```
 		#[doc(alias = "min_char_or_byte2")]
 		pub first_character_or_min_minor_index: u16,
-		/// If `min_byte1` and `max_byte1` are both zero, this is the character
-		/// index of the last element in `character_infos`. Otherwise, this is
-		/// a [`u8`] value used to index characters.
+		/// If `min_major_index` and `max_major_index` are both zero, this is
+		/// the character index of the last element in `character_infos`.
+		/// Otherwise, this is a [`u8`] value used to index characters.
 		///
 		/// If either `min_major_index` or `max_major_index` aren't zero, the
 		/// two indexes used to retrieve `character_infos` element `i` (counting
@@ -976,8 +977,8 @@ derive_xrb! {
 		#[allow(clippy::cast_possible_truncation)]
 		let properties_len: u16 = properties => properties.len() as u16,
 
-		/// A hint as to whether most [`CharacterInfo`s] in a font have a positive or
-		/// negative width.
+		/// A hint as to whether most [`CharacterInfo`s] in a font have a
+		/// positive or negative width.
 		///
 		/// See [`DrawDirection`] for more information.
 		///
@@ -1027,4 +1028,62 @@ derive_xrb! {
 		#[context(character_infos_len => *character_infos_len as usize)]
 		pub character_infos: Vec<CharacterInfo>,
 	}
+
+	/// The [reply] to a [`QueryTextExtents` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryTextExtents` request]: request::QueryTextExtents
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryTextExtents: Reply for request::QueryTextExtents {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// A hint as to whether most characters in a font have a positive
+		/// `width` or a negative `width`.
+		///
+		/// See [`DrawDirection`] for more information.
+		#[metabyte]
+		pub draw_direction: DrawDirection,
+
+		/// The extent of the font above the baseline, used for determining line
+		/// spacing.
+		///
+		/// Some specific characters may extend above this.
+		pub font_ascent: i16,
+		/// The extent of the font at or below the baseline, used for
+		/// determining line spacing.
+		///
+		/// Some specific characters may extend below this.
+		pub font_descent: i16,
+
+		/// The highest individual `ascent` of any character in `text`.
+		pub overall_ascent: i16,
+		/// The lowest individual `descent` of any character in `text`.
+		pub overall_descent: i16,
+
+		/// The sum of the `width`s of each character in the `text`.
+		pub overall_width: i32,
+
+		/// If the 'left side' of each character is the sum of the `width`s of
+		/// all characters before it plus its `left_side_bearing`, this is the
+		/// leftmost left side.
+		pub overall_left: i32,
+		/// If the 'right side' of each character is the sum of the `width`s of
+		/// all characters before it, plus its `width` and `right_side_bearing`,
+		/// this is the rightmost right side.
+		pub overall_right: i32,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 21efbcf9..844789fa 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -37,6 +37,7 @@ use crate::{
 	AnyModifierKeyMask,
 	Atom,
 	Button,
+	Char16,
 	Coords,
 	CopyableFromParent,
 	CurrentableTime,
@@ -51,6 +52,7 @@ use crate::{
 	FreezeMode,
 	Keycode,
 	Rectangle,
+	String16,
 	String8,
 	Window,
 	WindowClass,
@@ -3181,3 +3183,70 @@ derive_xrb! {
 		pub target: Fontable,
 	}
 }
+
+/// A private function used in [`QueryTextExtents`] to determine padding.
+#[inline]
+const fn query_text_extents_padding(odd_length: bool) -> usize {
+	if odd_length {
+		2 // Char16::X11_SIZE
+	} else {
+		0
+	}
+}
+
+derive_xrb! {
+	/// A [request] that returns the extents of the given `text` when displayed
+	/// with the given `font`.
+	///
+	/// If the font has no specified `fallback_character`, undefined characters
+	/// in the `text` are ignored.
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if `font` does not refer to a defined
+	/// [`Font`] nor [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`]: crate::GraphicsContext
+	///
+	/// [`Font` error]: error::Font
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryTextExtents: Request(48, error::Font) -> reply::QueryTextExtents {
+		// Whether `text` is of odd length. Is it is, it has 2 bytes of padding
+		// following it.
+		#[metabyte]
+		let odd_length: bool = text => text.len() % 2 != 0,
+
+		/// The font used in the `text`.
+		///
+		/// # Errors
+		/// A [`Font` error] is generated if this does not refer to a defined
+		/// [`Font`] nor [`GraphicsContext`].
+		///
+		/// [`GraphicsContext`]: crate::GraphicsContext
+		///
+		/// [`Font` error]: error::Font
+		pub font: Fontable,
+
+		/// The text for which this [request] gets the extents when displayed
+		/// with `font`.
+		///
+		/// [request]: crate::message::Request
+		#[context(self::length, odd_length => {
+			// The length is in units of 4 bytes - we subtract the header, which is one of those
+			// units, then multiply by 4 to get the total number of bytes.
+			let length = usize::from(length - 1) * 4;
+			// We then remove the size of the previous field, `font`, to get the bytes from the
+			// start of `text` onwards.
+			let length = length - Fontable::X11_SIZE;
+			// We then remove the padding at the end, which can be determined from `odd_length`.
+			let length = length - query_text_extents_padding(*odd_length);
+
+			// We then divide the length, which is the number of bytes, by the number of bytes
+			// per character.
+			length / Char16::X11_SIZE
+		})]
+		pub text: String16,
+		[_; odd_length => query_text_extents_padding(*odd_length)]
+	}
+}
diff --git a/xrbk_macro/src/definition/expansion/x11_size.rs b/xrbk_macro/src/definition/expansion/x11_size.rs
index 6dfb1317..d5564f18 100644
--- a/xrbk_macro/src/definition/expansion/x11_size.rs
+++ b/xrbk_macro/src/definition/expansion/x11_size.rs
@@ -2,13 +2,14 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-use super::*;
-use crate::TsExt;
-
 use proc_macro2::TokenStream as TokenStream2;
 use quote::quote_spanned;
 use syn::Path;
 
+use crate::{element::Element, TsExt};
+
+use super::*;
+
 impl Struct {
 	pub fn impl_x11_size(&self, tokens: &mut TokenStream2, trait_path: &Path) {
 		let ident = &self.ident;
@@ -65,8 +66,10 @@ impl Request {
 
 		let sizes = TokenStream2::with_tokens(|tokens| {
 			for element in &self.content {
-				if !element.is_metabyte() && !element.is_sequence() {
+				if element.is_normal() {
 					element.x11_size_tokens(tokens, DefinitionType::Request);
+				} else if let Element::Let(r#let) = element && element.is_metabyte() {
+					r#let.function_call_tokens(tokens);
 				}
 			}
 		});
@@ -112,8 +115,10 @@ impl Reply {
 
 		let sizes = TokenStream2::with_tokens(|tokens| {
 			for element in &self.content {
-				if !element.is_metabyte() && !element.is_sequence() {
+				if element.is_normal() {
 					element.x11_size_tokens(tokens, DefinitionType::Reply);
+				} else if let Element::Let(r#let) = element && element.is_metabyte() {
+					r#let.function_call_tokens(tokens);
 				}
 			}
 		});
@@ -167,6 +172,8 @@ impl Event {
 			for element in &self.content {
 				if element.is_normal() {
 					element.x11_size_tokens(tokens, DefinitionType::Event);
+				} else if let Element::Let(r#let) = element && element.is_metabyte() {
+					r#let.function_call_tokens(tokens);
 				}
 			}
 		});
@@ -216,6 +223,8 @@ impl Error {
 			for element in &self.content {
 				if element.is_normal() {
 					element.x11_size_tokens(tokens, DefinitionType::Error);
+				} else if let Element::Let(r#let) = element && element.is_metabyte() {
+					r#let.function_call_tokens(tokens);
 				}
 			}
 		});
diff --git a/xrbk_macro/src/element/expansion/xrbk.rs b/xrbk_macro/src/element/expansion/xrbk.rs
index b1d1ff01..7a717dfa 100644
--- a/xrbk_macro/src/element/expansion/xrbk.rs
+++ b/xrbk_macro/src/element/expansion/xrbk.rs
@@ -5,9 +5,10 @@
 use quote::quote_spanned;
 use syn::spanned::Spanned;
 
-use super::*;
 use crate::{definition::DefinitionType, TsExt};
 
+use super::*;
+
 impl Element {
 	pub fn write_tokens(&self, tokens: &mut TokenStream2, definition_type: DefinitionType) {
 		match self {
@@ -154,22 +155,8 @@ impl Let {
 		let formatted = &self.formatted;
 		let r#type = &self.r#type;
 
-		self.source.function_to_tokens(
-			tokens,
-			Some(&self.attributes),
-			formatted,
-			r#type.into_token_stream(),
-		);
-
-		let function_call = TokenStream2::with_tokens(|tokens| {
-			self.source.call_to_tokens(tokens, formatted);
-		});
+		self.function_call_tokens(tokens);
 
-		tokens.append_tokens({
-			quote_spanned!(formatted.span()=>
-				let #formatted = #function_call;
-			)
-		});
 		tokens.append_tokens({
 			let r#type = quote_spanned!(r#type.span()=>
 				<#r#type as ::xrbk::Writable>
@@ -182,6 +169,11 @@ impl Let {
 	}
 
 	pub fn x11_size_tokens(&self, tokens: &mut TokenStream2) {
+		self.function_call_tokens(tokens);
+		self.add_x11_size_tokens(tokens);
+	}
+
+	pub fn function_call_tokens(&self, tokens: &mut TokenStream2) {
 		let formatted = &self.formatted;
 
 		self.source.function_to_tokens(
@@ -195,13 +187,9 @@ impl Let {
 			self.source.call_to_tokens(tokens, formatted);
 		});
 
-		tokens.append_tokens({
-			quote_spanned!(self.span()=>
-				let #formatted = #function_call;
-			)
-		});
-
-		self.add_x11_size_tokens(tokens);
+		tokens.append_tokens(quote_spanned!(self.span()=>
+			let #formatted = #function_call;
+		));
 	}
 
 	pub fn read_tokens(&self, tokens: &mut TokenStream2) {
@@ -325,9 +313,12 @@ impl ArrayUnused {
 			UnusedContent::Source(source) => {
 				source.function_to_tokens(tokens, Some(&self.attributes), formatted, quote!(usize));
 
+				let call =
+					TokenStream2::with_tokens(|tokens| source.call_to_tokens(tokens, formatted));
+
 				tokens.append_tokens({
 					quote_spanned!(self.span()=>
-						let #formatted = #formatted();
+						let #formatted = #call;
 					)
 				});
 			},
diff --git a/xrbk_macro/src/lib.rs b/xrbk_macro/src/lib.rs
index 368280f9..8730aa87 100644
--- a/xrbk_macro/src/lib.rs
+++ b/xrbk_macro/src/lib.rs
@@ -6,14 +6,8 @@
 #![feature(if_let_guard)]
 #![allow(rustdoc::private_intra_doc_links)]
 
-mod attribute;
-mod definition;
-mod derive;
-mod element;
-mod ext;
-mod source;
-
 use proc_macro::TokenStream;
+
 use quote::{quote, ToTokens};
 use syn::{parse_macro_input, Data, DeriveInput, Fields, FieldsNamed, FieldsUnnamed};
 
@@ -22,6 +16,13 @@ use derive::*;
 pub(crate) use ext::*;
 pub(crate) use source::*;
 
+mod attribute;
+mod definition;
+mod derive;
+mod element;
+mod ext;
+mod source;
+
 #[proc_macro_derive(new)]
 pub fn derive_new(item: TokenStream) -> TokenStream {
 	let item = parse_macro_input!(item as DeriveInput);
diff --git a/xrbk_macro/src/source/expansion.rs b/xrbk_macro/src/source/expansion.rs
index c558aec4..ee9352f8 100644
--- a/xrbk_macro/src/source/expansion.rs
+++ b/xrbk_macro/src/source/expansion.rs
@@ -32,8 +32,8 @@ impl ToTokens for SourceArg {
 
 impl ToTokens for SourceArgs {
 	fn to_tokens(&self, tokens: &mut TokenStream2) {
-		if let Some((_, r#type)) = &self.length_arg {
-			tokens.append_tokens(quote!(length: #r#type, ));
+		if let Some((SourceLengthArg { length_token, .. }, r#type)) = &self.length_arg {
+			tokens.append_tokens(quote!(#length_token: #r#type, ));
 		}
 
 		for pair in self.args.pairs() {

From 6ec571bae3385140d42605dfece96c1a46487c2e Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 12:59:42 +0000
Subject: [PATCH 054/157] fix reply doc example

---
 src/x11/reply.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 17856eba..964b2ab2 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -920,6 +920,8 @@ derive_xrb! {
 		/// two indexes used to retrieve `character_infos` element `i` (counting
 		/// from `i = 0`) are:
 		/// ```
+		/// # let i = 0;
+		/// #
 		/// # let first_character_or_min_minor_index = 0;
 		/// # let last_character_or_max_minor_index = 1;
 		/// #
@@ -944,6 +946,8 @@ derive_xrb! {
 		/// two indexes used to retrieve `character_infos` element `i` (counting
 		/// from `i = 0`) are:
 		/// ```
+		/// # let i = 0;
+		/// #
 		/// # let first_character_or_min_minor_index = 0;
 		/// # let last_character_or_max_minor_index = 1;
 		/// #

From 74446b962955d2bd45d7153a887df53dec5b5c86 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 21:07:32 +0000
Subject: [PATCH 055/157] XRBK macro: use where clauses in derived
 implementations

Potentially fixes #36?
---
 .../src/definition/expansion/message_trait.rs | 32 ++++++++++++--
 .../src/definition/expansion/readable.rs      | 44 +++++++++++++++----
 .../src/definition/expansion/writable.rs      | 38 +++++++++++++---
 .../src/definition/expansion/x11_size.rs      | 38 +++++++++++++---
 4 files changed, 128 insertions(+), 24 deletions(-)

diff --git a/xrbk_macro/src/definition/expansion/message_trait.rs b/xrbk_macro/src/definition/expansion/message_trait.rs
index 06c9e4b8..05027276 100644
--- a/xrbk_macro/src/definition/expansion/message_trait.rs
+++ b/xrbk_macro/src/definition/expansion/message_trait.rs
@@ -12,7 +12,13 @@ use crate::TsExt;
 impl Request {
 	pub fn impl_trait(&self, tokens: &mut TokenStream2) {
 		let name = &self.ident;
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let reply = if let Some((_, r#type)) = &self.reply {
 			quote!(#r#type)
@@ -60,7 +66,13 @@ impl Request {
 impl Reply {
 	pub fn impl_trait(&self, tokens: &mut TokenStream2) {
 		let name = &self.ident;
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let request = &self.request;
 		let sequence = match &self.content {
@@ -100,7 +112,13 @@ impl Reply {
 impl Event {
 	pub fn impl_trait(&self, tokens: &mut TokenStream2) {
 		let name = &self.ident;
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let code = &self.event_code;
 		let sequence = match &self.content {
@@ -143,7 +161,13 @@ impl Event {
 impl Error {
 	pub fn impl_trait(&self, tokens: &mut TokenStream2) {
 		let name = &self.ident;
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let error_path = &self.error_token;
 		let error_code = &self.error_code;
diff --git a/xrbk_macro/src/definition/expansion/readable.rs b/xrbk_macro/src/definition/expansion/readable.rs
index 1c7167cb..244807d1 100644
--- a/xrbk_macro/src/definition/expansion/readable.rs
+++ b/xrbk_macro/src/definition/expansion/readable.rs
@@ -2,18 +2,25 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-use super::*;
-use crate::{element::Element, TsExt};
 use proc_macro2::TokenStream as TokenStream2;
 use quote::{format_ident, quote_spanned};
 use syn::Path;
 
+use crate::{element::Element, TsExt};
+
+use super::*;
+
 impl Struct {
 	pub fn impl_readable(&self, tokens: &mut TokenStream2, trait_path: &Path) {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		// Expand the tokens to declare the x11_size variable if there is an
 		// UnusedContent::Infer unused bytes element to use it.
@@ -71,7 +78,12 @@ impl Request {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			// The x11_size starts at `4` to account for the size of a request's header
@@ -148,7 +160,12 @@ impl Reply {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 8;))
@@ -222,7 +239,12 @@ impl Event {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			let size: usize = if self.content.sequence_element().is_some() {
@@ -306,7 +328,12 @@ impl Error {
 	pub fn impl_readable(&self, tokens: &mut TokenStream2, trait_path: &Path) {
 		let ident = &self.ident;
 
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			// 11 bytes includes:
@@ -412,7 +439,8 @@ impl Enum {
 		);
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = &self.where_clause;
 
 		let discriminants = TokenStream2::with_tokens(|tokens| {
 			for variant in &self.variants {
diff --git a/xrbk_macro/src/definition/expansion/writable.rs b/xrbk_macro/src/definition/expansion/writable.rs
index eb419eea..c256f8cb 100644
--- a/xrbk_macro/src/definition/expansion/writable.rs
+++ b/xrbk_macro/src/definition/expansion/writable.rs
@@ -14,7 +14,12 @@ impl Struct {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 0;))
@@ -67,7 +72,12 @@ impl Request {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			// The x11_size starts at `4` to account for the size of a request's header
@@ -147,7 +157,12 @@ impl Reply {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			// The x11_size starts at `8` to account for the size of a reply's\
@@ -229,7 +244,12 @@ impl Event {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			let x11_size: usize = if self.content.sequence_element().is_some() {
@@ -318,7 +338,12 @@ impl Error {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let declare_x11_size = if self.content.contains_infer() {
 			// 11 bytes includes:
@@ -436,7 +461,8 @@ impl Enum {
 		);
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = &self.where_clause;
 
 		let discriminants = TokenStream2::with_tokens(|tokens| {
 			for variant in &self.variants {
diff --git a/xrbk_macro/src/definition/expansion/x11_size.rs b/xrbk_macro/src/definition/expansion/x11_size.rs
index d5564f18..9a40207e 100644
--- a/xrbk_macro/src/definition/expansion/x11_size.rs
+++ b/xrbk_macro/src/definition/expansion/x11_size.rs
@@ -15,7 +15,12 @@ impl Struct {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
@@ -58,7 +63,12 @@ impl Request {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
@@ -107,7 +117,12 @@ impl Reply {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
@@ -156,7 +171,12 @@ impl Event {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let size: usize = if self.content.sequence_element().is_some() {
 			4
@@ -213,7 +233,12 @@ impl Error {
 		let ident = &self.ident;
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = match &self.content {
+			StructlikeContent::Regular { where_clause, .. } => where_clause,
+			StructlikeContent::Tuple { where_clause, .. } => where_clause,
+			StructlikeContent::Unit { where_clause, .. } => where_clause,
+		};
 
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
@@ -263,7 +288,8 @@ impl Enum {
 		);
 
 		// TODO: add generic bounds
-		let (impl_generics, type_generics, where_clause) = self.generics.split_for_impl();
+		let (impl_generics, type_generics, _) = self.generics.split_for_impl();
+		let where_clause = &self.where_clause;
 
 		let arms = TokenStream2::with_tokens(|tokens| {
 			for variant in &self.variants {

From c5ef5dcc2a6551b1d48e433fe6339893ceb570a6 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 21:09:40 +0000
Subject: [PATCH 056/157] LengthString8 - String8 with its length included

---
 src/common.rs | 39 +++++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 9dd09ac1..5f9952b3 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -2,13 +2,18 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-use crate::unit::Px;
-use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
+extern crate self as xrb;
 
 use derive_more::{From, Into};
 
+pub use atom::Atom;
+pub use mask::*;
+pub use res_id::*;
+pub use wrapper::*;
+use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap, Writable};
 use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
-extern crate self as xrb;
+
+use crate::unit::Px;
 
 pub mod atom;
 pub mod set;
@@ -18,11 +23,6 @@ mod mask;
 mod res_id;
 mod wrapper;
 
-pub use atom::Atom;
-pub use mask::*;
-pub use res_id::*;
-pub use wrapper::*;
-
 /// Whether something is enabled or disabled.
 #[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
 pub enum Toggle {
@@ -328,6 +328,29 @@ impl ReadableWithContext for String8 {
 	}
 }
 
+derive_xrb! {
+	#[derive(
+		Clone,
+		Eq,
+		PartialEq,
+		Hash,
+		Debug,
+		From,
+		Into,
+		// XRBK traits
+		X11Size,
+		Readable,
+		Writable,
+	)]
+	pub struct LengthString8 {
+		#[allow(clippy::cast_possible_truncation)]
+		let len: u8 = string => string.len() as u8,
+
+		#[context(len => usize::from(*len))]
+		string: String8,
+	}
+}
+
 #[derive(
 	Copy,
 	Clone,

From 5250a7ab975d380d2022bc6037d20b19658f3687 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 21:09:56 +0000
Subject: [PATCH 057/157] ListFonts and ListFontsWithInfo requests & replies

---
 src/x11/reply.rs   | 614 +++++++++++++++++++++++++++++++++++++++++----
 src/x11/request.rs |  82 +++++-
 2 files changed, 640 insertions(+), 56 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 964b2ab2..8577a1a0 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -7,7 +7,7 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: super
 
@@ -15,9 +15,21 @@ extern crate self as xrb;
 
 use derivative::Derivative;
 
+use xrbk::{
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadResult,
+	Readable,
+	ReadableWithContext,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
+	message::Reply,
 	unit::Px,
 	visual::{ColorId, VisualId},
 	x11::request::{self, DataFormat, DataList, RevertFocus},
@@ -29,6 +41,7 @@ use crate::{
 	EventMask,
 	FocusWindow,
 	GrabStatus,
+	LengthString8,
 	MaintainContents,
 	ModifierMask,
 	Rectangle,
@@ -63,7 +76,7 @@ pub enum MapState {
 derive_xrb! {
 	/// The [reply] to a [`GetWindowAttributes` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -75,9 +88,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -161,7 +174,12 @@ derive_xrb! {
 		#[doc(alias = "save_under")]
 		pub maintain_windows_under: bool,
 
-		// TODO
+		/// Whether the [window]'s `colormap` is an installed [colormap] for
+		/// the [screen].
+		///
+		/// [window]: Window
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
 		pub map_installed: bool,
 		/// The [window]'s [map state].
 		///
@@ -235,7 +253,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetGeometry` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetGeometry` request]: request::GetGeometry
 	#[doc(alias("GetX", "GetY", "GetWidth", "GetHeight", "GetBorderWidth"))]
@@ -248,9 +266,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -291,7 +309,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryWindowTree` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryWindowTree` request]: request::QueryWindowTree
 	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
@@ -306,9 +324,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -336,7 +354,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetAtom` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetAtom` request]: request::GetAtom
 	#[doc(alias("InternAtom", "CreateAtom"))]
@@ -349,9 +367,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -380,9 +398,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -402,7 +420,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetProperty` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetProperty` request]: request::GetProperty
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -414,9 +432,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -462,7 +480,7 @@ derive_xrb! {
 
 	/// The [reply] for a [`ListProperties` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`ListProperties` request]: request::ListProperties
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -474,9 +492,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -496,7 +514,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetSelectionOwner` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetSelectionOwner` request]: request::GetSelectionOwner
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -508,9 +526,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -524,7 +542,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GrabCursor` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GrabCursor` request]: request::GrabCursor
 	#[doc(alias = "GrabPointer")]
@@ -537,9 +555,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -556,7 +574,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GrabKeyboard` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GrabKeyboard` request]: request::GrabKeyboard
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -568,9 +586,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -588,7 +606,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryCursorLocation` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryCursorLocation` request]: request::QueryCursorLocation
 	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
@@ -601,9 +619,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -664,7 +682,7 @@ pub struct TimeCoords {
 derive_xrb! {
 	/// The [reply] to a [`GetMotionHistory` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetMotionHistory` request]: request::GetMotionHistory
 	#[doc(alias = "GetMotionEvents")]
@@ -677,9 +695,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -700,7 +718,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`ConvertCoordinates` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`ConvertCoordinates` request]: request::ConvertCoordinates
 	#[doc(alias = "TranslateCoordinates")]
@@ -713,9 +731,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -750,7 +768,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetFocus` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetFocus` request]: request::GetFocus
 	#[doc(alias = "GetInputFocus")]
@@ -763,9 +781,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -784,7 +802,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryKeyboard` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryKeyboard` request]: request::QueryKeyboard
 	#[doc(alias = "QueryKeymap")]
@@ -797,9 +815,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -864,6 +882,10 @@ pub struct CharacterInfo {
 	pub attributes: u16,
 }
 
+impl ConstantX11Size for CharacterInfo {
+	const X11_SIZE: usize = 12;
+}
+
 /// A hint as to whether most [`CharacterInfo`]s in a font have a positive or
 /// negative width.
 ///
@@ -880,10 +902,14 @@ pub enum DrawDirection {
 	RightToLeft,
 }
 
+impl ConstantX11Size for DrawDirection {
+	const X11_SIZE: usize = 1;
+}
+
 derive_xrb! {
 	/// The [reply] to a [`QueryFont` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryFont` request]: request::QueryFont
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -895,9 +921,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -912,9 +938,9 @@ derive_xrb! {
 		pub max_bounds: CharacterInfo,
 		[_; 4],
 
-		/// If `min_byte1` and `max_byte1` are both zero, this is the character
-		/// index of the first element in `character_infos`. Otherwise, this is
-		/// a [`u8`] value used to index characters.
+		/// If `min_major_index` and `max_major_index` are both zero, this is
+		/// the character index of the first element in `character_infos`.
+		/// Otherwise, this is a [`u8`] value used to index characters.
 		///
 		/// If either `min_major_index` or `max_major_index` aren't zero, the
 		/// two indexes used to retrieve `character_infos` element `i` (counting
@@ -1035,7 +1061,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryTextExtents` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryTextExtents` request]: request::QueryTextExtents
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -1047,9 +1073,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -1090,4 +1116,482 @@ derive_xrb! {
 		pub overall_right: i32,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`ListFonts` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`ListFonts` request]: request::ListFonts
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListFonts: Reply for request::ListFonts {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `names`.
+		#[allow(clippy::cast_possible_truncation)]
+		let names_len: u16 = names => names.len() as u16,
+		[_; 22],
+
+		/// The names of available fonts (no more than the given
+		/// `max_names_count` will appear here, though).
+		#[context(names_len => usize::from(*names_len))]
+		pub names: Vec<LengthString8>,
+		[_; ..],
+	}
+}
+
+/// The [reply] to a [`ListFontsWithInfo` request].
+///
+/// The [`ListFontsWithInfo` request] is unique in that it has a series of
+/// multiple replies, followed by a reply to terminate that series.
+///
+/// [reply]: Reply
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+pub enum ListFontsWithInfo {
+	/// Information about one of the available fonts.
+	Font(FontWithInfo),
+	/// Indicates the end of the series of replies to the
+	/// [`ListFontsWithInfo` request].
+	///
+	/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+	Terminate(TerminateListFontsWithInfo),
+}
+
+impl Reply for ListFontsWithInfo {
+	type Request = request::ListFontsWithInfo;
+
+	fn sequence(&self) -> u16 {
+		match self {
+			Self::Font(FontWithInfo { sequence, .. })
+			| Self::Terminate(TerminateListFontsWithInfo { sequence, .. }) => *sequence,
+		}
+	}
+}
+
+impl X11Size for ListFontsWithInfo {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::Font(reply) => reply.x11_size(),
+			Self::Terminate(last) => last.x11_size(),
+		}
+	}
+}
+
+impl Readable for ListFontsWithInfo {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		let name_len = buf.get_u8();
+		let sequence = buf.get_u16();
+
+		Ok(match name_len {
+			zero if zero == 0 => Self::Terminate(<_>::read_with(buf, &sequence)?),
+
+			other => Self::Font(<_>::read_with(buf, &(other, sequence))?),
+		})
+	}
+}
+
+impl Writable for ListFontsWithInfo {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Font(reply) => reply.write_to(buf)?,
+
+			Self::Terminate(last) => last.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+/// A [reply] to a [`ListFontsWithInfo` request] that provides information about
+/// one of the available fonts.
+///
+/// A `FontWithInfo` [reply] is sent for every available font. A
+/// [`TerminateListFontsWithInfo` reply] terminates the series.
+///
+/// [reply]: Reply
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct FontWithInfo {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+
+	/// A [`CharacterInfo`] representing the minimum bounds of all fields in
+	/// each [`CharacterInfo`] in `character_infos`.
+	pub min_bounds: CharacterInfo,
+	/// A [`CharacterInfo`] representing the maximum bounds of all fields in
+	/// each [`CharacterInfo`] in `character_infos`.
+	pub max_bounds: CharacterInfo,
+
+	/// If `min_major_index` and `max_major_index` are both zero, this is the
+	/// character index of the first element in `character_infos`. Otherwise,
+	/// this is a [`u8`] value used to index characters.
+	///
+	/// If either `min_major_index` or `max_major_index` aren't zero, the
+	/// two indexes used to retrieve `character_infos` element `i` (counting
+	/// from `i = 0`) are:
+	/// ```
+	/// # let i = 0;
+	/// #
+	/// # let first_character_or_min_minor_index = 0;
+	/// # let last_character_or_max_minor_index = 1;
+	/// #
+	/// # let min_major_index = 2;
+	/// #
+	/// let major_index_range = {
+	///     last_character_or_max_minor_index
+	///     - first_character_or_min_minor_index
+	///     + 1
+	/// };
+	///
+	/// let major_index = i / major_index_range + min_major_index;
+	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+	/// ```
+	#[doc(alias = "min_char_or_byte2")]
+	pub first_character_or_min_minor_index: u16,
+	/// If `min_major_index` and `max_major_index` are both zero, this is
+	/// the character index of the last element in `character_infos`.
+	/// Otherwise, this is a [`u8`] value used to index characters.
+	///
+	/// If either `min_major_index` or `max_major_index` aren't zero, the
+	/// two indexes used to retrieve `character_infos` element `i` (counting
+	/// from `i = 0`) are:
+	/// ```
+	/// # let i = 0;
+	/// #
+	/// # let first_character_or_min_minor_index = 0;
+	/// # let last_character_or_max_minor_index = 1;
+	/// #
+	/// # let min_major_index = 2;
+	/// #
+	/// let major_index_range = {
+	///     last_character_or_max_minor_index
+	///     - first_character_or_min_minor_index
+	///     + 1
+	/// };
+	///
+	/// let major_index = i / major_index_range + min_major_index;
+	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+	/// ```
+	#[doc(alias = "max_char_or_byte2")]
+	pub last_character_or_max_minor_index: u16,
+
+	/// The character used when an undefined or nonexistent character is
+	/// used.
+	///
+	/// If a font uses two bytes to index its characters (such as that used
+	/// for [`Char16`]), the first of the two bytes is found in the most
+	/// significant byte of this `fallback_character`, and the second of the
+	/// two bytes if found in the least significant byte.
+	///
+	/// [`Char16`]: crate::Char16
+	#[doc(alias = "default_char")]
+	pub fallback_character: u16,
+
+	/// A hint as to whether most [`CharacterInfo`s] in a font have a
+	/// positive or negative width.
+	///
+	/// See [`DrawDirection`] for more information.
+	///
+	/// [`CharacterInfo`s]: CharacterInfo
+	pub draw_direction: DrawDirection,
+
+	/// The value of the major index used to retrieve the first character in the
+	/// font.
+	#[doc(alias = "min_byte1")]
+	pub min_major_index: u8,
+	/// The value of the major index used to retrieve the last character in the
+	/// font.
+	#[doc(alias = "max_byte1")]
+	pub max_major_index: u8,
+
+	/// Whether all of the characters in the font have nonzero bounds.
+	pub all_chars_exist: bool,
+
+	/// The extent of the font above the baseline, used for determining line
+	/// spacing.
+	///
+	/// Some specific characters may extend above this.
+	pub font_ascent: i16,
+	/// The extent of the font at or below the baseline, used for
+	/// determining line spacing.
+	///
+	/// Some specific characters may extend below this.
+	pub font_descent: i16,
+
+	/// A hint as to how many more [`FontWithInfo` replies] there will be.
+	///
+	/// Note that this is only a hint: there may be more or less replies than
+	/// this number. A `replies_hint` of zero does not guarantee that there will
+	/// be no more [`FontWithInfo` replies]: the only way to know that is to
+	/// receive a [`TerminateListFontsWithInfo` reply].
+	///
+	/// [`FontWithInfo` replies]: FontWithInfo
+	/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
+	pub replies_hint: u32,
+
+	/// A list of [`FontProperty`s] associated with the font.
+	///
+	/// [`FontProperty`s]: FontProperty
+	pub properties: Vec<FontProperty>,
+
+	/// The name of this font.
+	pub name: String8,
+}
+
+fn pad<T: X11Size>(thing: &T) -> usize {
+	(4 - (thing.x11_size() % 4)) % 4
+}
+
+impl X11Size for FontWithInfo {
+	fn x11_size(&self) -> usize {
+		const CONSTANT_SIZES: usize = u8::X11_SIZE // `1`
+			+ u8::X11_SIZE // length of `name`
+			+ u16::X11_SIZE // `sequence`
+			+ u32::X11_SIZE // length
+			+ CharacterInfo::X11_SIZE // `min_bounds`
+			+ 4 // 4 unused bytes
+			+ CharacterInfo::X11_SIZE // `max_bounds`
+			+ 4 // 4 unused bytes
+			+ u16::X11_SIZE // `first_character_or_min_minor_index`
+			+ u16::X11_SIZE // `last_character_or_max_minor_index`
+			+ u16::X11_SIZE // `fallback_character`
+			+ u16::X11_SIZE // length of `properties`
+			+ DrawDirection::X11_SIZE // `draw_direction`
+			+ u8::X11_SIZE // `min_major_index`
+			+ u8::X11_SIZE // `max_major_index`
+			+ bool::X11_SIZE // `all_chars_exist`
+			+ i16::X11_SIZE // `font_ascent`
+			+ i16::X11_SIZE // `font_descent`
+			+ u32::X11_SIZE; // `replies_hint`
+
+		CONSTANT_SIZES + self.properties.x11_size() + self.name.x11_size() + pad(&self.name)
+	}
+}
+
+impl ReadableWithContext for FontWithInfo {
+	type Context = (u8, u16);
+
+	fn read_with(buf: &mut impl Buf, (name_len, sequence): &(u8, u16)) -> ReadResult<Self> {
+		let name_len = usize::from(*name_len);
+
+		// We skip the first 4 bytes because:
+		// - the first, `1`, was required to know this is a reply
+		// - the second was required to know the `name_len`
+		// - the third and fourth - the sequence - were required to know that this is a
+		//   `ListFontsWithInfo` reply
+
+		// Read the length - take away the 8 bytes we've already read.
+		let length = ((buf.get_u32() as usize) * 4) + (32 - 8);
+		// Limit `buf` by the read `length`.
+		let buf = &mut buf.take(length);
+
+		let min_bounds = CharacterInfo::read_from(buf)?;
+		buf.advance(4); // 4 unused bytes
+
+		let max_bounds = CharacterInfo::read_from(buf)?;
+		buf.advance(4); // 4 unused bytes
+
+		let first_character_or_min_minor_index = u16::read_from(buf)?;
+		let last_character_or_max_minor_index = u16::read_from(buf)?;
+
+		let fallback_character = u16::read_from(buf)?;
+
+		let properties_len = usize::from(u16::read_from(buf)?);
+
+		let draw_direction = DrawDirection::read_from(buf)?;
+
+		let min_major_index = u8::read_from(buf)?;
+		let max_major_index = u8::read_from(buf)?;
+
+		let all_chars_exist = bool::read_from(buf)?;
+
+		let font_ascent = i16::read_from(buf)?;
+		let font_descent = i16::read_from(buf)?;
+
+		let replies_hint = u32::read_from(buf)?;
+
+		let properties = <Vec<FontProperty>>::read_with(buf, &properties_len)?;
+
+		let name = String8::read_with(buf, &name_len)?;
+		buf.advance(pad(&name));
+
+		Ok(Self {
+			sequence: *sequence,
+
+			min_bounds,
+			max_bounds,
+
+			first_character_or_min_minor_index,
+			last_character_or_max_minor_index,
+
+			fallback_character,
+
+			draw_direction,
+
+			min_major_index,
+			max_major_index,
+
+			all_chars_exist,
+
+			font_ascent,
+			font_descent,
+
+			replies_hint,
+
+			properties,
+
+			name,
+		})
+	}
+}
+
+impl Writable for FontWithInfo {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		buf.put_u8(1);
+		buf.put_u8(self.name.len() as u8);
+		self.sequence.write_to(buf)?;
+
+		buf.put_u32(((self.x11_size() - 32) / 4) as u32);
+
+		self.min_bounds.write_to(buf)?;
+		// 4 unused bytes.
+		buf.put_bytes(0, 4);
+
+		self.max_bounds.write_to(buf)?;
+		// 4 unused bytes.
+		buf.put_bytes(0, 4);
+
+		self.first_character_or_min_minor_index.write_to(buf)?;
+		self.last_character_or_max_minor_index.write_to(buf)?;
+
+		self.fallback_character.write_to(buf)?;
+
+		buf.put_u16(self.properties.len() as u16);
+
+		self.draw_direction.write_to(buf)?;
+
+		self.min_major_index.write_to(buf)?;
+		self.max_major_index.write_to(buf)?;
+
+		self.all_chars_exist.write_to(buf)?;
+
+		self.font_ascent.write_to(buf)?;
+		self.font_descent.write_to(buf)?;
+
+		self.replies_hint.write_to(buf)?;
+
+		self.properties.write_to(buf)?;
+
+		self.name.write_to(buf)?;
+		// Padding bytes for `name`.
+		buf.put_bytes(0, pad(&self.name));
+
+		Ok(())
+	}
+}
+
+/// A [reply] to a [`ListFontsWithInfo` request] that represents the final
+/// [reply] sent for that [request].
+///
+/// [reply]: Reply
+/// [request]: crate::message::Request
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct TerminateListFontsWithInfo {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+}
+
+impl ConstantX11Size for TerminateListFontsWithInfo {
+	const X11_SIZE: usize = 60;
+}
+
+impl X11Size for TerminateListFontsWithInfo {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Writable for TerminateListFontsWithInfo {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		// Indicates that this is a reply.
+		buf.put_u8(1);
+		// Indicates that this is the last `ListFontsWithInfo` reply.
+		buf.put_u8(0);
+
+		// The sequence number.
+		buf.put_u16(self.sequence);
+
+		// Length - the number of 4-byte units after the 32nd byte in this
+		// reply.
+		buf.put_u32(7);
+
+		// 52 unused bytes.
+		buf.put_bytes(0, 52);
+
+		Ok(())
+	}
+}
+
+impl ReadableWithContext for TerminateListFontsWithInfo {
+	type Context = u16;
+
+	fn read_with(buf: &mut impl Buf, sequence: &u16) -> ReadResult<Self> {
+		// We skip the first 4 bytes because:
+		// - the first, `1`, was required to know this is a reply
+		// - the second was required to know this is the last reply for
+		//   ListFontsWithInfo
+		// - the third and fourth - the sequence - were required to know that this is a
+		//   `ListFontsWithInfo` reply
+
+		// Then we skip the length because we know what it is meant to be... should
+		// probably verify that...
+		buf.advance(4);
+
+		// And then skip the 52 remaining unused bytes.
+		buf.advance(52);
+
+		Ok(Self {
+			sequence: *sequence,
+		})
+	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 844789fa..375de163 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3124,7 +3124,7 @@ derive_xrb! {
 		let name_len: u16 = name => name.len() as u16,
 		[_; 2],
 
-		/// A pattern match against the name of the font
+		/// A pattern match against the name of the font.
 		///
 		/// The name uses ISO Latin-1 encoding.
 		///
@@ -3201,6 +3201,9 @@ derive_xrb! {
 	/// If the font has no specified `fallback_character`, undefined characters
 	/// in the `text` are ignored.
 	///
+	/// # Replies
+	/// This [request] generates a [`QueryTextExtents` reply].
+	///
 	/// # Errors
 	/// A [`Font` error] is generated if `font` does not refer to a defined
 	/// [`Font`] nor [`GraphicsContext`].
@@ -3209,6 +3212,8 @@ derive_xrb! {
 	///
 	/// [`GraphicsContext`]: crate::GraphicsContext
 	///
+	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
+	///
 	/// [`Font` error]: error::Font
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryTextExtents: Request(48, error::Font) -> reply::QueryTextExtents {
@@ -3249,4 +3254,79 @@ derive_xrb! {
 		pub text: String16,
 		[_; odd_length => query_text_extents_padding(*odd_length)]
 	}
+
+	/// A [request] that lists the names of available fonts (as controlled by
+	/// the [font search path]).
+	///
+	/// # Replies
+	/// This [request] generates a [`ListFonts` reply].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [font search path]: SetFontPath
+	///
+	/// [`ListFonts` reply]: reply::ListFonts
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListFonts: Request(49) -> reply::ListFonts {
+		/// The maximum number of names that will appear in the returned font
+		/// `names`.
+		#[doc(alias("max_names", "max_names_len"))]
+		pub max_names_count: u16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let pattern_len: u16 = pattern => pattern.len() as u16,
+		/// A pattern match against the font names.
+		///
+		/// The case (uppercase or lowercase) of the pattern does not matter:
+		/// font names are converted to lowercase, as is the pattern.
+		///
+		/// Font names use ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(pattern_len => usize::from(*pattern_len))]
+		pub pattern: String8,
+		[_; ..],
+	}
+
+	/// A [request] that lists available fonts (as controlled by the
+	/// [font search path]) with information about them.
+	///
+	/// The information returned for each font almost entirely matches that returned in a
+	/// [`QueryFont` reply].
+	///
+	/// # Replies
+	/// This [request] generates a [`ListFonts` reply].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [font search path]: SetFontPath
+	///
+	/// [`ListFonts` reply]: reply::ListFonts
+	/// [`QueryFont` reply]: reply::QueryFont
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListFontsWithInfo: Request(50) -> reply::ListFontsWithInfo {
+		/// The maximum number of [`FontWithInfo` replies] that will be returned.
+		///
+		/// [`FontWithInfo` replies]: reply::FontWithInfo
+		#[doc(alias("max_names", "max_names_len"))]
+		pub max_fonts_count: u16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let pattern_len: u16 = pattern => pattern.len() as u16,
+		/// A pattern match against the font names.
+		///
+		/// The case (uppercase or lowercase) of the pattern does not matter:
+		/// font names are converted to lowercase, as is the pattern.
+		///
+		/// Font names use ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(pattern_len => usize::from(*pattern_len))]
+		pub pattern: String8,
+		[_; ..],
+	}
 }

From 28b5e945ae5370898abf090cb4af43af8b69d177 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 25 Jan 2023 21:11:15 +0000
Subject: [PATCH 058/157] [CI800] applied recommended clippy fixes

---
 src/common.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/common.rs b/src/common.rs
index 5f9952b3..b9eb658e 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -10,7 +10,7 @@ pub use atom::Atom;
 pub use mask::*;
 pub use res_id::*;
 pub use wrapper::*;
-use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap, Writable};
+use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
 use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use crate::unit::Px;

From 8da603a9cb6eb542573a487329cd45498fe10d27 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 22:41:13 +0000
Subject: [PATCH 059/157] SetFontPath request

---
 src/x11/request.rs | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 375de163..01667ad9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -51,6 +51,7 @@ use crate::{
 	Fontable,
 	FreezeMode,
 	Keycode,
+	LengthString8,
 	Rectangle,
 	String16,
 	String8,
@@ -3329,4 +3330,31 @@ derive_xrb! {
 		pub pattern: String8,
 		[_; ..],
 	}
+
+	/// A [request] that defines the directories which are searched for
+	/// available fonts.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if the operating system rejects the given
+	/// paths for whatever reason.
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`Value` error]: error::Value
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetFontPath: Request(51, error::Value) {
+		// The length of `directories`.
+		#[allow(clippy::cast_possible_truncation)]
+		let directories_len: u16 = directories => directories.len() as u16,
+		[_; 2],
+
+		/// The directories to be searched in the order listed.
+		///
+		/// Specifying an empty list here restores the default font search path
+		/// defined for the X server.
+		#[doc(alias = "path")]
+		#[context(directories_len => usize::from(*directories_len))]
+		pub directories: Vec<LengthString8>,
+		[_; ..],
+	}
 }

From ed6307b64c4c2483a31187e42591c8e8548329cb Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 25 Jan 2023 22:49:15 +0000
Subject: [PATCH 060/157] GetFontSearchDirectories request + reply

---
 src/x11/reply.rs   | 36 ++++++++++++++++++++++++++++++++++++
 src/x11/request.rs | 16 +++++++++++++---
 2 files changed, 49 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 8577a1a0..15a7779e 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -1595,3 +1595,39 @@ impl ReadableWithContext for TerminateListFontsWithInfo {
 		})
 	}
 }
+
+derive_xrb! {
+	/// The [reply] to a [`GetFontSearchDirectories` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetFontSearchDirectories` request]: request::GetFontSearchDirectories
+	#[doc(alias = "GetFontPath")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetFontSearchDirectories: Reply for request::GetFontSearchDirectories {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `directories`.
+		#[allow(clippy::cast_possible_truncation)]
+		let directories_len: u16 = directories => directories.len() as u16,
+		[_; 22],
+
+		/// The directories that are searched in the order listed.
+		#[doc(alias = "path")]
+		#[context(directories_len => usize::from(*directories_len))]
+		pub directories: Vec<LengthString8>,
+		[_; ..],
+	}
+}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 01667ad9..1555c3ff 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3264,7 +3264,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	///
-	/// [font search path]: SetFontPath
+	/// [font search path]: SetFontSearchDirectories
 	///
 	/// [`ListFonts` reply]: reply::ListFonts
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
@@ -3302,7 +3302,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	///
-	/// [font search path]: SetFontPath
+	/// [font search path]: SetFontSearchDirectories
 	///
 	/// [`ListFonts` reply]: reply::ListFonts
 	/// [`QueryFont` reply]: reply::QueryFont
@@ -3341,8 +3341,9 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	///
 	/// [`Value` error]: error::Value
+	#[doc(alias = "SetFontPath")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetFontPath: Request(51, error::Value) {
+	pub struct SetFontSearchDirectories: Request(51, error::Value) {
 		// The length of `directories`.
 		#[allow(clippy::cast_possible_truncation)]
 		let directories_len: u16 = directories => directories.len() as u16,
@@ -3357,4 +3358,13 @@ derive_xrb! {
 		pub directories: Vec<LengthString8>,
 		[_; ..],
 	}
+
+	/// A [request] that returns the current directories which are searched to
+	/// find available fonts.
+	///
+	/// See also: [`SetFontSearchDirectories`].
+	///
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
 }

From 2b6edb4f162ab96ae22ed617b5c304553869a392 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 26 Jan 2023 21:31:58 +0000
Subject: [PATCH 061/157] CreatePixmap request

---
 src/x11/request.rs | 110 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 107 insertions(+), 3 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 1555c3ff..a8f0bcd3 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -52,6 +52,7 @@ use crate::{
 	FreezeMode,
 	Keycode,
 	LengthString8,
+	Pixmap,
 	Rectangle,
 	String16,
 	String8,
@@ -130,7 +131,7 @@ derive_xrb! {
 		///
 		/// # Errors
 		/// If the provided [`Window` ID][window] is already used or it is not
-		/// allocated to this client, a [`ResourceIdChoice` error] is generated.
+		/// allocated to your client, a [`ResourceIdChoice` error] is generated.
 		///
 		/// [window]: Window
 		///
@@ -888,7 +889,7 @@ derive_xrb! {
 	/// defined [window] nor [pixmap].
 	///
 	/// [window]: Window
-	/// [pixmap]: crate::Pixmap
+	/// [pixmap]: Pixmap
 	/// [drawable]: Drawable
 	/// [request]: crate::message::Request
 	///
@@ -906,7 +907,7 @@ derive_xrb! {
 		/// defined [window] nor [pixmap].
 		///
 		/// [window]: Window
-		/// [pixmap]: crate::Pixmap
+		/// [pixmap]: Pixmap
 		/// [drawable]: Drawable
 		/// [request]: crate::message::Request
 		///
@@ -3368,3 +3369,106 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
 }
+
+/// An [error] generated because of a failed [`CreatePixmap` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`CreatePixmap` request]: CreatePixmap
+pub enum CreatePixmapError {
+	/// A [`Drawable` error].
+	///
+	/// [`Drawable` error]: error::Drawable
+	Drawable(error::Drawable),
+	/// A [`ResourceIdChoice` error].
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	ResourceIdChoice(error::ResourceIdChoice),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [pixmap] and assigned the provided
+	/// [`Pixmap` ID][pixmap] to it.
+	///
+	/// The initial contents of the [pixmap] are undefined.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if `depth` is not a depth supported by
+	/// the `drawable`'s root [window].
+	///
+	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
+	/// already used for another resource, or an ID not allocated to your client.
+	///
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`]: crate::GraphicsContext
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Value` error]: error::Value
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreatePixmap: Request(53, CreatePixmapError) {
+		/// The depth of the [pixmap].
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this depth is not supported by the
+		/// root [window] of the `drawable`.
+		///
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Value` error]: error::Value
+		#[metabyte]
+		pub depth: u8,
+
+		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is already used or if
+		/// it isn't allocated to your client.
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias = "pid")]
+		pub pixmap_id: Pixmap,
+		// TODO: what is this for??
+		//       possible theory: pixmaps are references to drawables, which are either other
+		//       pixmaps referring to other drawables, or windows...
+		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
+		/// [request].
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [`GraphicsContext`].
+		///
+		/// [window]: Window
+		/// [drawable]: Drawable
+		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext`]: crate::GraphicsContext
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub drawable: Drawable,
+
+		/// The width of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub width: Px<u16>,
+		/// The height of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub height: Px<u16>,
+	}
+}

From 6d6e73c69773ef1c805a0bb03cfcd3ac6e1c8b3f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 26 Jan 2023 21:37:54 +0000
Subject: [PATCH 062/157] FreePixmap request

---
 src/x11/request.rs | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index a8f0bcd3..4500c489 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3471,4 +3471,33 @@ derive_xrb! {
 		/// [pixmap]: Pixmap
 		pub height: Px<u16>,
 	}
+
+	/// A [request] that removes the association between a given
+	/// [`Pixmap` ID][pixmap] and the [pixmap] it is associated with.
+	///
+	/// The stored [pixmap] will be freed when it is no longer referenced by any
+	/// other resource.
+	///
+	/// # Errors
+	/// A [`Pixmap` error] is generated if `target` does not refer to a defined
+	/// [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [request]: crate::message::Request
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FreePixmap: Request(54, error::Pixmap) {
+		/// The [pixmap] which is to have its association with its ID removed.
+		///
+		/// # Errors
+		/// A [`Pixmap` error] is generated if this does not refer to a defined
+		/// [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Pixmap` error]: error::Pixmap
+		#[doc(alias = "pixmap")]
+		pub target: Pixmap,
+	}
 }

From 656fe98a7ee84c2cb037e32c5a30389edc48e533 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 26 Jan 2023 21:59:29 +0000
Subject: [PATCH 063/157] CreateGraphicsContext request

---
 src/common/set/graphics_options.rs |   5 ++
 src/x11/request.rs                 | 119 +++++++++++++++++++++++++----
 2 files changed, 110 insertions(+), 14 deletions(-)

diff --git a/src/common/set/graphics_options.rs b/src/common/set/graphics_options.rs
index 53e64258..0f50fca7 100644
--- a/src/common/set/graphics_options.rs
+++ b/src/common/set/graphics_options.rs
@@ -12,6 +12,7 @@ use crate::{
 	Pixmap,
 };
 use bitflags::bitflags;
+use derivative::Derivative;
 use xrbk::{
 	Buf,
 	BufMut,
@@ -330,9 +331,13 @@ pub type ClipMask = Option<Pixmap>;
 /// [`clip_mask`]: GraphicsOptions::clip_mask
 /// [`dash_offset`]: GraphicsOptions::dash_offset
 /// [`dashes`]: GraphicsOptions::dashes
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
 pub struct GraphicsOptions {
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
 	x11_size: usize,
 
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
 	mask: GraphicsOptionsMask,
 
 	function: Option<__Function>,
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 4500c489..e4b945cb 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -29,7 +29,7 @@ use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Event,
-	set::{Attributes, WindowConfig},
+	set::{Attributes, GraphicsOptions, WindowConfig},
 	unit::Px,
 	visual::VisualId,
 	x11::{error, reply},
@@ -50,6 +50,7 @@ use crate::{
 	Font,
 	Fontable,
 	FreezeMode,
+	GraphicsContext,
 	Keycode,
 	LengthString8,
 	Pixmap,
@@ -3164,7 +3165,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	///
-	/// [`GraphicsContext`]: crate::GraphicsContext
+	/// [`GraphicsContext`]: GraphicsContext
 	///
 	/// [`QueryFont` reply]: reply::QueryFont
 	///
@@ -3179,7 +3180,7 @@ derive_xrb! {
 		///
 		/// [request]: crate::message::Request
 		///
-		/// [`GraphicsContext`]: crate::GraphicsContext
+		/// [`GraphicsContext`]: GraphicsContext
 		///
 		/// [`Font` error]: error::Font
 		pub target: Fontable,
@@ -3212,7 +3213,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	///
-	/// [`GraphicsContext`]: crate::GraphicsContext
+	/// [`GraphicsContext`]: GraphicsContext
 	///
 	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
 	///
@@ -3230,7 +3231,7 @@ derive_xrb! {
 		/// A [`Font` error] is generated if this does not refer to a defined
 		/// [`Font`] nor [`GraphicsContext`].
 		///
-		/// [`GraphicsContext`]: crate::GraphicsContext
+		/// [`GraphicsContext`]: GraphicsContext
 		///
 		/// [`Font` error]: error::Font
 		pub font: Fontable,
@@ -3391,7 +3392,7 @@ pub enum CreatePixmapError {
 }
 
 derive_xrb! {
-	/// A [request] that creates a new [pixmap] and assigned the provided
+	/// A [request] that creates a new [pixmap] and assigns the provided
 	/// [`Pixmap` ID][pixmap] to it.
 	///
 	/// The initial contents of the [pixmap] are undefined.
@@ -3404,14 +3405,12 @@ derive_xrb! {
 	/// already used for another resource, or an ID not allocated to your client.
 	///
 	/// A [`Drawable` error] is generated if `drawable` does not refer to a
-	/// defined [window] nor [`GraphicsContext`].
+	/// defined [window] nor [pixmap].
 	///
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [request]: crate::message::Request
 	///
-	/// [`GraphicsContext`]: crate::GraphicsContext
-	///
 	/// [`Drawable` error]: error::Drawable
 	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
 	/// [`Value` error]: error::Value
@@ -3433,8 +3432,8 @@ derive_xrb! {
 		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
 		///
 		/// # Errors
-		/// A [`ResourceIdChoice` error] is generated if this resource ID is already used or if
-		/// it isn't allocated to your client.
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
 		///
 		/// [pixmap]: Pixmap
 		///
@@ -3449,14 +3448,13 @@ derive_xrb! {
 		///
 		/// # Errors
 		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [`GraphicsContext`].
+		/// defined [window] nor [pixmap].
 		///
 		/// [window]: Window
+		/// [pixmap]: Pixmap
 		/// [drawable]: Drawable
 		/// [request]: crate::message::Request
 		///
-		/// [`GraphicsContext`]: crate::GraphicsContext
-		///
 		/// [`InputOnly`]: WindowClass::InputOnly
 		///
 		/// [`Drawable` error]: error::Drawable
@@ -3501,3 +3499,96 @@ derive_xrb! {
 		pub target: Pixmap,
 	}
 }
+
+/// An [error] generated because of a failed [`CreateGraphicsContext` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`CreateGraphicsContext` request]: CreateGraphicsContext
+pub enum CreateGraphicsContextError {
+	/// A [`Drawable` error].
+	///
+	/// [`Drawable` error]: error::Drawable
+	Drawable(error::Drawable),
+	/// A [`Font` error].
+	///
+	/// [`Font` error]: error::Font
+	Font(error::Font),
+	/// A [`ResourceIdChoice` error].
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	ResourceIdChoice(error::ResourceIdChoice),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Pixmap` error].
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	Pixmap(error::Pixmap),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [`GraphicsContext`] and assigns the
+	/// provided [`GraphicsContext` ID] to it.
+	///
+	/// # Errors
+	/// A [`ResourceIdChoice` error] is generated if `graphics_context_id`
+	/// specifies an ID already used for another resource, or an ID which is not
+	/// allocated to your client.
+	///
+	/// A [`Drawable` error] is generated if `source` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Drawable` error]: error::Drawable
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
+		/// The [`GraphicsContext` ID] which is to be assigned to the
+		/// [`GraphicsContext`].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [`GraphicsContext` ID]: GraphicsContext
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		pub graphics_context_id: GraphicsContext,
+		// FIXME: is this the source???
+		/// The [drawable] used as the 'source' in graphics operations.
+		///
+		/// See also: [`Function`].
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Function`]: crate::set::Function
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub source: Drawable,
+
+		/// The [graphics options] with which the [`GraphicsContext`] is configured.
+		///
+		/// These options are used when the [`GraphicsContext`] is used in
+		/// graphics operations.
+		///
+		/// [graphics options]: GraphicsOptions
+		pub graphics_options: GraphicsOptions,
+	}
+}

From 894d1c8bbfde49f8959b5205a36f7d9fee706bae Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 09:47:43 +0000
Subject: [PATCH 064/157] ChangeGraphicsOptions request

---
 src/x11/request.rs | 101 +++++++++++++++++++++++++++++++++++++++------
 1 file changed, 88 insertions(+), 13 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index e4b945cb..344b4c2d 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3296,17 +3296,17 @@ derive_xrb! {
 	/// A [request] that lists available fonts (as controlled by the
 	/// [font search path]) with information about them.
 	///
-	/// The information returned for each font almost entirely matches that returned in a
-	/// [`QueryFont` reply].
+	/// The information returned for each font almost entirely matches that
+	/// returned in a [`QueryFont` reply].
 	///
 	/// # Replies
-	/// This [request] generates a [`ListFonts` reply].
+	/// This [request] generates [`ListFontsWithInfo` replies].
 	///
 	/// [request]: crate::message::Request
 	///
 	/// [font search path]: SetFontSearchDirectories
 	///
-	/// [`ListFonts` reply]: reply::ListFonts
+	/// [`ListFontsWithInfo` replies]: reply::ListFontsWithInfo
 	/// [`QueryFont` reply]: reply::QueryFont
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ListFontsWithInfo: Request(50) -> reply::ListFontsWithInfo {
@@ -3402,7 +3402,8 @@ derive_xrb! {
 	/// the `drawable`'s root [window].
 	///
 	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
-	/// already used for another resource, or an ID not allocated to your client.
+	/// already used for another resource, or an ID not allocated to your
+	/// client.
 	///
 	/// A [`Drawable` error] is generated if `drawable` does not refer to a
 	/// defined [window] nor [pixmap].
@@ -3441,8 +3442,6 @@ derive_xrb! {
 		#[doc(alias = "pid")]
 		pub pixmap_id: Pixmap,
 		// TODO: what is this for??
-		//       possible theory: pixmaps are references to drawables, which are either other
-		//       pixmaps referring to other drawables, or windows...
 		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
 		/// [request].
 		///
@@ -3552,6 +3551,7 @@ derive_xrb! {
 	///
 	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
 	/// [`Drawable` error]: error::Drawable
+	#[doc(alias("CreateGc", "CreateGC", "CreateGcontext", "CreateGContext"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
 		/// The [`GraphicsContext` ID] which is to be assigned to the
@@ -3565,8 +3565,8 @@ derive_xrb! {
 		///
 		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
 		pub graphics_context_id: GraphicsContext,
-		// FIXME: is this the source???
-		/// The [drawable] used as the 'source' in graphics operations.
+
+		/// The [drawable] used as the source in graphics operations.
 		///
 		/// See also: [`Function`].
 		///
@@ -3583,12 +3583,87 @@ derive_xrb! {
 		/// [`Drawable` error]: error::Drawable
 		pub source: Drawable,
 
-		/// The [graphics options] with which the [`GraphicsContext`] is configured.
-		///
-		/// These options are used when the [`GraphicsContext`] is used in
-		/// graphics operations.
+		/// The [graphics options] used in graphics operations when this
+		/// [`GraphicsContext`] is provided.
 		///
 		/// [graphics options]: GraphicsOptions
 		pub graphics_options: GraphicsOptions,
 	}
 }
+
+/// An [error] generated because of a failed [`ChangeGraphicsOptions` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+#[doc(alias("ChangeGcError", "ChangeGCError", "ChangeGraphicsContextError"))]
+pub enum ChangeGraphicsOptionsError {
+	/// A [`Font` error].
+	///
+	/// [`Font` error]: error::Font
+	Font(error::Font),
+	/// A [`GraphicsContext` error].
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	GraphicsContext(error::GraphicsContext),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Pixmap` error].
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	Pixmap(error::Pixmap),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+}
+
+derive_xrb! {
+	/// A [request] that changes the [graphics options] configured in a
+	/// [`GraphicsContext`].
+	///
+	/// Changing the [`clip_mask`] overrides any [`SetClipRectangles` request]
+	/// on the [`GraphicsContext`].
+	///
+	/// Changing [`dash_offset`] or [`dashes`] overrides any
+	/// [`SetDashes` request] on the [`GraphicsContext`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [graphics options]: GraphicsOptions
+	///
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	/// [`SetDashes` request]: SetDashes
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("ChangeGc", "ChangeGC", "ChangeGraphicsContext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeGraphicsOptions: Request(56, ChangeGraphicsOptionsError) {
+		/// The [`GraphicsContext`] for which this [request] changes its
+		/// [graphics options].
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [graphics options]: GraphicsOptions
+		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		pub target: GraphicsContext,
+
+		/// The changes which are made to the `target`'s [graphics options].
+		///
+		/// [graphics options]: GraphicsOptions
+		pub changed_options: GraphicsOptions,
+	}
+}

From f577f0878b7a2a466e922246ca5eac3f98c66df5 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 13:33:45 +0000
Subject: [PATCH 065/157] CopyGraphicsOptions request

---
 src/x11/request.rs | 101 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 100 insertions(+), 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 344b4c2d..fabc610b 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -29,7 +29,7 @@ use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Event,
-	set::{Attributes, GraphicsOptions, WindowConfig},
+	set::{Attributes, GraphicsOptions, GraphicsOptionsMask, WindowConfig},
 	unit::Px,
 	visual::VisualId,
 	x11::{error, reply},
@@ -3564,6 +3564,7 @@ derive_xrb! {
 		/// [`GraphicsContext` ID]: GraphicsContext
 		///
 		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias("cid", "gid", "gcid", "context_id"))]
 		pub graphics_context_id: GraphicsContext,
 
 		/// The [drawable] used as the source in graphics operations.
@@ -3581,12 +3582,16 @@ derive_xrb! {
 		/// [`Function`]: crate::set::Function
 		///
 		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable", "src", "source_drawable", "src_drawable"))]
 		pub source: Drawable,
 
 		/// The [graphics options] used in graphics operations when this
 		/// [`GraphicsContext`] is provided.
 		///
 		/// [graphics options]: GraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
 		pub graphics_options: GraphicsOptions,
 	}
 }
@@ -3659,11 +3664,105 @@ derive_xrb! {
 		/// [request]: crate::message::Request
 		///
 		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context"))]
 		pub target: GraphicsContext,
 
 		/// The changes which are made to the `target`'s [graphics options].
 		///
 		/// [graphics options]: GraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
 		pub changed_options: GraphicsOptions,
 	}
 }
+
+/// An [error] generated because of a failed [`CopyGraphicsOptions` request].
+///
+/// [error]: crate::message::Error
+///
+/// [`CopyGraphicsOptions` request]: CopyGraphicsOptions
+#[doc(alias(
+	"CopyGcError",
+	"CopyGCError",
+	"CopyGraphicsContextError",
+	"CopyGcontextError"
+))]
+pub enum CopyGraphicsOptionsError {
+	/// A [`GraphicsContext` error].
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	GraphicsContext(error::GraphicsContext),
+	/// A [`Match` error].
+	///
+	/// [`Match` error]: error::Match
+	Match(error::Match),
+	/// A [`Value` error].
+	///
+	/// [`Value` error]: error::Value
+	Value(error::Value),
+}
+
+derive_xrb! {
+	/// A [request] that copies the specified [graphics options] from the
+	/// `source` [`GraphicsContext`] into the `destination` [`GraphicsContext`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if either the `source` or the
+	/// `destination` do not refer to defined [`GraphicsContext`s].
+	///
+	/// A [`Match` error] is generated if the `source` and the `destination` do
+	/// not have the same root [window] and depth.
+	///
+	/// [graphics options]: GraphicsOptions
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`s]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
+		/// The [`GraphicsContext`] from which the [options] specified in
+		/// `options_mask` are copied.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("src_gc", "source_graphics_context", "src"))]
+		pub source: GraphicsContext,
+		/// The [`GraphicsContext`] into which the [options] specified in
+		/// `options_mask` are copied from the `source`.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `source`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("dst_gc", "destination_graphics_context", "dst"))]
+		pub destination: GraphicsContext,
+
+		/// A mask that specifies which options are copied from the `source`
+		/// into the `destination`.
+		#[doc(alias("value_mask"))]
+		pub options_mask: GraphicsOptionsMask,
+	}
+}

From eae37426ded56e80f45bf7effa52a1ee3d6f70f3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 13:45:24 +0000
Subject: [PATCH 066/157] use explicit padding unused bytes for dynamic padding

Closes #96.
---
 src/common.rs      |  6 +++---
 src/x11/reply.rs   | 11 ++++-------
 src/x11/request.rs | 17 +++++++++--------
 xrbk/src/lib.rs    | 17 +++++++++++++++--
 4 files changed, 31 insertions(+), 20 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index b9eb658e..b59d210d 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -3,15 +3,15 @@
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
 extern crate self as xrb;
+use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use derive_more::{From, Into};
+use xrbk::{pad, Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
 
 pub use atom::Atom;
 pub use mask::*;
 pub use res_id::*;
 pub use wrapper::*;
-use xrbk::{Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
-use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use crate::unit::Px;
 
@@ -491,6 +491,6 @@ derive_xrb! {
 
 		#[context(address_len => *address_len as usize)]
 		pub address: Vec<u8>,
-		[_; ..],
+		[_; address => pad(address)],
 	}
 }
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 15a7779e..943f145a 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -16,6 +16,7 @@ extern crate self as xrb;
 use derivative::Derivative;
 
 use xrbk::{
+	pad,
 	Buf,
 	BufMut,
 	ConstantX11Size,
@@ -415,7 +416,7 @@ derive_xrb! {
 		/// [atom]: Atom
 		#[context(name_len => usize::from(*name_len))]
 		pub name: String8,
-		[_; ..],
+		[_; name => pad(name)],
 	}
 
 	/// The [reply] to a [`GetProperty` request].
@@ -1147,7 +1148,7 @@ derive_xrb! {
 		/// `max_names_count` will appear here, though).
 		#[context(names_len => usize::from(*names_len))]
 		pub names: Vec<LengthString8>,
-		[_; ..],
+		[_; names => pad(names)],
 	}
 }
 
@@ -1365,10 +1366,6 @@ pub struct FontWithInfo {
 	pub name: String8,
 }
 
-fn pad<T: X11Size>(thing: &T) -> usize {
-	(4 - (thing.x11_size() % 4)) % 4
-}
-
 impl X11Size for FontWithInfo {
 	fn x11_size(&self) -> usize {
 		const CONSTANT_SIZES: usize = u8::X11_SIZE // `1`
@@ -1628,6 +1625,6 @@ derive_xrb! {
 		#[doc(alias = "path")]
 		#[context(directories_len => usize::from(*directories_len))]
 		pub directories: Vec<LengthString8>,
-		[_; ..],
+		[_; directories => pad(directories)],
 	}
 }
diff --git a/src/x11/request.rs b/src/x11/request.rs
index fabc610b..abca1822 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -10,8 +10,10 @@
 //! [core X11 protocol]: super
 
 extern crate self as xrb;
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use xrbk::{
+	pad,
 	Buf,
 	BufMut,
 	ConstantX11Size,
@@ -25,7 +27,6 @@ use xrbk::{
 	WriteResult,
 	X11Size,
 };
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Event,
@@ -999,7 +1000,7 @@ derive_xrb! {
 		/// [atom]: Atom
 		#[context(name_len => usize::from(*name_len))]
 		pub name: String8,
-		[_; ..],
+		[_; name => pad(name)],
 	}
 
 	/// A [request] that returns the name of the given [atom].
@@ -3136,7 +3137,7 @@ derive_xrb! {
 		/// characters (like `.*` in regular expressions).
 		#[context(name_len => usize::from(*name_len))]
 		pub name: String8,
-		[_; ..],
+		[_; name => pad(name)],
 	}
 
 	/// A [request] that removes the association between a given [`Font` ID] and
@@ -3290,7 +3291,7 @@ derive_xrb! {
 		/// characters (like `.*` in regular expressions).
 		#[context(pattern_len => usize::from(*pattern_len))]
 		pub pattern: String8,
-		[_; ..],
+		[_; pattern => pad(pattern)],
 	}
 
 	/// A [request] that lists available fonts (as controlled by the
@@ -3330,7 +3331,7 @@ derive_xrb! {
 		/// characters (like `.*` in regular expressions).
 		#[context(pattern_len => usize::from(*pattern_len))]
 		pub pattern: String8,
-		[_; ..],
+		[_; pattern => pad(pattern)],
 	}
 
 	/// A [request] that defines the directories which are searched for
@@ -3353,12 +3354,12 @@ derive_xrb! {
 
 		/// The directories to be searched in the order listed.
 		///
-		/// Specifying an empty list here restores the default font search path
-		/// defined for the X server.
+		/// Specifying an empty list here restores the default font search
+		/// directories defined for the X server.
 		#[doc(alias = "path")]
 		#[context(directories_len => usize::from(*directories_len))]
 		pub directories: Vec<LengthString8>,
-		[_; ..],
+		[_; directories => pad(directories)],
 	}
 
 	/// A [request] that returns the current directories which are searched to
diff --git a/xrbk/src/lib.rs b/xrbk/src/lib.rs
index 8ba6f3b1..14d2b0a4 100644
--- a/xrbk/src/lib.rs
+++ b/xrbk/src/lib.rs
@@ -33,13 +33,26 @@ use std::{
 	fmt::{Debug, Display},
 };
 
+pub use bytes::{Buf, BufMut};
 use thiserror::Error;
 
+/// Determines the number of unused bytes required to be inserted after the
+/// given `value` to reach a multiple of four bytes in size.
+///
+/// This is frequently used in X11 because all messages must have a total length
+/// that is a multiple of four bytes. This function can determine how many
+/// unused bytes need to be added to ensure that.
+pub fn pad<T: X11Size>(value: &T) -> usize {
+	const ALIGNMENT: usize = 4;
+
+	let x11_size = value.x11_size();
+
+	(ALIGNMENT - (x11_size % ALIGNMENT)) % ALIGNMENT
+}
+
 pub type ReadResult<T> = Result<T, ReadError>;
 pub type WriteResult = Result<(), WriteError>;
 
-pub use bytes::{Buf, BufMut};
-
 pub trait DebugDisplay: Debug + Display {}
 impl<T: Debug + Display> DebugDisplay for T {}
 

From f89c732d3aa012d662ff61df89548b25a422e822 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 14:14:59 +0000
Subject: [PATCH 067/157] use declarative macro for request errors

---
 src/x11/request.rs | 674 +++++++++++++--------------------------------
 1 file changed, 194 insertions(+), 480 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index abca1822..e27041bf 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -62,40 +62,55 @@ use crate::{
 	WindowClass,
 };
 
-/// An [error] generated because of a failed [`CreateWindow` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`CreateWindow` request]: CreateWindow
-pub enum CreateWindowError {
-	/// A [`Colormap` error].
-	///
-	/// [`Colormap` error]: error::Colormap
-	Colormap(error::Colormap),
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	CursorAppearance(error::CursorAppearance),
-	/// A [`ResourceIdChoice` error].
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	ResourceIdChoice(error::ResourceIdChoice),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Pixmap` error].
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	Pixmap(error::Pixmap),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+macro_rules! request_error {
+	(
+		$vis:vis enum $Name:ident for $Request:ident {
+			$FirstError:ident
+			$(, $Error:ident)+
+			$(,)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		$vis enum $Name {
+			#[doc = concat!(
+				"A [`",
+				stringify!($FirstError),
+				"` error](error::",
+				stringify!($FirstError),
+				")."
+			)]
+			$FirstError(error::$FirstError)
+
+			$(,
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			)+
+		}
+	};
+}
+
+request_error! {
+	pub enum CreateWindowError for CreateWindow {
+		Colormap,
+		CursorAppearance,
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -208,40 +223,16 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ChangeWindowAttributes` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ChangeWindowAttributes` request]: ChangeWindowAttributes
-pub enum ChangeWindowAttributesError {
-	/// An [`Access` error].
-	///
-	/// [`Access` error]: error::Access
-	Access(error::Access),
-	/// A [`Colormap` error].
-	///
-	/// [`Colormap` error]: error::Colormap
-	Colormap(error::Colormap),
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	CursorAppearance(error::CursorAppearance),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Pixmap` error].
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	Pixmap(error::Pixmap),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ChangeWindowAttributesError for ChangeWindowAttributes {
+		Access,
+		Colormap,
+		CursorAppearance,
+		Match,
+		Pixmap,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -364,24 +355,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ChangeSavedWindows` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ChangeSavedWindows` request]: ChangeSavedWindows
-pub enum ChangeSavedWindowsError {
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ChangeSavedWindowsError for ChangeSavedWindows {
+		Match,
+		Value,
+		Window,
+	}
 }
 
 /// Whether something is added or removed.
@@ -447,20 +426,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ReparentWindow` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ReparentWindow` request]: ReparentWindow
-pub enum ReparentWindowError {
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ReparentWindowError for ReparentWindow {
+		Match,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -690,24 +660,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ConfigureWindow` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ConfigureWindow` request]: ConfigureWindow
-pub enum ConfigureWindowError {
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ConfigureWindowError for ConfigureWindow {
+		Match,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -796,20 +754,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`CirculateWindow` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`CirculateWindow` request]: CirculateWindow
-pub enum CirculateWindowError {
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum CirculateWindowError for CirculateWindow {
+		Value,
+		Window,
+	}
 }
 
 /// The direction with which a [window]'s mapped children are circulated in
@@ -1035,29 +984,13 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because a [`ModifyProperty` request] failed.
-///
-/// [error]: crate::message::Error
-///
-/// [`ModifyProperty` request]: ModifyProperty
-#[doc(alias = "ChangePropertyError")]
-pub enum ModifyPropertyError {
-	/// An [`Atom` error].
-	///
-	/// [`Atom` error]: error::Atom
-	Atom(error::Atom),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ModifyPropertyError for ModifyProperty {
+		Atom,
+		Match,
+		Value,
+		Window,
+	}
 }
 
 /// Whether a property is [replaced], [prepended] to a [window]'s list of
@@ -1316,20 +1249,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`DeleteProperty` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`DeleteProperty` request]: DeleteProperty
-pub enum DeletePropertyError {
-	/// An [`Atom` error].
-	///
-	/// [`Atom` error]: error::Atom
-	Atom(error::Atom),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum DeletePropertyError for DeleteProperty {
+		Atom,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1382,24 +1306,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`GetProperty` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`GetProperty` request]: GetProperty
-pub enum GetPropertyError {
-	/// An [`Atom` error].
-	///
-	/// [`Atom` error]: error::Atom
-	Atom(error::Atom),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum GetPropertyError for GetProperty {
+		Atom,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1519,20 +1431,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`SetSelectionOwner` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`SetSelectionOwner` request]: SetSelectionOwner
-pub enum SetSelectionOwnerError {
-	/// An [`Atom` error].
-	///
-	/// [`Atom` error]: error::Atom
-	Atom(error::Atom),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum SetSelectionOwnerError for SetSelectionOwner {
+		Atom,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1634,20 +1537,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ConvertSelection` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ConvertSelection` request]: ConvertSelection
-pub enum ConvertSelectionError {
-	/// An [`Atom` error].
-	///
-	/// [`Atom` error]: error::Atom
-	Atom(error::Atom),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum ConvertSelectionError for ConvertSelection {
+		Atom,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1712,20 +1606,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`SendEvent` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`SendEvent` request]: SendEvent
-pub enum SendEventError {
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum SendEventError for SendEvent {
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1800,26 +1685,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`GrabCursor` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`GrabCursor` request]: GrabCursor
-#[doc(alias = "GrabPointerError")]
-pub enum GrabCursorError {
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[doc(alias = "Cursor")]
-	CursorAppearance(error::CursorAppearance),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum GrabCursorError for GrabCursor {
+		CursorAppearance,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -1970,28 +1841,13 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`GrabButton` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`GrabButton` request]: GrabButton
-pub enum GrabButtonError {
-	/// An [`Access` error].
-	///
-	/// [`Access` error]: error::Access
-	Access(error::Access),
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	CursorAppearance(error::CursorAppearance),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum GrabButtonError for GrabButton {
+		Access,
+		CursorAppearance,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -2145,20 +2001,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`UngrabButton` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`UngrabButton` request]: UngrabButton
-pub enum UngrabButtonError {
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum UngrabButtonError for UngrabButton {
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -2222,21 +2069,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ChangeActiveCursorGrab` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ChangeActiveCursorGrab` request]: ChangeActiveCursorGrab
-#[doc(alias = "ChangeActivePointerGrabError")]
-pub enum ChangeActiveCursorGrabError {
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	CursorAppearance(error::CursorAppearance),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
+request_error! {
+	pub enum ChangeActiveCursorGrabError for ChangeActiveCursorGrab {
+		CursorAppearance,
+		Value,
+	}
 }
 
 derive_xrb! {
@@ -2293,20 +2130,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`GrabKeyboard` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`GrabKeyboard` request]: GrabKeyboard
-pub enum GrabKeyboardError {
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum GrabKeyboardError for GrabKeyboard {
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -2418,28 +2246,13 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`GrabKey` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`GrabKey` request]: GrabKey
-pub enum GrabKeyError {
-	/// An [`Access` error].
-	///
-	/// [`Access` error]: error::Access
-	Access(error::Access),
-	/// A [`CursorAppearance` error].
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	CursorAppearance(error::CursorAppearance),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum GrabKeyError for GrabKey {
+		Access,
+		CursorAppearance,
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -2555,20 +2368,11 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`UngrabKey` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`UngrabKey` request]: UngrabKey
-pub enum UngrabKeyError {
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Window),
+request_error! {
+	pub enum UngrabKeyError for UngrabKey {
+		Value,
+		Window,
+	}
 }
 
 derive_xrb! {
@@ -2984,25 +2788,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`SetFocus` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`SetFocus` request]: SetFocus
-#[doc(alias = "SetInputFocusError")]
-pub enum SetFocusError {
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
-	/// A [`Window` error].
-	///
-	/// [`Window` error]: error::Window
-	Window(error::Value),
+request_error! {
+	pub enum SetFocusError for SetFocus {
+		Match,
+		Value,
+		Window,
+	}
 }
 
 /// What the focus should revert to if the focused [window] becomes unviewable.
@@ -3096,18 +2887,11 @@ derive_xrb! {
 	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
 }
 
-/// An [error] generated because of a failed [`AssignFont` request].
-///
-/// [`AssignFont` request]: AssignFont
-pub enum AssignFontError {
-	/// A [`ResourceIdChoice` error].
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	ResourceIdChoice(error::ResourceIdChoice),
-	/// A [`Name` error].
-	///
-	/// [`Name` error]: error::Name
-	Name(error::Name),
+request_error! {
+	pub enum AssignFontError for AssignFont {
+		ResourceIdChoice,
+		Name,
+	}
 }
 
 derive_xrb! {
@@ -3372,24 +3156,12 @@ derive_xrb! {
 	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
 }
 
-/// An [error] generated because of a failed [`CreatePixmap` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`CreatePixmap` request]: CreatePixmap
-pub enum CreatePixmapError {
-	/// A [`Drawable` error].
-	///
-	/// [`Drawable` error]: error::Drawable
-	Drawable(error::Drawable),
-	/// A [`ResourceIdChoice` error].
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	ResourceIdChoice(error::ResourceIdChoice),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
+request_error! {
+	pub enum CreatePixmapError for CreatePixmap {
+		Drawable,
+		ResourceIdChoice,
+		Value,
+	}
 }
 
 derive_xrb! {
@@ -3500,36 +3272,15 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`CreateGraphicsContext` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`CreateGraphicsContext` request]: CreateGraphicsContext
-pub enum CreateGraphicsContextError {
-	/// A [`Drawable` error].
-	///
-	/// [`Drawable` error]: error::Drawable
-	Drawable(error::Drawable),
-	/// A [`Font` error].
-	///
-	/// [`Font` error]: error::Font
-	Font(error::Font),
-	/// A [`ResourceIdChoice` error].
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	ResourceIdChoice(error::ResourceIdChoice),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Pixmap` error].
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	Pixmap(error::Pixmap),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
+request_error! {
+	pub enum CreateGraphicsContextError for GraphicsContext {
+		Drawable,
+		Font,
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+		Value,
+	}
 }
 
 derive_xrb! {
@@ -3597,33 +3348,14 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`ChangeGraphicsOptions` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
-#[doc(alias("ChangeGcError", "ChangeGCError", "ChangeGraphicsContextError"))]
-pub enum ChangeGraphicsOptionsError {
-	/// A [`Font` error].
-	///
-	/// [`Font` error]: error::Font
-	Font(error::Font),
-	/// A [`GraphicsContext` error].
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	GraphicsContext(error::GraphicsContext),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Pixmap` error].
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	Pixmap(error::Pixmap),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
+request_error! {
+	pub enum ChangeGraphicsOptionsError for ChangeGraphicsOptions {
+		Font,
+		GraphicsContext,
+		Match,
+		Pixmap,
+		Value,
+	}
 }
 
 derive_xrb! {
@@ -3678,30 +3410,12 @@ derive_xrb! {
 	}
 }
 
-/// An [error] generated because of a failed [`CopyGraphicsOptions` request].
-///
-/// [error]: crate::message::Error
-///
-/// [`CopyGraphicsOptions` request]: CopyGraphicsOptions
-#[doc(alias(
-	"CopyGcError",
-	"CopyGCError",
-	"CopyGraphicsContextError",
-	"CopyGcontextError"
-))]
-pub enum CopyGraphicsOptionsError {
-	/// A [`GraphicsContext` error].
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	GraphicsContext(error::GraphicsContext),
-	/// A [`Match` error].
-	///
-	/// [`Match` error]: error::Match
-	Match(error::Match),
-	/// A [`Value` error].
-	///
-	/// [`Value` error]: error::Value
-	Value(error::Value),
+request_error! {
+	pub enum CopyGraphicsOptionsError for CopyGraphicsOptions {
+		GraphicsContext,
+		Match,
+		Value,
+	}
 }
 
 derive_xrb! {

From 58af04e3ab5b78ff7a3edc2616ecf758287a685b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 17:13:00 +0000
Subject: [PATCH 068/157] SetDashes request

---
 src/x11/request.rs | 67 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index e27041bf..e039df29 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -64,6 +64,7 @@ use crate::{
 
 macro_rules! request_error {
 	(
+		$(#[$meta:meta])*
 		$vis:vis enum $Name:ident for $Request:ident {
 			$FirstError:ident
 			$(, $Error:ident)+
@@ -77,6 +78,8 @@ macro_rules! request_error {
 			stringify!($Request),
 			")."
 		)]
+		#[doc = ""]
+		$(#[$meta])*
 		$vis enum $Name {
 			#[doc = concat!(
 				"A [`",
@@ -3368,6 +3371,9 @@ derive_xrb! {
 	/// Changing [`dash_offset`] or [`dashes`] overrides any
 	/// [`SetDashes` request] on the [`GraphicsContext`].
 	///
+	/// The [`SetDashes` request] allows an alternating pattern of dashes to be
+	/// configured, while configuring [`dashes`] with this [request] does not.
+	///
 	/// # Errors
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
@@ -3481,3 +3487,64 @@ derive_xrb! {
 		pub options_mask: GraphicsOptionsMask,
 	}
 }
+
+request_error! {
+	pub enum SetDashesError for SetDashes {
+		GraphicsContext,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that sets the [`dash_offset`] and the pattern of dashes on a
+	/// [`GraphicsContext`].
+	///
+	/// Configuring [`dashes`] or [`dash_offset`] with a
+	/// [`ChangeGraphicsOptions` request] overrides the effects of this
+	/// [request].
+	///
+	/// Configuring [`dashes`] with a [`ChangeGraphicsOptions` request] does not
+	/// allow an alternating pattern of dashes to be specified; this [request]
+	/// does.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	///
+	/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetDashes: Request(58, SetDashesError) {
+		/// The [`GraphicsContext`] on which this [request] configures its
+		/// dashes.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [request]: crate::message::Request
+		pub target: GraphicsContext,
+
+		/// The offset from the endpoints or joinpoints of a dashed line before
+		/// the dashes are drawn.
+		pub dash_offset: Px<u16>,
+
+		// The length of `dashes`.
+		#[allow(clippy::cast_possible_truncation)]
+		let dashes_len: u16 = dashes => dashes.len() as u16,
+		/// The pattern of dashes used when drawing dashed lines.
+		///
+		/// Each element represents the length of a dash in the pattern,
+		/// measured in pixels. A `dashes` list of odd length is appended to
+		/// itself to produce a list of even length.
+		#[context(dashes_len => usize::from(*dashes_len))]
+		pub dashes: Vec<Px<u8>>,
+		[_; dashes => pad(dashes)],
+	}
+}

From dc56c8cc68a45a34102eebbd39c253afe11604b2 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 17:13:19 +0000
Subject: [PATCH 069/157] SetClipRectangles request

---
 src/x11/request.rs | 150 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index e039df29..032f9bde 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3548,3 +3548,153 @@ derive_xrb! {
 		[_; dashes => pad(dashes)],
 	}
 }
+
+request_error! {
+	pub enum SetClipRectanglesError for SetClipMask {
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies the ordering of [rectangles] given by `clip_rectangles` in a
+/// [`SetClipRectangles` request].
+///
+/// [rectangles]: Rectangle
+///
+/// [`SetClipRectangles` request]: SetClipRectangles
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ClipRectanglesOrdering {
+	/// No particular order is specified.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are given in no particular order.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	Unsorted,
+
+	/// [Rectangles][rectangles] are ordered by their y coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high.
+	///
+	/// The ordering among [rectangles] with equal y coordinates is not
+	/// specified.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByY,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// and secondarily by their x coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, and those of equal y are sorted by their x coordinate from low
+	/// to high.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByYx,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// secondarily by their x coordinate, and each one which intersects a given
+	/// y coordinate has an equal y coordinate and height.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, those of equal y are sorted by their x coordinate from low to
+	/// high, and every [rectangle] which intersects a given y coordinate is
+	/// guaranteed to have the same y coordinate and height as every other
+	/// intersecting [rectangle][rectangles].
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	BandedByYx,
+}
+
+derive_xrb! {
+	/// A [request] that sets the clip mask of a [`GraphicsContext`] based on
+	/// the provided list of [rectangles], as well as the [`clip_x`] and
+	/// [`clip_y`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetClipRectangles: Request(59, SetClipRectanglesError) {
+		/// Specifies the ordering of [rectangles] within `clip_rectangles`.
+		///
+		/// See [`ClipRectanglesOrdering`] for more information.
+		///
+		/// [rectangles]: Rectangle
+		#[metabyte]
+		pub ordering: ClipRectanglesOrdering,
+
+		/// The [`GraphicsContext`] on which this [request] configures its clip
+		/// mask.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		pub target: GraphicsContext,
+
+		/// The x coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this x coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_x: Px<i16>,
+		/// The y coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this y coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_y: Px<i16>,
+
+		/// A list of non-overlapping [rectangles] that are used to mask the
+		/// effects of a graphics operation.
+		///
+		/// These [rectangles] specify the areas within which the effects of a
+		/// graphics operation are applied.
+		///
+		/// If this list is empty, graphics operations will have no graphical
+		/// effect.
+		///
+		/// [rectangles]: Rectangle
+		#[context(self::length => {
+			let mut length = usize::from(length - 1) * 4;
+
+			length -= GraphicsContext::X11_SIZE;
+			length -= 2 * <Px<i16>>::X11_SIZE;
+
+			length / Rectangle::X11_SIZE
+		})]
+		pub clip_rectangles: Vec<Rectangle>,
+	}
+}

From fadcda176a7249fb9f05ad38be77cde923d56b2b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 17:29:41 +0000
Subject: [PATCH 070/157] DestroyGraphicsContext request (60th/120!!)

Halfway done with the requests!  Hooray!
---
 src/x11/request.rs | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 032f9bde..c7a9e66f 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -10,7 +10,6 @@
 //! [core X11 protocol]: super
 
 extern crate self as xrb;
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use xrbk::{
 	pad,
@@ -27,6 +26,7 @@ use xrbk::{
 	WriteResult,
 	X11Size,
 };
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Event,
@@ -3697,4 +3697,31 @@ derive_xrb! {
 		})]
 		pub clip_rectangles: Vec<Rectangle>,
 	}
+
+	/// A [request] that deletes the given [`GraphicsContext`].
+	///
+	/// The association between the [`GraphicsContext` ID] and the
+	/// [`GraphicsContext`] itself is removed in the process.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("FreeGc", "FreeGC", "FreeGcontext", "FreeGraphicsContext"))]
+	#[doc(alias("DestroyGc", "DestroyGC", "DestroyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
+		/// The [`GraphicsContext`] which is to be deleted.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context", "gcontext"))]
+		pub target: GraphicsContext,
+	}
 }

From 7dec6d628b72a81164486dff19cb024fc7d6f26d Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 19:36:32 +0000
Subject: [PATCH 071/157] ClearArea request

---
 src/x11/request.rs | 68 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index c7a9e66f..22eab0e4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3725,3 +3725,71 @@ derive_xrb! {
 		pub target: GraphicsContext,
 	}
 }
+
+request_error! {
+	pub enum ClearAreaError for ClearArea {
+		Match,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] which clears a particular area of a [window].
+	///
+	/// If the [window] has a defined background ([`background_pixmap`] or
+	/// [`background_color`], the `area` is replaced by that background.
+	/// Otherwise, in the background is [`None`], the contents are not changed.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// A [`Match` error] is generated if the `target` is an [`InputOnly`]
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`background_pixmap`]: Attributes::background_pixmap
+	/// [`background_color`]: Attributes::background_color
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	///
+	/// [`Window` error]: error::Window
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ClearArea: Request(61, ClearAreaError) {
+		/// Whether [`GraphicsExposure` events] should be generated for regions
+		/// of the `area` which are visible or maintained.
+		///
+		/// [`GraphicsExposure` events]: super::event::GraphicsExposure
+		#[metabyte]
+		pub graphics_exposure: bool,
+
+		/// The [window] which this [request] clears an area of.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// A [`Match` error] is generated if this is an [`InputOnly`] [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Window` error]: error::Window
+		/// [`Match` error]: error::Match
+		pub target: Window,
+
+		/// The area of the `target` [window] which is cleared.
+		///
+		/// The `x` and `y` coordinates are relative to the top-left corner of
+		/// the `target` [window].
+		///
+		/// [window]: Window
+		pub area: Rectangle,
+	}
+}

From dec7d5153000c31189ebd0fbab8bdfbf33c0178b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 20:11:48 +0000
Subject: [PATCH 072/157] CopyArea request

---
 src/x11/request.rs | 120 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 22eab0e4..d3e2d3b2 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3338,6 +3338,7 @@ derive_xrb! {
 		///
 		/// [`Drawable` error]: error::Drawable
 		#[doc(alias("drawable", "src", "source_drawable", "src_drawable"))]
+		// FIXME: is this the source??
 		pub source: Drawable,
 
 		/// The [graphics options] used in graphics operations when this
@@ -3793,3 +3794,122 @@ derive_xrb! {
 		pub area: Rectangle,
 	}
 }
+
+request_error! {
+	pub enum CopyAreaError for CopyArea {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies an area of the given `source` [drawable] into
+	/// the given `destination` [drawable].
+	///
+	/// [Regions][regions] of the `source` that are obscured and have not been
+	/// [maintained], as well as [regions] specified by the `source_area` which
+	/// fall outside of the `source` itself, are not copied. If the
+	/// `destination` has a background, however, and those [regions] of the
+	/// `source` which are not copied correspond to [regions] of the
+	/// `destination` which are visible or [maintained], those [regions] will be
+	/// filled with the `destination`'s background. If the `graphics_context`'s
+	/// [`graphics_exposure`] is `true`, [`GraphicsExposure` events] will be
+	/// generated for those [regions] (or a [`NoExposure` event] if none are
+	/// generated).
+	///
+	/// # Graphics options used
+	/// This [request] uses the following options of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`child_mode`]
+	/// - [`graphics_exposure`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if either `source` or `destination` do
+	/// not refer to defined [windows] nor [pixmaps].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [windows]: Window
+	/// [pixmaps]: Pixmap
+	/// [regions]: crate::Region
+	/// [request]: crate::message::Request
+	///
+	/// [maintained]: crate::MaintainContents
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_y
+	///
+	/// [`GraphicsExposure` events]: super::event::GraphicsExposure
+	/// [`NoExposure` event]: super::event::NoExposure
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CopyArea: Request(62, CopyAreaError) {
+		/// The [drawable] from which the area is copied.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		pub source: Drawable,
+		/// The [drawable] into which the area is copied.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		pub destination: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		pub graphics_context: GraphicsContext,
+
+		/// The area within the `source` [drawable] which is copied.
+		///
+		/// The `x` and `y` coordinates are relative to the top-left corner of
+		/// the `source`.
+		///
+		/// [drawable]: Drawable
+		pub source_area: Rectangle,
+		/// The coordinates at which the copied area will be placed within the
+		/// `destination` [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `destination`, and specify what the top-left corner of the copied
+		/// area will be when it has been copied.
+		///
+		/// [drawable]: Drawable
+		pub destination_coords: Coords,
+	}
+}

From 0cf251f971a627dac93a5b572ada4ddd42c875b3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 20:25:56 +0000
Subject: [PATCH 073/157] clarify the uncertainty about a certain request field

I'm still not sure what the drawable used in creating a GraphicsContext is used for.  I guessed that it was the source in graphics operations, but this can't be true, because I am now implementing the graphics operations and they have a dedicated `source` drawable.
---
 src/x11/request.rs | 44 ++++++++++++++++++++------------------------
 1 file changed, 20 insertions(+), 24 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index d3e2d3b2..6281bd97 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -65,10 +65,8 @@ use crate::{
 macro_rules! request_error {
 	(
 		$(#[$meta:meta])*
-		$vis:vis enum $Name:ident for $Request:ident {
-			$FirstError:ident
-			$(, $Error:ident)+
-			$(,)?
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
 		}
 	) => {
 		#[doc = concat!(
@@ -81,16 +79,7 @@ macro_rules! request_error {
 		#[doc = ""]
 		$(#[$meta])*
 		$vis enum $Name {
-			#[doc = concat!(
-				"A [`",
-				stringify!($FirstError),
-				"` error](error::",
-				stringify!($FirstError),
-				")."
-			)]
-			$FirstError(error::$FirstError)
-
-			$(,
+			$($(
 				#[doc = concat!(
 					"A [`",
 					stringify!($Error),
@@ -99,7 +88,7 @@ macro_rules! request_error {
 					")."
 				)]
 				$Error(error::$Error)
-			)+
+			),+)?
 		}
 	};
 }
@@ -3295,7 +3284,7 @@ derive_xrb! {
 	/// specifies an ID already used for another resource, or an ID which is not
 	/// allocated to your client.
 	///
-	/// A [`Drawable` error] is generated if `source` does not refer to a
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
 	/// defined [window] nor [pixmap].
 	///
 	/// [pixmap]: Pixmap
@@ -3322,9 +3311,12 @@ derive_xrb! {
 		#[doc(alias("cid", "gid", "gcid", "context_id"))]
 		pub graphics_context_id: GraphicsContext,
 
-		/// The [drawable] used as the source in graphics operations.
-		///
-		/// See also: [`Function`].
+		/// > *<sup>TODO</sup>*
+		/// > ***We don't yet understand what this field is for. If you have any
+		/// > ideas, please feel free to open an issue or a discussion on the
+		/// > [GitHub repo]!***
+		/// >
+		/// > [GitHub repo]: https://github.com/XdotRS/xrb/
 		///
 		/// # Errors
 		/// A [`Drawable` error] is generated if this does not refer to a
@@ -3334,17 +3326,21 @@ derive_xrb! {
 		/// [window]: Window
 		/// [pixmap]: Pixmap
 		///
-		/// [`Function`]: crate::set::Function
-		///
 		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable", "src", "source_drawable", "src_drawable"))]
-		// FIXME: is this the source??
-		pub source: Drawable,
+		pub drawable: Drawable,
 
 		/// The [graphics options] used in graphics operations when this
 		/// [`GraphicsContext`] is provided.
 		///
+		/// These [graphics options] may be later configured through the
+		/// [`SetDashes` request], [`SetClipRectangles` request], and the
+		/// [`ChangeGraphicsOptions` request].
+		///
 		/// [graphics options]: GraphicsOptions
+		///
+		/// [`SetDashes` request]: SetDashes
+		/// [`SetClipRectangles` request]: SetClipRectangles
+		/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
 		#[doc(alias("values", "value_mask", "value_list"))]
 		#[doc(alias("options", "option_mask", "option_list"))]
 		#[doc(alias("graphics_option_mask", "graphics_option_list"))]

From 2a7e4b2f5d942ce329b4c01cecd1d1796a1fb200 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 20:52:45 +0000
Subject: [PATCH 074/157] common - Dimensions + use generics for Coords,
 Rectangle

---
 src/common.rs      | 107 ++++++++++++++++++++++++++++++++++-----------
 src/x11/request.rs |   2 +-
 2 files changed, 82 insertions(+), 27 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index b59d210d..a662613c 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -3,15 +3,25 @@
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
 extern crate self as xrb;
-use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use derive_more::{From, Into};
-use xrbk::{pad, Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
 
 pub use atom::Atom;
 pub use mask::*;
 pub use res_id::*;
 pub use wrapper::*;
+use xrbk::{
+	pad,
+	Buf,
+	ConstantX11Size,
+	ReadError,
+	ReadResult,
+	Readable,
+	ReadableWithContext,
+	Wrap,
+	Writable,
+};
+use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use crate::unit::Px;
 
@@ -407,49 +417,94 @@ impl ReadableWithContext for String16 {
 	Debug,
 	From,
 	Into,
-	// `new` and `unwrap` const fns
+	// `new` const fn
 	new,
-	unwrap,
 	// XRBK traits
 	X11Size,
 	ConstantX11Size,
 	Readable,
 	Writable,
 )]
-pub struct Coords {
-	#[allow(missing_docs)]
-	pub x: Px<i16>,
-	#[allow(missing_docs)]
-	pub y: Px<i16>,
+pub struct Coords<T = i16>
+where
+	T: Writable + Readable + ConstantX11Size,
+{
+	/// The x coordinate, measured in pixels.
+	pub x: Px<T>,
+	/// The y coordinate, measured in pixels.
+	pub y: Px<T>,
+}
+
+/// 2D dimensions (width and height), measured in pixels.
+#[derive(
+	Copy,
+	Clone,
+	Eq,
+	PartialEq,
+	Hash,
+	Debug,
+	From,
+	Into,
+	// `new` const fn
+	new,
+	// XRBK traits
+	X11Size,
+	ConstantX11Size,
+	Readable,
+	Writable,
+)]
+pub struct Dimensions<T = u16>
+where
+	T: Writable + Readable + ConstantX11Size,
+{
+	/// The width, measured in pixels.
+	pub width: Px<T>,
+	/// The height, measured in pixels.
+	pub height: Px<T>,
 }
 
 /// A rectangle with coordinates and dimensions.
-#[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
-pub struct Rectangle {
+#[derive(
+	Copy, Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable,
+)]
+pub struct Rectangle<Xy = i16, Wh = u16>
+where
+	Xy: Copy + Readable + Writable + ConstantX11Size,
+	Wh: Copy + Readable + Writable + ConstantX11Size,
+{
 	/// The x-coordinate of the upper left corner of the `Rectangle`.
-	pub x: Px<i16>,
+	pub x: Px<Xy>,
 	/// The y-coordinate of the upper left corner of the `Rectangle`.
-	pub y: Px<i16>,
+	pub y: Px<Xy>,
 	/// The width of the `Rectangle`.
-	pub width: Px<u16>,
+	pub width: Px<Wh>,
 	/// The height of the `Rectangle`.
-	pub height: Px<u16>,
+	pub height: Px<Wh>,
 }
 
-/// Same as a [`Rectangle`], but with unsigned coordinates.
-#[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
-pub struct Region {
-	/// The x-coordinate of the upper left corner of the `Region`.
-	pub x: Px<u16>,
-	/// The y-coordinate of the upper left corner of the `Region`.
-	pub y: Px<u16>,
+impl<Xy, Wh> Rectangle<Xy, Wh>
+where
+	Xy: Copy + Readable + Writable + ConstantX11Size,
+	Wh: Copy + Readable + Writable + ConstantX11Size,
+{
+	/// Returns the rectangle's `x` and `y` coordinates as [`Coords`].
+	///
+	/// This copies the values of `x` and `y`.
+	pub const fn as_coords(&self) -> Coords<Xy> {
+		Coords::new(self.x, self.y)
+	}
 
-	/// The width of the `Region`.
-	pub width: Px<u16>,
-	/// The height of the `Region`.
-	pub height: Px<u16>,
+	/// Returns the rectangle's `width` and `height` as [`Dimensions`].
+	///
+	/// This copies the values of `width` and `height`.
+	pub const fn as_dimensions(&self) -> Dimensions<Wh> {
+		Dimensions::new(self.width, self.height)
+	}
 }
 
+/// A [`Rectangle`] with unsigned coordinates.
+pub type Region = Rectangle<u16, u16>;
+
 #[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
 pub struct Arc {
 	pub x: Px<i16>,
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6281bd97..86d4b93d 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3690,7 +3690,7 @@ derive_xrb! {
 			length -= GraphicsContext::X11_SIZE;
 			length -= 2 * <Px<i16>>::X11_SIZE;
 
-			length / Rectangle::X11_SIZE
+			length / <Rectangle<i16, u16>>::X11_SIZE
 		})]
 		pub clip_rectangles: Vec<Rectangle>,
 	}

From 48e100f564f581f169bbcc93d6b5800f9551af2b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 21:33:18 +0000
Subject: [PATCH 075/157] common - undo use of generic types for coords, etc.

I think it is confusing, and I don't believe there are cases where `i16` or `u16` aren't the types used.
---
 src/common.rs      | 68 ++++++++++++++++++++++------------------------
 src/x11/request.rs |  2 +-
 2 files changed, 33 insertions(+), 37 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index a662613c..25740ec8 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -417,22 +417,20 @@ impl ReadableWithContext for String16 {
 	Debug,
 	From,
 	Into,
-	// `new` const fn
+	// `new` and `unwrap` const fns
 	new,
+	unwrap,
 	// XRBK traits
 	X11Size,
 	ConstantX11Size,
 	Readable,
 	Writable,
 )]
-pub struct Coords<T = i16>
-where
-	T: Writable + Readable + ConstantX11Size,
-{
+pub struct Coords {
 	/// The x coordinate, measured in pixels.
-	pub x: Px<T>,
+	pub x: Px<i16>,
 	/// The y coordinate, measured in pixels.
-	pub y: Px<T>,
+	pub y: Px<i16>,
 }
 
 /// 2D dimensions (width and height), measured in pixels.
@@ -445,66 +443,64 @@ where
 	Debug,
 	From,
 	Into,
-	// `new` const fn
+	// `new` and `unwrap` const fns
 	new,
+	unwrap,
 	// XRBK traits
 	X11Size,
 	ConstantX11Size,
 	Readable,
 	Writable,
 )]
-pub struct Dimensions<T = u16>
-where
-	T: Writable + Readable + ConstantX11Size,
-{
+pub struct Dimensions {
 	/// The width, measured in pixels.
-	pub width: Px<T>,
+	pub width: Px<u16>,
 	/// The height, measured in pixels.
-	pub height: Px<T>,
+	pub height: Px<u16>,
 }
 
 /// A rectangle with coordinates and dimensions.
 #[derive(
 	Copy, Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable,
 )]
-pub struct Rectangle<Xy = i16, Wh = u16>
-where
-	Xy: Copy + Readable + Writable + ConstantX11Size,
-	Wh: Copy + Readable + Writable + ConstantX11Size,
-{
+pub struct Rectangle {
 	/// The x-coordinate of the upper left corner of the `Rectangle`.
-	pub x: Px<Xy>,
+	pub x: Px<i16>,
 	/// The y-coordinate of the upper left corner of the `Rectangle`.
-	pub y: Px<Xy>,
+	pub y: Px<i16>,
 	/// The width of the `Rectangle`.
-	pub width: Px<Wh>,
+	pub width: Px<u16>,
 	/// The height of the `Rectangle`.
-	pub height: Px<Wh>,
+	pub height: Px<u16>,
 }
 
-impl<Xy, Wh> Rectangle<Xy, Wh>
-where
-	Xy: Copy + Readable + Writable + ConstantX11Size,
-	Wh: Copy + Readable + Writable + ConstantX11Size,
-{
+impl Rectangle {
 	/// Returns the rectangle's `x` and `y` coordinates as [`Coords`].
-	///
-	/// This copies the values of `x` and `y`.
-	pub const fn as_coords(&self) -> Coords<Xy> {
+	pub const fn as_coords(&self) -> Coords {
 		Coords::new(self.x, self.y)
 	}
 
 	/// Returns the rectangle's `width` and `height` as [`Dimensions`].
-	///
-	/// This copies the values of `width` and `height`.
-	pub const fn as_dimensions(&self) -> Dimensions<Wh> {
+	pub const fn as_dimensions(&self) -> Dimensions {
 		Dimensions::new(self.width, self.height)
 	}
 }
 
-/// A [`Rectangle`] with unsigned coordinates.
-pub type Region = Rectangle<u16, u16>;
+/// Same as a [`Rectangle`], but with unsigned coordinates.
+#[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
+pub struct Region {
+	/// The x-coordinate of the upper left corner of the `Region`.
+	pub x: Px<u16>,
+	/// The y-coordinate of the upper left corner of the `Region`.
+	pub y: Px<u16>,
+
+	/// The width of the `Region`.
+	pub width: Px<u16>,
+	/// The height of the `Region`.
+	pub height: Px<u16>,
+}
 
+/// This copies the values of `width` and `height`.
 #[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
 pub struct Arc {
 	pub x: Px<i16>,
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 86d4b93d..6281bd97 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3690,7 +3690,7 @@ derive_xrb! {
 			length -= GraphicsContext::X11_SIZE;
 			length -= 2 * <Px<i16>>::X11_SIZE;
 
-			length / <Rectangle<i16, u16>>::X11_SIZE
+			length / Rectangle::X11_SIZE
 		})]
 		pub clip_rectangles: Vec<Rectangle>,
 	}

From 779abaacde82214fcfda1f3481a7d053cad7c401 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 27 Jan 2023 21:35:25 +0000
Subject: [PATCH 076/157] [CI830] applied recommended clippy fixes

---
 src/common.rs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 25740ec8..4287263b 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -16,10 +16,8 @@ use xrbk::{
 	ConstantX11Size,
 	ReadError,
 	ReadResult,
-	Readable,
 	ReadableWithContext,
 	Wrap,
-	Writable,
 };
 use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
@@ -476,12 +474,12 @@ pub struct Rectangle {
 
 impl Rectangle {
 	/// Returns the rectangle's `x` and `y` coordinates as [`Coords`].
-	pub const fn as_coords(&self) -> Coords {
+	#[must_use] pub const fn as_coords(&self) -> Coords {
 		Coords::new(self.x, self.y)
 	}
 
 	/// Returns the rectangle's `width` and `height` as [`Dimensions`].
-	pub const fn as_dimensions(&self) -> Dimensions {
+	#[must_use] pub const fn as_dimensions(&self) -> Dimensions {
 		Dimensions::new(self.width, self.height)
 	}
 }

From 6fc9dcebc71ae6b412c8b5b570b522cb9d15f738 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 27 Jan 2023 21:35:26 +0000
Subject: [PATCH 077/157] [CI830] formatted code with rustfmt

---
 src/common.rs | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 4287263b..8336417d 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -10,15 +10,7 @@ pub use atom::Atom;
 pub use mask::*;
 pub use res_id::*;
 pub use wrapper::*;
-use xrbk::{
-	pad,
-	Buf,
-	ConstantX11Size,
-	ReadError,
-	ReadResult,
-	ReadableWithContext,
-	Wrap,
-};
+use xrbk::{pad, Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
 use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use crate::unit::Px;
@@ -474,12 +466,14 @@ pub struct Rectangle {
 
 impl Rectangle {
 	/// Returns the rectangle's `x` and `y` coordinates as [`Coords`].
-	#[must_use] pub const fn as_coords(&self) -> Coords {
+	#[must_use]
+	pub const fn as_coords(&self) -> Coords {
 		Coords::new(self.x, self.y)
 	}
 
 	/// Returns the rectangle's `width` and `height` as [`Dimensions`].
-	#[must_use] pub const fn as_dimensions(&self) -> Dimensions {
+	#[must_use]
+	pub const fn as_dimensions(&self) -> Dimensions {
 		Dimensions::new(self.width, self.height)
 	}
 }

From 297bbdcb9a889069642bf93c7d4b670ff0ed391c Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 27 Jan 2023 22:03:29 +0000
Subject: [PATCH 078/157] CopyBitPlane request

---
 src/x11/event.rs   |   6 +-
 src/x11/request.rs | 192 +++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 188 insertions(+), 10 deletions(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index 9f917c73..fba89938 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -1250,11 +1250,11 @@ derive_xrb! {
 		/// The [major opcode] identifying the graphics request used.
 		///
 		/// For the core protocol, this always refers to [`CopyArea`] or
-		/// [`CopyPlane`].
+		/// [`CopyBitPlane`].
 		///
 		/// [major opcode]: crate::message::Request::MAJOR_OPCODE
 		/// [`CopyArea`]: super::request::CopyArea
-		/// [`CopyPlane`]: super::request::CopyPlane
+		/// [`CopyBitPlane`]: super::request::CopyBitPlane
 		pub major_opcode: u8,
 		[_; ..],
 	}
@@ -1301,7 +1301,7 @@ derive_xrb! {
 		///
 		/// [major opcode]: crate::message::Request::MAJOR_OPCODE
 		/// [`CopyArea`]: super::request::CopyArea
-		/// [`CopyPlane`]: super::request::CopyPlane
+		/// [`CopyPlane`]: super::request::CopyBitPlane
 		pub major_opcode: u8,
 		[_; ..],
 	}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6281bd97..9f1ed896 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -45,6 +45,7 @@ use crate::{
 	CursorAppearance,
 	CursorEventMask,
 	DestinationWindow,
+	Dimensions,
 	Drawable,
 	EventMask,
 	FocusWindow,
@@ -3804,8 +3805,8 @@ derive_xrb! {
 	/// the given `destination` [drawable].
 	///
 	/// [Regions][regions] of the `source` that are obscured and have not been
-	/// [maintained], as well as [regions] specified by the `source_area` which
-	/// fall outside of the `source` itself, are not copied. If the
+	/// [maintained], as well as [regions] specified by `source_coords` and
+	/// `dimensions` fall outside of the `source` itself, are not copied. If the
 	/// `destination` has a background, however, and those [regions] of the
 	/// `source` which are not copied correspond to [regions] of the
 	/// `destination` which are visible or [maintained], those [regions] will be
@@ -3815,7 +3816,7 @@ derive_xrb! {
 	/// generated).
 	///
 	/// # Graphics options used
-	/// This [request] uses the following options of the `graphics_context`:
+	/// This [request] uses the following [options] of the `graphics_context`:
 	/// - [`function`]
 	/// - [`plane_mask`]
 	/// - [`child_mode`]
@@ -3835,6 +3836,7 @@ derive_xrb! {
 	/// [windows]: Window
 	/// [pixmaps]: Pixmap
 	/// [regions]: crate::Region
+	/// [options]: GraphicsOptions
 	/// [request]: crate::message::Request
 	///
 	/// [maintained]: crate::MaintainContents
@@ -3889,15 +3891,23 @@ derive_xrb! {
 		pub destination: Drawable,
 
 		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
 		pub graphics_context: GraphicsContext,
 
-		/// The area within the `source` [drawable] which is copied.
+		/// The coordinates of the area which is copied from the `source`
+		/// [drawable].
 		///
-		/// The `x` and `y` coordinates are relative to the top-left corner of
-		/// the `source`.
+		/// These coordinates are relative to the top-left corner of the
+		/// `source`, and specify the top-left corner of the area which is
+		/// copied.
 		///
 		/// [drawable]: Drawable
-		pub source_area: Rectangle,
+		pub source_coords: Coords,
 		/// The coordinates at which the copied area will be placed within the
 		/// `destination` [drawable].
 		///
@@ -3907,5 +3917,173 @@ derive_xrb! {
 		///
 		/// [drawable]: Drawable
 		pub destination_coords: Coords,
+
+		/// The dimensions of the area that is copied.
+		pub dimensions: Dimensions,
+	}
+}
+
+request_error! {
+	#[doc(alias("CopyPlaneError"))]
+	pub enum CopyBitPlaneError for CopyBitPlane {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies a [region] of the `source` [drawable], masked by the given
+	/// `bit_plane`, and filled according to the [`foreground_color`] and [`background_color`] in
+	/// the `graphics_context`.
+	///
+	/// Effectively, a [pixmap] with the given `dimensions` and the same depth
+	/// as the `destination` [drawable] is created. It is filled with the
+	/// [`foreground_color`] where the `bit_plane` in the `source` [drawable]
+	/// contains a bit set to 1, and [`background_color`] where the `bit_plane`
+	/// in the `source` [drawable] contains a bit set to 0.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`child_mode`]
+	/// - [`graphics_exposure`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if either the `source` or the
+	/// `destination` do not refer to defined [windows][window] nor
+	/// [pixmaps][pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if the `graphics_context` does
+	/// not refer to a defined [`GraphicsContext`].
+	///
+	/// A [`Match` error] is generated if the `source` [drawable] does not have
+	/// the same root [window] as the `destination` [drawable].
+	///
+	/// A [`Value` error] is generated if the `bit_plane` does not have exactly
+	/// one bit set to 1, or if the value of the `bit_plane` is not less than
+	/// 2<sup>`depth`</sup>, where `depth` is the `source` [drawable]'s depth.
+	///
+	/// [drawable]: Drawable
+	/// [pixmap]: Pixmap
+	/// [window]: Window
+	/// [region]: crate::Region
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	/// [`Value` error]: error::Value
+	#[doc(alias("CopyPlane"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CopyBitPlane: Request(63, CopyBitPlaneError) {
+		/// The [drawable] used as the source in this graphics operation.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		#[doc(alias("src", "src_drawable", "source_drawable"))]
+		pub source: Drawable,
+		/// The [drawable] which the filled [region] is copied into.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] as the `source`.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		#[doc(alias("dst", "dst_drawable", "destination_drawable"))]
+		pub destination: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The coordinates of the [region] within the `source` [drawable] which
+		/// is used.
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `source`, and specify the top-left corner of the [region] which is
+		/// copied.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		#[doc(alias("src_x", "src_y", "source_x", "source_y", "src_coords"))]
+		pub source_coords: Coords,
+		/// The coordinates at which the copied [region] will be placed within
+		/// the `destination` [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `destination`, and specify what the top-left corner of the copied
+		/// [region] will be when it has been copied.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		#[doc(alias("dst_x", "dst_y", "destination_x", "destination_y", "dst_coords"))]
+		pub destination_coords: Coords,
+
+		/// The dimensions of the [region] that is copied.
+		///
+		/// [region]: crate::Region
+		#[doc(alias("width", "height"))]
+		pub dimensions: Dimensions,
+
+		/// The bit plane that is copied.
+		///
+		/// Exactly one bit must be set and the value must be less than
+		/// 2<sup>`depth`</sup>, where `depth` is the depth of the `source`
+		/// [drawable].
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this does not have exactly one bit
+		/// set to 1, or if this value is not less than 2<sup>`depth`</sup>,
+		/// where `depth` is the depth of the `source` [drawable].
+		///
+		/// [drawable]: Drawable
+		///
+		/// [`Value` error]: error::Value
+		pub bit_plane: u32,
 	}
 }

From d49e4ebdfe7c841d4ea6402f6f88cb79f1fdeefd Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 08:09:53 +0000
Subject: [PATCH 079/157] fixes to some request + reply docs

---
 src/lib.rs         |  6 ++---
 src/x11/reply.rs   | 10 +++++---
 src/x11/request.rs | 63 +++++++++++++++++++++++++++++-----------------
 3 files changed, 50 insertions(+), 29 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 70637f4f..c8e2e4ac 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -35,7 +35,7 @@
 #![warn(clippy::missing_const_for_fn)]
 // Warn for these doc lints.
 #![warn(missing_docs)]
-#![warn(broken_intra_doc_links)]
+#![warn(rustdoc::broken_intra_doc_links)]
 // Allow these lints.
 #![allow(clippy::doc_markdown)]
 #![allow(clippy::wildcard_imports)]
@@ -67,6 +67,8 @@
 //! [X11]: https://x.org/releases/X11R7.7/doc/x11protocol.html
 //! [X.RS]: https://github.com/XdotRS/xrs/
 
+pub use common::*;
+
 /// The major version of the X protocol used in XRB.
 ///
 /// The X protocol major version may increment if breaking changes are
@@ -85,5 +87,3 @@ pub mod connection;
 pub mod message;
 pub mod unit;
 pub mod x11;
-
-pub use common::*;
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 943f145a..009040d7 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -164,8 +164,8 @@ derive_xrb! {
 		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
 		#[doc(alias = "backing_pixel")]
 		pub maintenance_fallback_color: ColorId,
-		/// Whether the X server should maintain the contents of [windows] under
-		/// this [window].
+		/// Whether the X server should maintain the contents of
+		/// [windows][window] under this [window].
 		///
 		/// See [`Attributes::maintain_windows_under`] for more information.
 		///
@@ -294,7 +294,7 @@ derive_xrb! {
 		/// of the [window]'s parent.
 		///
 		/// [window]: Window
-		/// [pixmap]: create::Pixmap
+		/// [pixmap]: crate::Pixmap
 		/// [drawable]: crate::Drawable
 		#[doc(alias("x", "y", "width", "height"))]
 		pub geometry: Rectangle,
@@ -629,6 +629,8 @@ derive_xrb! {
 
 		/// Whether the cursor is on the `same_screen` as the given `target`
 		/// [window].
+		///
+		/// [window]: Window
 		#[metabyte]
 		pub same_screen: bool,
 
@@ -751,6 +753,8 @@ derive_xrb! {
 		/// `output` [window], this is that child.
 		///
 		/// If `same_screen` is `false`, this is always [`None`].
+		///
+		/// [window]: Window
 		// TODO: should always be [`None`] if `same_screen` is false
 		pub child: Option<Window>,
 
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 9f1ed896..c1c4bf6d 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -687,6 +687,8 @@ derive_xrb! {
 	///
 	/// [configures]: WindowConfig
 	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	///
 	/// [`width`]: WindowConfig::width
 	/// [`height`]: WindowConfig::height
 	/// [`border_width`]: WindowConfig::border_width
@@ -732,6 +734,8 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [configuration]: WindowConfig
+		/// [window]: Window
+		/// [request]: crate::message::Request
 		///
 		/// [`width`]: WindowConfig::width
 		/// [`height`]: WindowConfig::height
@@ -855,7 +859,7 @@ derive_xrb! {
 		/// [drawable]: Drawable
 		/// [request]: crate::message::Request
 		///
-		/// [`Drawable` error]: Error::Drawable
+		/// [`Drawable` error]: error::Drawable
 		#[doc(alias = "drawable")]
 		pub target: Drawable,
 	}
@@ -1451,7 +1455,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [atom]: Atom
-	/// [time]: CurrentableTime
+	/// [time]: crate::Timestamp
 	/// [request]: crate::message::Request
 	///
 	/// [current time]: CurrentableTime::CurrentTime
@@ -1493,7 +1497,7 @@ derive_xrb! {
 		/// [time] for the selection's owner, or this [time] is later than the
 		/// server's [current time], this [request] has no effect.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		/// [current time]: CurrentableTime::CurrentTime
 		/// [request]: crate::message::Request
 		pub time: CurrentableTime,
@@ -1594,7 +1598,7 @@ derive_xrb! {
 		/// The [time] at which this conversion is recorded as having taken
 		/// place.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 	}
 }
@@ -1687,7 +1691,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] to actively grab control of the cursor.
+	/// A [request] that actively grabs control of the cursor.
 	///
 	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
 	///
@@ -1809,7 +1813,7 @@ derive_xrb! {
 
 		/// The [time] at which this grab is recorded as having been initiated.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 	}
 
@@ -1829,7 +1833,7 @@ derive_xrb! {
 	pub struct UngrabCursor: Request(27) {
 		/// The [time] at which the grab is recorded as having been released.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 	}
 }
@@ -2002,8 +2006,8 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] which releases a [passive button grab] by this client on the
-	/// specified `grab_window` if the grab was established by your client.
+	/// A [request] that releases a [passive button grab] on the specified
+	/// `grab_window` if the grab was established by your client.
 	///
 	/// # Errors
 	/// A [`Window` error] is generated if `grab_window` does not refer to a
@@ -2070,7 +2074,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] which modifies the `event_mask` or `cursor_appearance` of an
+	/// A [request] that modifies the `event_mask` or `cursor_appearance` of an
 	/// [active cursor grab].
 	///
 	/// # Errors
@@ -2110,7 +2114,7 @@ derive_xrb! {
 		/// This must be later than the [time] of the last cursor grab, and
 		/// equal to or earlier than the X server's [current time].
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		/// [current time]: CurrentableTime::CurrentTime
 		pub time: CurrentableTime,
 
@@ -2131,7 +2135,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] to actively grab control of the keyboard.
+	/// A [request] that actively grabs control of the keyboard.
 	///
 	/// This [request] generates [`Focus`] and [`Unfocus`] events.
 	///
@@ -2179,7 +2183,7 @@ derive_xrb! {
 
 		/// The [time] at which this grab is recorded as having been initiated.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 
 		/// The [freeze mode] applied to the cursor.
@@ -2234,7 +2238,7 @@ derive_xrb! {
 	pub struct UngrabKeyboard: Request(32) {
 		/// The [time] at which the grab is recorded as having been released.
 		///
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 	}
 }
@@ -2369,7 +2373,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] which releases a [passive key grab] on the specified
+	/// A [request] that releases a [passive key grab] on the specified
 	/// `grab_window` if the grab was established by your client.
 	///
 	/// # Errors
@@ -2523,7 +2527,7 @@ derive_xrb! {
 		/// [current time].
 		///
 		/// [request]: crate::message::Request
-		/// [time]: CurrentableTime
+		/// [time]: crate::Timestamp
 		/// [current time]: CurrentableTime::CurrentTime
 		pub time: CurrentableTime,
 	}
@@ -2740,7 +2744,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// # Errors
-		/// A [`Window` error] is generated if this is [`SOme`] but does not
+		/// A [`Window` error] is generated if this is [`Some`] but does not
 		/// refer to a defined [window].
 		///
 		/// [window]: Window
@@ -2815,11 +2819,13 @@ pub enum RevertFocus {
 	CursorRoot,
 	/// Revert the focus to the parent of the [window] which the cursor is in at
 	/// the time.
+	///
+	/// [window]: Window
 	Parent,
 }
 
 derive_xrb! {
-	/// A [request] which changes the current focus.
+	/// A [request] that changes the current focus.
 	///
 	/// This [request] generates [`Focus`] and [`Unfocus`] events.
 	///
@@ -2861,6 +2867,8 @@ derive_xrb! {
 		pub new_focus: FocusWindow,
 
 		/// The [time] at which the focus is recorded as having changed.
+		///
+		/// [time]: crate::Timestamp
 		pub time: CurrentableTime,
 	}
 
@@ -3382,6 +3390,7 @@ derive_xrb! {
 	///
 	/// [`clip_mask`]: GraphicsOptions::clip_mask
 	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
 	///
 	/// [`SetClipRectangles` request]: SetClipRectangles
 	/// [`SetDashes` request]: SetDashes
@@ -3548,7 +3557,7 @@ derive_xrb! {
 }
 
 request_error! {
-	pub enum SetClipRectanglesError for SetClipMask {
+	pub enum SetClipRectanglesError for SetClipRectangles {
 		GraphicsContext,
 		Match,
 		Value,
@@ -3618,15 +3627,19 @@ pub enum ClipRectanglesOrdering {
 }
 
 derive_xrb! {
-	/// A [request] that sets the clip mask of a [`GraphicsContext`] based on
-	/// the provided list of [rectangles], as well as the [`clip_x`] and
-	/// [`clip_y`].
+	/// A [request] that configures the clip mask of a [`GraphicsContext`] using
+	/// a list of [rectangles].
+	///
+	/// This [request] also sets the [`clip_x`] and [`clip_y`] of the clip mask.
+	/// The coordinates used in the [rectangles] are relative to the [`clip_x`]
+	/// and [`clip_y`].
 	///
 	/// # Errors
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
 	///
 	/// [rectangles]: Rectangle
+	/// [request]: crate::message::Request
 	///
 	/// [`clip_x`]: GraphicsOptions::clip_x
 	/// [`clip_y`]: GraphicsOptions::clip_y
@@ -3649,6 +3662,8 @@ derive_xrb! {
 		/// A [`GraphicsContext` error] is generated if this does not refer to a
 		/// defined [`GraphicsContext`].
 		///
+		/// [request]: crate::message::Request
+		///
 		/// [`GraphicsContext` error]: error::GraphicsContext
 		pub target: GraphicsContext,
 
@@ -3705,6 +3720,8 @@ derive_xrb! {
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
 	///
+	/// [request]: crate::message::Request
+	///
 	/// [`GraphicsContext` ID]: GraphicsContext
 	///
 	/// [`GraphicsContext` error]: error::GraphicsContext
@@ -3733,7 +3750,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] which clears a particular area of a [window].
+	/// A [request] that clears a particular area of a [window].
 	///
 	/// If the [window] has a defined background ([`background_pixmap`] or
 	/// [`background_color`], the `area` is replaced by that background.

From 8e6a2b2ef0afd5d26dfe94d22b875e7dba21b658 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 08:10:07 +0000
Subject: [PATCH 080/157] XRBK: bump XRBK version to 0.0.2

---
 xrbk/Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xrbk/Cargo.toml b/xrbk/Cargo.toml
index 5ab2f96a..50bc8ed3 100644
--- a/xrbk/Cargo.toml
+++ b/xrbk/Cargo.toml
@@ -4,7 +4,7 @@
 
 [package]
 name = "xrbk"
-version = "0.0.1"
+version = "0.0.2"
 readme = false
 repository = "https://github.com/XdotRS/xrb/tree/main/xrbk"
 documentation = "https://docs.aquariwm.org/doc/xrbk"

From 9ca18974db4fe3eb43028bfdeca9772386942c41 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 10:27:50 +0000
Subject: [PATCH 081/157] XRBK macro: replace self::length with self::remaining

---
 src/x11/request.rs                            |  25 +---
 xrbk_macro/src/definition.rs                  |   2 +-
 .../src/definition/expansion/readable.rs      | 116 +++++++-----------
 .../src/definition/expansion/writable.rs      | 104 ++++++----------
 xrbk_macro/src/source.rs                      |  47 +++----
 xrbk_macro/src/source/expansion.rs            |  31 +++--
 xrbk_macro/src/source/parsing.rs              |  32 ++---
 7 files changed, 147 insertions(+), 210 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index c1c4bf6d..61b80159 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -3026,19 +3026,13 @@ derive_xrb! {
 		/// with `font`.
 		///
 		/// [request]: crate::message::Request
-		#[context(self::length, odd_length => {
-			// The length is in units of 4 bytes - we subtract the header, which is one of those
-			// units, then multiply by 4 to get the total number of bytes.
-			let length = usize::from(length - 1) * 4;
-			// We then remove the size of the previous field, `font`, to get the bytes from the
-			// start of `text` onwards.
-			let length = length - Fontable::X11_SIZE;
-			// We then remove the padding at the end, which can be determined from `odd_length`.
-			let length = length - query_text_extents_padding(*odd_length);
+		#[context(self::remaining, odd_length => {
+			// We remove the padding at the end, which can be determined from `odd_length`.
+			let remaining = remaining - query_text_extents_padding(*odd_length);
 
 			// We then divide the length, which is the number of bytes, by the number of bytes
 			// per character.
-			length / Char16::X11_SIZE
+			remaining / Char16::X11_SIZE
 		})]
 		pub text: String16,
 		[_; odd_length => query_text_extents_padding(*odd_length)]
@@ -3320,7 +3314,7 @@ derive_xrb! {
 		#[doc(alias("cid", "gid", "gcid", "context_id"))]
 		pub graphics_context_id: GraphicsContext,
 
-		/// > *<sup>TODO</sup>*
+		/// > *<sup>TODO</sup>*\
 		/// > ***We don't yet understand what this field is for. If you have any
 		/// > ideas, please feel free to open an issue or a discussion on the
 		/// > [GitHub repo]!***
@@ -3700,14 +3694,7 @@ derive_xrb! {
 		/// effect.
 		///
 		/// [rectangles]: Rectangle
-		#[context(self::length => {
-			let mut length = usize::from(length - 1) * 4;
-
-			length -= GraphicsContext::X11_SIZE;
-			length -= 2 * <Px<i16>>::X11_SIZE;
-
-			length / Rectangle::X11_SIZE
-		})]
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
 		pub clip_rectangles: Vec<Rectangle>,
 	}
 
diff --git a/xrbk_macro/src/definition.rs b/xrbk_macro/src/definition.rs
index 4df9242b..4fe4bdf3 100644
--- a/xrbk_macro/src/definition.rs
+++ b/xrbk_macro/src/definition.rs
@@ -432,7 +432,7 @@ impl DefinitionType {
 		}
 	}
 
-	pub fn length_syntax(&self) -> bool {
+	pub fn remaining_syntax(&self) -> bool {
 		matches!(self, Self::Request | Self::Reply)
 	}
 }
diff --git a/xrbk_macro/src/definition/expansion/readable.rs b/xrbk_macro/src/definition/expansion/readable.rs
index 244807d1..9cec12d1 100644
--- a/xrbk_macro/src/definition/expansion/readable.rs
+++ b/xrbk_macro/src/definition/expansion/readable.rs
@@ -22,14 +22,6 @@ impl Struct {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		// Expand the tokens to declare the x11_size variable if there is an
-		// UnusedContent::Infer unused bytes element to use it.
-		let declare_x11_size = if self.content.contains_infer() {
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 0;))
-		} else {
-			None
-		};
-
 		// Expand the tokens to call Self's constructor.
 		let cons = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
@@ -40,9 +32,9 @@ impl Struct {
 			for element in &self.content {
 				element.read_tokens(tokens, DefinitionType::Basic);
 
-				if self.content.contains_infer() {
-					element.add_x11_size_tokens(tokens);
-				}
+				// if self.content.contains_infer() {
+				element.add_x11_size_tokens(tokens);
+				// }
 			}
 		});
 
@@ -54,13 +46,14 @@ impl Struct {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
 				) -> Result<Self, ::xrbk::ReadError> {
 					// Declare a x11_size variable if it is going to be
 					// used in an infer unused bytes element.
-					#declare_x11_size
+					let mut size: usize = 0;
 
 					// Read each element.
 					#reads
@@ -85,14 +78,6 @@ impl Request {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			// The x11_size starts at `4` to account for the size of a request's header
-			// being 4 bytes.
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 4;))
-		} else {
-			None
-		};
-
 		let cons = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -102,9 +87,9 @@ impl Request {
 				if !element.is_metabyte() && !element.is_sequence() {
 					element.read_tokens(tokens, DefinitionType::Request);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -130,11 +115,12 @@ impl Request {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
 				) -> Result<Self, ::xrbk::ReadError> {
-					#declare_x11_size
+					let mut size: usize = 4;
 
 					// If there is a metabyte element, read it, if not and
 					// there is no minor opcode, skip one byte. If there
@@ -143,6 +129,7 @@ impl Request {
 					#metabyte
 					// Read the request's length.
 					let length = buf.get_u16();
+					let buf = &mut buf.take(((length - 1) as usize) * 4);
 
 					// Read other elements.
 					#reads
@@ -167,12 +154,6 @@ impl Reply {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 8;))
-		} else {
-			None
-		};
-
 		let cons = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -182,9 +163,9 @@ impl Reply {
 				if !element.is_metabyte() && !element.is_sequence() {
 					element.read_tokens(tokens, DefinitionType::Reply);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -210,11 +191,12 @@ impl Reply {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
 				) -> Result<Self, ::xrbk::ReadError> {
-					#declare_x11_size
+					let mut size: usize = 8;
 
 					// Metabyte position
 					#metabyte
@@ -222,6 +204,7 @@ impl Reply {
 					let #sequence = buf.get_u16();
 					// Length
 					let length = buf.get_u32();
+					let buf = &mut buf.take((((length) as usize) * 4) + (32 - 8));
 
 					// Other elements
 					#reads
@@ -246,16 +229,10 @@ impl Event {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			let size: usize = if self.content.sequence_element().is_some() {
-				4
-			} else {
-				1
-			};
-
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = #size;))
+		let x11_size: usize = if self.content.sequence_element().is_some() {
+			4
 		} else {
-			None
+			1
 		};
 
 		let cons = TokenStream2::with_tokens(|tokens| {
@@ -267,9 +244,9 @@ impl Event {
 				if !element.is_metabyte() && !element.is_sequence() {
 					element.read_tokens(tokens, DefinitionType::Event);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -302,11 +279,12 @@ impl Event {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
 				) -> Result<Self, ::xrbk::ReadError> {
-					#declare_x11_size
+					let mut size: usize = #x11_size;
 
 					// Metabyte position
 					#metabyte
@@ -335,19 +313,6 @@ impl Error {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			// 11 bytes includes:
-			// - 1 byte to say it's an error
-			// - 1 byte for its code
-			// - 2 bytes for its sequence number
-			// - 4 bytes for its (optional) error data
-			// - 2 bytes for the request's minor opcode
-			// - 1 byte for the request's major opcode
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 11;))
-		} else {
-			None
-		};
-
 		let cons = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -357,9 +322,9 @@ impl Error {
 				if element.is_normal() {
 					element.read_tokens(tokens, DefinitionType::Error);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -410,11 +375,19 @@ impl Error {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
 				) -> Result<Self, ::xrbk::ReadError> {
-					#declare_x11_size
+					// 11 bytes includes:
+					// - 1 byte to say it's an error
+					// - 1 byte for its code
+					// - 2 bytes for its sequence number
+					// - 4 bytes for its (optional) error data
+					// - 2 bytes for the request's minor opcode
+					// - 1 byte for the request's major opcode
+					let mut size: usize = 11;
 
 					#sequence
 					#error_data
@@ -472,16 +445,14 @@ impl Enum {
 			for variant in &self.variants {
 				let ident = &variant.ident;
 
-				let declare_x11_size = if variant.content.contains_infer() {
+				let declare_x11_size = {
 					let discrim_type = quote_spanned!(discrim_type.span()=>
 						<#discrim_type as ::xrbk::ConstantX11Size>
 					);
 
-					Some(quote_spanned!(trait_path.span()=>
+					quote_spanned!(trait_path.span()=>
 						let mut size: usize = #discrim_type::X11_SIZE;
-					))
-				} else {
-					None
+					)
 				};
 
 				if variant.discriminant.is_some() {
@@ -498,9 +469,9 @@ impl Enum {
 					for element in &variant.content {
 						element.read_tokens(tokens, DefinitionType::Basic);
 
-						if variant.content.contains_infer() {
-							element.add_x11_size_tokens(tokens);
-						}
+						// if variant.content.contains_infer() {
+						element.add_x11_size_tokens(tokens);
+						// }
 					}
 				});
 
@@ -531,6 +502,7 @@ impl Enum {
 					clippy::needless_borrow,
 					clippy::identity_op,
 					clippy::unnecessary_cast,
+					unused_mut,
 				)]
 				fn read_from(
 					buf: &mut impl ::xrbk::Buf,
diff --git a/xrbk_macro/src/definition/expansion/writable.rs b/xrbk_macro/src/definition/expansion/writable.rs
index c256f8cb..71bb5745 100644
--- a/xrbk_macro/src/definition/expansion/writable.rs
+++ b/xrbk_macro/src/definition/expansion/writable.rs
@@ -21,12 +21,6 @@ impl Struct {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 0;))
-		} else {
-			None
-		};
-
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -35,9 +29,9 @@ impl Struct {
 			for element in &self.content {
 				element.write_tokens(tokens, DefinitionType::Basic);
 
-				if self.content.contains_infer() {
-					element.add_x11_size_tokens(tokens);
-				}
+				// if self.content.contains_infer() {
+				element.add_x11_size_tokens(tokens);
+				// }
 			}
 		});
 
@@ -49,12 +43,13 @@ impl Struct {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
 					buf: &mut impl ::xrbk::BufMut,
 				) -> Result<(), ::xrbk::WriteError> {
-					#declare_x11_size
+					let mut size: usize = 0;
 					// Destructure the struct's fields, if any.
 					let Self #pat = self;
 
@@ -79,14 +74,6 @@ impl Request {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			// The x11_size starts at `4` to account for the size of a request's header
-			// being 4 bytes.
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 4;))
-		} else {
-			None
-		};
-
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -96,9 +83,9 @@ impl Request {
 				if !element.is_metabyte() && !element.is_sequence() {
 					element.write_tokens(tokens, DefinitionType::Request);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -126,12 +113,13 @@ impl Request {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
 					buf: &mut impl ::xrbk::BufMut,
 				) -> Result<(), ::xrbk::WriteError> {
-					#declare_x11_size
+					let mut size: usize = 4;
 					// Destructure the request struct's fields, if any.
 					let Self #pat = self;
 
@@ -164,14 +152,6 @@ impl Reply {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			// The x11_size starts at `8` to account for the size of a reply's\
-			// header being 8 bytes.
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 8;))
-		} else {
-			None
-		};
-
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -181,9 +161,9 @@ impl Reply {
 				if !element.is_metabyte() && !element.is_sequence() {
 					element.write_tokens(tokens, DefinitionType::Reply);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -211,12 +191,13 @@ impl Reply {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
 					buf: &mut impl ::xrbk::BufMut,
 				) -> Result<(), ::xrbk::WriteError> {
-					#declare_x11_size
+					let mut size: usize = 8;
 					// Destructure the reply struct's fields, if any.
 					let Self #pat = self;
 
@@ -251,16 +232,10 @@ impl Event {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			let x11_size: usize = if self.content.sequence_element().is_some() {
-				4
-			} else {
-				1
-			};
-
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = #x11_size;))
+		let x11_size: usize = if self.content.sequence_element().is_some() {
+			4
 		} else {
-			None
+			1
 		};
 
 		let pat = TokenStream2::with_tokens(|tokens| {
@@ -272,9 +247,9 @@ impl Event {
 				if element.is_normal() {
 					element.write_tokens(tokens, DefinitionType::Event);
 
-					if self.content.contains_infer() {
-						element.add_x11_size_tokens(tokens);
-					}
+					// if self.content.contains_infer() {
+					element.add_x11_size_tokens(tokens);
+					// }
 				}
 			}
 		});
@@ -307,12 +282,13 @@ impl Event {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
 					buf: &mut impl ::xrbk::BufMut,
 				) -> Result<(), ::xrbk::WriteError> {
-					#declare_x11_size
+					let mut size: usize = #x11_size;
 					// Destructure the event struct's fields, if any.
 					let Self #pat = self;
 
@@ -345,19 +321,6 @@ impl Error {
 			StructlikeContent::Unit { where_clause, .. } => where_clause,
 		};
 
-		let declare_x11_size = if self.content.contains_infer() {
-			// 11 bytes includes:
-			// - 1 byte to say it's an error
-			// - 1 byte for its code
-			// - 2 bytes for its sequence number
-			// - 4 bytes for its (optional) error data
-			// - 2 bytes for the request's minor opcode
-			// - 1 byte for the request's major opcode
-			Some(quote_spanned!(trait_path.span()=> let mut size: usize = 11;))
-		} else {
-			None
-		};
-
 		let pat = TokenStream2::with_tokens(|tokens| {
 			self.content.pat_cons_to_tokens(tokens);
 		});
@@ -420,12 +383,20 @@ impl Error {
 					clippy::trivially_copy_pass_by_ref,
 					clippy::needless_borrow,
 					clippy::identity_op,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
 					buf: &mut impl ::xrbk::BufMut,
 				) -> Result<(), ::xrbk::WriteError> {
-					#declare_x11_size
+					// 11 bytes includes:
+					// - 1 byte to say it's an error
+					// - 1 byte for its code
+					// - 2 bytes for its sequence number
+					// - 4 bytes for its (optional) error data
+					// - 2 bytes for the request's minor opcode
+					// - 1 byte for the request's major opcode
+					let mut size: usize = 11;
 					// Destructure the error struct's fields, if any.
 					let Self #pat = self;
 
@@ -494,7 +465,7 @@ impl Enum {
 			for variant in &self.variants {
 				let ident = &variant.ident;
 
-				let declare_x11_size = if variant.content.contains_infer() {
+				let declare_x11_size = {
 					let discrim_type = quote_spanned!(discrim_type.span()=>
 						<#discrim_type as ::xrbk::ConstantX11Size>
 					);
@@ -502,8 +473,6 @@ impl Enum {
 					Some(quote_spanned!(trait_path.span()=>
 						let mut size: usize = #discrim_type::X11_SIZE;
 					))
-				} else {
-					None
 				};
 
 				if variant.discriminant.is_some() {
@@ -520,9 +489,9 @@ impl Enum {
 					for element in &variant.content {
 						element.write_tokens(tokens, DefinitionType::Basic);
 
-						if variant.content.contains_infer() {
-							element.add_x11_size_tokens(tokens);
-						}
+						// if variant.content.contains_infer() {
+						element.add_x11_size_tokens(tokens);
+						// }
 					}
 				});
 
@@ -553,6 +522,7 @@ impl Enum {
 					clippy::identity_op,
 					clippy::cast_possible_truncation,
 					clippy::unnecessary_cast,
+					unused_mut,
 				)]
 				fn write_to(
 					&self,
diff --git a/xrbk_macro/src/source.rs b/xrbk_macro/src/source.rs
index 16e56da3..c2578885 100644
--- a/xrbk_macro/src/source.rs
+++ b/xrbk_macro/src/source.rs
@@ -5,13 +5,14 @@
 mod expansion;
 mod parsing;
 
+use crate::definition::DefinitionType;
 use std::collections::HashMap;
 use syn::{punctuated::Punctuated, Expr, Ident, Pat, Token, Type};
 
 pub type IdentMap<'a> = &'a HashMap<String, Type>;
 pub type IdentMapMut<'a> = &'a mut HashMap<String, Type>;
 
-/// A non-[SourceLengthArg] argument for a [`Source`].
+/// A non-[SourceRemainingArg] argument for a [`Source`].
 ///
 /// > **<sup>Syntax</sup>**\
 /// > _SourceArg_ :\
@@ -40,10 +41,10 @@ pub struct SourceArg {
 ///
 /// [`Request`]: crate::definition::Request
 /// [`Reply`]: crate::definition::Reply
-pub struct SourceLengthArg {
+pub struct SourceRemainingArg {
 	pub self_token: Token![self],
 	pub double_colon_token: Token![::],
-	pub length_token: Ident,
+	pub remaining_token: Ident,
 }
 
 /// Arguments for a [`Source`].
@@ -53,18 +54,18 @@ pub struct SourceLengthArg {
 /// > &nbsp;&nbsp; _Arg_ ( `,` _Arg_ )<sup>\*</sup> `,`<sup>?</sup>
 /// >
 /// > _Arg_ :\
-/// > &nbsp;&nbsp; [_SourceArg_] | [_SourceLengthArg_][^usage]
+/// > &nbsp;&nbsp; [_SourceArg_] | [_SourceRemainingArg_][^usage]
 /// >
-/// > [^usage]: [_SourceLengthArg_]s may only be used within [`Request`]s and
+/// > [^usage]: [_SourceRemainingArg_]s may only be used within [`Request`]s and
 /// > [`Reply`]s, and they may be used no more than once per _SourceArgs_.
 ///
 /// [_SourceArg_]: SourceArg
-/// [_SourceLengthArg_]: SourceLengthArg
+/// [_SourceLengthArg_]: SourceRemainingArg
 /// [`Request`]: crate::definition::Request
 /// [`Reply`]: crate::definition::Reply
 pub struct SourceArgs {
 	pub args: Punctuated<SourceArg, Token![,]>,
-	pub length_arg: Option<(SourceLengthArg, Type)>,
+	pub remaining_arg: Option<(SourceRemainingArg, DefinitionType)>,
 }
 
 /// An inline function.
@@ -77,18 +78,18 @@ pub struct SourceArgs {
 /// > &nbsp;&nbsp; [_Arg_] ( `,` [_Arg_] )<sup>\*</sup> `,`<sup>?</sup>
 /// >
 /// > [_Arg_] :\
-/// > &nbsp;&nbsp; [_SourceArg_] | [_SourceLengthArg_]
+/// > &nbsp;&nbsp; [_SourceArg_] | [_SourceRemainingArg_]
 /// >
 /// > [_SourceArg_] :\
 /// > &nbsp;&nbsp; [IDENTIFIER] ( `:` [_Pattern_] )<sup>?</sup>
 /// >
-/// > [_SourceLengthArg_] :\
-/// > &nbsp;&nbsp; `self` `::` `length`
+/// > [_SourceRemainingArg_] :\
+/// > &nbsp;&nbsp; `self` `::` `remaining`
 /// >
 /// > [_SourceArgs_]: SourceArgs
 /// > [_Arg_]: SourceArgs
 /// > [_SourceArg_]: SourceArg
-/// > [_SourceLengthArg_]: SourceLengthArg
+/// > [_SourceRemainingArg_]: SourceRemainingArg
 /// >
 /// > [_Expression_]: https://doc.rust-lang.org/reference/expressions.html
 /// > [IDENTIFIER]: https://doc.rust-lang.org/reference/identifiers.html
@@ -174,12 +175,11 @@ pub struct SourceArgs {
 /// [^pattern-use-name]: Unless that pattern simply repeats the same name, like
 /// `shape: shape`.
 ///
-/// # Length arguments
+/// # Remaining bytes arguments
 /// Additionally, in a [`Request`] or a [`Reply`], a special argument referring
-/// to the length of the message (in units of 4 bytes, as defined in the X11
-/// protocol, and offset by 8 units in the case of replies) may be used:
-/// `self::length`. This special syntax may be used in any `Source` within that
-/// [`Request`] or [`Reply`].
+/// to the remaining bytes in the message may be used: `self::remaining`. This
+/// special syntax may be used in any `Source` within that [`Request`] or
+/// [`Reply`].
 ///
 /// # Examples
 /// ```ignore
@@ -234,7 +234,7 @@ pub struct SourceArgs {
 /// `[_; ..]` syntax is a special syntax for [`ArrayUnused`] bytes elements to
 /// infer the number of unused bytes. It generates no function.
 ///
-/// ## Length arguments
+/// ## Remaining bytes arguments
 /// ```ignore
 /// # extern crate xrbk;
 /// # extern crate xrb;
@@ -257,18 +257,7 @@ pub struct SourceArgs {
 ///         pub context: GraphicsContext,
 ///         pub clip_origin: Point,
 ///
-///         #[context(self::length => {
-///             (
-///                 // Each length unit is four bytes.
-///                 (length * 4)
-///                 // The request header is four bytes.
-///                 - 4
-///                 // The elements before the `rectangles` field are eight bytes.
-///                 - 8
-///             )
-///             // Each rectangle is eight bytes.
-///             / 8
-///         })]
+///         #[context(self::remaining => remaining / Rectangle::X11_SIZE)]
 ///         pub rectangles: Vec<Rectangle>,
 ///     }
 /// }
diff --git a/xrbk_macro/src/source/expansion.rs b/xrbk_macro/src/source/expansion.rs
index ee9352f8..78e5ab95 100644
--- a/xrbk_macro/src/source/expansion.rs
+++ b/xrbk_macro/src/source/expansion.rs
@@ -2,17 +2,19 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-use super::*;
-use crate::TsExt;
 use proc_macro2::TokenStream as TokenStream2;
 use quote::{quote, quote_spanned, ToTokens};
 use syn::{punctuated::Pair, Attribute};
 
-impl ToTokens for SourceLengthArg {
+use crate::TsExt;
+
+use super::*;
+
+impl ToTokens for SourceRemainingArg {
 	fn to_tokens(&self, tokens: &mut TokenStream2) {
 		self.self_token.to_tokens(tokens);
 		self.double_colon_token.to_tokens(tokens);
-		self.length_token.to_tokens(tokens);
+		self.remaining_token.to_tokens(tokens);
 	}
 }
 
@@ -32,8 +34,14 @@ impl ToTokens for SourceArg {
 
 impl ToTokens for SourceArgs {
 	fn to_tokens(&self, tokens: &mut TokenStream2) {
-		if let Some((SourceLengthArg { length_token, .. }, r#type)) = &self.length_arg {
-			tokens.append_tokens(quote!(#length_token: #r#type, ));
+		if let Some((
+			SourceRemainingArg {
+				remaining_token, ..
+			},
+			_,
+		)) = &self.remaining_arg
+		{
+			tokens.append_tokens(quote!(#remaining_token: usize, ));
 		}
 
 		for pair in self.args.pairs() {
@@ -50,8 +58,15 @@ impl ToTokens for SourceArgs {
 
 impl SourceArgs {
 	pub fn formatted_tokens(&self, tokens: &mut TokenStream2) {
-		if let Some((SourceLengthArg { length_token, .. }, ..)) = &self.length_arg {
-			quote_spanned!(length_token.span()=> #length_token,).to_tokens(tokens);
+		if let Some((_, definition_type)) = &self.remaining_arg {
+			match definition_type {
+				DefinitionType::Request => quote!((((length - 1) as usize) * 4) - size,),
+				DefinitionType::Reply => {
+					quote!(((length as usize) * 4) + (32 - 8) - size,)
+				},
+				_ => unreachable!(),
+			}
+			.to_tokens(tokens);
 		}
 
 		for pair in self.args.pairs() {
diff --git a/xrbk_macro/src/source/parsing.rs b/xrbk_macro/src/source/parsing.rs
index a6f3e826..29f2540a 100644
--- a/xrbk_macro/src/source/parsing.rs
+++ b/xrbk_macro/src/source/parsing.rs
@@ -61,16 +61,16 @@ impl ParseWithContext for SourceArg {
 	}
 }
 
-impl Parse for SourceLengthArg {
+impl Parse for SourceRemainingArg {
 	fn parse(input: ParseStream) -> syn::Result<Self> {
 		let self_token = input.parse()?;
 		let double_colon_token = input.parse()?;
 
-		let length_token = {
+		let remaining_token = {
 			let ident: Ident = input.parse()?;
 
-			if ident != "length" {
-				return Err(Error::new(ident.span(), "expected message `length`"));
+			if ident != "remaining" {
+				return Err(Error::new(ident.span(), "expected `remaining` bytes"));
 			}
 
 			ident
@@ -79,7 +79,7 @@ impl Parse for SourceLengthArg {
 		Ok(Self {
 			self_token,
 			double_colon_token,
-			length_token,
+			remaining_token,
 		})
 	}
 }
@@ -94,20 +94,21 @@ impl ParseWithContext for SourceArgs {
 		let (maps, definition_type) = context;
 
 		let mut args = Punctuated::new();
-		let mut length_arg = None;
+		let mut remaining_arg = None;
 
-		while input.peek(Ident) || (definition_type.length_syntax() && input.peek(Token![self])) {
-			if let Some(r#type) = definition_type.length_type() && input.peek(Token![self]) {
-				if length_arg.is_some() {
-					let length_arg2: SourceLengthArg = input.parse()?;
+		while input.peek(Ident) || (definition_type.remaining_syntax() && input.peek(Token![self]))
+		{
+			if definition_type.remaining_syntax() && input.peek(Token![self]) {
+				if remaining_arg.is_some() {
+					let remaining_arg2: SourceRemainingArg = input.parse()?;
 
 					return Err(Error::new(
-						length_arg2.span(),
-						"duplicate message length argument",
+						remaining_arg2.span(),
+						"duplicate remaining bytes argument",
 					));
 				}
 
-				length_arg = Some((input.parse()?, r#type));
+				remaining_arg = Some((input.parse()?, definition_type));
 
 				if input.peek(Token![,]) {
 					input.parse::<Token![,]>()?;
@@ -125,7 +126,10 @@ impl ParseWithContext for SourceArgs {
 			}
 		}
 
-		Ok(Self { args, length_arg })
+		Ok(Self {
+			args,
+			remaining_arg,
+		})
 	}
 }
 

From a6d694ba7100e0482585c30de889a0a067e8555f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 10:28:24 +0000
Subject: [PATCH 082/157] DrawPoints request

---
 src/x11/request.rs | 123 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 123 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 61b80159..75fc48c4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4091,3 +4091,126 @@ derive_xrb! {
 		pub bit_plane: u32,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyPointError", "DrawPointError"))]
+	pub enum DrawPointsError for DrawPoints {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Whether [coordinates] of elements to be drawn in graphics operations are
+/// relative to the [drawable] or the previous element.
+///
+/// The first element is always relative to the [drawable].
+///
+/// [coordinates]: Coords
+/// [drawable]: Drawable
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum CoordinateMode {
+	/// [Coordinates] are relative to the top-left corner of the [drawable].
+	///
+	/// [Coordinates]: Coords
+	/// [drawable]: Drawable
+	Drawable,
+
+	/// [Coordinates][coords] are relative to the [coordinates][coords] of the
+	/// previous element.
+	///
+	/// [coords]: Coords
+	Previous,
+}
+
+derive_xrb! {
+	/// A [request] that draws the  given `points` on the `target` [drawable].
+	///
+	/// The points are drawn by combining the `graphics_context`'s
+	/// [`foreground_color`] with the existing color at those coordinates in the
+	/// [drawable]. They are drawn in the order that they are specified in the
+	/// list.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [drawable].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("PolyPoint", "DrawPoint"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawPoints: Request(64, DrawPointsError) {
+		/// Whether the `points` are drawn relative to the `target` or the
+		/// previously drawn point.
+		///
+		/// The first point is always drawn relative to the `target`.
+		///
+		/// See [`CoordinateMode`] for more information.
+		#[metabyte]
+		pub coordinate_mode: CoordinateMode,
+
+		/// The [drawable] on which the given `points` are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [drawable].
+		///
+		/// [drawable]: Drawable
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The points which are to be drawn.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are drawn in the order that they appear in the list.
+		///
+		/// Each point is drawn by combining the [`foreground_color`] with the
+		/// existing color of the pixel at the point's [coordinates].
+		///
+		/// [coordinates]: Coords
+		///
+		/// [`foreground_color`]: GraphicsOptions::foreground_color
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}

From 10d0d5af9e25ed11175ab5ce54907256060896ae Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 11:01:20 +0000
Subject: [PATCH 083/157] DrawPath request

---
 src/x11/request.rs | 146 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 144 insertions(+), 2 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 75fc48c4..055ed488 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4144,12 +4144,14 @@ derive_xrb! {
 	///
 	/// # Errors
 	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [drawable].
+	/// defined [window] nor [pixmap].
 	///
 	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
 	/// refer to a defined [`GraphicsContext`].
 	///
 	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
 	/// [request]: crate::message::Request
 	///
@@ -4180,9 +4182,11 @@ derive_xrb! {
 		///
 		/// # Errors
 		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [drawable].
+		/// defined [window] nor [pixmap].
 		///
 		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
 		///
 		/// [`Drawable` error]: error::Drawable
 		#[doc(alias("drawable"))]
@@ -4214,3 +4218,141 @@ derive_xrb! {
 		pub points: Vec<Coords>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyLineError", "DrawLinesError", "DrawLineError"))]
+	pub enum DrawPathError for DrawPath {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws a path comprised of lines that join the given
+	/// `points`.
+	///
+	/// The lines are drawn in the order that the points appear in `points`.
+	/// They join at each intermediate point. If the first and last points are
+	/// in the same location, they are also joined to create a closed path (with
+	/// no endpoints).
+	///
+	/// Intersecting [thin] lines have their intersecting pixels drawn multiple
+	/// times. Intersecting [thick] lines, however, only have their intersecting
+	/// pixels drawn once.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [thin]: crate::set::LineWidth::Thin
+	/// [thick]: crate::set::LineWidth::Thick
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("PolyLine", "DrawLines", "DrawLine"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawPath: Request(65, DrawPathError) {
+		/// Whether the [coordinates] of each point in `points` are relative to
+		/// the `target` or to the previous point.
+		///
+		/// The first point is always relative to the `target` [drawable].
+		///
+		/// [coordinates]: Coords
+		/// [drawable]: Drawable
+		#[metabyte]
+		pub coordinate_mode: CoordinateMode,
+
+		/// The [drawable] on which the path is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The points which are to be connected by lines.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are connected by lines in the order that they appear in
+		/// this list.
+		///
+		/// [coordinates]: Coords
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}

From 118b0e9c7e80f66127748351b540852467ad942a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 11:17:54 +0000
Subject: [PATCH 084/157] DrawLines request

---
 src/x11/request.rs | 122 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 120 insertions(+), 2 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 055ed488..9f4c05fb 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -26,7 +26,7 @@ use xrbk::{
 	WriteResult,
 	X11Size,
 };
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 
 use crate::{
 	message::Event,
@@ -4306,7 +4306,6 @@ derive_xrb! {
 	///
 	/// [`Drawable` error]: error::Drawable
 	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
 	#[doc(alias("PolyLine", "DrawLines", "DrawLine"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct DrawPath: Request(65, DrawPathError) {
@@ -4356,3 +4355,122 @@ derive_xrb! {
 		pub points: Vec<Coords>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolySegmentError", "DrawSegmentError"))]
+	pub enum DrawLinesError for DrawLines {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+/// A line from the given `start` point to the given `end` point.
+#[doc(alias("Segment"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+pub struct Line {
+	/// The start of the line.
+	pub start: Coords,
+	/// The end of the line.
+	pub end: Coords,
+}
+
+derive_xrb! {
+	/// A [request] that draws the given `lines`.
+	///
+	/// No join points are created. Intersecting [lines] have their intersecting
+	/// pixels drawn multiple times.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [lines]: Line
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolySegment", "DrawSegment"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawLines: Request(66, DrawLinesError) {
+		/// The [drawable] on which the given `lines` are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The lines which are to be drawn.
+		///
+		/// The lines are drawn in the order that they appear in this list.
+		#[context(self::remaining => remaining / Line::X11_SIZE)]
+		pub lines: Vec<Line>,
+	}
+}

From 57626894fe64cc83e2e2f05f6b8f6386fe4774df Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 11:45:07 +0000
Subject: [PATCH 085/157] requests - add ConstantX11Size derive

The macro doesn't actually implement ConstantX11Size yet, that is yet TODO, but I've added the derive so that it works when they do.
---
 src/x11/request.rs | 103 +++++++++++++++++++++++----------------------
 1 file changed, 52 insertions(+), 51 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 9f4c05fb..473e5d57 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -36,6 +36,7 @@ use crate::{
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
+	Arc,
 	Atom,
 	Button,
 	Char16,
@@ -265,7 +266,7 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	/// [attributes]: Attributes
 	/// [window]: Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetWindowAttributes: Request(3, error::Window) -> reply::GetWindowAttributes {
 		/// The [window] for which this [request] gets the [attributes].
 		///
@@ -298,7 +299,7 @@ derive_xrb! {
 	///
 	/// [`UnmapWindow` request]: UnmapWindow
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct DestroyWindow: Request(4, error::Window) {
 		/// The [window] which is the target of the `DestroyWindow` [request].
 		///
@@ -330,7 +331,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "DestroySubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct DestroyChildren: Request(5, error::Window) {
 		/// The [window] which will have its children [destroyed].
 		///
@@ -392,7 +393,7 @@ derive_xrb! {
 	///
 	/// [reparented]: ReparentWindow
 	#[doc(alias = "ChangeSaveSet")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ChangeSavedWindows: Request(6, ChangeSavedWindowsError) {
 		#[metabyte]
 		/// Whether the `window` is added to or removed from your saved
@@ -466,7 +467,7 @@ derive_xrb! {
 	///
 	/// [`Match` error]: error::Match
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ReparentWindow: Request(7, ReparentWindowError) {
 		/// The [window] which will be transferred to be a child of the
 		/// `new_parent`.
@@ -536,7 +537,7 @@ derive_xrb! {
 	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct MapWindow: Request(8, error::Window) {
 		/// The [window] which is the target of the `MapWindow` [request].
 		///
@@ -569,7 +570,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "MapSubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct MapChildren: Request(9, error::Window) {
 		/// The [window] which will have its unmapped children [mapped].
 		///
@@ -603,7 +604,7 @@ derive_xrb! {
 	/// [`Unmap` event]: super::event::Unmap
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UnmapWindow: Request(10, error::Window) {
 		/// The [window] which is the target of the `UnmapWindow` [request].
 		///
@@ -635,7 +636,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "UnmapSubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UnmapChildren: Request(11, error::Window) {
 		/// The [window] which will have its mapped children [unmapped].
 		///
@@ -800,7 +801,7 @@ derive_xrb! {
 	/// [`Circulate` event]: super::event::Circulate
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct CirculateWindow: Request(13, CirculateWindowError) {
 		#[metabyte]
 		/// Which of the [window]'s children might be circulated and in which
@@ -846,7 +847,7 @@ derive_xrb! {
 	/// [`GetGeometry` reply]: reply::GetGeometry
 	///
 	/// [`Drawable` error]: error::Drawable
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetGeometry: Request(14, error::Drawable) -> reply::GetGeometry {
 		/// The [drawable] for which this [request] gets its geometry.
 		///
@@ -883,7 +884,7 @@ derive_xrb! {
 	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
 	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
 	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
 		/// The [window] for which this [request] gets its root [window],
 		/// parent, and children.
@@ -964,7 +965,7 @@ derive_xrb! {
 	/// [`GetAtomName` reply]: reply::GetAtomName
 	///
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetAtomName: Request(17, error::Atom) -> reply::GetAtomName {
 		/// The [atom] for which this [request] gets its name.
 		///
@@ -1274,7 +1275,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct DeleteProperty: Request(19, DeletePropertyError) {
 		/// The [window] for which this [request] removes the `property`.
 		///
@@ -1333,7 +1334,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetProperty: Request(20, GetPropertyError) -> reply::GetProperty {
 		/// Whether the `property` should be deleted from the `target` [window].
 		///
@@ -1411,7 +1412,7 @@ derive_xrb! {
 	/// [`ListProperties` reply]: reply::ListProperties
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ListProperties: Request(21, error::Window) -> reply::ListProperties {
 		/// The [window] for which this [request] returns its properties.
 		///
@@ -1464,7 +1465,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct SetSelectionOwner: Request(22, SetSelectionOwnerError) {
 		/// Sets the new owner of the `selection`.
 		///
@@ -1518,7 +1519,7 @@ derive_xrb! {
 	/// [`GetSelectionOwner` reply]: reply::GetSelectionOwner
 	///
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetSelectionOwner: Request(23) -> reply::GetSelectionOwner {
 		/// The selection for which this [request] returns its owner.
 		///
@@ -1558,7 +1559,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ConvertSelection: Request(24, ConvertSelectionError) {
 		/// Your [window] which is requesting this conversion.
 		///
@@ -1648,8 +1649,8 @@ derive_xrb! {
 	//
 	// This feature would be nice for this:
 	// <https://github.com/rust-lang/rust/issues/92827>
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SendEvent<E: Event>: Request(25, SendEventError) {
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct SendEvent<E: Event + ConstantX11Size>: Request(25, SendEventError) {
 		/// Whether the `event` should be propagated to the closest appropriate
 		/// ancestor, if necessary.
 		///
@@ -1716,7 +1717,7 @@ derive_xrb! {
 	/// [`Window` error]: error::Window
 	/// [`CursorAppearance` error]: error::CursorAppearance
 	#[doc(alias = "GrabPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabCursor: Request(26, GrabCursorError) -> reply::GrabCursor {
 		/// Whether cursor [events] which would normally be reported to this
 		/// client are reported normally.
@@ -1829,7 +1830,7 @@ derive_xrb! {
 	/// [`EnterWindow`]: super::event::EnterWindow
 	/// [`LeaveWindow`]: super::event::LeaveWindow
 	#[doc(alias = "UngrabPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabCursor: Request(27) {
 		/// The [time] at which the grab is recorded as having been released.
 		///
@@ -1880,7 +1881,7 @@ derive_xrb! {
 	/// [`Access` error]: error::Access
 	/// [`Window` error]: error::Window
 	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabButton: Request(28, GrabButtonError) {
 		/// Whether cursor [events] which would normally be reported to this
 		/// client are reported normally.
@@ -2019,7 +2020,7 @@ derive_xrb! {
 	/// [passive button grab]: GrabButton
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabButton: Request(29, UngrabButtonError) {
 		/// The [button] which the [passive button grab] was established for.
 		///
@@ -2088,7 +2089,7 @@ derive_xrb! {
 	///
 	/// [`CursorAppearance` error]: error::CursorAppearance
 	#[doc(alias = "ChangeActivePointerGrab")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ChangeActiveCursorGrab: Request(30, ChangeActiveCursorGrabError) {
 		/// Optionally overrides the [appearance of the cursor], no matter which
 		/// [window] it is within, for the duration of the grab.
@@ -2155,7 +2156,7 @@ derive_xrb! {
 	/// [`GrabKeyboard` reply]: reply::GrabKeyboard
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabKeyboard: Request(31, GrabKeyboardError) -> reply::GrabKeyboard {
 		/// Whether key [events] which would normally be reported to this client
 		/// are reported normally.
@@ -2234,7 +2235,7 @@ derive_xrb! {
 	///
 	/// [`Focus`]: super::event::Focus
 	/// [`Unfocus`]: super::event::Unfocus
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabKeyboard: Request(32) {
 		/// The [time] at which the grab is recorded as having been released.
 		///
@@ -2281,7 +2282,7 @@ derive_xrb! {
 	///
 	/// [`Access` error]: error::Access
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabKey: Request(33, GrabKeyError) {
 		/// Whether key [events] which would normally be reported to this client
 		/// are reported normally.
@@ -2386,7 +2387,7 @@ derive_xrb! {
 	/// [passive key grab]: GrabKey
 	///
 	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabKey: Request(34, UngrabKeyError) {
 		/// The key which the [passive key grab] was established for.
 		///
@@ -2511,7 +2512,7 @@ derive_xrb! {
 	///
 	/// [frozen]: FreezeMode::Frozen
 	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct AllowEvents: Request(35, error::Value) {
 		/// The conditions under which the queued [events] are released.
 		///
@@ -2536,14 +2537,14 @@ derive_xrb! {
 	/// connection closes on all other clients' connections.
 	///
 	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabServer: Request(36);
 
 	/// A [request] that unfreezes processing of [requests][request] and
 	/// connection closes on all other clients' connections.
 	///
 	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabServer: Request(37);
 
 	/// A [request] that gets the current location of the cursor.
@@ -2557,7 +2558,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryCursorLocation: Request(38, error::Window) -> reply::QueryCursorLocation {
 		/// Specifies a [window] to receive relative coordinates of the cursor
 		/// in relation to, if the cursor is on the same screen.
@@ -2587,7 +2588,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "GetMotionEvents")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetMotionHistory: Request(39, error::Window) -> reply::GetMotionHistory {
 		/// The [window] for which the motion history is returned.
 		///
@@ -2622,7 +2623,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "TranslateCoordinates")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ConvertCoordinates: Request(40, error::Window) -> reply::ConvertCoordinates {
 		/// The [window] which the `original_coords` are relative to.
 		///
@@ -2724,7 +2725,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "WarpPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct WarpCursor: Request(41, error::Window) {
 		/// The [window] which the cursor is being warped from.
 		///
@@ -2845,7 +2846,7 @@ derive_xrb! {
 	/// [`Match` error]: error::Match
 	/// [`Window` error]: error::Window
 	#[doc(alias("SetInputFocus", "Focus", "FocusWindow"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct SetFocus: Request(42, SetFocusError) {
 		/// What the focus should revert to if the focused [window] becomes
 		/// unviewable.
@@ -2876,7 +2877,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	#[doc(alias = "GetInputFocus")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetFocus: Request(43) -> reply::GetFocus;
 
 	/// A [request] that returns a bit vector of the currently held keys on the
@@ -2884,7 +2885,7 @@ derive_xrb! {
 	///
 	/// [request]: crate::message::Request
 	#[doc(alias = "QueryKeymap")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
 }
 
@@ -2931,7 +2932,7 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	/// [`Font` ID]: Font
 	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UnassignFont: Request(46) {
 		/// The [`Font` ID] which is having its association with a font removed.
 		///
@@ -2956,7 +2957,7 @@ derive_xrb! {
 	/// [`QueryFont` reply]: reply::QueryFont
 	///
 	/// [`Font` error]: error::Font
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryFont: Request(47, error::Font) -> reply::QueryFont {
 		/// The font which this [request] returns information about.
 		///
@@ -3147,7 +3148,7 @@ derive_xrb! {
 	/// See also: [`SetFontSearchDirectories`].
 	///
 	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
 }
 
@@ -3183,7 +3184,7 @@ derive_xrb! {
 	/// [`Drawable` error]: error::Drawable
 	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
 	/// [`Value` error]: error::Value
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct CreatePixmap: Request(53, CreatePixmapError) {
 		/// The depth of the [pixmap].
 		///
@@ -3251,7 +3252,7 @@ derive_xrb! {
 	/// [request]: crate::message::Request
 	///
 	/// [`Pixmap` error]: error::Pixmap
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct FreePixmap: Request(54, error::Pixmap) {
 		/// The [pixmap] which is to have its association with its ID removed.
 		///
@@ -3445,7 +3446,7 @@ derive_xrb! {
 	/// [`GraphicsContext` error]: error::GraphicsContext
 	/// [`Match` error]: error::Match
 	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
 		/// The [`GraphicsContext`] from which the [options] specified in
 		/// `options_mask` are copied.
@@ -3714,7 +3715,7 @@ derive_xrb! {
 	/// [`GraphicsContext` error]: error::GraphicsContext
 	#[doc(alias("FreeGc", "FreeGC", "FreeGcontext", "FreeGraphicsContext"))]
 	#[doc(alias("DestroyGc", "DestroyGC", "DestroyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
 		/// The [`GraphicsContext`] which is to be deleted.
 		///
@@ -3760,7 +3761,7 @@ derive_xrb! {
 	///
 	/// [`Window` error]: error::Window
 	/// [`Match` error]: error::Match
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ClearArea: Request(61, ClearAreaError) {
 		/// Whether [`GraphicsExposure` events] should be generated for regions
 		/// of the `area` which are visible or maintained.
@@ -3859,7 +3860,7 @@ derive_xrb! {
 	/// [`Drawable` error]: error::Drawable
 	/// [`GraphicsContext` error]: error::GraphicsContext
 	/// [`Match` error]: error::Match
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct CopyArea: Request(62, CopyAreaError) {
 		/// The [drawable] from which the area is copied.
 		///
@@ -3997,7 +3998,7 @@ derive_xrb! {
 	/// [`Match` error]: error::Match
 	/// [`Value` error]: error::Value
 	#[doc(alias("CopyPlane"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct CopyBitPlane: Request(63, CopyBitPlaneError) {
 		/// The [drawable] used as the source in this graphics operation.
 		///
@@ -4125,7 +4126,7 @@ pub enum CoordinateMode {
 }
 
 derive_xrb! {
-	/// A [request] that draws the  given `points` on the `target` [drawable].
+	/// A [request] that draws the given `points` on the `target` [drawable].
 	///
 	/// The points are drawn by combining the `graphics_context`'s
 	/// [`foreground_color`] with the existing color at those coordinates in the

From a14df658a07ea2a760c86951fecbf2f053212d38 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 28 Jan 2023 11:47:12 +0000
Subject: [PATCH 086/157] [CI844] applied recommended clippy fixes

---
 src/x11/request.rs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 473e5d57..0e532651 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -36,7 +36,6 @@ use crate::{
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
-	Arc,
 	Atom,
 	Button,
 	Char16,

From 0394577d36a26a07178b831a79b2ac1aa9f1342b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 11:53:38 +0000
Subject: [PATCH 087/157] XRBK macro: potentially fix errors with buf.take

---
 xrbk_macro/src/definition/expansion/readable.rs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/xrbk_macro/src/definition/expansion/readable.rs b/xrbk_macro/src/definition/expansion/readable.rs
index 9cec12d1..85038f9b 100644
--- a/xrbk_macro/src/definition/expansion/readable.rs
+++ b/xrbk_macro/src/definition/expansion/readable.rs
@@ -129,7 +129,10 @@ impl Request {
 					#metabyte
 					// Read the request's length.
 					let length = buf.get_u16();
-					let buf = &mut buf.take(((length - 1) as usize) * 4);
+					let buf = &mut <_ as ::xrbk::Buf>::take(
+						buf,
+						((length - 1) as usize) * 4,
+					);
 
 					// Read other elements.
 					#reads
@@ -204,7 +207,10 @@ impl Reply {
 					let #sequence = buf.get_u16();
 					// Length
 					let length = buf.get_u32();
-					let buf = &mut buf.take((((length) as usize) * 4) + (32 - 8));
+					let buf = &mut <_ as ::xrbk::Buf>::take(
+						buf,
+						(((length) as usize) * 4) + (32 - 8),
+					);
 
 					// Other elements
 					#reads

From c96c226d5ab5b20c84be1c0f1e2173c1ca44ef69 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 12:18:16 +0000
Subject: [PATCH 088/157] DrawRectangles request

---
 src/x11/request.rs | 122 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 122 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 0e532651..b43292e9 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4474,3 +4474,125 @@ derive_xrb! {
 		pub lines: Vec<Line>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyRectangleError"))]
+	pub enum DrawRectanglesError for DrawRectangles {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws the outlines of the given `rectangles`.
+	///
+	/// The outlines are drawn as [lines] connecting each corner of the
+	/// [rectangles], starting at the top-left corner and going clockwise, with
+	/// a join point at each corner - thus forming a closed path.
+	///
+	/// If any of the given `rectangles` intersect, the intersecting pixels are
+	/// drawn multiple times.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [lines]: Line
+	/// [rectangles]: Rectangle
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyRectangle"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawRectangles: Request(67, DrawRectanglesError) {
+		/// The [drawable] on which the `rectangles`' outlines are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [rectangles] which are to have their outlines drawn.
+		///
+		/// Their `x` and `y` coordinates are relative to the top-left corner of
+		/// the `target` [drawable].
+		///
+		/// The [rectangles] are drawn in the order that they appear in this
+		/// list.
+		///
+		/// [rectangles]: Rectangle
+		/// [drawable]: Drawable
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub rectangles: Vec<Rectangle>,
+	}
+}

From 5b966b42d974c97df96a4a5d64434ed66562d5c5 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 16:06:14 +0000
Subject: [PATCH 089/157] XRBK macro: fix errors with using Buf::take

---
 .../src/definition/expansion/readable.rs      | 30 +++++---
 .../src/definition/expansion/writable.rs      | 69 ++++++++++++++-----
 xrbk_macro/src/element/expansion/xrbk.rs      |  8 +--
 3 files changed, 76 insertions(+), 31 deletions(-)

diff --git a/xrbk_macro/src/definition/expansion/readable.rs b/xrbk_macro/src/definition/expansion/readable.rs
index 85038f9b..9f2187c1 100644
--- a/xrbk_macro/src/definition/expansion/readable.rs
+++ b/xrbk_macro/src/definition/expansion/readable.rs
@@ -104,7 +104,7 @@ impl Request {
 				element.read_tokens(tokens, DefinitionType::Request);
 			}))
 		} else {
-			Some(quote_spanned!(trait_path.span()=> buf.advance(1);))
+			Some(quote_spanned!(trait_path.span()=> <_ as ::xrbk::Buf>::advance(buf, 1);))
 		};
 
 		tokens.append_tokens(quote_spanned!(trait_path.span()=>
@@ -128,7 +128,7 @@ impl Request {
 					// read.
 					#metabyte
 					// Read the request's length.
-					let length = buf.get_u16();
+					let length = <_ as ::xrbk::Buf>::get_u16(buf);
 					let buf = &mut <_ as ::xrbk::Buf>::take(
 						buf,
 						((length - 1) as usize) * 4,
@@ -178,7 +178,7 @@ impl Reply {
 				element.read_tokens(tokens, DefinitionType::Reply);
 			})
 		} else {
-			quote_spanned!(trait_path.span()=> buf.advance(1);)
+			quote_spanned!(trait_path.span()=> <_ as ::xrbk::Buf>::advance(buf, 1);)
 		};
 
 		let sequence = match self.content.sequence_element() {
@@ -204,9 +204,9 @@ impl Reply {
 					// Metabyte position
 					#metabyte
 					// Sequence field
-					let #sequence = buf.get_u16();
+					let #sequence = <_ as ::xrbk::Buf>::get_u16(buf);
 					// Length
-					let length = buf.get_u32();
+					let length = <_ as ::xrbk::Buf>::get_u32(buf);
 					let buf = &mut <_ as ::xrbk::Buf>::take(
 						buf,
 						(((length) as usize) * 4) + (32 - 8),
@@ -265,14 +265,16 @@ impl Event {
 			}))
 		} else {
 			Some(quote_spanned!(trait_path.span()=>
-				buf.advance(1);
+				<_ as ::xrbk::Buf>::advance(buf, 1);
 			))
 		};
 
 		let sequence = if let Some(Element::Field(field)) = self.content.sequence_element() {
 			let formatted = &field.formatted;
 
-			Some(quote_spanned!(trait_path.span()=> let #formatted = buf.get_u16();))
+			Some(quote_spanned!(trait_path.span()=>
+				let #formatted = <_ as ::xrbk::Buf>::get_u16(buf);
+			))
 		} else {
 			None
 		};
@@ -339,7 +341,9 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> let #formatted = buf.get_u16();)
+				quote_spanned!(trait_path.span()=>
+					let #formatted = <_ as ::xrbk::Buf>::get_u16(buf);
+				)
 			},
 
 			_ => panic!("errors must have sequence fields"),
@@ -349,7 +353,9 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> let #formatted = buf.get_u16();)
+				quote_spanned!(trait_path.span()=>
+					let #formatted = <_ as ::xrbk::Buf>::get_u16(buf);
+				)
 			},
 
 			_ => panic!("errors must have minor opcode fields"),
@@ -359,7 +365,9 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> let #formatted = buf.get_u8();)
+				quote_spanned!(trait_path.span()=>
+					let #formatted = <_ as ::xrbk::Buf>::get_u8(buf);
+				)
 			},
 
 			_ => panic!("errors must have major opcode fields"),
@@ -370,7 +378,7 @@ impl Error {
 				TokenStream2::with_tokens(|tokens| field.read_tokens(tokens))
 			},
 
-			_ => quote_spanned!(trait_path.span()=> buf.advance(4);),
+			_ => quote_spanned!(trait_path.span()=> <_ as ::xrbk::Buf>::advance(buf, 4);),
 		};
 
 		tokens.append_tokens(quote_spanned!(trait_path.span()=>
diff --git a/xrbk_macro/src/definition/expansion/writable.rs b/xrbk_macro/src/definition/expansion/writable.rs
index 71bb5745..24a989ae 100644
--- a/xrbk_macro/src/definition/expansion/writable.rs
+++ b/xrbk_macro/src/definition/expansion/writable.rs
@@ -93,7 +93,10 @@ impl Request {
 		let metabyte = if self.minor_opcode.is_some() {
 			// TODO: can't be in metabyte, must check this in protocol!!
 			quote_spanned!(trait_path.span()=>
-				buf.put_u16(<Self as xrb::message::Request>::MINOR_OPCODE.unwrap());
+				<_ as ::xrbk::BufMut>::put_u16(
+					buf,
+					<Self as xrb::message::Request>::MINOR_OPCODE.unwrap(),
+				);
 			)
 		} else if let Some(element) = self.content.metabyte_element() {
 			TokenStream2::with_tokens(|tokens| {
@@ -101,7 +104,10 @@ impl Request {
 			})
 		} else {
 			quote_spanned!(trait_path.span()=>
-				buf.put_u8(0);
+				<_ as ::xrbk::BufMut>::put_u8(
+					buf,
+					0,
+				);
 			)
 		};
 
@@ -124,11 +130,17 @@ impl Request {
 					let Self #pat = self;
 
 					// Major opcode
-					buf.put_u8(<Self as xrb::message::Request>::MAJOR_OPCODE);
+					<_ as ::xrbk::BufMut>::put_u8(
+						buf,
+						<Self as xrb::message::Request>::MAJOR_OPCODE
+					);
 					// Metabyte position
 					#metabyte
 					// Length
-					buf.put_u16(<Self as xrb::message::Request>::length(&self));
+					<_ as ::xrbk::BufMut>::put_u16(
+						buf,
+						<Self as xrb::message::Request>::length(&self),
+					);
 
 					// Other elements
 					#writes
@@ -174,7 +186,7 @@ impl Reply {
 			})
 		} else {
 			quote_spanned!(trait_path.span()=>
-				buf.put_u8(0);
+				<_ as ::xrbk::BufMut>::put_u8(buf, 0);
 			)
 		};
 
@@ -206,9 +218,15 @@ impl Reply {
 					// Metabyte position
 					#metabyte
 					// Sequence field
-					buf.put_u16(*#sequence);
+					<_ as ::xrbk::BufMut>::put_u16(
+						buf,
+						*#sequence,
+					);
 					// Length
-					buf.put_u32(<Self as xrb::message::Reply>::length(&self));
+					<_ as ::xrbk::BufMut>::put_u32(
+						buf,
+						<Self as xrb::message::Reply>::length(&self),
+					);
 
 					// Other elements
 					#writes
@@ -262,14 +280,16 @@ impl Event {
 			}))
 		} else {
 			Some(quote_spanned!(trait_path.span()=>
-				buf.put_u8(0);
+				<_ as ::xrbk::BufMut>::put_u8(buf, 0);
 			))
 		};
 
 		let sequence = if let Some(Element::Field(field)) = self.content.sequence_element() {
 			let formatted = &field.formatted;
 
-			Some(quote_spanned!(trait_path.span()=> buf.put_u16(*#formatted);))
+			Some(quote_spanned!(trait_path.span()=>
+				<_ as ::xrbk::BufMut>::put_u16(buf, *#formatted);
+			))
 		} else {
 			None
 		};
@@ -293,7 +313,10 @@ impl Event {
 					let Self #pat = self;
 
 					// Event code
-					buf.put_u8(<Self as xrb::message::Event>::CODE);
+					<_ as ::xrbk::BufMut>::put_u8(
+						buf,
+						<Self as xrb::message::Event>::CODE,
+					);
 					// Metabyte position
 					#metabyte
 					// Sequence field
@@ -341,7 +364,12 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> buf.put_u16(*#formatted);)
+				quote_spanned!(trait_path.span()=>
+					<_ as ::xrbk::BufMut>::put_u16(
+						buf,
+						*#formatted,
+					);
+				)
 			},
 
 			_ => panic!("errors must have sequence fields"),
@@ -351,7 +379,9 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> buf.put_u16(*#formatted);)
+				quote_spanned!(trait_path.span()=>
+					<_ as ::xrbk::BufMut>::put_u16(buf, *#formatted);
+				)
 			},
 
 			_ => panic!("errors must have minor opcode fields"),
@@ -361,7 +391,9 @@ impl Error {
 			Some(Element::Field(field)) => {
 				let formatted = &field.formatted;
 
-				quote_spanned!(trait_path.span()=> buf.put_u8(*#formatted);)
+				quote_spanned!(trait_path.span()=>
+					<_ as ::xrbk::BufMut>::put_u8(buf, *#formatted);
+				)
 			},
 
 			_ => panic!("errors must have major opcode fields"),
@@ -372,7 +404,9 @@ impl Error {
 				TokenStream2::with_tokens(|tokens| field.write_tokens(tokens))
 			},
 
-			_ => quote_spanned!(trait_path.span()=> buf.put_bytes(0, 4);),
+			_ => quote_spanned!(trait_path.span()=>
+				<_ as ::xrbk::BufMut>::put_bytes(buf, 0, 4);
+			),
 		};
 
 		tokens.append_tokens(quote_spanned!(trait_path.span()=>
@@ -401,9 +435,12 @@ impl Error {
 					let Self #pat = self;
 
 					// A first byte of `0` means that this is an error.
-					buf.put_u8(0);
+					<_ as ::xrbk::BufMut>::put_u8(buf, 0);
 					// Error code, uniquely identifying the error.
-					buf.put_u8(<Self as xrb::message::Error>::CODE);
+					<_ as ::xrbk::BufMut>::put_u8(
+						buf,
+						<Self as xrb::message::Error>::CODE,
+					);
 					// Sequence number.
 					#sequence
 					// An optional 4-byte data field.
diff --git a/xrbk_macro/src/element/expansion/xrbk.rs b/xrbk_macro/src/element/expansion/xrbk.rs
index 7a717dfa..a956b726 100644
--- a/xrbk_macro/src/element/expansion/xrbk.rs
+++ b/xrbk_macro/src/element/expansion/xrbk.rs
@@ -257,7 +257,7 @@ impl SingleUnused {
 	pub fn write_tokens(&self, tokens: &mut TokenStream2) {
 		tokens.append_tokens({
 			quote_spanned!(self.span()=>
-				buf.put_u8(0);
+				<_ as ::xrbk::BufMut>::put_u8(buf, 0);
 			)
 		});
 	}
@@ -269,7 +269,7 @@ impl SingleUnused {
 	pub fn read_tokens(&self, tokens: &mut TokenStream2) {
 		tokens.append_tokens({
 			quote_spanned!(self.span()=>
-				buf.advance(1);
+				<_ as ::xrbk::Buf>::advance(buf, 1);
 			)
 		});
 	}
@@ -332,7 +332,7 @@ impl ArrayUnused {
 
 		tokens.append_tokens({
 			quote_spanned!(self.span()=>
-				buf.put_bytes(0u8, #formatted);
+				<_ as ::xrbk::BufMut>::put_bytes(buf, 0u8, #formatted);
 			)
 		});
 	}
@@ -349,7 +349,7 @@ impl ArrayUnused {
 
 		tokens.append_tokens({
 			quote_spanned!(self.span()=>
-				buf.advance(#formatted);
+				<_ as ::xrbk::Buf>::advance(buf, #formatted);
 			)
 		})
 	}

From 931b29e13130f9659093c9c444cbd375e482e04f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 16:40:11 +0000
Subject: [PATCH 090/157] DrawArcs request

---
 src/common.rs      |  15 ++++--
 src/x11/request.rs | 113 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 123 insertions(+), 5 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 8336417d..0013bd64 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -492,13 +492,18 @@ pub struct Region {
 	pub height: Px<u16>,
 }
 
-/// This copies the values of `width` and `height`.
+/// A circular or elliptical arc.
 #[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, ConstantX11Size, Readable, Writable)]
 pub struct Arc {
-	pub x: Px<i16>,
-	pub y: Px<i16>,
-	pub width: Px<u16>,
-	pub height: Px<u16>,
+	/// The [rectangle] which contains the arc.
+	///
+	/// The center of the arc is the center of this rectangle. If the arc were
+	/// to form a full circle, it would touch this [rectangle] in four places:
+	/// the left side, the top side, the right side, and the bottom side. It is
+	/// fully contained within this [rectangle].
+	///
+	/// [rectangle]: Rectangle
+	pub bounds: Rectangle,
 
 	/// Specifies the start of the `Arc`.
 	///
diff --git a/src/x11/request.rs b/src/x11/request.rs
index b43292e9..199e6b41 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -36,6 +36,7 @@ use crate::{
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
+	Arc,
 	Atom,
 	Button,
 	Char16,
@@ -4596,3 +4597,115 @@ derive_xrb! {
 		pub rectangles: Vec<Rectangle>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyArcError"))]
+	pub enum DrawArcsError for DrawArcs {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws circular or elliptical [arcs][arc].
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	///
+	/// [arc]: Arc
+	/// [request]: crate::message::Request
+	#[doc(alias("PolyArc"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawArcs: Request(68, DrawArcsError) {
+		/// The [drawable] on which the [arcs] are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [arcs]: Arc
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [arcs][arc] which are to be drawn.
+		///
+		/// If the last point in an [arc] is in the same location as the first
+		/// point in the next [arc], the two [arcs][arc] are joined with a
+		/// joinpoint. If the last point of the last [arc] and the first point
+		/// of the first [arc] are in the same location, they will also be
+		/// joined.
+		///
+		/// [arc]: Arc
+		#[context(self::remaining => remaining / Arc::X11_SIZE)]
+		pub arcs: Vec<Arc>,
+	}
+}

From fc1eba9d36eb9e7c9ae4961aeeca092ecc0e8190 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 17:18:56 +0000
Subject: [PATCH 091/157] FillPolygon request

---
 src/x11/request.rs | 164 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 161 insertions(+), 3 deletions(-)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 199e6b41..9b9946d3 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4531,6 +4531,7 @@ derive_xrb! {
 	/// [pixmap]: Pixmap
 	/// [lines]: Line
 	/// [rectangles]: Rectangle
+	/// [options]: GraphicsOptions
 	/// [request]: crate::message::Request
 	///
 	/// [`function`]: GraphicsOptions::function
@@ -4642,6 +4643,12 @@ derive_xrb! {
 	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
 	/// refer to a defined [`GraphicsContext`].
 	///
+	/// [arc]: Arc
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
 	/// [`line_width`]: GraphicsOptions::line_width
@@ -4665,9 +4672,6 @@ derive_xrb! {
 	///
 	/// [`Drawable` error]: error::Drawable
 	/// [`GraphicsContext` error]: error::GraphicsContext
-	///
-	/// [arc]: Arc
-	/// [request]: crate::message::Request
 	#[doc(alias("PolyArc"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct DrawArcs: Request(68, DrawArcsError) {
@@ -4709,3 +4713,157 @@ derive_xrb! {
 		pub arcs: Vec<Arc>,
 	}
 }
+
+request_error! {
+	#[doc(alias("FillPolyError"))]
+	pub enum FillPolygonError for FillPolygon {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies properties of a polygon that may allow for optimizations when
+/// drawing it.
+///
+/// This is used in the [`FillPolygon` request].
+///
+/// [`FillPolygon` request]: FillPolygon
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ShapeMode {
+	/// The shape may intersect itself.
+	Complex,
+
+	/// The shape may not intersect itself, but it is not (fully) convex.
+	///
+	/// If these properties are known to be true by the client, specifying this
+	/// mode may improve performance over [`Complex`](ShapeMode::Complex).
+	Nonconvex,
+
+	/// The shape may not intersect itself and it is convex.
+	///
+	/// Convex means that no [line] could be drawn between two points in the
+	/// shape which intersects the shape's path.
+	///
+	/// If these properties are known to be true by the client, specifying this
+	/// mode may improve performance over [`Nonconvex`](ShapeMode::Nonconvex).
+	///
+	/// [line]: Line
+	Convex,
+}
+
+derive_xrb! {
+	/// A [request] that fills the area enclosed the given path.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`fill_rule`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`fill_rule`]: GraphicsOptions::fill_rule
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("FillPoly"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillPolygon: Request(69, FillPolygonError) {
+		/// The [drawable] on which the filled polygon is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// Specifies whether the polygon self-intersects and whether it is
+		/// convex.
+		///
+		/// If the relevant properties of the specified polygon are known by the
+		/// client, specifying a more restrictive [shape mode] may improve
+		/// performance.
+		///
+		/// See [`ShapeMode`] for more information.
+		///
+		/// [shape mode]: ShapeMode
+		pub shape: ShapeMode,
+		/// Whether the [coordinates] of each point in `points` are relative to
+		/// the `target` or to the previous point.
+		///
+		/// The first point is always relative to the `target` [drawable].
+		///
+		/// [coordinates]: Coords
+		/// [drawable]: Drawable
+		pub coordinate_mode: CoordinateMode,
+		[_; 2],
+
+		/// The points which, when connected, specify the path of the polygon.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are connected in the order that they appear in this list.
+		/// If the last point is not in the same location as the first point, it
+		/// is automatically connected to the first point to close the path.
+		///
+		/// [coordinates]: Coords
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}

From 1fb30120390defc8e3f3c113d731a5d216d9e5dc Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 17:31:53 +0000
Subject: [PATCH 092/157] FillRectangles request

---
 src/x11/request.rs | 107 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 107 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 9b9946d3..6fee89cf 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4867,3 +4867,110 @@ derive_xrb! {
 		pub points: Vec<Coords>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyFillRectangleError"))]
+	pub enum FillRectanglesError for FillRectangles {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that fills the given `rectangles`.
+	///
+	/// This is effectively the same as if a [`FillPolygon` request] were sent
+	/// for each [rectangle] with the [rectangle]'s four points, starting with
+	/// the top-left corner and going clockwise.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [rectangle]: Rectangle
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`FillPolygon` request]: FillPolygon
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyFillRectangle"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillRectangles: Request(70, FillRectanglesError) {
+		/// The [drawable] on which the [rectangles] are filled.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [rectangles]: Rectangle
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [rectangles] which are to be filled.
+		///
+		/// The [rectangles] are filled in the order that they appear in this
+		/// list. For intersecting [rectangles], the intersecting pixels are
+		/// drawn multiple times.
+		///
+		/// [rectangles]: Rectangle
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub rectangles: Vec<Rectangle>,
+	}
+}

From 11a9a90faf22e5196eb59a4d02a3e384b7fac8fd Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sat, 28 Jan 2023 17:45:27 +0000
Subject: [PATCH 093/157] FillArcs request

---
 src/x11/request.rs | 113 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)

diff --git a/src/x11/request.rs b/src/x11/request.rs
index 6fee89cf..622851f4 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -4974,3 +4974,116 @@ derive_xrb! {
 		pub rectangles: Vec<Rectangle>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyFillArcError"))]
+	pub enum FillArcsError for FillArcs {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that fills the given `arcs`.
+	///
+	/// If the `graphics_context`'s [`arc_mode`] is [`ArcMode::Chord`], the
+	/// [arcs][arc] are filled by joining each [arc]'s endpoints with a single
+	/// [line]. If the [`arc_mode`] is [`ArcMode::PieSlice`], however, the
+	/// [arcs][arc] are filled by joining each [arc]'s endpoints with the center
+	/// of that [arc], thus using two [lines][line].
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`arc_mode`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [arc]: Arc
+	/// [line]: Line
+	/// [request]: crate::message::Request
+	///
+	/// [`ArcMode::Chord`]: crate::set::ArcMode::Chord
+	/// [`ArcMode::PieSlice`]: crate::set::ArcMode::PieSlice
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`arc_mode`]: GraphicsOptions::arc_mode
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyFillArc"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillArcs: Request(71, FillArcsError) {
+		/// The [drawable] on which the [arcs] are filled.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [arcs]: Arc
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [arcs] which are to be filled.
+		///
+		/// The [arcs] are filled in the order that they appear in this list. If
+		/// there are intersecting [arcs], the intersecting pixels will be drawn
+		/// multiple times.
+		///
+		/// [arcs]: Arc
+		#[context(self::remaining => remaining / Arc::X11_SIZE)]
+		pub arcs: Vec<Arc>,
+	}
+}

From 11f89a693920a4e612f33613ca8a0e4d413df508 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 10:17:20 +0000
Subject: [PATCH 094/157] organize requests and replies into categories

---
 src/common/set/attribute.rs      |    6 +-
 src/x11/reply.rs                 | 1641 +---------
 src/x11/reply/color.rs           |   15 +
 src/x11/reply/font.rs            |  832 +++++
 src/x11/reply/graphics.rs        |   15 +
 src/x11/reply/input.rs           |  326 ++
 src/x11/reply/meta.rs            |   15 +
 src/x11/reply/miscellaneous.rs   |  219 ++
 src/x11/reply/window.rs          |  336 ++
 src/x11/request.rs               | 5096 +-----------------------------
 src/x11/request/color.rs         |   10 +
 src/x11/request/font.rs          |  320 ++
 src/x11/request/graphics.rs      | 1998 ++++++++++++
 src/x11/request/input.rs         | 1270 ++++++++
 src/x11/request/meta.rs          |  119 +
 src/x11/request/miscellaneous.rs |  857 +++++
 src/x11/request/window.rs        |  796 +++++
 17 files changed, 7167 insertions(+), 6704 deletions(-)
 create mode 100644 src/x11/reply/color.rs
 create mode 100644 src/x11/reply/font.rs
 create mode 100644 src/x11/reply/graphics.rs
 create mode 100644 src/x11/reply/input.rs
 create mode 100644 src/x11/reply/meta.rs
 create mode 100644 src/x11/reply/miscellaneous.rs
 create mode 100644 src/x11/reply/window.rs
 create mode 100644 src/x11/request/color.rs
 create mode 100644 src/x11/request/font.rs
 create mode 100644 src/x11/request/graphics.rs
 create mode 100644 src/x11/request/input.rs
 create mode 100644 src/x11/request/meta.rs
 create mode 100644 src/x11/request/miscellaneous.rs
 create mode 100644 src/x11/request/window.rs

diff --git a/src/common/set/attribute.rs b/src/common/set/attribute.rs
index b6009ef1..c7b3cc8b 100644
--- a/src/common/set/attribute.rs
+++ b/src/common/set/attribute.rs
@@ -69,7 +69,7 @@ pub type ColormapAttribute = CopyableFromParent<Colormap>;
 /// not explicitly initialized in the [`CreateWindow` request], and the
 /// [window classes] that it can be set with.
 ///
-/// [window]: Window
+/// [window]: crate::Window
 /// [`CreateWindow` request]: crate::x11::request::CreateWindow
 /// [window classes]: crate::WindowClass
 ///
@@ -116,8 +116,6 @@ pub type ColormapAttribute = CopyableFromParent<Colormap>;
 ///
 /// [`InputOutput`]: crate::WindowClass::InputOutput
 /// [`InputOnly`]: crate::WindowClass::InputOnly
-///
-/// [window]: Window
 #[derive(Clone, Debug, Hash, PartialEq, Eq)]
 pub struct Attributes {
 	/// Total [`X11Size`] of these `Attributes`.
@@ -209,7 +207,7 @@ impl AttributesBuilder {
 	/// methods on this builder. When the builder is configured, [`build()`] can
 	/// be used to build the resulting [`Attributes`].
 	///
-	/// [`build()`]: build
+	/// [`build()`]: AttributesBuilder::build
 	#[must_use]
 	pub const fn new() -> Self {
 		Self {
diff --git a/src/x11/reply.rs b/src/x11/reply.rs
index 009040d7..98330e3d 100644
--- a/src/x11/reply.rs
+++ b/src/x11/reply.rs
@@ -7,1628 +7,25 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: Reply
+//! [Replies]: crate::message::Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: super
 
-extern crate self as xrb;
-
-use derivative::Derivative;
-
-use xrbk::{
-	pad,
-	Buf,
-	BufMut,
-	ConstantX11Size,
-	ReadResult,
-	Readable,
-	ReadableWithContext,
-	Writable,
-	WriteResult,
-	X11Size,
-};
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
-
-use crate::{
-	message::Reply,
-	unit::Px,
-	visual::{ColorId, VisualId},
-	x11::request::{self, DataFormat, DataList, RevertFocus},
-	Atom,
-	BitGravity,
-	Colormap,
-	Coords,
-	DeviceEventMask,
-	EventMask,
-	FocusWindow,
-	GrabStatus,
-	LengthString8,
-	MaintainContents,
-	ModifierMask,
-	Rectangle,
-	String8,
-	Timestamp,
-	Window,
-	WindowClass,
-	WindowGravity,
-};
-
-/// The state of the [window] regarding how it is mapped.
-///
-/// [window]: Window
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum MapState {
-	/// The [window] is not mapped.
-	///
-	/// [window]: Window
-	Unmapped,
-
-	/// The [window] is mapped but one of its ancestors is unmapped.
-	///
-	/// [window]: Window
-	Unviewable,
-
-	/// The [window] is mapped and all of its ancestors are mapped.
-	///
-	/// [window]: Window
-	Viewable,
-}
-
-derive_xrb! {
-	/// The [reply] to a [`GetWindowAttributes` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetWindowAttributes: Reply for request::GetWindowAttributes {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The conditions under which the X server should maintain the obscured
-		/// [regions] of the [window].
-		///
-		/// See [`Attributes::maintain_contents`] for more information.
-		///
-		/// [regions]: crate::Region
-		/// [window]: Window
-		///
-		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
-		#[doc(alias = "backing_store")]
-		#[metabyte]
-		pub maintain_contents: MaintainContents,
-
-		/// The visual used by the [window].
-		///
-		/// See [`VisualType`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`VisualType`]: crate::visual::VisualType
-		pub visual: VisualId,
-		/// The [window]'s [class].
-		///
-		/// [window]: Window
-		/// [class]: WindowClass
-		pub class: WindowClass,
-
-		/// Defines the [region] of the [window] which is retained when the
-		/// [window] is resized.
-		///
-		/// See [`Attributes::bit_gravity`] for more information.
-		///
-		/// [region]: crate::Region
-		/// [window]: Window
-		///
-		/// [`Attributes::bit_gravity`]: crate::set::Attributes::bit_gravity
-		pub bit_gravity: BitGravity,
-		/// Defines how the [window] is repositioned if its parent is resized.
-		///
-		/// See [`Attributes::window_gravity`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`Attributes::window_gravity`]: crate::set::Attributes::window_gravity
-		#[doc(alias = "win_gravity")]
-		pub window_graivty: WindowGravity,
-
-		/// Defines which bit planes of the [window] hold dynamic data which is
-		/// maintained for `maintain_contents` and `maintain_windows_under`.
-		///
-		/// See [`Attributes::maintained_planes`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`Attributes::maintained_planes`]: crate::set::Attributes::maintained_planes
-		#[doc(alias = "backing_planes")]
-		pub maintained_planes: u32,
-		/// Defines the [color] used for bit planes which are not preserved for
-		/// `maintain_contents` and `maintain_windows_under` (see
-		/// `maintained_planes`).
-		///
-		/// See [`Attributes::maintenance_fallback_color`] for more information.
-		///
-		/// [color]: ColorId
-		///
-		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
-		#[doc(alias = "backing_pixel")]
-		pub maintenance_fallback_color: ColorId,
-		/// Whether the X server should maintain the contents of
-		/// [windows][window] under this [window].
-		///
-		/// See [`Attributes::maintain_windows_under`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`Attributes::maintain_windows_under`]: crate::set::Attributes::maintain_windows_under
-		#[doc(alias = "save_under")]
-		pub maintain_windows_under: bool,
-
-		/// Whether the [window]'s `colormap` is an installed [colormap] for
-		/// the [screen].
-		///
-		/// [window]: Window
-		/// [colormap]: Colormap
-		/// [screen]: crate::visual::Screen
-		pub map_installed: bool,
-		/// The [window]'s [map state].
-		///
-		/// See [`MapState`] for more information.
-		///
-		/// [window]: Window
-		/// [map state]: MapState
-		pub map_state: MapState,
-
-		/// Whether [`MapWindow`] and [`ConfigureWindow`] requests on the
-		/// [window] override a [`SUBSTRUCTURE_REDIRECT`] selection on its
-		/// parent.
-		///
-		/// This is typically used to inform a window manager not to tamper with
-		/// the [window].
-		///
-		/// See [`Attributes::override_redirect`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`MapWindow`]: request::MapWindow
-		/// [`ConfigureWindow`]: request::ConfigureWindow
-		///
-		/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
-		///
-		/// [`Attributes::override_redirect`]: crate::set::Attributes::override_redirect
-		pub override_redirect: bool,
-
-		/// The [colormap] which best reflects the true colors of the [window].
-		///
-		/// See [`Attributes::colormap`] for more information.
-		///
-		/// [window]: Window
-		/// [colormap]: Colormap
-		///
-		/// [`Attributes::colormap`]: crate::set::Attributes::colormap
-		pub colormap: Option<Colormap>,
-
-		/// All of the [events] selected by all clients on the [window].
-		///
-		/// This is the bitwise OR of every client's [`event_mask`] on the
-		/// [window].
-		///
-		/// [window]: Window
-		/// [events]: crate::message::Event
-		///
-		/// [`event_mask`]: crate::set::Attributes::event_mask
-		pub all_event_masks: EventMask,
-		/// The [events] selected by you on the [window].
-		///
-		/// This is your [`event_mask`] on the [window].
-		///
-		/// [window]: Window
-		/// [events]: crate::message::Event
-		///
-		/// [`event_mask`]: crate::set::Attributes::event_mask
-		pub your_event_mask: EventMask,
-		/// Defines the [events][event] which should not be propagated to
-		/// ancestors of the [window] if no client has selected the [event] on
-		/// the [window].
-		///
-		/// See [`Attributes::do_not_propagate_mask`] for more information.
-		///
-		/// [event]: crate::message::Event
-		/// [window]: Window
-		///
-		/// [`Attributes::do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
-		pub do_not_propagate_mask: DeviceEventMask,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`GetGeometry` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetGeometry` request]: request::GetGeometry
-	#[doc(alias("GetX", "GetY", "GetWidth", "GetHeight", "GetBorderWidth"))]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetGeometry: Reply for request::GetGeometry {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The number of bits per pixel for the [drawable].
-		///
-		/// [drawable]: crate::Drawable
-		#[metabyte]
-		pub depth: u8,
-
-		/// The [drawable]'s root [window].
-		///
-		/// [window]: Window
-		/// [drawable]: crate::Drawable
-		pub root: Window,
-
-		/// The [drawable]'s geometry.
-		///
-		/// For a [pixmap], the `x` and `y` coordinates will always be zero.
-		///
-		/// For a [window], the coordinates are relative to the top-left corner
-		/// of the [window]'s parent.
-		///
-		/// [window]: Window
-		/// [pixmap]: crate::Pixmap
-		/// [drawable]: crate::Drawable
-		#[doc(alias("x", "y", "width", "height"))]
-		pub geometry: Rectangle,
-		/// The width of the [drawable]'s border.
-		///
-		/// For a [pixmap], this will always be zero.
-		///
-		/// [pixmap]: crate::Pixmap
-		/// [drawable]: crate::Drawable
-		pub border_width: Px<u16>,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`QueryWindowTree` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`QueryWindowTree` request]: request::QueryWindowTree
-	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
-	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
-	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The `target` [window]'s root [window].
-		///
-		/// [window]: Window
-		pub root: Window,
-		/// The `target` [window]'s parent.
-		///
-		/// [window]: Window
-		pub parent: Option<Window>,
-
-		// The length of `children`.
-		#[allow(clippy::cast_possible_truncation)]
-		let children_len: u16 = children => children.len() as u16,
-		[_; 14],
-
-		/// The `target` [window]'s children.
-		///
-		/// [window]: Window
-		#[context(children_len => usize::from(*children_len))]
-		pub children: Vec<Window>,
-	}
-
-	/// The [reply] to a [`GetAtom` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetAtom` request]: request::GetAtom
-	#[doc(alias("InternAtom", "CreateAtom"))]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetAtom: Reply for request::GetAtom {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The returned [atom].
-		///
-		/// If `no_creation` was set to `true` and an [atom] by the given `name`
-		/// didn't already exist, this will be [`None`].
-		///
-		/// [atom]: Atom
-		pub atom: Option<Atom>,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`GetAtomName` request].
-	///
-	/// [reply]: crate::message
-	///
-	/// [`GetAtomName` request]: request::GetAtomName
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetAtomName: Reply for request::GetAtomName {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		// The length of `name`.
-		#[allow(clippy::cast_possible_truncation)]
-		let name_len: u16 = name => name.len() as u16,
-		[_; 22],
-
-		/// The name of the [atom].
-		///
-		/// [atom]: Atom
-		#[context(name_len => usize::from(*name_len))]
-		pub name: String8,
-		[_; name => pad(name)],
-	}
-
-	/// The [reply] to a [`GetProperty` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetProperty` request]: request::GetProperty
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetProperty: Reply for request::GetProperty {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// Whether the `value` is empty ([`None`]), or made up of `i8` values,
-		/// `i16` values, or `i32` values.
-		#[metabyte]
-		pub format: Option<DataFormat>,
-
-		/// The actual type of the property.
-		pub r#type: Option<Atom>,
-		/// The number of bytes remaining in the `property`'s data.
-		///
-		/// If the specified `property` does not exist for the `target`
-		/// [window], this is zero.
-		///
-		/// If the specified `property` exists but its `type` does not match the
-		/// specified type, this is the size of the property's data in bytes.
-		///
-		/// If the specified `property` exists and the type is either [`Any`] or
-		/// matches the actual `type` of the property, this is the number of
-		/// bytes remaining in the `property`'s data after the end of the
-		/// returned `value`.
-		///
-		/// [window]: Window
-		///
-		/// [`Any`]: crate::Any::Any
-		#[doc(alias = "bytes_after")]
-		pub bytes_remaining: u32,
-
-		// The length of `value`.
-		#[allow(clippy::cast_possible_truncation)]
-		let value_len: u32 = value => value.len() as u32,
-		[_; 12],
-
-		/// The property's value.
-		///
-		/// If `format` is [`None`], this will be [`DataList::I8`], but with an
-		/// empty list.
-		#[context(format, value_len => (format.unwrap_or(DataFormat::I8), *value_len))]
-		pub value: DataList,
-	}
-
-	/// The [reply] for a [`ListProperties` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`ListProperties` request]: request::ListProperties
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct ListProperties: Reply for request::ListProperties {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		// The length of `properties`.
-		#[allow(clippy::cast_possible_truncation)]
-		let properties_len: u16 = properties => properties.len() as u16,
-		[_; 22],
-
-		/// The properties defined for the given [window].
-		///
-		/// [window]: Window
-		#[doc(alias = "atoms")]
-		#[context(properties_len => usize::from(*properties_len))]
-		pub properties: Vec<Atom>,
-	}
-
-	/// The [reply] to a [`GetSelectionOwner` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetSelectionOwner` request]: request::GetSelectionOwner
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetSelectionOwner: Reply for request::GetSelectionOwner {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The owner of the given `selection`.
-		///
-		/// If this is [`None`], then the selection has no owner.
-		pub owner: Option<Window>,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`GrabCursor` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GrabCursor` request]: request::GrabCursor
-	#[doc(alias = "GrabPointer")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GrabCursor: Reply for request::GrabCursor {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The status of the attempted grab.
-		///
-		/// See [`GrabStatus`] for more information.
-		#[doc(alias = "status")]
-		#[metabyte]
-		pub grab_status: GrabStatus,
-
-		[_; ..],
-	}
-
-	/// The [reply] to a [`GrabKeyboard` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GrabKeyboard` request]: request::GrabKeyboard
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GrabKeyboard: Reply for request::GrabKeyboard {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// The status of the attempted grab.
-		///
-		/// See [`GrabStatus`] for more information.
-		#[doc(alias = "status")]
-		#[metabyte]
-		pub grab_status: GrabStatus,
-
-		[_; ..],
-	}
-
-
-	/// The [reply] to a [`QueryCursorLocation` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`QueryCursorLocation` request]: request::QueryCursorLocation
-	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct QueryCursorLocation: Reply for request::QueryCursorLocation {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// Whether the cursor is on the `same_screen` as the given `target`
-		/// [window].
-		///
-		/// [window]: Window
-		#[metabyte]
-		pub same_screen: bool,
-
-		/// The root [window] which the cursor is located within.
-		///
-		/// [window]: Window
-		pub root: Window,
-		/// The child [window] containing the cursor, if any.
-		///
-		/// If the cursor is not on the `same_screen` (i.e., `same_screen` is
-		/// `false`), this will always be [`None`].
-		///
-		/// [window]: Window
-		// TODO: should always be [`None`] if `same_screen` is false
-		pub child: Option<Window>,
-
-		/// The coordinates of the cursor relative to the top-left corner of the
-		/// `root` [window].
-		///
-		/// [window]: Window
-		pub root_coords: Coords,
-		/// The coordinates of the cursor relative to the top-left corner of the
-		/// given `target` [window].
-		///
-		/// [window]: Window
-		// TODO: should always be [`None`] if `same_screen` is false
-		pub target_coords: Coords,
-
-		/// The currently held mouse buttons and modifier keys.
-		pub modifiers: ModifierMask,
-		[_; ..],
-	}
-}
-
-/// The coordinates of the cursor at a certain [time].
-///
-/// This is used in the [`GetMotionHistory` reply].
-///
-/// [time]: Timestamp
-///
-/// [`GetMotionHistory` reply]: GetMotionHistory
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub struct TimeCoords {
-	/// The [time] at which the cursor was at the `coords`.
-	///
-	/// [time]: Timestamp
-	pub time: Timestamp,
-	/// The coordinates of the cursor at the `time`.
-	pub coords: Coords,
-}
-
-derive_xrb! {
-	/// The [reply] to a [`GetMotionHistory` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetMotionHistory` request]: request::GetMotionHistory
-	#[doc(alias = "GetMotionEvents")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetMotionHistory: Reply for request::GetMotionHistory {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		// The length of `motion_history`.
-		#[allow(clippy::cast_possible_truncation)]
-		let motion_history_len: u32 = motion_history => motion_history.len() as u32,
-		[_; 20],
-
-		/// The recorded cursor motion between the `start` and `end` times
-		/// (inclusive) for the given `target` [window].
-		///
-		/// [window]: Window
-		#[context(motion_history_len => *motion_history_len as usize)]
-		pub motion_history: Vec<TimeCoords>,
-	}
-
-
-	/// The [reply] to a [`ConvertCoordinates` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`ConvertCoordinates` request]: request::ConvertCoordinates
-	#[doc(alias = "TranslateCoordinates")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct ConvertCoordinates: Reply for request::ConvertCoordinates {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// Whether the `original` [window] and the `output` [window] are on the
-		/// same [screen].
-		///
-		/// [window]: Window
-		/// [screen]: crate::visual::Screen
-		#[metabyte]
-		pub same_screen: bool,
-
-		/// If the `output_coords` are contained within a mapped child of the
-		/// `output` [window], this is that child.
-		///
-		/// If `same_screen` is `false`, this is always [`None`].
-		///
-		/// [window]: Window
-		// TODO: should always be [`None`] if `same_screen` is false
-		pub child: Option<Window>,
-
-		/// The converted coordinates which are now relative to the top-left
-		/// corner of the `output` [window].
-		///
-		// FIXME: should always be [`None`], but requires overriding the reading
-		//        behavior here
-		/// If `same_screen` is `false`, these are always zero.
-		///
-		/// [window]: Window
-		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
-		pub output_coords: Coords,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`GetFocus` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetFocus` request]: request::GetFocus
-	#[doc(alias = "GetInputFocus")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetFocus: Reply for request::GetFocus {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// What the focus will retain to if the focused [window] becomes
-		/// unviewable.
-		///
-		/// [window]: Window
-		#[metabyte]
-		pub revert_to: RevertFocus,
-
-		/// The current focus.
-		pub focus: FocusWindow,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`QueryKeyboard` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`QueryKeyboard` request]: request::QueryKeyboard
-	#[doc(alias = "QueryKeymap")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct QueryKeyboard: Reply for request::QueryKeyboard {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// A bit vector representing the currently held keys of the keyboard.
-		///
-		/// A bit is `0` if the key is not held, and `1` if it is held. Byte
-		/// `N`, starting at `0`, contains the bits for keys `8N` to `8N + 7`.
-		/// The least significant bit in the byte represents key `8N`.
-		pub keys: [u8; 32],
-	}
-}
-
-/// A property of a font.
-///
-/// The value of this property is uninterpreted by XRB.
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub struct FontProperty {
-	/// The name of the font property.
-	pub name: Atom,
-	/// The value of the property.
-	///
-	/// This is represented as four individual `u8` values because it is not
-	/// necessarily one numerical value; it must not be subject to the byte
-	/// swapping that would occur for a `u32` value.
-	pub value: [u8; 4],
-}
-
-/// Information about a particular character within a font.
-///
-/// For a nonexistent character, all of these fields are zero.
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub struct CharacterInfo {
-	/// The extent of this character's appearance beyond its left edge.
-	///
-	/// If this is negative, the character's appearance extends to the left of
-	/// its x coordinate. If this is positive, the character's appearance starts
-	/// after its x coordinate.
-	pub left_side_bearing: i16,
-	/// The extent of this character's appearance beyond its right edge.
-	///
-	/// If this is negative, the character's appearance ends before its width.
-	/// If this is positive, the character's appearance extends beyond its
-	/// width.
-	pub right_side_bearing: i16,
-
-	/// The width of this character - positive if it is read [`LeftToRight`],
-	/// negative if it is read [`RightToLeft`].
-	///
-	/// [`LeftToRight`]: DrawDirection::LeftToRight
-	/// [`RightToLeft`]: DrawDirection::RightToLeft
-	#[doc(alias = "character_width")]
-	pub width: i16,
-
-	/// The extent of this character above the baseline.
-	pub ascent: i16,
-	/// The extent of this character at or below the baseline.
-	pub descent: i16,
-
-	/// The interpretation of these character attributes depends on the X
-	/// server.
-	pub attributes: u16,
-}
-
-impl ConstantX11Size for CharacterInfo {
-	const X11_SIZE: usize = 12;
-}
-
-/// A hint as to whether most [`CharacterInfo`]s in a font have a positive or
-/// negative width.
-///
-/// A positive width means the character is [`LeftToRight`]. A negative width
-/// means the character is [`RightToLeft`].
-///
-/// [`LeftToRight`]: DrawDirection::LeftToRight
-/// [`RightToLeft`]: DrawDirection::RightToLeft
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum DrawDirection {
-	/// Most [`CharacterInfo`]s in the font have a positive width.
-	LeftToRight,
-	/// Most [`CharacterInfo`]s in the font have a negative width.
-	RightToLeft,
-}
-
-impl ConstantX11Size for DrawDirection {
-	const X11_SIZE: usize = 1;
-}
-
-derive_xrb! {
-	/// The [reply] to a [`QueryFont` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`QueryFont` request]: request::QueryFont
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct QueryFont: Reply for request::QueryFont {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// A [`CharacterInfo`] representing the minimum bounds of all fields in
-		/// each [`CharacterInfo`] in `character_infos`.
-		pub min_bounds: CharacterInfo,
-		[_; 4],
-
-		/// A [`CharacterInfo`] representing the maximum bounds of all fields in
-		/// each [`CharacterInfo`] in `character_infos`.
-		pub max_bounds: CharacterInfo,
-		[_; 4],
-
-		/// If `min_major_index` and `max_major_index` are both zero, this is
-		/// the character index of the first element in `character_infos`.
-		/// Otherwise, this is a [`u8`] value used to index characters.
-		///
-		/// If either `min_major_index` or `max_major_index` aren't zero, the
-		/// two indexes used to retrieve `character_infos` element `i` (counting
-		/// from `i = 0`) are:
-		/// ```
-		/// # let i = 0;
-		/// #
-		/// # let first_character_or_min_minor_index = 0;
-		/// # let last_character_or_max_minor_index = 1;
-		/// #
-		/// # let min_major_index = 2;
-		/// #
-		/// let major_index_range = {
-		///     last_character_or_max_minor_index
-		///     - first_character_or_min_minor_index
-		///     + 1
-		/// };
-		///
-		/// let major_index = i / major_index_range + min_major_index;
-		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
-		/// ```
-		#[doc(alias = "min_char_or_byte2")]
-		pub first_character_or_min_minor_index: u16,
-		/// If `min_major_index` and `max_major_index` are both zero, this is
-		/// the character index of the last element in `character_infos`.
-		/// Otherwise, this is a [`u8`] value used to index characters.
-		///
-		/// If either `min_major_index` or `max_major_index` aren't zero, the
-		/// two indexes used to retrieve `character_infos` element `i` (counting
-		/// from `i = 0`) are:
-		/// ```
-		/// # let i = 0;
-		/// #
-		/// # let first_character_or_min_minor_index = 0;
-		/// # let last_character_or_max_minor_index = 1;
-		/// #
-		/// # let min_major_index = 2;
-		/// #
-		/// let major_index_range = {
-		///     last_character_or_max_minor_index
-		///     - first_character_or_min_minor_index
-		///     + 1
-		/// };
-		///
-		/// let major_index = i / major_index_range + min_major_index;
-		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
-		/// ```
-		#[doc(alias = "max_char_or_byte2")]
-		pub last_character_or_max_minor_index: u16,
-
-		/// The character used when an undefined or nonexistent character is
-		/// used.
-		///
-		/// If a font uses two bytes to index its characters (such as that used
-		/// for [`Char16`]), the first of the two bytes is found in the most
-		/// significant byte of this `fallback_character`, and the second of the
-		/// two bytes if found in the least significant byte.
-		///
-		/// [`Char16`]: crate::Char16
-		#[doc(alias("default_char", "default_character", "fallback_char"))]
-		pub fallback_character: u16,
-
-		// The length of `properties`.
-		#[allow(clippy::cast_possible_truncation)]
-		let properties_len: u16 = properties => properties.len() as u16,
-
-		/// A hint as to whether most [`CharacterInfo`s] in a font have a
-		/// positive or negative width.
-		///
-		/// See [`DrawDirection`] for more information.
-		///
-		/// [`CharacterInfo`s]: CharacterInfo
-		pub draw_direction: DrawDirection,
-
-		/// The value of the major index used to retrieve the first element in
-		/// `character_infos`.
-		#[doc(alias = "min_byte1")]
-		pub min_major_index: u8,
-		/// The value of the major index used to retrieve the last element in
-		/// `character_infos`.
-		#[doc(alias = "max_byte1")]
-		pub max_major_index: u8,
-
-		/// Whether all of the [`CharacterInfo`s] in `character_infos` have
-		/// nonzero bounds.
-		///
-		/// [`CharacterInfo`s]: CharacterInfo
-		pub all_characters_exist: bool,
-
-		/// The extent of the font above the baseline, used for determining line
-		/// spacing.
-		///
-		/// Some specific characters may extend above this.
-		pub font_ascent: i16,
-		/// The extent of the font at or below the baseline, used for
-		/// determining line spacing.
-		///
-		/// Some specific characters may extend below this.
-		pub font_descent: i16,
-
-		// The length of `character_infos`.
-		#[allow(clippy::cast_possible_truncation)]
-		let character_infos_len: u32 = character_infos => character_infos.len() as u32,
-
-		/// A list of [`FontProperty`s] associated with the font.
-		///
-		/// [`FontProperty`s]: FontProperty
-		#[context(properties_len => usize::from(*properties_len))]
-		pub properties: Vec<FontProperty>,
-		/// A list of the characters associated with the font, represented by
-		/// [`CharacterInfo`s].
-		///
-		/// [`CharacterInfo`s]: CharacterInfo
-		#[doc(alias = "char_infos")]
-		#[context(character_infos_len => *character_infos_len as usize)]
-		pub character_infos: Vec<CharacterInfo>,
-	}
-
-	/// The [reply] to a [`QueryTextExtents` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`QueryTextExtents` request]: request::QueryTextExtents
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct QueryTextExtents: Reply for request::QueryTextExtents {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		/// A hint as to whether most characters in a font have a positive
-		/// `width` or a negative `width`.
-		///
-		/// See [`DrawDirection`] for more information.
-		#[metabyte]
-		pub draw_direction: DrawDirection,
-
-		/// The extent of the font above the baseline, used for determining line
-		/// spacing.
-		///
-		/// Some specific characters may extend above this.
-		pub font_ascent: i16,
-		/// The extent of the font at or below the baseline, used for
-		/// determining line spacing.
-		///
-		/// Some specific characters may extend below this.
-		pub font_descent: i16,
-
-		/// The highest individual `ascent` of any character in `text`.
-		pub overall_ascent: i16,
-		/// The lowest individual `descent` of any character in `text`.
-		pub overall_descent: i16,
-
-		/// The sum of the `width`s of each character in the `text`.
-		pub overall_width: i32,
-
-		/// If the 'left side' of each character is the sum of the `width`s of
-		/// all characters before it plus its `left_side_bearing`, this is the
-		/// leftmost left side.
-		pub overall_left: i32,
-		/// If the 'right side' of each character is the sum of the `width`s of
-		/// all characters before it, plus its `width` and `right_side_bearing`,
-		/// this is the rightmost right side.
-		pub overall_right: i32,
-		[_; ..],
-	}
-
-	/// The [reply] to a [`ListFonts` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`ListFonts` request]: request::ListFonts
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct ListFonts: Reply for request::ListFonts {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		// The length of `names`.
-		#[allow(clippy::cast_possible_truncation)]
-		let names_len: u16 = names => names.len() as u16,
-		[_; 22],
-
-		/// The names of available fonts (no more than the given
-		/// `max_names_count` will appear here, though).
-		#[context(names_len => usize::from(*names_len))]
-		pub names: Vec<LengthString8>,
-		[_; names => pad(names)],
-	}
-}
-
-/// The [reply] to a [`ListFontsWithInfo` request].
-///
-/// The [`ListFontsWithInfo` request] is unique in that it has a series of
-/// multiple replies, followed by a reply to terminate that series.
-///
-/// [reply]: Reply
-///
-/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
-pub enum ListFontsWithInfo {
-	/// Information about one of the available fonts.
-	Font(FontWithInfo),
-	/// Indicates the end of the series of replies to the
-	/// [`ListFontsWithInfo` request].
-	///
-	/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
-	Terminate(TerminateListFontsWithInfo),
-}
-
-impl Reply for ListFontsWithInfo {
-	type Request = request::ListFontsWithInfo;
-
-	fn sequence(&self) -> u16 {
-		match self {
-			Self::Font(FontWithInfo { sequence, .. })
-			| Self::Terminate(TerminateListFontsWithInfo { sequence, .. }) => *sequence,
-		}
-	}
-}
-
-impl X11Size for ListFontsWithInfo {
-	fn x11_size(&self) -> usize {
-		match self {
-			Self::Font(reply) => reply.x11_size(),
-			Self::Terminate(last) => last.x11_size(),
-		}
-	}
-}
-
-impl Readable for ListFontsWithInfo {
-	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
-	where
-		Self: Sized,
-	{
-		let name_len = buf.get_u8();
-		let sequence = buf.get_u16();
-
-		Ok(match name_len {
-			zero if zero == 0 => Self::Terminate(<_>::read_with(buf, &sequence)?),
-
-			other => Self::Font(<_>::read_with(buf, &(other, sequence))?),
-		})
-	}
-}
-
-impl Writable for ListFontsWithInfo {
-	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		match self {
-			Self::Font(reply) => reply.write_to(buf)?,
-
-			Self::Terminate(last) => last.write_to(buf)?,
-		}
-
-		Ok(())
-	}
-}
-
-/// A [reply] to a [`ListFontsWithInfo` request] that provides information about
-/// one of the available fonts.
-///
-/// A `FontWithInfo` [reply] is sent for every available font. A
-/// [`TerminateListFontsWithInfo` reply] terminates the series.
-///
-/// [reply]: Reply
-///
-/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
-/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
-#[derive(Derivative, Debug)]
-#[derivative(Hash, PartialEq, Eq)]
-pub struct FontWithInfo {
-	/// The sequence number identifying the [request] that generated this
-	/// [reply].
-	///
-	/// See [`Reply::sequence`] for more information.
-	///
-	/// [request]: crate::message::Request
-	/// [reply]: Reply
-	///
-	/// [`Reply::sequence`]: Reply::sequence
-	#[derivative(Hash = "ignore", PartialEq = "ignore")]
-	pub sequence: u16,
-
-	/// A [`CharacterInfo`] representing the minimum bounds of all fields in
-	/// each [`CharacterInfo`] in `character_infos`.
-	pub min_bounds: CharacterInfo,
-	/// A [`CharacterInfo`] representing the maximum bounds of all fields in
-	/// each [`CharacterInfo`] in `character_infos`.
-	pub max_bounds: CharacterInfo,
-
-	/// If `min_major_index` and `max_major_index` are both zero, this is the
-	/// character index of the first element in `character_infos`. Otherwise,
-	/// this is a [`u8`] value used to index characters.
-	///
-	/// If either `min_major_index` or `max_major_index` aren't zero, the
-	/// two indexes used to retrieve `character_infos` element `i` (counting
-	/// from `i = 0`) are:
-	/// ```
-	/// # let i = 0;
-	/// #
-	/// # let first_character_or_min_minor_index = 0;
-	/// # let last_character_or_max_minor_index = 1;
-	/// #
-	/// # let min_major_index = 2;
-	/// #
-	/// let major_index_range = {
-	///     last_character_or_max_minor_index
-	///     - first_character_or_min_minor_index
-	///     + 1
-	/// };
-	///
-	/// let major_index = i / major_index_range + min_major_index;
-	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
-	/// ```
-	#[doc(alias = "min_char_or_byte2")]
-	pub first_character_or_min_minor_index: u16,
-	/// If `min_major_index` and `max_major_index` are both zero, this is
-	/// the character index of the last element in `character_infos`.
-	/// Otherwise, this is a [`u8`] value used to index characters.
-	///
-	/// If either `min_major_index` or `max_major_index` aren't zero, the
-	/// two indexes used to retrieve `character_infos` element `i` (counting
-	/// from `i = 0`) are:
-	/// ```
-	/// # let i = 0;
-	/// #
-	/// # let first_character_or_min_minor_index = 0;
-	/// # let last_character_or_max_minor_index = 1;
-	/// #
-	/// # let min_major_index = 2;
-	/// #
-	/// let major_index_range = {
-	///     last_character_or_max_minor_index
-	///     - first_character_or_min_minor_index
-	///     + 1
-	/// };
-	///
-	/// let major_index = i / major_index_range + min_major_index;
-	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
-	/// ```
-	#[doc(alias = "max_char_or_byte2")]
-	pub last_character_or_max_minor_index: u16,
-
-	/// The character used when an undefined or nonexistent character is
-	/// used.
-	///
-	/// If a font uses two bytes to index its characters (such as that used
-	/// for [`Char16`]), the first of the two bytes is found in the most
-	/// significant byte of this `fallback_character`, and the second of the
-	/// two bytes if found in the least significant byte.
-	///
-	/// [`Char16`]: crate::Char16
-	#[doc(alias = "default_char")]
-	pub fallback_character: u16,
-
-	/// A hint as to whether most [`CharacterInfo`s] in a font have a
-	/// positive or negative width.
-	///
-	/// See [`DrawDirection`] for more information.
-	///
-	/// [`CharacterInfo`s]: CharacterInfo
-	pub draw_direction: DrawDirection,
-
-	/// The value of the major index used to retrieve the first character in the
-	/// font.
-	#[doc(alias = "min_byte1")]
-	pub min_major_index: u8,
-	/// The value of the major index used to retrieve the last character in the
-	/// font.
-	#[doc(alias = "max_byte1")]
-	pub max_major_index: u8,
-
-	/// Whether all of the characters in the font have nonzero bounds.
-	pub all_chars_exist: bool,
-
-	/// The extent of the font above the baseline, used for determining line
-	/// spacing.
-	///
-	/// Some specific characters may extend above this.
-	pub font_ascent: i16,
-	/// The extent of the font at or below the baseline, used for
-	/// determining line spacing.
-	///
-	/// Some specific characters may extend below this.
-	pub font_descent: i16,
-
-	/// A hint as to how many more [`FontWithInfo` replies] there will be.
-	///
-	/// Note that this is only a hint: there may be more or less replies than
-	/// this number. A `replies_hint` of zero does not guarantee that there will
-	/// be no more [`FontWithInfo` replies]: the only way to know that is to
-	/// receive a [`TerminateListFontsWithInfo` reply].
-	///
-	/// [`FontWithInfo` replies]: FontWithInfo
-	/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
-	pub replies_hint: u32,
-
-	/// A list of [`FontProperty`s] associated with the font.
-	///
-	/// [`FontProperty`s]: FontProperty
-	pub properties: Vec<FontProperty>,
-
-	/// The name of this font.
-	pub name: String8,
-}
-
-impl X11Size for FontWithInfo {
-	fn x11_size(&self) -> usize {
-		const CONSTANT_SIZES: usize = u8::X11_SIZE // `1`
-			+ u8::X11_SIZE // length of `name`
-			+ u16::X11_SIZE // `sequence`
-			+ u32::X11_SIZE // length
-			+ CharacterInfo::X11_SIZE // `min_bounds`
-			+ 4 // 4 unused bytes
-			+ CharacterInfo::X11_SIZE // `max_bounds`
-			+ 4 // 4 unused bytes
-			+ u16::X11_SIZE // `first_character_or_min_minor_index`
-			+ u16::X11_SIZE // `last_character_or_max_minor_index`
-			+ u16::X11_SIZE // `fallback_character`
-			+ u16::X11_SIZE // length of `properties`
-			+ DrawDirection::X11_SIZE // `draw_direction`
-			+ u8::X11_SIZE // `min_major_index`
-			+ u8::X11_SIZE // `max_major_index`
-			+ bool::X11_SIZE // `all_chars_exist`
-			+ i16::X11_SIZE // `font_ascent`
-			+ i16::X11_SIZE // `font_descent`
-			+ u32::X11_SIZE; // `replies_hint`
-
-		CONSTANT_SIZES + self.properties.x11_size() + self.name.x11_size() + pad(&self.name)
-	}
-}
-
-impl ReadableWithContext for FontWithInfo {
-	type Context = (u8, u16);
-
-	fn read_with(buf: &mut impl Buf, (name_len, sequence): &(u8, u16)) -> ReadResult<Self> {
-		let name_len = usize::from(*name_len);
-
-		// We skip the first 4 bytes because:
-		// - the first, `1`, was required to know this is a reply
-		// - the second was required to know the `name_len`
-		// - the third and fourth - the sequence - were required to know that this is a
-		//   `ListFontsWithInfo` reply
-
-		// Read the length - take away the 8 bytes we've already read.
-		let length = ((buf.get_u32() as usize) * 4) + (32 - 8);
-		// Limit `buf` by the read `length`.
-		let buf = &mut buf.take(length);
-
-		let min_bounds = CharacterInfo::read_from(buf)?;
-		buf.advance(4); // 4 unused bytes
-
-		let max_bounds = CharacterInfo::read_from(buf)?;
-		buf.advance(4); // 4 unused bytes
-
-		let first_character_or_min_minor_index = u16::read_from(buf)?;
-		let last_character_or_max_minor_index = u16::read_from(buf)?;
-
-		let fallback_character = u16::read_from(buf)?;
-
-		let properties_len = usize::from(u16::read_from(buf)?);
-
-		let draw_direction = DrawDirection::read_from(buf)?;
-
-		let min_major_index = u8::read_from(buf)?;
-		let max_major_index = u8::read_from(buf)?;
-
-		let all_chars_exist = bool::read_from(buf)?;
-
-		let font_ascent = i16::read_from(buf)?;
-		let font_descent = i16::read_from(buf)?;
-
-		let replies_hint = u32::read_from(buf)?;
-
-		let properties = <Vec<FontProperty>>::read_with(buf, &properties_len)?;
-
-		let name = String8::read_with(buf, &name_len)?;
-		buf.advance(pad(&name));
-
-		Ok(Self {
-			sequence: *sequence,
-
-			min_bounds,
-			max_bounds,
-
-			first_character_or_min_minor_index,
-			last_character_or_max_minor_index,
-
-			fallback_character,
-
-			draw_direction,
-
-			min_major_index,
-			max_major_index,
-
-			all_chars_exist,
-
-			font_ascent,
-			font_descent,
-
-			replies_hint,
-
-			properties,
-
-			name,
-		})
-	}
-}
-
-impl Writable for FontWithInfo {
-	#[allow(clippy::cast_possible_truncation)]
-	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		buf.put_u8(1);
-		buf.put_u8(self.name.len() as u8);
-		self.sequence.write_to(buf)?;
-
-		buf.put_u32(((self.x11_size() - 32) / 4) as u32);
-
-		self.min_bounds.write_to(buf)?;
-		// 4 unused bytes.
-		buf.put_bytes(0, 4);
-
-		self.max_bounds.write_to(buf)?;
-		// 4 unused bytes.
-		buf.put_bytes(0, 4);
-
-		self.first_character_or_min_minor_index.write_to(buf)?;
-		self.last_character_or_max_minor_index.write_to(buf)?;
-
-		self.fallback_character.write_to(buf)?;
-
-		buf.put_u16(self.properties.len() as u16);
-
-		self.draw_direction.write_to(buf)?;
-
-		self.min_major_index.write_to(buf)?;
-		self.max_major_index.write_to(buf)?;
-
-		self.all_chars_exist.write_to(buf)?;
-
-		self.font_ascent.write_to(buf)?;
-		self.font_descent.write_to(buf)?;
-
-		self.replies_hint.write_to(buf)?;
-
-		self.properties.write_to(buf)?;
-
-		self.name.write_to(buf)?;
-		// Padding bytes for `name`.
-		buf.put_bytes(0, pad(&self.name));
-
-		Ok(())
-	}
-}
-
-/// A [reply] to a [`ListFontsWithInfo` request] that represents the final
-/// [reply] sent for that [request].
-///
-/// [reply]: Reply
-/// [request]: crate::message::Request
-///
-/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
-#[derive(Derivative, Debug)]
-#[derivative(Hash, PartialEq, Eq)]
-pub struct TerminateListFontsWithInfo {
-	/// The sequence number identifying the [request] that generated this
-	/// [reply].
-	///
-	/// See [`Reply::sequence`] for more information.
-	///
-	/// [request]: crate::message::Request
-	/// [reply]: Reply
-	///
-	/// [`Reply::sequence`]: Reply::sequence
-	#[derivative(Hash = "ignore", PartialEq = "ignore")]
-	pub sequence: u16,
-}
-
-impl ConstantX11Size for TerminateListFontsWithInfo {
-	const X11_SIZE: usize = 60;
-}
-
-impl X11Size for TerminateListFontsWithInfo {
-	fn x11_size(&self) -> usize {
-		Self::X11_SIZE
-	}
-}
-
-impl Writable for TerminateListFontsWithInfo {
-	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		// Indicates that this is a reply.
-		buf.put_u8(1);
-		// Indicates that this is the last `ListFontsWithInfo` reply.
-		buf.put_u8(0);
-
-		// The sequence number.
-		buf.put_u16(self.sequence);
-
-		// Length - the number of 4-byte units after the 32nd byte in this
-		// reply.
-		buf.put_u32(7);
-
-		// 52 unused bytes.
-		buf.put_bytes(0, 52);
-
-		Ok(())
-	}
-}
-
-impl ReadableWithContext for TerminateListFontsWithInfo {
-	type Context = u16;
-
-	fn read_with(buf: &mut impl Buf, sequence: &u16) -> ReadResult<Self> {
-		// We skip the first 4 bytes because:
-		// - the first, `1`, was required to know this is a reply
-		// - the second was required to know this is the last reply for
-		//   ListFontsWithInfo
-		// - the third and fourth - the sequence - were required to know that this is a
-		//   `ListFontsWithInfo` reply
-
-		// Then we skip the length because we know what it is meant to be... should
-		// probably verify that...
-		buf.advance(4);
-
-		// And then skip the 52 remaining unused bytes.
-		buf.advance(52);
-
-		Ok(Self {
-			sequence: *sequence,
-		})
-	}
-}
-
-derive_xrb! {
-	/// The [reply] to a [`GetFontSearchDirectories` request].
-	///
-	/// [reply]: Reply
-	///
-	/// [`GetFontSearchDirectories` request]: request::GetFontSearchDirectories
-	#[doc(alias = "GetFontPath")]
-	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
-	#[derivative(Hash, PartialEq, Eq)]
-	pub struct GetFontSearchDirectories: Reply for request::GetFontSearchDirectories {
-		/// The sequence number identifying the [request] that generated this
-		/// [reply].
-		///
-		/// See [`Reply::sequence`] for more information.
-		///
-		/// [request]: crate::message::Request
-		/// [reply]: Reply
-		///
-		/// [`Reply::sequence`]: Reply::sequence
-		#[sequence]
-		#[derivative(Hash = "ignore", PartialEq = "ignore")]
-		pub sequence: u16,
-
-		// The length of `directories`.
-		#[allow(clippy::cast_possible_truncation)]
-		let directories_len: u16 = directories => directories.len() as u16,
-		[_; 22],
-
-		/// The directories that are searched in the order listed.
-		#[doc(alias = "path")]
-		#[context(directories_len => usize::from(*directories_len))]
-		pub directories: Vec<LengthString8>,
-		[_; directories => pad(directories)],
-	}
-}
+// TODO: should these modules be private and re-exported, or public?
+//       or public and also re-exported?
+
+pub use color::*;
+pub use font::*;
+pub use graphics::*;
+pub use input::*;
+pub use meta::*;
+pub use miscellaneous::*;
+pub use window::*;
+
+pub mod color;
+pub mod font;
+pub mod graphics;
+pub mod input;
+pub mod meta;
+pub mod miscellaneous;
+pub mod window;
diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
new file mode 100644
index 00000000..56bb008b
--- /dev/null
+++ b/src/x11/reply/color.rs
@@ -0,0 +1,15 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to colors].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to colors]: crate::x11::request::color
diff --git a/src/x11/reply/font.rs b/src/x11/reply/font.rs
new file mode 100644
index 00000000..473888e4
--- /dev/null
+++ b/src/x11/reply/font.rs
@@ -0,0 +1,832 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to fonts].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to fonts]: request::font
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk::{
+	pad,
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadResult,
+	Readable,
+	ReadableWithContext,
+	Writable,
+	WriteResult,
+	X11Size,
+};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{message::Reply, x11::request, Atom, LengthString8, String8};
+
+/// A property of a font.
+///
+/// The value of this property is uninterpreted by XRB.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct FontProperty {
+	/// The name of the font property.
+	pub name: Atom,
+	/// The value of the property.
+	///
+	/// This is represented as four individual `u8` values because it is not
+	/// necessarily one numerical value; it must not be subject to the byte
+	/// swapping that would occur for a `u32` value.
+	pub value: [u8; 4],
+}
+
+/// Information about a particular character within a font.
+///
+/// For a nonexistent character, all of these fields are zero.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct CharacterInfo {
+	/// The extent of this character's appearance beyond its left edge.
+	///
+	/// If this is negative, the character's appearance extends to the left of
+	/// its x coordinate. If this is positive, the character's appearance starts
+	/// after its x coordinate.
+	pub left_side_bearing: i16,
+	/// The extent of this character's appearance beyond its right edge.
+	///
+	/// If this is negative, the character's appearance ends before its width.
+	/// If this is positive, the character's appearance extends beyond its
+	/// width.
+	pub right_side_bearing: i16,
+
+	/// The width of this character - positive if it is read [`LeftToRight`],
+	/// negative if it is read [`RightToLeft`].
+	///
+	/// [`LeftToRight`]: DrawDirection::LeftToRight
+	/// [`RightToLeft`]: DrawDirection::RightToLeft
+	#[doc(alias = "character_width")]
+	pub width: i16,
+
+	/// The extent of this character above the baseline.
+	pub ascent: i16,
+	/// The extent of this character at or below the baseline.
+	pub descent: i16,
+
+	/// The interpretation of these character attributes depends on the X
+	/// server.
+	pub attributes: u16,
+}
+
+impl ConstantX11Size for CharacterInfo {
+	const X11_SIZE: usize = 12;
+}
+
+/// A hint as to whether most [`CharacterInfo`]s in a font have a positive or
+/// negative width.
+///
+/// A positive width means the character is [`LeftToRight`]. A negative width
+/// means the character is [`RightToLeft`].
+///
+/// [`LeftToRight`]: DrawDirection::LeftToRight
+/// [`RightToLeft`]: DrawDirection::RightToLeft
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum DrawDirection {
+	/// Most [`CharacterInfo`]s in the font have a positive width.
+	LeftToRight,
+	/// Most [`CharacterInfo`]s in the font have a negative width.
+	RightToLeft,
+}
+
+impl ConstantX11Size for DrawDirection {
+	const X11_SIZE: usize = 1;
+}
+
+derive_xrb! {
+	/// The [reply] to a [`QueryFont` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`QueryFont` request]: request::QueryFont
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryFont: Reply for request::QueryFont {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// A [`CharacterInfo`] representing the minimum bounds of all fields in
+		/// each [`CharacterInfo`] in `character_infos`.
+		pub min_bounds: CharacterInfo,
+		[_; 4],
+
+		/// A [`CharacterInfo`] representing the maximum bounds of all fields in
+		/// each [`CharacterInfo`] in `character_infos`.
+		pub max_bounds: CharacterInfo,
+		[_; 4],
+
+		/// If `min_major_index` and `max_major_index` are both zero, this is
+		/// the character index of the first element in `character_infos`.
+		/// Otherwise, this is a [`u8`] value used to index characters.
+		///
+		/// If either `min_major_index` or `max_major_index` aren't zero, the
+		/// two indexes used to retrieve `character_infos` element `i` (counting
+		/// from `i = 0`) are:
+		/// ```
+		/// # let i = 0;
+		/// #
+		/// # let first_character_or_min_minor_index = 0;
+		/// # let last_character_or_max_minor_index = 1;
+		/// #
+		/// # let min_major_index = 2;
+		/// #
+		/// let major_index_range = {
+		///     last_character_or_max_minor_index
+		///     - first_character_or_min_minor_index
+		///     + 1
+		/// };
+		///
+		/// let major_index = i / major_index_range + min_major_index;
+		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+		/// ```
+		#[doc(alias = "min_char_or_byte2")]
+		pub first_character_or_min_minor_index: u16,
+		/// If `min_major_index` and `max_major_index` are both zero, this is
+		/// the character index of the last element in `character_infos`.
+		/// Otherwise, this is a [`u8`] value used to index characters.
+		///
+		/// If either `min_major_index` or `max_major_index` aren't zero, the
+		/// two indexes used to retrieve `character_infos` element `i` (counting
+		/// from `i = 0`) are:
+		/// ```
+		/// # let i = 0;
+		/// #
+		/// # let first_character_or_min_minor_index = 0;
+		/// # let last_character_or_max_minor_index = 1;
+		/// #
+		/// # let min_major_index = 2;
+		/// #
+		/// let major_index_range = {
+		///     last_character_or_max_minor_index
+		///     - first_character_or_min_minor_index
+		///     + 1
+		/// };
+		///
+		/// let major_index = i / major_index_range + min_major_index;
+		/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+		/// ```
+		#[doc(alias = "max_char_or_byte2")]
+		pub last_character_or_max_minor_index: u16,
+
+		/// The character used when an undefined or nonexistent character is
+		/// used.
+		///
+		/// If a font uses two bytes to index its characters (such as that used
+		/// for [`Char16`]), the first of the two bytes is found in the most
+		/// significant byte of this `fallback_character`, and the second of the
+		/// two bytes if found in the least significant byte.
+		///
+		/// [`Char16`]: crate::Char16
+		#[doc(alias("default_char", "default_character", "fallback_char"))]
+		pub fallback_character: u16,
+
+		// The length of `properties`.
+		#[allow(clippy::cast_possible_truncation)]
+		let properties_len: u16 = properties => properties.len() as u16,
+
+		/// A hint as to whether most [`CharacterInfo`s] in a font have a
+		/// positive or negative width.
+		///
+		/// See [`DrawDirection`] for more information.
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
+		pub draw_direction: DrawDirection,
+
+		/// The value of the major index used to retrieve the first element in
+		/// `character_infos`.
+		#[doc(alias = "min_byte1")]
+		pub min_major_index: u8,
+		/// The value of the major index used to retrieve the last element in
+		/// `character_infos`.
+		#[doc(alias = "max_byte1")]
+		pub max_major_index: u8,
+
+		/// Whether all of the [`CharacterInfo`s] in `character_infos` have
+		/// nonzero bounds.
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
+		pub all_characters_exist: bool,
+
+		/// The extent of the font above the baseline, used for determining line
+		/// spacing.
+		///
+		/// Some specific characters may extend above this.
+		pub font_ascent: i16,
+		/// The extent of the font at or below the baseline, used for
+		/// determining line spacing.
+		///
+		/// Some specific characters may extend below this.
+		pub font_descent: i16,
+
+		// The length of `character_infos`.
+		#[allow(clippy::cast_possible_truncation)]
+		let character_infos_len: u32 = character_infos => character_infos.len() as u32,
+
+		/// A list of [`FontProperty`s] associated with the font.
+		///
+		/// [`FontProperty`s]: FontProperty
+		#[context(properties_len => usize::from(*properties_len))]
+		pub properties: Vec<FontProperty>,
+		/// A list of the characters associated with the font, represented by
+		/// [`CharacterInfo`s].
+		///
+		/// [`CharacterInfo`s]: CharacterInfo
+		#[doc(alias = "char_infos")]
+		#[context(character_infos_len => *character_infos_len as usize)]
+		pub character_infos: Vec<CharacterInfo>,
+	}
+
+	/// The [reply] to a [`QueryTextExtents` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`QueryTextExtents` request]: request::QueryTextExtents
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryTextExtents: Reply for request::QueryTextExtents {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// A hint as to whether most characters in a font have a positive
+		/// `width` or a negative `width`.
+		///
+		/// See [`DrawDirection`] for more information.
+		#[metabyte]
+		pub draw_direction: DrawDirection,
+
+		/// The extent of the font above the baseline, used for determining line
+		/// spacing.
+		///
+		/// Some specific characters may extend above this.
+		pub font_ascent: i16,
+		/// The extent of the font at or below the baseline, used for
+		/// determining line spacing.
+		///
+		/// Some specific characters may extend below this.
+		pub font_descent: i16,
+
+		/// The highest individual `ascent` of any character in `text`.
+		pub overall_ascent: i16,
+		/// The lowest individual `descent` of any character in `text`.
+		pub overall_descent: i16,
+
+		/// The sum of the `width`s of each character in the `text`.
+		pub overall_width: i32,
+
+		/// If the 'left side' of each character is the sum of the `width`s of
+		/// all characters before it plus its `left_side_bearing`, this is the
+		/// leftmost left side.
+		pub overall_left: i32,
+		/// If the 'right side' of each character is the sum of the `width`s of
+		/// all characters before it, plus its `width` and `right_side_bearing`,
+		/// this is the rightmost right side.
+		pub overall_right: i32,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`ListFonts` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`ListFonts` request]: request::ListFonts
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListFonts: Reply for request::ListFonts {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `names`.
+		#[allow(clippy::cast_possible_truncation)]
+		let names_len: u16 = names => names.len() as u16,
+		[_; 22],
+
+		/// The names of available fonts (no more than the given
+		/// `max_names_count` will appear here, though).
+		#[context(names_len => usize::from(*names_len))]
+		pub names: Vec<LengthString8>,
+		[_; names => pad(names)],
+	}
+}
+
+/// The [reply] to a [`ListFontsWithInfo` request].
+///
+/// The [`ListFontsWithInfo` request] is unique in that it has a series of
+/// multiple replies, followed by a reply to terminate that series.
+///
+/// [reply]: Reply
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+pub enum ListFontsWithInfo {
+	/// Information about one of the available fonts.
+	Font(FontWithInfo),
+	/// Indicates the end of the series of replies to the
+	/// [`ListFontsWithInfo` request].
+	///
+	/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+	Terminate(TerminateListFontsWithInfo),
+}
+
+impl Reply for ListFontsWithInfo {
+	type Request = request::ListFontsWithInfo;
+
+	fn sequence(&self) -> u16 {
+		match self {
+			Self::Font(FontWithInfo { sequence, .. })
+			| Self::Terminate(TerminateListFontsWithInfo { sequence, .. }) => *sequence,
+		}
+	}
+}
+
+impl X11Size for ListFontsWithInfo {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::Font(reply) => reply.x11_size(),
+			Self::Terminate(last) => last.x11_size(),
+		}
+	}
+}
+
+impl Readable for ListFontsWithInfo {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		let name_len = buf.get_u8();
+		let sequence = buf.get_u16();
+
+		Ok(match name_len {
+			zero if zero == 0 => Self::Terminate(<_>::read_with(buf, &sequence)?),
+
+			other => Self::Font(<_>::read_with(buf, &(other, sequence))?),
+		})
+	}
+}
+
+impl Writable for ListFontsWithInfo {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Font(reply) => reply.write_to(buf)?,
+
+			Self::Terminate(last) => last.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+/// A [reply] to a [`ListFontsWithInfo` request] that provides information about
+/// one of the available fonts.
+///
+/// A `FontWithInfo` [reply] is sent for every available font. A
+/// [`TerminateListFontsWithInfo` reply] terminates the series.
+///
+/// [reply]: Reply
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct FontWithInfo {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+
+	/// A [`CharacterInfo`] representing the minimum bounds of all fields in
+	/// each [`CharacterInfo`] in `character_infos`.
+	pub min_bounds: CharacterInfo,
+	/// A [`CharacterInfo`] representing the maximum bounds of all fields in
+	/// each [`CharacterInfo`] in `character_infos`.
+	pub max_bounds: CharacterInfo,
+
+	/// If `min_major_index` and `max_major_index` are both zero, this is the
+	/// character index of the first element in `character_infos`. Otherwise,
+	/// this is a [`u8`] value used to index characters.
+	///
+	/// If either `min_major_index` or `max_major_index` aren't zero, the
+	/// two indexes used to retrieve `character_infos` element `i` (counting
+	/// from `i = 0`) are:
+	/// ```
+	/// # let i = 0;
+	/// #
+	/// # let first_character_or_min_minor_index = 0;
+	/// # let last_character_or_max_minor_index = 1;
+	/// #
+	/// # let min_major_index = 2;
+	/// #
+	/// let major_index_range = {
+	///     last_character_or_max_minor_index
+	///     - first_character_or_min_minor_index
+	///     + 1
+	/// };
+	///
+	/// let major_index = i / major_index_range + min_major_index;
+	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+	/// ```
+	#[doc(alias = "min_char_or_byte2")]
+	pub first_character_or_min_minor_index: u16,
+	/// If `min_major_index` and `max_major_index` are both zero, this is
+	/// the character index of the last element in `character_infos`.
+	/// Otherwise, this is a [`u8`] value used to index characters.
+	///
+	/// If either `min_major_index` or `max_major_index` aren't zero, the
+	/// two indexes used to retrieve `character_infos` element `i` (counting
+	/// from `i = 0`) are:
+	/// ```
+	/// # let i = 0;
+	/// #
+	/// # let first_character_or_min_minor_index = 0;
+	/// # let last_character_or_max_minor_index = 1;
+	/// #
+	/// # let min_major_index = 2;
+	/// #
+	/// let major_index_range = {
+	///     last_character_or_max_minor_index
+	///     - first_character_or_min_minor_index
+	///     + 1
+	/// };
+	///
+	/// let major_index = i / major_index_range + min_major_index;
+	/// let minor_index = i % major_index_range + first_character_or_min_minor_index;
+	/// ```
+	#[doc(alias = "max_char_or_byte2")]
+	pub last_character_or_max_minor_index: u16,
+
+	/// The character used when an undefined or nonexistent character is
+	/// used.
+	///
+	/// If a font uses two bytes to index its characters (such as that used
+	/// for [`Char16`]), the first of the two bytes is found in the most
+	/// significant byte of this `fallback_character`, and the second of the
+	/// two bytes if found in the least significant byte.
+	///
+	/// [`Char16`]: crate::Char16
+	#[doc(alias = "default_char")]
+	pub fallback_character: u16,
+
+	/// A hint as to whether most [`CharacterInfo`s] in a font have a
+	/// positive or negative width.
+	///
+	/// See [`DrawDirection`] for more information.
+	///
+	/// [`CharacterInfo`s]: CharacterInfo
+	pub draw_direction: DrawDirection,
+
+	/// The value of the major index used to retrieve the first character in the
+	/// font.
+	#[doc(alias = "min_byte1")]
+	pub min_major_index: u8,
+	/// The value of the major index used to retrieve the last character in the
+	/// font.
+	#[doc(alias = "max_byte1")]
+	pub max_major_index: u8,
+
+	/// Whether all of the characters in the font have nonzero bounds.
+	pub all_chars_exist: bool,
+
+	/// The extent of the font above the baseline, used for determining line
+	/// spacing.
+	///
+	/// Some specific characters may extend above this.
+	pub font_ascent: i16,
+	/// The extent of the font at or below the baseline, used for
+	/// determining line spacing.
+	///
+	/// Some specific characters may extend below this.
+	pub font_descent: i16,
+
+	/// A hint as to how many more [`FontWithInfo` replies] there will be.
+	///
+	/// Note that this is only a hint: there may be more or less replies than
+	/// this number. A `replies_hint` of zero does not guarantee that there will
+	/// be no more [`FontWithInfo` replies]: the only way to know that is to
+	/// receive a [`TerminateListFontsWithInfo` reply].
+	///
+	/// [`FontWithInfo` replies]: FontWithInfo
+	/// [`TerminateListFontsWithInfo` reply]: TerminateListFontsWithInfo
+	pub replies_hint: u32,
+
+	/// A list of [`FontProperty`s] associated with the font.
+	///
+	/// [`FontProperty`s]: FontProperty
+	pub properties: Vec<FontProperty>,
+
+	/// The name of this font.
+	pub name: String8,
+}
+
+impl X11Size for FontWithInfo {
+	fn x11_size(&self) -> usize {
+		const CONSTANT_SIZES: usize = u8::X11_SIZE // `1`
+			+ u8::X11_SIZE // length of `name`
+			+ u16::X11_SIZE // `sequence`
+			+ u32::X11_SIZE // length
+			+ CharacterInfo::X11_SIZE // `min_bounds`
+			+ 4 // 4 unused bytes
+			+ CharacterInfo::X11_SIZE // `max_bounds`
+			+ 4 // 4 unused bytes
+			+ u16::X11_SIZE // `first_character_or_min_minor_index`
+			+ u16::X11_SIZE // `last_character_or_max_minor_index`
+			+ u16::X11_SIZE // `fallback_character`
+			+ u16::X11_SIZE // length of `properties`
+			+ DrawDirection::X11_SIZE // `draw_direction`
+			+ u8::X11_SIZE // `min_major_index`
+			+ u8::X11_SIZE // `max_major_index`
+			+ bool::X11_SIZE // `all_chars_exist`
+			+ i16::X11_SIZE // `font_ascent`
+			+ i16::X11_SIZE // `font_descent`
+			+ u32::X11_SIZE; // `replies_hint`
+
+		CONSTANT_SIZES + self.properties.x11_size() + self.name.x11_size() + pad(&self.name)
+	}
+}
+
+impl ReadableWithContext for FontWithInfo {
+	type Context = (u8, u16);
+
+	fn read_with(buf: &mut impl Buf, (name_len, sequence): &(u8, u16)) -> ReadResult<Self> {
+		let name_len = usize::from(*name_len);
+
+		// We skip the first 4 bytes because:
+		// - the first, `1`, was required to know this is a reply
+		// - the second was required to know the `name_len`
+		// - the third and fourth - the sequence - were required to know that this is a
+		//   `ListFontsWithInfo` reply
+
+		// Read the length - take away the 8 bytes we've already read.
+		let length = ((buf.get_u32() as usize) * 4) + (32 - 8);
+		// Limit `buf` by the read `length`.
+		let buf = &mut buf.take(length);
+
+		let min_bounds = CharacterInfo::read_from(buf)?;
+		buf.advance(4); // 4 unused bytes
+
+		let max_bounds = CharacterInfo::read_from(buf)?;
+		buf.advance(4); // 4 unused bytes
+
+		let first_character_or_min_minor_index = u16::read_from(buf)?;
+		let last_character_or_max_minor_index = u16::read_from(buf)?;
+
+		let fallback_character = u16::read_from(buf)?;
+
+		let properties_len = usize::from(u16::read_from(buf)?);
+
+		let draw_direction = DrawDirection::read_from(buf)?;
+
+		let min_major_index = u8::read_from(buf)?;
+		let max_major_index = u8::read_from(buf)?;
+
+		let all_chars_exist = bool::read_from(buf)?;
+
+		let font_ascent = i16::read_from(buf)?;
+		let font_descent = i16::read_from(buf)?;
+
+		let replies_hint = u32::read_from(buf)?;
+
+		let properties = <Vec<FontProperty>>::read_with(buf, &properties_len)?;
+
+		let name = String8::read_with(buf, &name_len)?;
+		buf.advance(pad(&name));
+
+		Ok(Self {
+			sequence: *sequence,
+
+			min_bounds,
+			max_bounds,
+
+			first_character_or_min_minor_index,
+			last_character_or_max_minor_index,
+
+			fallback_character,
+
+			draw_direction,
+
+			min_major_index,
+			max_major_index,
+
+			all_chars_exist,
+
+			font_ascent,
+			font_descent,
+
+			replies_hint,
+
+			properties,
+
+			name,
+		})
+	}
+}
+
+impl Writable for FontWithInfo {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		buf.put_u8(1);
+		buf.put_u8(self.name.len() as u8);
+		self.sequence.write_to(buf)?;
+
+		buf.put_u32(((self.x11_size() - 32) / 4) as u32);
+
+		self.min_bounds.write_to(buf)?;
+		// 4 unused bytes.
+		buf.put_bytes(0, 4);
+
+		self.max_bounds.write_to(buf)?;
+		// 4 unused bytes.
+		buf.put_bytes(0, 4);
+
+		self.first_character_or_min_minor_index.write_to(buf)?;
+		self.last_character_or_max_minor_index.write_to(buf)?;
+
+		self.fallback_character.write_to(buf)?;
+
+		buf.put_u16(self.properties.len() as u16);
+
+		self.draw_direction.write_to(buf)?;
+
+		self.min_major_index.write_to(buf)?;
+		self.max_major_index.write_to(buf)?;
+
+		self.all_chars_exist.write_to(buf)?;
+
+		self.font_ascent.write_to(buf)?;
+		self.font_descent.write_to(buf)?;
+
+		self.replies_hint.write_to(buf)?;
+
+		self.properties.write_to(buf)?;
+
+		self.name.write_to(buf)?;
+		// Padding bytes for `name`.
+		buf.put_bytes(0, pad(&self.name));
+
+		Ok(())
+	}
+}
+
+/// A [reply] to a [`ListFontsWithInfo` request] that represents the final
+/// [reply] sent for that [request].
+///
+/// [reply]: Reply
+/// [request]: crate::message::Request
+///
+/// [`ListFontsWithInfo` request]: request::ListFontsWithInfo
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct TerminateListFontsWithInfo {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+}
+
+impl ConstantX11Size for TerminateListFontsWithInfo {
+	const X11_SIZE: usize = 60;
+}
+
+impl X11Size for TerminateListFontsWithInfo {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Writable for TerminateListFontsWithInfo {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		// Indicates that this is a reply.
+		buf.put_u8(1);
+		// Indicates that this is the last `ListFontsWithInfo` reply.
+		buf.put_u8(0);
+
+		// The sequence number.
+		buf.put_u16(self.sequence);
+
+		// Length - the number of 4-byte units after the 32nd byte in this
+		// reply.
+		buf.put_u32(7);
+
+		// 52 unused bytes.
+		buf.put_bytes(0, 52);
+
+		Ok(())
+	}
+}
+
+impl ReadableWithContext for TerminateListFontsWithInfo {
+	type Context = u16;
+
+	fn read_with(buf: &mut impl Buf, sequence: &u16) -> ReadResult<Self> {
+		// We skip the first 4 bytes because:
+		// - the first, `1`, was required to know this is a reply
+		// - the second was required to know this is the last reply for
+		//   ListFontsWithInfo
+		// - the third and fourth - the sequence - were required to know that this is a
+		//   `ListFontsWithInfo` reply
+
+		// Then we skip the length because we know what it is meant to be... should
+		// probably verify that...
+		buf.advance(4);
+
+		// And then skip the 52 remaining unused bytes.
+		buf.advance(52);
+
+		Ok(Self {
+			sequence: *sequence,
+		})
+	}
+}
+
+derive_xrb! {
+	/// The [reply] to a [`GetFontSearchDirectories` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetFontSearchDirectories` request]: request::GetFontSearchDirectories
+	#[doc(alias = "GetFontPath")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetFontSearchDirectories: Reply for request::GetFontSearchDirectories {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `directories`.
+		#[allow(clippy::cast_possible_truncation)]
+		let directories_len: u16 = directories => directories.len() as u16,
+		[_; 22],
+
+		/// The directories that are searched in the order listed.
+		#[doc(alias = "path")]
+		#[context(directories_len => usize::from(*directories_len))]
+		pub directories: Vec<LengthString8>,
+		[_; directories => pad(directories)],
+	}
+}
diff --git a/src/x11/reply/graphics.rs b/src/x11/reply/graphics.rs
new file mode 100644
index 00000000..0d346e6c
--- /dev/null
+++ b/src/x11/reply/graphics.rs
@@ -0,0 +1,15 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to graphics operations].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to graphics operations]: request::graphics
diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
new file mode 100644
index 00000000..cba386eb
--- /dev/null
+++ b/src/x11/reply/input.rs
@@ -0,0 +1,326 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to input devices, grabs, and coordinates].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to input devices, grabs, and coordinates]: request::input
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	x11::{request, request::RevertFocus},
+	Coords,
+	FocusWindow,
+	GrabStatus,
+	ModifierMask,
+	Timestamp,
+	Window,
+};
+
+derive_xrb! {
+	/// The [reply] to a [`GrabCursor` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GrabCursor` request]: request::GrabCursor
+	#[doc(alias = "GrabPointer")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GrabCursor: Reply for request::GrabCursor {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The status of the attempted grab.
+		///
+		/// See [`GrabStatus`] for more information.
+		#[doc(alias = "status")]
+		#[metabyte]
+		pub grab_status: GrabStatus,
+
+		[_; ..],
+	}
+
+	/// The [reply] to a [`GrabKeyboard` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GrabKeyboard` request]: request::GrabKeyboard
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GrabKeyboard: Reply for request::GrabKeyboard {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The status of the attempted grab.
+		///
+		/// See [`GrabStatus`] for more information.
+		#[doc(alias = "status")]
+		#[metabyte]
+		pub grab_status: GrabStatus,
+
+		[_; ..],
+	}
+
+
+	/// The [reply] to a [`QueryCursorLocation` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryCursorLocation` request]: request::QueryCursorLocation
+	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryCursorLocation: Reply for request::QueryCursorLocation {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the cursor is on the `same_screen` as the given `target`
+		/// [window].
+		///
+		/// [window]: Window
+		#[metabyte]
+		pub same_screen: bool,
+
+		/// The root [window] which the cursor is located within.
+		///
+		/// [window]: Window
+		pub root: Window,
+		/// The child [window] containing the cursor, if any.
+		///
+		/// If the cursor is not on the `same_screen` (i.e., `same_screen` is
+		/// `false`), this will always be [`None`].
+		///
+		/// [window]: Window
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub child: Option<Window>,
+
+		/// The coordinates of the cursor relative to the top-left corner of the
+		/// `root` [window].
+		///
+		/// [window]: Window
+		pub root_coords: Coords,
+		/// The coordinates of the cursor relative to the top-left corner of the
+		/// given `target` [window].
+		///
+		/// [window]: Window
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub target_coords: Coords,
+
+		/// The currently held mouse buttons and modifier keys.
+		pub modifiers: ModifierMask,
+		[_; ..],
+	}
+}
+
+/// The coordinates of the cursor at a certain [time].
+///
+/// This is used in the [`GetMotionHistory` reply].
+///
+/// [time]: Timestamp
+///
+/// [`GetMotionHistory` reply]: GetMotionHistory
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct TimeCoords {
+	/// The [time] at which the cursor was at the `coords`.
+	///
+	/// [time]: Timestamp
+	pub time: Timestamp,
+	/// The coordinates of the cursor at the `time`.
+	pub coords: Coords,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`GetMotionHistory` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetMotionHistory` request]: request::GetMotionHistory
+	#[doc(alias = "GetMotionEvents")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetMotionHistory: Reply for request::GetMotionHistory {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `motion_history`.
+		#[allow(clippy::cast_possible_truncation)]
+		let motion_history_len: u32 = motion_history => motion_history.len() as u32,
+		[_; 20],
+
+		/// The recorded cursor motion between the `start` and `end` times
+		/// (inclusive) for the given `target` [window].
+		///
+		/// [window]: Window
+		#[context(motion_history_len => *motion_history_len as usize)]
+		pub motion_history: Vec<TimeCoords>,
+	}
+
+	/// The [reply] to a [`ConvertCoordinates` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`ConvertCoordinates` request]: request::ConvertCoordinates
+	#[doc(alias = "TranslateCoordinates")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ConvertCoordinates: Reply for request::ConvertCoordinates {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the `original` [window] and the `output` [window] are on the
+		/// same [screen].
+		///
+		/// [window]: Window
+		/// [screen]: crate::visual::Screen
+		#[metabyte]
+		pub same_screen: bool,
+
+		/// If the `output_coords` are contained within a mapped child of the
+		/// `output` [window], this is that child.
+		///
+		/// If `same_screen` is `false`, this is always [`None`].
+		///
+		/// [window]: Window
+		// TODO: should always be [`None`] if `same_screen` is false
+		pub child: Option<Window>,
+
+		/// The converted coordinates which are now relative to the top-left
+		/// corner of the `output` [window].
+		///
+		// FIXME: should always be [`None`], but requires overriding the reading
+		//        behavior here
+		/// If `same_screen` is `false`, these are always zero.
+		///
+		/// [window]: Window
+		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
+		pub output_coords: Coords,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`GetFocus` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetFocus` request]: request::GetFocus
+	#[doc(alias = "GetInputFocus")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetFocus: Reply for request::GetFocus {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// What the focus will retain to if the focused [window] becomes
+		/// unviewable.
+		///
+		/// [window]: Window
+		#[metabyte]
+		pub revert_to: RevertFocus,
+
+		/// The current focus.
+		pub focus: FocusWindow,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`QueryKeyboard` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryKeyboard` request]: request::QueryKeyboard
+	#[doc(alias = "QueryKeymap")]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryKeyboard: Reply for request::QueryKeyboard {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// A bit vector representing the currently held keys of the keyboard.
+		///
+		/// A bit is `0` if the key is not held, and `1` if it is held. Byte
+		/// `N`, starting at `0`, contains the bits for keys `8N` to `8N + 7`.
+		/// The least significant bit in the byte represents key `8N`.
+		pub keys: [u8; 32],
+	}
+}
diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
new file mode 100644
index 00000000..ffa96d5e
--- /dev/null
+++ b/src/x11/reply/meta.rs
@@ -0,0 +1,15 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to an X client or the X server].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to an X client or the X server]: crate::x11::request::meta
diff --git a/src/x11/reply/miscellaneous.rs b/src/x11/reply/miscellaneous.rs
new file mode 100644
index 00000000..9e99b9ea
--- /dev/null
+++ b/src/x11/reply/miscellaneous.rs
@@ -0,0 +1,219 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to atoms, properties, selections, and sending events].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to atoms, properties, selections, and sending events]: request::miscellaneous
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk::pad;
+use xrbk_macro::derive_xrb;
+
+use crate::{
+	x11::request::{self, DataFormat, DataList},
+	Atom,
+	String8,
+	Window,
+};
+
+derive_xrb! {
+	/// The [reply] to a [`GetAtom` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetAtom` request]: request::GetAtom
+	#[doc(alias("InternAtom", "CreateAtom"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetAtom: Reply for request::GetAtom {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The returned [atom].
+		///
+		/// If `no_creation` was set to `true` and an [atom] by the given `name`
+		/// didn't already exist, this will be [`None`].
+		///
+		/// [atom]: Atom
+		pub atom: Option<Atom>,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`GetAtomName` request].
+	///
+	/// [reply]: crate::message
+	///
+	/// [`GetAtomName` request]: request::GetAtomName
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetAtomName: Reply for request::GetAtomName {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 22],
+
+		/// The name of the [atom].
+		///
+		/// [atom]: Atom
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+
+	/// The [reply] to a [`GetProperty` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetProperty` request]: request::GetProperty
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetProperty: Reply for request::GetProperty {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the `value` is empty ([`None`]), or made up of `i8` values,
+		/// `i16` values, or `i32` values.
+		#[metabyte]
+		pub format: Option<DataFormat>,
+
+		/// The actual type of the property.
+		pub r#type: Option<Atom>,
+		/// The number of bytes remaining in the `property`'s data.
+		///
+		/// If the specified `property` does not exist for the `target`
+		/// [window], this is zero.
+		///
+		/// If the specified `property` exists but its `type` does not match the
+		/// specified type, this is the size of the property's data in bytes.
+		///
+		/// If the specified `property` exists and the type is either [`Any`] or
+		/// matches the actual `type` of the property, this is the number of
+		/// bytes remaining in the `property`'s data after the end of the
+		/// returned `value`.
+		///
+		/// [window]: Window
+		///
+		/// [`Any`]: crate::Any::Any
+		#[doc(alias = "bytes_after")]
+		pub bytes_remaining: u32,
+
+		// The length of `value`.
+		#[allow(clippy::cast_possible_truncation)]
+		let value_len: u32 = value => value.len() as u32,
+		[_; 12],
+
+		/// The property's value.
+		///
+		/// If `format` is [`None`], this will be [`DataList::I8`], but with an
+		/// empty list.
+		#[context(format, value_len => (format.unwrap_or(DataFormat::I8), *value_len))]
+		pub value: DataList,
+	}
+
+	/// The [reply] for a [`ListProperties` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`ListProperties` request]: request::ListProperties
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListProperties: Reply for request::ListProperties {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `properties`.
+		#[allow(clippy::cast_possible_truncation)]
+		let properties_len: u16 = properties => properties.len() as u16,
+		[_; 22],
+
+		/// The properties defined for the given [window].
+		///
+		/// [window]: Window
+		#[doc(alias = "atoms")]
+		#[context(properties_len => usize::from(*properties_len))]
+		pub properties: Vec<Atom>,
+	}
+
+	/// The [reply] to a [`GetSelectionOwner` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetSelectionOwner` request]: request::GetSelectionOwner
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetSelectionOwner: Reply for request::GetSelectionOwner {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The owner of the given `selection`.
+		///
+		/// If this is [`None`], then the selection has no owner.
+		pub owner: Option<Window>,
+		[_; ..],
+	}
+}
diff --git a/src/x11/reply/window.rs b/src/x11/reply/window.rs
new file mode 100644
index 00000000..8f4c2515
--- /dev/null
+++ b/src/x11/reply/window.rs
@@ -0,0 +1,336 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Replies] defined in the [core X11 protocol] for
+//! [requests that relate to windows and their management].
+//!
+//! [Replies] are messages sent from the X server to an X client in response to
+//! a [request].
+//!
+//! [Replies]: crate::message::Reply
+//! [request]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+//!
+//! [requests that relate to windows and their management]: request::window
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	unit::Px,
+	visual::{ColorId, VisualId},
+	x11::request,
+	BitGravity,
+	Colormap,
+	DeviceEventMask,
+	EventMask,
+	MaintainContents,
+	Rectangle,
+	Window,
+	WindowClass,
+	WindowGravity,
+};
+
+/// The state of the [window] regarding how it is mapped.
+///
+/// [window]: Window
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum MapState {
+	/// The [window] is not mapped.
+	///
+	/// [window]: Window
+	Unmapped,
+
+	/// The [window] is mapped but one of its ancestors is unmapped.
+	///
+	/// [window]: Window
+	Unviewable,
+
+	/// The [window] is mapped and all of its ancestors are mapped.
+	///
+	/// [window]: Window
+	Viewable,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`GetWindowAttributes` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetWindowAttributes: Reply for request::GetWindowAttributes {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The conditions under which the X server should maintain the obscured
+		/// [regions] of the [window].
+		///
+		/// See [`Attributes::maintain_contents`] for more information.
+		///
+		/// [regions]: crate::Region
+		/// [window]: Window
+		///
+		/// [`Attributes::maintain_contents`]: crate::set::Attributes::maintain_contents
+		#[doc(alias = "backing_store")]
+		#[metabyte]
+		pub maintain_contents: MaintainContents,
+
+		/// The visual used by the [window].
+		///
+		/// See [`VisualType`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`VisualType`]: crate::visual::VisualType
+		pub visual: VisualId,
+		/// The [window]'s [class].
+		///
+		/// [window]: Window
+		/// [class]: WindowClass
+		pub class: WindowClass,
+
+		/// Defines the [region] of the [window] which is retained when the
+		/// [window] is resized.
+		///
+		/// See [`Attributes::bit_gravity`] for more information.
+		///
+		/// [region]: crate::Region
+		/// [window]: Window
+		///
+		/// [`Attributes::bit_gravity`]: crate::set::Attributes::bit_gravity
+		pub bit_gravity: BitGravity,
+		/// Defines how the [window] is repositioned if its parent is resized.
+		///
+		/// See [`Attributes::window_gravity`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`Attributes::window_gravity`]: crate::set::Attributes::window_gravity
+		#[doc(alias = "win_gravity")]
+		pub window_graivty: WindowGravity,
+
+		/// Defines which bit planes of the [window] hold dynamic data which is
+		/// maintained for `maintain_contents` and `maintain_windows_under`.
+		///
+		/// See [`Attributes::maintained_planes`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`Attributes::maintained_planes`]: crate::set::Attributes::maintained_planes
+		#[doc(alias = "backing_planes")]
+		pub maintained_planes: u32,
+		/// Defines the [color] used for bit planes which are not preserved for
+		/// `maintain_contents` and `maintain_windows_under` (see
+		/// `maintained_planes`).
+		///
+		/// See [`Attributes::maintenance_fallback_color`] for more information.
+		///
+		/// [color]: ColorId
+		///
+		/// [`Attributes::maintenance_fallback_color`]: crate::set::Attributes::maintenance_fallback_color
+		#[doc(alias = "backing_pixel")]
+		pub maintenance_fallback_color: ColorId,
+		/// Whether the X server should maintain the contents of
+		/// [windows][window] under this [window].
+		///
+		/// See [`Attributes::maintain_windows_under`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`Attributes::maintain_windows_under`]: crate::set::Attributes::maintain_windows_under
+		#[doc(alias = "save_under")]
+		pub maintain_windows_under: bool,
+
+		/// Whether the [window]'s `colormap` is an installed [colormap] for
+		/// the [screen].
+		///
+		/// [window]: Window
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
+		pub map_installed: bool,
+		/// The [window]'s [map state].
+		///
+		/// See [`MapState`] for more information.
+		///
+		/// [window]: Window
+		/// [map state]: MapState
+		pub map_state: MapState,
+
+		/// Whether [`MapWindow`] and [`ConfigureWindow`] requests on the
+		/// [window] override a [`SUBSTRUCTURE_REDIRECT`] selection on its
+		/// parent.
+		///
+		/// This is typically used to inform a window manager not to tamper with
+		/// the [window].
+		///
+		/// See [`Attributes::override_redirect`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`MapWindow`]: request::MapWindow
+		/// [`ConfigureWindow`]: request::ConfigureWindow
+		///
+		/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
+		///
+		/// [`Attributes::override_redirect`]: crate::set::Attributes::override_redirect
+		pub override_redirect: bool,
+
+		/// The [colormap] which best reflects the true colors of the [window].
+		///
+		/// See [`Attributes::colormap`] for more information.
+		///
+		/// [window]: Window
+		/// [colormap]: Colormap
+		///
+		/// [`Attributes::colormap`]: crate::set::Attributes::colormap
+		pub colormap: Option<Colormap>,
+
+		/// All of the [events] selected by all clients on the [window].
+		///
+		/// This is the bitwise OR of every client's [`event_mask`] on the
+		/// [window].
+		///
+		/// [window]: Window
+		/// [events]: crate::message::Event
+		///
+		/// [`event_mask`]: crate::set::Attributes::event_mask
+		pub all_event_masks: EventMask,
+		/// The [events] selected by you on the [window].
+		///
+		/// This is your [`event_mask`] on the [window].
+		///
+		/// [window]: Window
+		/// [events]: crate::message::Event
+		///
+		/// [`event_mask`]: crate::set::Attributes::event_mask
+		pub your_event_mask: EventMask,
+		/// Defines the [events][event] which should not be propagated to
+		/// ancestors of the [window] if no client has selected the [event] on
+		/// the [window].
+		///
+		/// See [`Attributes::do_not_propagate_mask`] for more information.
+		///
+		/// [event]: crate::message::Event
+		/// [window]: Window
+		///
+		/// [`Attributes::do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
+		pub do_not_propagate_mask: DeviceEventMask,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`GetGeometry` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`GetGeometry` request]: request::GetGeometry
+	#[doc(alias("GetX", "GetY", "GetWidth", "GetHeight", "GetBorderWidth"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetGeometry: Reply for request::GetGeometry {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The number of bits per pixel for the [drawable].
+		///
+		/// [drawable]: crate::Drawable
+		#[metabyte]
+		pub depth: u8,
+
+		/// The [drawable]'s root [window].
+		///
+		/// [window]: Window
+		/// [drawable]: crate::Drawable
+		pub root: Window,
+
+		/// The [drawable]'s geometry.
+		///
+		/// For a [pixmap], the `x` and `y` coordinates will always be zero.
+		///
+		/// For a [window], the coordinates are relative to the top-left corner
+		/// of the [window]'s parent.
+		///
+		/// [window]: Window
+		/// [pixmap]: crate::Pixmap
+		/// [drawable]: crate::Drawable
+		#[doc(alias("x", "y", "width", "height"))]
+		pub geometry: Rectangle,
+		/// The width of the [drawable]'s border.
+		///
+		/// For a [pixmap], this will always be zero.
+		///
+		/// [pixmap]: crate::Pixmap
+		/// [drawable]: crate::Drawable
+		pub border_width: Px<u16>,
+		[_; ..],
+	}
+
+	/// The [reply] to a [`QueryWindowTree` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`QueryWindowTree` request]: request::QueryWindowTree
+	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
+	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
+	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryWindowTree: Reply for request::QueryWindowTree {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The `target` [window]'s root [window].
+		///
+		/// [window]: Window
+		pub root: Window,
+		/// The `target` [window]'s parent.
+		///
+		/// [window]: Window
+		pub parent: Option<Window>,
+
+		// The length of `children`.
+		#[allow(clippy::cast_possible_truncation)]
+		let children_len: u16 = children => children.len() as u16,
+		[_; 14],
+
+		/// The `target` [window]'s children.
+		///
+		/// [window]: Window
+		#[context(children_len => usize::from(*children_len))]
+		pub children: Vec<Window>,
+	}
+}
diff --git a/src/x11/request.rs b/src/x11/request.rs
index 622851f4..eb42991a 100644
--- a/src/x11/request.rs
+++ b/src/x11/request.rs
@@ -9,5081 +9,21 @@
 //! [Requests]: crate::message::Request
 //! [core X11 protocol]: super
 
-extern crate self as xrb;
-
-use xrbk::{
-	pad,
-	Buf,
-	BufMut,
-	ConstantX11Size,
-	ReadError,
-	ReadError::UnrecognizedDiscriminant,
-	ReadResult,
-	Readable,
-	ReadableWithContext,
-	Wrap,
-	Writable,
-	WriteResult,
-	X11Size,
-};
-use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
-
-use crate::{
-	message::Event,
-	set::{Attributes, GraphicsOptions, GraphicsOptionsMask, WindowConfig},
-	unit::Px,
-	visual::VisualId,
-	x11::{error, reply},
-	Any,
-	AnyModifierKeyMask,
-	Arc,
-	Atom,
-	Button,
-	Char16,
-	Coords,
-	CopyableFromParent,
-	CurrentableTime,
-	CursorAppearance,
-	CursorEventMask,
-	DestinationWindow,
-	Dimensions,
-	Drawable,
-	EventMask,
-	FocusWindow,
-	Font,
-	Fontable,
-	FreezeMode,
-	GraphicsContext,
-	Keycode,
-	LengthString8,
-	Pixmap,
-	Rectangle,
-	String16,
-	String8,
-	Window,
-	WindowClass,
-};
-
-macro_rules! request_error {
-	(
-		$(#[$meta:meta])*
-		$vis:vis enum $Name:ident for $Request:ty {
-			$($($Error:ident),+$(,)?)?
-		}
-	) => {
-		#[doc = concat!(
-			"An [error](crate::message::Error) generated because of a failed [`",
-			stringify!($Request),
-			"` request](",
-			stringify!($Request),
-			")."
-		)]
-		#[doc = ""]
-		$(#[$meta])*
-		$vis enum $Name {
-			$($(
-				#[doc = concat!(
-					"A [`",
-					stringify!($Error),
-					"` error](error::",
-					stringify!($Error),
-					")."
-				)]
-				$Error(error::$Error)
-			),+)?
-		}
-	};
-}
-
-request_error! {
-	pub enum CreateWindowError for CreateWindow {
-		Colormap,
-		CursorAppearance,
-		ResourceIdChoice,
-		Match,
-		Pixmap,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that creates a new unmapped [window] and assigns the
-	/// provided [`Window` ID][window] to it.
-	///
-	/// [request]: crate::message::Request
-	/// [window]: Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct CreateWindow: Request(1, CreateWindowError) {
-		#[metabyte]
-		/// The [window]'s depth.
-		///
-		/// For a `class` of [`CopyFromParent`] or
-		/// <code>[Other]\([InputOutput])</code>, [`CopyFromParent`] for `depth`
-		/// means that the depth is copied from the `parent`.
-		///
-		/// # Errors
-		/// For a `class` of <code>[Other]\([InputOnly])</code>, however,
-		/// [`CopyFromParent`] is *required*, else a [`Match` error] is
-		/// generated, and _does not_ mean that the depth is copied from the
-		/// `parent`.
-		///
-		/// [window]: Window
-		///
-		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
-		/// [Other]: CopyableFromParent::Other
-		/// [InputOutput]: WindowClass::InputOutput
-		/// [InputOnly]: WindowClass::InputOnly
-		///
-		/// [`Match` error]: error::Match
-		pub depth: CopyableFromParent<u8>,
-
-		/// The [`Window` ID][window] which is to be assigned to the [window].
-		///
-		/// # Errors
-		/// If the provided [`Window` ID][window] is already used or it is not
-		/// allocated to your client, a [`ResourceIdChoice` error] is generated.
-		///
-		/// [window]: Window
-		///
-		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-		#[doc(alias = "wid")]
-		pub window_id: Window,
-		/// The [window] which should be used as the new [window]'s parent.
-		///
-		/// # Errors
-		/// For a `class` of [`InputOutput`], the parent cannot be an
-		/// [`InputOnly`] [window], else a [`Match` error] is generated.
-		///
-		/// [window]: Window
-		///
-		/// [`InputOutput`]: WindowClass::InputOutput
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Match` error]: error::Match
-		pub parent: Window,
-
-		/// The coordinates and dimensions of the [window].
-		///
-		/// The coordinates are of the top-left corner of the [window], and are
-		/// relative to the top-left corner of the [window]'s `parent`.
-		///
-		/// [window]: Window
-		pub geometry: Rectangle,
-		/// The width of the [window]'s border.
-		///
-		/// [window]: Window
-		pub border_width: Px<u16>,
-
-		/// The [window]'s [class].
-		///
-		/// [`CopyFromParent`] means the class is taken from the `parent`.
-		///
-		/// # Errors
-		/// For [`InputOutput`], the `visual` type and `depth` must be
-		/// combination supported by the [screen], else a [`Match` error] is
-		/// generated.
-		///
-		/// For [`InputOnly`], the `visual` must be one supported by the
-		/// [screen], else a [`Match` error] is generated.
-		///
-		/// [window]: Window
-		/// [class]: WindowClass
-		/// [screen]: crate::visual::Screen
-		///
-		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
-		/// [`InputOutput`]: WindowClass::InputOutput
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Match` error]: error::Match
-		pub class: CopyableFromParent<WindowClass>,
-		/// The visual used by the [window].
-		///
-		/// See [`VisualType`] for more information.
-		///
-		/// [window]: Window
-		///
-		/// [`VisualType`]: crate::visual::VisualType
-		pub visual: CopyableFromParent<VisualId>,
-
-		/// Additional [attributes] configured for the [window].
-		///
-		/// See [`Attributes`] for more information.
-		///
-		/// [window]: Window
-		/// [attributes]: Attributes
-		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
-		pub attributes: Attributes,
-	}
-}
-
-request_error! {
-	pub enum ChangeWindowAttributesError for ChangeWindowAttributes {
-		Access,
-		Colormap,
-		CursorAppearance,
-		Match,
-		Pixmap,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that configures the [attributes] of a [window].
-	///
-	/// The [`event_mask`] attribute on the [window] is not shared between
-	/// clients: one client modifying the [`event_mask`] only selects interest
-	/// in the relevant events for that client. There are three exceptions to
-	/// this: only one client at a time may select [`SUBSTRUCTURE_REDIRECT`],
-	/// [`RESIZE_REDIRECT`], or [`BUTTON_PRESS`] on the [window].
-	///
-	/// [request]: crate::message::Request
-	/// [window]: Window
-	/// [attributes]: Attributes
-	///
-	/// [`event_mask`]: Attributes::event_mask
-	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
-	/// [`RESIZE_REDIRECT`]: EventMask::RESIZE_REDIRECT
-	/// [`BUTTON_PRESS`]: EventMask::BUTTON_PRESS
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ChangeWindowAttributes: Request(2, ChangeWindowAttributesError) {
-		/// The [window] which the `attributes` are changed on.
-		///
-		/// [window]: Window
-		#[doc(alias = "window")]
-		pub target: Window,
-
-		/// The [attributes] which are changed.
-		///
-		/// [attributes]: Attributes
-		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
-		pub attributes: Attributes,
-	}
-
-	/// A [request] that returns the current [attributes] of the [window].
-	///
-	/// [request]: crate::message::Request
-	/// [attributes]: Attributes
-	/// [window]: Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetWindowAttributes: Request(3, error::Window) -> reply::GetWindowAttributes {
-		/// The [window] for which this [request] gets the [attributes].
-		///
-		/// [request]: crate::message::Request
-		/// [attributes]: Attributes
-		/// [window]: Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that destroys the given [window] and all its descendents.
-	///
-	/// If the `target` [window] is mapped, an [`UnmapWindow` request] is
-	/// automatically performed.
-	///
-	/// The ordering of [`Destroy` events][event] is such that a
-	/// [`Destroy` event][event] is generated on every descendent of the target
-	/// [window] before being generated on the [window] itself.
-	///
-	/// This [request] has no effect on root [windows][window].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [event]: super::event::Destroy
-	///
-	/// [`UnmapWindow` request]: UnmapWindow
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct DestroyWindow: Request(4, error::Window) {
-		/// The [window] which is the target of the `DestroyWindow` [request].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that [destroys] every child of the given [window] in
-	/// bottom-to-top stacking order.
-	///
-	/// A [`DestroyWindow` request][destroys] is performed on each child.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [destroys]: DestroyWindow
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "DestroySubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct DestroyChildren: Request(5, error::Window) {
-		/// The [window] which will have its children [destroyed].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [destroyed]: DestroyWindow
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-}
-
-request_error! {
-	pub enum ChangeSavedWindowsError for ChangeSavedWindows {
-		Match,
-		Value,
-		Window,
-	}
-}
-
-/// Whether something is added or removed.
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum AddOrRemove {
-	/// The thing is added.
-	Add,
-	/// The thing is removed.
-	Remove,
-}
-
-derive_xrb! {
-	/// A [request] that [adds] or [removes] the specified [window] from the
-	/// set of [windows][window] which you have chosen to save.
-	///
-	/// When a client's resources are destroyed, each of the client's saved
-	/// [windows] which are descendents of [windows] created by the client is
-	/// [reparented] to the closest ancestor which is not created by the client.
-	///
-	/// # Errors
-	/// The given `window` must not be a [window] created by you, else a
-	/// [`Match` error] is generated.
-	///
-	/// A [`Window` error] is generated if the `window` does not refer to a
-	/// defined [window].
-	///
-	/// A [`Value` error] is generated if the `change_mode` is encoded
-	/// incorrectly. It is a bug in X Rust Bindings if that happens.
-	///
-	/// [window]: Window
-	/// [windows]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [adds]: AddOrRemove::Add
-	/// [removes]: AddOrRemove::Remove
-	///
-	/// [reparented]: ReparentWindow
-	#[doc(alias = "ChangeSaveSet")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ChangeSavedWindows: Request(6, ChangeSavedWindowsError) {
-		#[metabyte]
-		/// Whether the `window` is added to or removed from your saved
-		/// [windows].
-		///
-		/// [windows]: Window
-		#[doc(alias = "mode")]
-		pub change_mode: AddOrRemove,
-
-		/// The [window] which is added to or removed from your saved
-		/// [windows][window].
-		///
-		/// # Errors
-		/// A [`Match` error] is generated if you created this [window].
-		///
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Match` error]: error::Match
-		/// [`Window` error]: error::Window
-		pub window: Window,
-	}
-}
-
-request_error! {
-	pub enum ReparentWindowError for ReparentWindow {
-		Match,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that changes a [window]'s parent to a different one.
-	///
-	/// If the [window] is mapped, an [`UnmapWindow` request] is first
-	/// automatically performed. The [window] is then removed from its current
-	/// parent and inserted as a child of the `new_parent`. If the [window] was
-	/// mapped originally, then a [`MapWindow` request] is then automatically
-	/// performed to map it again.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if either the `target` or the
-	/// `new_parent` do not refer to defined [windows][window].
-	///
-	/// A [`Match` error] is generated if the `new_parent` is not on the same
-	/// [screen] as the old parent.
-	///
-	/// A [`Match` error] is generated if the `new_parent` is the `target`
-	/// [window] itself, or a descendent of the `target` [window].
-	///
-	/// A [`Match` error] is generated if the `new_parent` is [`InputOnly`] but
-	/// the `target` [window] is not.
-	///
-	/// A [`Match` error] is generated if the `target` [window] has a
-	/// [`ParentRelative`] [`background_pixmap`] and the `new_parent` does not
-	/// have the same depth as the `target` [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	/// [screen]: crate::visual::Screen
-	///
-	/// [`UnmapWindow` request]: UnmapWindow
-	/// [`MapWindow` request]: MapWindow
-	///
-	/// [`InputOnly`]: WindowClass::InputOnly
-	/// [`ParentRelative`]: crate::ParentRelatable::ParentRelative
-	///
-	/// [`background_pixmap`]: Attributes::background_pixmap
-	///
-	/// [`Match` error]: error::Match
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ReparentWindow: Request(7, ReparentWindowError) {
-		/// The [window] which will be transferred to be a child of the
-		/// `new_parent`.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-		/// The `target`'s new parent [window].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// A [`Match` error] is generated if this [window] is not on the same
-		/// [screen] as the `target` [window].
-		///
-		/// A [`Match` error] is generated if this [window] is the same [window]
-		/// as the `target`, or is a descendent of the `target` [window].
-		///
-		/// A [`Match` error] is generated if this [window] is [`InputOnly`] but
-		/// the `target` [window] is not.
-		///
-		/// [window]: Window
-		/// [screen]: crate::visual::Screen
-		///
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Match` error]: error::Match
-		/// [`Window` error]: error::Window
-		#[doc(alias = "parent")]
-		pub new_parent: Window,
-
-		/// The `target`'s new coordinates relative to its `new_parent`'s
-		/// top-left corner.
-		#[doc(alias("x", "y"))]
-		pub coords: Coords,
-	}
-
-	/// A [request] that maps the given [window].
-	///
-	/// If the [window]'s [`override_redirect` attribute] is `false` and some
-	/// other client has selected [`SUBSTRUCTURE_REDIRECT`] on its parent, then
-	/// a [`MapWindowRequest` event] is generated, but the [window] remains
-	/// unmapped. Otherwise, the [window] is mapped and a [`Map` event] is
-	/// generated.
-	///
-	/// If the [window] is already mapped, this [request] has no effect.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Map` event]: super::event::Map
-	/// [`MapWindowRequest` event]: super::event::MapWindowRequest
-	///
-	/// [`override_redirect` attribute]: Attributes::override_redirect
-	///
-	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct MapWindow: Request(8, error::Window) {
-		/// The [window] which is the target of the `MapWindow` [request].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that [maps] every unmapped child of the given [window] in
-	/// top-to-bottom stacking order.
-	///
-	/// A [`MapWindow` request][maps] is performed on each unmapped child.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [maps]: MapWindow
-	///
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "MapSubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct MapChildren: Request(9, error::Window) {
-		/// The [window] which will have its unmapped children [mapped].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [mapped]: MapWindow
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that unmaps the given [window].
-	///
-	/// If the [window] is currently mapped, the [window] is unmapped and an
-	/// [`Unmap` event] is generated.
-	///
-	/// If the [window] is already unmapped, this [request] has no effect.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Unmap` event]: super::event::Unmap
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UnmapWindow: Request(10, error::Window) {
-		/// The [window] which is the target of the `UnmapWindow` [request].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that [unmaps] every mapped child of the
-	/// given [window] in bottom-to-top stacking order.
-	///
-	/// An [`UnmapWindow` request][unmaps] is performed on each mapped child.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [unmaps]: UnmapWindow
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "UnmapSubwindows")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UnmapChildren: Request(11, error::Window) {
-		/// The [window] which will have its mapped children [unmapped].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [unmapped]: UnmapWindow
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-}
-
-request_error! {
-	pub enum ConfigureWindowError for ConfigureWindow {
-		Match,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that [configures] a [window].
-	///
-	/// See [`WindowConfig`] for more information.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// A [`Match` error] is generated if either the [`width`] or [`height`] is
-	/// configured to be zero.
-	///
-	/// A [`Match` error] is generated if the [`border_width`] is configured to
-	/// be anything other than zero if the `target` [window] is [`InputOnly`].
-	///
-	/// A [`Match` error] is generated if [`sibling`] is configured without a
-	/// specified [`stack_mode`].
-	///
-	/// A [`Match` error] is generated if [`sibling`] is specified but that
-	/// specified [window] is not actually a sibling of the `target` [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [configures]: WindowConfig
-	///
-	/// [`InputOnly`]: WindowClass::InputOnly
-	///
-	/// [`width`]: WindowConfig::width
-	/// [`height`]: WindowConfig::height
-	/// [`border_width`]: WindowConfig::border_width
-	/// [`sibling`]: WindowConfig::sibling
-	/// [`stack_mode`]: WindowConfig::stack_mode
-	///
-	/// [`Window` error]: error::Window
-	/// [`Match` error]: error::Match
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ConfigureWindow: Request(12, ConfigureWindowError) {
-		/// The [window] which is the target of the `ConfigureWindow` [request].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-
-		/// The changes to the `target` [window]'s [configuration].
-		///
-		/// See [`WindowConfig`] for more information.
-		///
-		/// If the `target` [window] is a root [window], this [request] has no
-		/// effect.
-		///
-		/// # Errors
-		/// A [`Match` error] is generated if either the [`width`] or the
-		/// [`height`] is zero.
-		///
-		/// A [`Match` error] is generated if the [`border_width`] is set to
-		/// zero if the `target` [window] is [`InputOnly`].
-		///
-		/// A [`Match` error] is generated if [`sibling`] is configured without
-		/// a specified [`stack_mode`].
-		///
-		/// A [`Match` error] is generated if [`sibling`] is specified but that
-		/// specified [window] is not actually a sibling of the `target`
-		/// [window].
-		///
-		/// [configuration]: WindowConfig
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`width`]: WindowConfig::width
-		/// [`height`]: WindowConfig::height
-		/// [`border_width`]: WindowConfig::border_width
-		/// [`sibling`]: WindowConfig::sibling
-		/// [`stack_mode`]: WindowConfig::stack_mode
-		///
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Match` error]: error::Match
-		#[doc(alias("values", "value_mask", "value_list", "window_config"))]
-		pub config: WindowConfig,
-	}
-}
-
-request_error! {
-	pub enum CirculateWindowError for CirculateWindow {
-		Value,
-		Window,
-	}
-}
-
-/// The direction with which a [window]'s mapped children are circulated in
-/// their stacking order.
-///
-/// This is used in the [`CirculateWindow` request].
-///
-/// [window]: Window
-///
-/// [`CirculateWindow` request]: CirculateWindow
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum CirculateDirection {
-	/// Raises the lowest mapped child that is occluded by another child, if
-	/// any, to the top of the stack.
-	RaiseLowest,
-
-	/// Lowers the highest mapped child that occludes another child, if any, to
-	/// the bottom of the stack.
-	LowerHighest,
-}
-
-derive_xrb! {
-	/// A [request] that [circulates] the mapped children of the given [window].
-	///
-	/// If some other client has selected [`SUBSTRUCTURE_REDIRECT`] on the
-	/// `target` [window], then a [`CirculateWindowRequest` event] is generated
-	/// and no further processing occurs. Otherwise, a [`Circulate` event] is
-	/// generated if one of the [window]'s children is actually restacked.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [circulates]: CirculateDirection
-	///
-	/// [`SUBSTRUCTURE_REDIRECT`]: EventMask::SUBSTRUCTURE_REDIRECT
-	///
-	/// [`CirculateWindowRequest` event]: super::event::CirculateWindowRequest
-	/// [`Circulate` event]: super::event::Circulate
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CirculateWindow: Request(13, CirculateWindowError) {
-		#[metabyte]
-		/// Which of the [window]'s children might be circulated and in which
-		/// direction.
-		///
-		/// [window]: Window
-		pub direction: CirculateDirection,
-
-		/// The [window] which is the target of the `CirculateWindow` [request].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window error`]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that returns the root [window] and current geometry of the
-	/// given [drawable].
-	///
-	/// It is legal to pass an [`InputOnly`] [window] as a [drawable] to this
-	/// [request].
-	///
-	/// # Replies
-	/// This [request] generates a [`GetGeometry` reply].
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if the `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [drawable]: Drawable
-	/// [request]: crate::message::Request
-	///
-	/// [`InputOnly`]: WindowClass::InputOnly
-	///
-	/// [`GetGeometry` reply]: reply::GetGeometry
-	///
-	/// [`Drawable` error]: error::Drawable
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetGeometry: Request(14, error::Drawable) -> reply::GetGeometry {
-		/// The [drawable] for which this [request] gets its geometry.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		/// [drawable]: Drawable
-		/// [request]: crate::message::Request
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias = "drawable")]
-		pub target: Drawable,
-	}
-
-	/// A [request] that returns the root [window], the parent, and the children
-	/// of the given [window].
-	///
-	/// # Replies
-	/// This [request] generates a [`QueryWindowTree` reply].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
-	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
-	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
-		/// The [window] for which this [request] gets its root [window],
-		/// parent, and children.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that returns the [atom] with the given `name`.
-	///
-	/// If `no_creation` is false and an [atom] by the specified `name` does not
-	/// already exist, a new [atom] will be created and then returned. If an
-	/// [atom] by the specified `name` already exists, that [atom] will be
-	/// returned.
-	///
-	/// # Replies
-	/// This [request] generates a [`GetAtom` reply].
-	///
-	/// [atom]: Atom
-	/// [request]: crate::message::Request
-	///
-	/// [`GetAtom` reply]: reply::GetAtom
-	#[doc(alias("InternAtom", "CreateAtom"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct GetAtom: Request(16, error::Value) -> reply::GetAtom {
-		#[metabyte]
-		/// Whether the X server should avoid creating a new [atom] for an
-		/// unrecognised `name`.
-		///
-		/// If this is `true`, the X server won't create a new [atom] for a
-		/// `name` which doesn't already refer to an [atom]. If it is `false`,
-		/// the X server will create a new [atom] for the given `name`.
-		///
-		/// [atom]: Atom
-		#[doc(alias = "only_if_exists")]
-		pub no_creation: bool,
-
-		// Encodes the length of `name`.
-		#[allow(clippy::cast_possible_truncation)]
-		let name_len: u16 = name => name.len() as u16,
-		[_; 2],
-
-		/// The name of the [atom] to either create or retrieve.
-		///
-		/// If an [atom] by this name does not already exist and `no_creation`
-		/// is `false`, a new [atom] with this name will be created and
-		/// returned.
-		///
-		/// If an [atom] by this name already exists, that [atom] will be
-		/// returned.
-		///
-		/// [atom]: Atom
-		#[context(name_len => usize::from(*name_len))]
-		pub name: String8,
-		[_; name => pad(name)],
-	}
-
-	/// A [request] that returns the name of the given [atom].
-	///
-	/// # Replies
-	/// This [request] generates a [`GetAtomName` reply].
-	///
-	/// # Errors
-	/// An [`Atom` error] is generated if the `target` does not refer to a
-	/// defined [atom].
-	///
-	/// [atom]: Atom
-	/// [request]: crate::message::Request
-	///
-	/// [`GetAtomName` reply]: reply::GetAtomName
-	///
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetAtomName: Request(17, error::Atom) -> reply::GetAtomName {
-		/// The [atom] for which this [request] gets its name.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [request]: crate::message::Request
-		///
-		/// [`Atom` error]: error::Atom
-		#[doc(alias = "atom")]
-		pub target: Atom,
-	}
-}
-
-request_error! {
-	pub enum ModifyPropertyError for ModifyProperty {
-		Atom,
-		Match,
-		Value,
-		Window,
-	}
-}
-
-/// Whether a property is [replaced], [prepended] to a [window]'s list of
-/// properties, or [appended] to the [window]'s list of properties.
-///
-/// [replaced]: ModifyPropertyMode::Replace
-/// [prepended]: ModifyPropertyMode::Prepend
-/// [appended]: ModifyPropertyMode::Append
-///
-/// [window]: Window
-#[doc(alias = "ChangePropertyMode")]
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum ModifyPropertyMode {
-	/// The property replaces an existing property; the previous value is
-	/// discarded.
-	Replace,
-
-	/// The property is prepended to the list of properties.
-	Prepend,
-
-	/// The property is appended to the list of properties.
-	Append,
-}
-
-/// Whether a [`DataList`] is formatted as a list of `i8` values, `i16` values,
-/// or `i32` values.
-#[derive(Copy, Clone, Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum DataFormat {
-	/// The list is formatted as `i8` values.
-	I8 = 8,
-	/// The list is formatted as `i16` values.
-	I16 = 16,
-	/// The list is formatted as `i32` values.
-	I32 = 32,
-}
-
-impl ConstantX11Size for DataFormat {
-	const X11_SIZE: usize = 1;
-}
-
-impl Wrap for DataFormat {
-	type Integer = u8;
-}
-
-impl TryFrom<u8> for DataFormat {
-	type Error = ReadError;
-
-	fn try_from(value: u8) -> Result<Self, Self::Error> {
-		match value {
-			i8 if i8 == 8 => Ok(Self::I8),
-			i16 if i16 == 16 => Ok(Self::I16),
-			i32 if i32 == 32 => Ok(Self::I32),
-
-			other => Err(UnrecognizedDiscriminant(usize::from(other))),
-		}
-	}
-}
-
-impl From<DataFormat> for u8 {
-	fn from(format: DataFormat) -> Self {
-		match format {
-			DataFormat::I8 => 8,
-			DataFormat::I16 => 16,
-			DataFormat::I32 => 32,
-		}
-	}
-}
-
-/// A list of either `i8` values, `i16` values, or `i32` values.
-///
-/// This represents uninterpreted 'raw' data.
-#[derive(Clone, Debug, Hash, PartialEq, Eq)]
-pub enum DataList {
-	/// A list of `i8` values.
-	I8(Vec<i8>),
-	/// A list of `i16` values.
-	I16(Vec<i16>),
-	/// A list of `i32` values.
-	I32(Vec<i32>),
-}
-
-impl DataList {
-	/// The length of the data.
-	///
-	/// This is how many values there are - not the number of bytes.
-	#[must_use]
-	pub fn len(&self) -> usize {
-		match self {
-			Self::I8(list) => list.len(),
-			Self::I16(list) => list.len(),
-			Self::I32(list) => list.len(),
-		}
-	}
-
-	/// Whether the `DataList` is empty.
-	#[must_use]
-	pub fn is_empty(&self) -> bool {
-		match self {
-			Self::I8(list) => list.is_empty(),
-			Self::I16(list) => list.is_empty(),
-			Self::I32(list) => list.is_empty(),
-		}
-	}
-}
-
-impl X11Size for DataList {
-	fn x11_size(&self) -> usize {
-		match self {
-			Self::I8(list) => list.x11_size(),
-			Self::I16(list) => list.x11_size(),
-			Self::I32(list) => list.x11_size(),
-		}
-	}
-}
-
-impl ReadableWithContext for DataList {
-	type Context = (DataFormat, u32);
-
-	fn read_with(buf: &mut impl Buf, (format, length): &(DataFormat, u32)) -> ReadResult<Self>
-	where
-		Self: Sized,
-	{
-		let length = &(*length as usize);
-
-		Ok(match format {
-			DataFormat::I8 => Self::I8(<Vec<i8>>::read_with(buf, length)?),
-			DataFormat::I16 => Self::I16(<Vec<i16>>::read_with(buf, length)?),
-			DataFormat::I32 => Self::I32(<Vec<i32>>::read_with(buf, length)?),
-		})
-	}
-}
-
-impl Writable for DataList {
-	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		match self {
-			Self::I8(list) => list.write_to(buf)?,
-			Self::I16(list) => list.write_to(buf)?,
-			Self::I32(list) => list.write_to(buf)?,
-		}
-
-		Ok(())
-	}
-}
-
-derive_xrb! {
-	/// A [request] that modifies the given `property` for the [window].
-	///
-	/// A [`Property` event] is generated on the `target` [window].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// An [`Atom` error] is generated if either `property` or `type` do not
-	/// refer to defined [windows][window].
-	///
-	/// If the `modify_mode` is [`Prepend`] or [`Append`], the `type` and
-	/// `format` must match that of the existing property's value, else a
-	/// [`Match` error] is generated.
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Prepend`]: ModifyPropertyMode::Prepend
-	/// [`Append`]: ModifyPropertyMode::Append
-	///
-	/// [`Property` event]: super::event::Property
-	///
-	/// [`Window` error]: error::Window
-	/// [`Atom` error]: error::Atom
-	/// [`Match` error]: error::Match
-	#[doc(alias = "ChangeProperty")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ModifyProperty: Request(18, ModifyPropertyError) {
-		#[metabyte]
-		/// The way in which the property is modified.
-		///
-		/// If the mode is [`Replace`], the previous property value is
-		/// discarded.
-		///
-		/// If the mode is [`Prepend`], the data is prepended to the existing
-		/// data. If the mode is [`Append`], the data is appended to the
-		/// existing data.
-		///
-		/// # Errors
-		/// If the mode is [`Prepend`] or [`Append`], the `type` and `format`
-		/// must match that of the existing property's value, else a
-		/// [`Match` error] is generated.
-		///
-		/// [window]: Window
-		///
-		/// [`Replace`]: ModifyPropertyMode::Replace
-		/// [`Prepend`]: ModifyPropertyMode::Prepend
-		/// [`Append`]: ModifyPropertyMode::Append
-		///
-		/// [`Match` error]: error::Match
-		#[doc(alias = "mode")]
-		pub modify_mode: ModifyPropertyMode,
-
-		/// The [window] which the `property` is modified for.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-
-		/// The property which is modified.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		///
-		/// [`Atom` error]: error::Atom
-		pub property: Atom,
-		/// The type of the property's data.
-		///
-		/// For example, if the property is of type [`Window`], then this would
-		/// be [`atom::WINDOW`].
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [`atom::WINDOW`]: crate::atom::WINDOW
-		///
-		/// [`Atom` error]: error::Atom
-		pub r#type: Atom,
-
-		// Whether the `data` is formatted as `i8` values, `i16` values, or
-		// `i32` values.
-		let format: DataFormat = data => match data {
-			DataList::I8(_) => DataFormat::I8,
-			DataList::I16(_) => DataFormat::I16,
-			DataList::I32(_) => DataFormat::I32,
-		},
-		[_; 3],
-
-		// The length of `data` in number of values (i.e., an `i32` value is
-		// counted as one, rather than the number of bytes).
-		#[allow(clippy::cast_possible_truncation)]
-		let data_len: u32 = data => data.len() as u32,
-
-		/// The property's value.
-		///
-		/// See [`DataList`] for information on the format of this data.
-		#[context(format, data_len => (*format, *data_len))]
-		pub data: DataList,
-	}
-}
-
-request_error! {
-	pub enum DeletePropertyError for DeleteProperty {
-		Atom,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that removes the given `property` from a [window].
-	///
-	/// If the `property` does not exist on the [window], this [request] has no
-	/// effect. Otherwise, a [`Property` event] is generated on the [window].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// An [`Atom` error] is generated if the `property` does not refer to a
-	/// defined [atom].
-	///
-	/// [window]: Window
-	/// [atom]: Atom
-	/// [request]: crate::message::Request
-	///
-	/// [`Property` event]: super::event::Property
-	///
-	/// [`Window` error]: error::Window
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct DeleteProperty: Request(19, DeletePropertyError) {
-		/// The [window] for which this [request] removes the `property`.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-
-		/// The property which is to be removed from the `target` [window].
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [window]: Window
-		///
-		/// [`Atom` error]: error::Atom
-		pub property: Atom,
-	}
-}
-
-request_error! {
-	pub enum GetPropertyError for GetProperty {
-		Atom,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that gets the value of the given `property` on the given
-	/// [window].
-	///
-	/// # Replies
-	/// This [request] generates a [`GetProperty` reply].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// An [`Atom` error] is generated if either `property` or `type` do not
-	/// refer to defined [atoms].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	/// [atoms]: Atom
-	///
-	/// [`GetProperty` reply]: reply::GetProperty
-	///
-	/// [`Window` error]: error::Window
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetProperty: Request(20, GetPropertyError) -> reply::GetProperty {
-		/// Whether the `property` should be deleted from the `target` [window].
-		///
-		/// If the `type` matches the `property`'s actual type (or is [`Any`]),
-		/// the property is removed from the [window]. Otherwise, this is
-		/// ignored.
-		///
-		/// [window]: Window
-		///
-		/// [`Any`]: Any::Any
-		#[metabyte]
-		pub delete: bool,
-
-		/// The [window] on which the requested `property` is found.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-
-		/// The property for which this [request] gets its value.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [request]: crate::message::Request
-		pub property: Atom,
-		/// The property type to filter the [window]'s properties by.
-		///
-		/// This specifies that specifically a `property` of this type is
-		/// requested. If the type does not match, the value is not provided in
-		/// [the reply].
-		///
-		/// [window]: Window
-		///
-		/// [the reply]: reply::GetProperty
-		pub r#type: Any<Atom>,
-
-		/// The offset of the value of the `property` that is requested in
-		/// 4-byte units.
-		///
-		/// This offset is multiplied by 4 when applied to the start of the
-		/// `property`'s data.
-		#[doc(alias = "long_offset")]
-		pub offset: u32,
-		/// The length of the value of the `property` that is requested in
-		/// 4-byte units.
-		///
-		/// This length is multiplied by 4 and added to the `offset` to find the
-		/// endpoint of the value that is requested.
-		#[doc(alias = "long_length")]
-		pub length: u32,
-	}
-
-	/// A [request] that returns the list of properties defined for the given
-	/// [window].
-	///
-	/// # Replies
-	/// This [request] generates a [`ListProperties` reply].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`ListProperties` reply]: reply::ListProperties
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ListProperties: Request(21, error::Window) -> reply::ListProperties {
-		/// The [window] for which this [request] returns its properties.
-		///
-		/// # Errors
-		/// A [`Window` error] is returned if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-}
-
-request_error! {
-	pub enum SetSelectionOwnerError for SetSelectionOwner {
-		Atom,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that changes the owner of the given selection.
-	///
-	/// If the `new_owner` is different to the previous owner of the selection,
-	/// and the previous owner was not [`None`], then a [`SelectionClear` event]
-	/// is sent to the previous owner.
-	///
-	/// If the given `time` is earlier than the [time] of the previous owner
-	/// change or is later than the X server's [current time], this [request]
-	/// has no effect.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `owner` is [`Some`] but does not
-	/// refer to a defined [window].
-	///
-	/// An [`Atom` error] is generated if `selection` does not refer to a
-	/// defined [atom].
-	///
-	/// [window]: Window
-	/// [atom]: Atom
-	/// [time]: crate::Timestamp
-	/// [request]: crate::message::Request
-	///
-	/// [current time]: CurrentableTime::CurrentTime
-	///
-	/// [`SelectionClear` event]: super::event::SelectionClear
-	///
-	/// [`Window` error]: error::Window
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct SetSelectionOwner: Request(22, SetSelectionOwnerError) {
-		/// Sets the new owner of the `selection`.
-		///
-		/// [`None`] specifies that the `selection` is to have no owner.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`Some`] but does not
-		/// refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "owner")]
-		pub new_owner: Option<Window>,
-		/// The selection for which this [request] changes its owner.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [request]: crate::message::Request
-		///
-		/// [`Atom` error]: error::Atom
-		pub selection: Atom,
-
-		/// The [time] at which this change is recorded to occur at.
-		///
-		/// If this [time] is earlier than the server's current 'last-change'
-		/// [time] for the selection's owner, or this [time] is later than the
-		/// server's [current time], this [request] has no effect.
-		///
-		/// [time]: crate::Timestamp
-		/// [current time]: CurrentableTime::CurrentTime
-		/// [request]: crate::message::Request
-		pub time: CurrentableTime,
-	}
-
-	/// A [request] that returns the owner of a given selection.
-	///
-	/// # Replies
-	/// This [request] generates a [`GetSelectionOwner` reply].
-	///
-	/// # Errors
-	/// An [`Atom` error] is generated if `target` does not refer to a defined
-	/// [atom].
-	///
-	/// [atom]: Atom
-	/// [request]: crate::message::Request
-	///
-	/// [`GetSelectionOwner` reply]: reply::GetSelectionOwner
-	///
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetSelectionOwner: Request(23) -> reply::GetSelectionOwner {
-		/// The selection for which this [request] returns its owner.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [request]: crate::message::Request
-		///
-		/// [`Atom` error]: error::Atom
-		pub target: Atom,
-	}
-}
-
-request_error! {
-	pub enum ConvertSelectionError for ConvertSelection {
-		Atom,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that asks the given selection's owner to convert it to the
-	/// given `target_type`.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `requester` does not refer to a
-	/// defined [window].
-	///
-	/// An [`Atom` error] is generated if any `selection`, `target_type`, or
-	/// `property` do not refer to defined [atoms].
-	///
-	/// [window]: Window
-	/// [atoms]: Atom
-	/// [request]: crate::message::Request
-	///
-	/// [`Window` error]: error::Window
-	/// [`Atom` error]: error::Atom
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ConvertSelection: Request(24, ConvertSelectionError) {
-		/// Your [window] which is requesting this conversion.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub requester: Window,
-
-		/// The selection which this [request] asks to be converted.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		/// [request]: crate::message::Request
-		///
-		/// [`Atom` error]: error::Atom
-		pub selection: Atom,
-
-		/// The type which the selection should be converted into.
-		///
-		/// # Errors
-		/// An [`Atom` error] is generated if this does not refer to a defined
-		/// [atom].
-		///
-		/// [atom]: Atom
-		///
-		/// [`Atom` error]: error::Atom
-		pub target_type: Atom,
-		pub property: Option<Atom>,
-
-		/// The [time] at which this conversion is recorded as having taken
-		/// place.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-	}
-}
-
-request_error! {
-	pub enum SendEventError for SendEvent {
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that sends the given [event] to the given [window].
-	///
-	/// If the `event_mask` is empty, the [event] is sent to the client that
-	/// created the [window] - if that client no longer exists, the [event] is
-	/// not sent.
-	///
-	/// If `propagate` is `false`, the [event] is sent to every client selecting
-	/// any of the [events][event] indicated in the `event_mask`.
-	///
-	/// If `propagate` is `true` and no clients have selected any of the
-	/// [events][event] indicated in the `event_mask` on the [window], the
-	/// [event] is sent to the closest ancestor [window] of the [window] which
-	/// some client has selected at least one of the indicated [events][event]
-	/// for (provided no [windows][window] between the original destination and
-	/// the closest ancestor have that [event] in their
-	/// [`do_not_propagate_mask`]). The [event] is sent to every client
-	/// selecting any of the [events][event] indicated in the `event_mask` on
-	/// the final destination.
-	///
-	/// Active grabs are ignored for this [request].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `destination` is [`DestinationWindow::Other`] and the
-	/// specified [window] is not defined.
-	///
-	/// [window]: Window
-	/// [event]: Event
-	/// [request]: crate::message::Request
-	///
-	/// [`do_not_propagate_mask`]: Attributes::do_not_propagate_mask
-	///
-	/// [`Window` error]: error::Window
-	// FIXME: this requires that the event is absolutely 32 bytes, which is
-	//        currently not bounded.
-	//
-	// This feature would be nice for this:
-	// <https://github.com/rust-lang/rust/issues/92827>
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct SendEvent<E: Event + ConstantX11Size>: Request(25, SendEventError) {
-		/// Whether the `event` should be propagated to the closest appropriate
-		/// ancestor, if necessary.
-		///
-		/// That is, whether the `event` should be propagated to the closest
-		/// ancestor of the `destination` [window] which some client has
-		/// selected any of the [events] indicated in the `event_mask` on if no
-		/// clients have selected any of the [events] in the `event_mask` on the
-		/// `destination` [window].
-		///
-		/// [window]: Window
-		/// [events]: Event
-		#[metabyte]
-		pub propagate: bool,
-
-		/// The destination [window] for the `event`.
-		///
-		/// [window]: Window
-		pub destination: DestinationWindow,
-
-		/// The mask of [events][event] which should be selected for the [event]
-		/// to be sent to the selecting clients.
-		///
-		/// [event]: Event
-		pub event_mask: EventMask,
-
-		/// The [event] that is sent.
-		///
-		/// [event]: Event
-		pub event: E,
-	}
-}
-
-request_error! {
-	pub enum GrabCursorError for GrabCursor {
-		CursorAppearance,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that actively grabs control of the cursor.
-	///
-	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
-	///
-	/// # Replies
-	/// This [request] generates a [`GrabCursor` reply].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if either the `grab_window` or the
-	/// `confine_to` [window] do not refer to defined [windows][window].
-	///
-	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
-	/// [`Some`] and does not refer to a defined [cursor appearance].
-	///
-	/// [cursor appearance]: CursorAppearance
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`EnterWindow`]: super::event::EnterWindow
-	/// [`LeaveWindow`]: super::event::LeaveWindow
-	/// [`GrabCursor` reply]: reply::GrabCursor
-	///
-	/// [`Window` error]: error::Window
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[doc(alias = "GrabPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GrabCursor: Request(26, GrabCursorError) -> reply::GrabCursor {
-		/// Whether cursor [events] which would normally be reported to this
-		/// client are reported normally.
-		///
-		/// [events]: Event
-		#[metabyte]
-		pub owner_events: bool,
-
-		/// The [window] on which the cursor is grabbed.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// A mask of the cursor [events] which are to be reported to the
-		/// your client.
-		///
-		/// [events]: Event
-		pub event_mask: CursorEventMask,
-
-		/// The [freeze mode] applied to the cursor.
-		///
-		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
-		/// as normal.
-		///
-		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
-		/// freeze - cursor [events][event] generated during this time are not
-		/// lost: they are queued to be processed later. The freeze ends when
-		/// either the grabbing client sends an [`AllowEvents` request], or when
-		/// the cursor grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias("pointer_mode", "cursor_mode"))]
-		pub cursor_freeze: FreezeMode,
-		/// The [freeze mode] applied to the keyboard.
-		///
-		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
-		/// continues as normal.
-		///
-		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
-		/// to freeze - keyboard [events][event] generated during this time are
-		/// not lost: they are queued to be processed later. The freeze ends
-		/// when either the grabbing client sends an [`AllowEvents` request], or
-		/// when the keyboard grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "keyboard_mode")]
-		pub keyboard_freeze: FreezeMode,
-
-		/// Optionally confines the cursor to the given [window].
-		///
-		/// This [window] does not need to have any relation to the
-		/// `grab_window`.
-		///
-		/// The cursor will be warped to the closest edge of this [window] if it
-		/// is not already within it. Subsequent changes to the configuration of
-		/// the [window] which cause the cursor to be outside of the [window]
-		/// will also trigger the cursor to be warped to the [window] again.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`Some`] and does not
-		/// refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub confine_to: Option<Window>,
-
-		/// Optionally overrides the [appearance of the cursor], no matter which
-		/// [window] it is within, for the duration of the grab.
-		///
-		/// # Errors
-		/// A [`CursorAppearance` error] is generated if this does not refer to
-		/// a defined [cursor appearance].
-		///
-		/// [cursor appearance]: CursorAppearance
-		/// [appearance of the cursor]: CursorAppearance
-		/// [window]: Window
-		///
-		/// [`CursorAppearance` error]: error::CursorAppearance
-		#[doc(alias = "cursor")]
-		pub cursor_appearance: Option<CursorAppearance>,
-
-		/// The [time] at which this grab is recorded as having been initiated.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-	}
-
-	/// A [request] that ends an active cursor grab by your client.
-	///
-	/// Any queued [events] are released.
-	///
-	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
-	///
-	/// [request]: crate::message::Request
-	/// [events]: Event
-	///
-	/// [`EnterWindow`]: super::event::EnterWindow
-	/// [`LeaveWindow`]: super::event::LeaveWindow
-	#[doc(alias = "UngrabPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UngrabCursor: Request(27) {
-		/// The [time] at which the grab is recorded as having been released.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-	}
-}
-
-request_error! {
-	pub enum GrabButtonError for GrabButton {
-		Access,
-		CursorAppearance,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that establishes a passive cursor grab for a given `button`
-	/// and `modifiers` combination.
-	///
-	/// If the following conditions are true, the grab is converted into an
-	/// active cursor grab (as described in the [`GrabCursor` request]):
-	/// - the cursor is not already actively grabbed; and
-	/// - the specified `button` and specified `modifiers` are held; and
-	/// - the cursor is within the `grab_window`; and
-	/// - if the `confine_to` [window] is specified, it is viewable; and
-	/// - a passive grab for the same `button` and `modifiers` combination does
-	///   not exist for any ancestor of the `grab_window`.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if either the `grab_window` or the
-	/// `confine_to` [window] do not refer to defined [windows][window].
-	///
-	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
-	/// [`Some`] and does not refer to a defined [cursor appearance].
-	///
-	/// An [`Access` error] is generated if some other client has already sent a
-	/// `GrabButton` [request] with the same `button` and `modifiers`
-	/// combination on the same `grab_window`.
-	///
-	/// [cursor appearance]: CursorAppearance
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`GrabCursor` request]: GrabCursor
-	///
-	/// [`Access` error]: error::Access
-	/// [`Window` error]: error::Window
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GrabButton: Request(28, GrabButtonError) {
-		/// Whether cursor [events] which would normally be reported to this
-		/// client are reported normally.
-		///
-		/// [events]: Event
-		#[metabyte]
-		pub owner_events: bool,
-
-		/// The [window] on which the `button` is grabbed.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// A mask of the cursor [events] which are to be reported to the
-		/// grabbing client.
-		///
-		/// [events]: Event
-		pub event_mask: CursorEventMask,
-
-		/// The [freeze mode] applied to the cursor.
-		///
-		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
-		/// as normal.
-		///
-		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
-		/// freeze - cursor [events][event] generated during this time are not
-		/// lost: they are queued to be processed later. The freeze ends when
-		/// either the grabbing client sends an [`AllowEvents` request], or when
-		/// the cursor grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias("pointer_mode", "cursor_mode"))]
-		pub cursor_freeze: FreezeMode,
-		/// The [freeze mode] applied to the keyboard.
-		///
-		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
-		/// continues as normal.
-		///
-		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
-		/// to freeze - keyboard [events][event] generated during this time are
-		/// not lost: they are queued to be processed later. The freeze ends
-		/// when either the grabbing client sends an [`AllowEvents` request], or
-		/// when the keyboard grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "keyboard_mode")]
-		pub keyboard_freeze: FreezeMode,
-
-		/// Optionally confines the cursor to the given [window].
-		///
-		/// This [window] does not need to have any relation to the
-		/// `grab_window`.
-		///
-		/// The cursor will be warped to the closest edge of this [window] if it
-		/// is not already within it. Subsequent changes to the configuration of
-		/// the [window] which cause the cursor to be outside of the [window]
-		/// will also trigger the cursor to be warped to the [window] again.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`Some`] and does not
-		/// refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub confine_to: Option<Window>,
-
-		/// Optionally overrides the [appearance of the cursor], no matter which
-		/// [window] it is within, for the duration of the grab.
-		///
-		/// # Errors
-		/// A [`CursorAppearance` error] is generated if this does not refer to
-		/// a defined [cursor appearance].
-		///
-		/// [cursor appearance]: CursorAppearance
-		/// [appearance of the cursor]: CursorAppearance
-		/// [window]: Window
-		///
-		/// [`CursorAppearance` error]: error::CursorAppearance
-		pub cursor_appearance: Option<CursorAppearance>,
-
-		/// The [button] for which this grab is established.
-		///
-		/// [`Any`] means that the grab is effectively established for all
-		/// possible [buttons][button].
-		///
-		/// When this button and the given `modifiers`,
-		///
-		/// [button]: Button
-		///
-		/// [`Any`]: Any::Any
-		pub button: Any<Button>,
-		_,
-
-		/// The combination of modifiers which must be held for a press of the
-		/// `button` to activate the active cursor grab.
-		///
-		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
-		/// at all.
-		///
-		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
-		pub modifiers: AnyModifierKeyMask,
-	}
-}
-
-request_error! {
-	pub enum UngrabButtonError for UngrabButton {
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that releases a [passive button grab] on the specified
-	/// `grab_window` if the grab was established by your client.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `grab_window` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [passive button grab]: GrabButton
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UngrabButton: Request(29, UngrabButtonError) {
-		/// The [button] which the [passive button grab] was established for.
-		///
-		/// [`Any`] matches any `button` specified in the [passive button grab].
-		/// It is equivalent to sending this `UngrabButton` [request] for all
-		/// possible [buttons][button].
-		///
-		/// [button]: Button
-		/// [request]: crate::message::Request
-		///
-		/// [passive button grab]: GrabButton
-		///
-		/// [`Any`]: Any::Any
-		#[metabyte]
-		pub button: Any<Button>,
-
-		/// The [window] on which the [passive button grab] was established.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [passive button grab]: GrabButton
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// The modifier combination specified by the [passive button grab].
-		///
-		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
-		/// [passive button grab] (including no modifiers). It is equivalent to
-		/// sending this `UngrabButton` [request] for all possible `modifiers`
-		/// combinations.
-		///
-		/// [request]: crate::message::Request
-		///
-		/// [passive button grab]: GrabButton
-		///
-		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
-		pub modifiers: AnyModifierKeyMask,
-		[_; 2],
-	}
-}
-
-request_error! {
-	pub enum ChangeActiveCursorGrabError for ChangeActiveCursorGrab {
-		CursorAppearance,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that modifies the `event_mask` or `cursor_appearance` of an
-	/// [active cursor grab].
-	///
-	/// # Errors
-	/// A [`CursorAppearance` error] is generated if `cursor_appearance` does
-	/// not refer to a defined [cursor appearance].
-	///
-	/// [cursor appearance]: CursorAppearance
-	/// [request]: crate::message::Request
-	///
-	/// [active cursor grab]: GrabCursor
-	///
-	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[doc(alias = "ChangeActivePointerGrab")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ChangeActiveCursorGrab: Request(30, ChangeActiveCursorGrabError) {
-		/// Optionally overrides the [appearance of the cursor], no matter which
-		/// [window] it is within, for the duration of the grab.
-		///
-		/// This replaces the previously specified `cursor_appearance` for the
-		/// grab - [`None`] means that the `cursor_appearance` is no longer
-		/// overridden.
-		///
-		/// # Errors
-		/// A [`CursorAppearance` error] is generated if this does not refer to
-		/// a defined [cursor appearance].
-		///
-		/// [cursor appearance]: CursorAppearance
-		/// [appearance of the cursor]: CursorAppearance
-		/// [window]: Window
-		///
-		/// [`CursorAppearance` error]: error::CursorAppearance
-		#[doc(alias = "cursor")]
-		pub cursor_appearance: Option<CursorAppearance>,
-
-		/// The [time] at which this change is recorded as having taken place.
-		///
-		/// This must be later than the [time] of the last cursor grab, and
-		/// equal to or earlier than the X server's [current time].
-		///
-		/// [time]: crate::Timestamp
-		/// [current time]: CurrentableTime::CurrentTime
-		pub time: CurrentableTime,
-
-		/// A mask of the cursor [events] which are to be reported to the
-		/// your client.
-		///
-		/// [events]: Event
-		pub event_mask: CursorEventMask,
-		[_; 2],
-	}
-}
-
-request_error! {
-	pub enum GrabKeyboardError for GrabKeyboard {
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that actively grabs control of the keyboard.
-	///
-	/// This [request] generates [`Focus`] and [`Unfocus`] events.
-	///
-	/// # Replies
-	/// This [request] generates a [`GrabKeyboard` reply].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `grab_window` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Focus`]: super::event::Focus
-	/// [`Unfocus`]: super::event::Unfocus
-	///
-	/// [`GrabKeyboard` reply]: reply::GrabKeyboard
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GrabKeyboard: Request(31, GrabKeyboardError) -> reply::GrabKeyboard {
-		/// Whether key [events] which would normally be reported to this client
-		/// are reported normally.
-		///
-		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
-		/// matter what events you have selected.
-		///
-		/// [events]: Event
-		///
-		/// [`KeyPress`]: super::event::KeyPress
-		/// [`KeyRelease`]: super::event::KeyRelease
-		#[metabyte]
-		pub owner_events: bool,
-
-		/// The [window] on which the keyboard is grabbed.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// The [time] at which this grab is recorded as having been initiated.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-
-		/// The [freeze mode] applied to the cursor.
-		///
-		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
-		/// as normal.
-		///
-		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
-		/// freeze - cursor [events][event] generated during this time are not
-		/// lost: they are queued to be processed later. The freeze ends when
-		/// either the grabbing client sends an [`AllowEvents` request], or when
-		/// the cursor grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias("pointer_mode", "cursor_mode"))]
-		pub cursor_freeze: FreezeMode,
-		/// The [freeze mode] applied to the keyboard.
-		///
-		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
-		/// continues as normal.
-		///
-		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
-		/// to freeze - keyboard [events][event] generated during this time are
-		/// not lost: they are queued to be processed later. The freeze ends
-		/// when either the grabbing client sends an [`AllowEvents` request], or
-		/// when the keyboard grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "keyboard_mode")]
-		pub keyboard_freeze: FreezeMode,
-		[_; 2],
-	}
-
-	/// A [request] that ends an active keyboard grab by your client.
-	///
-	/// Any queued [events] are released.
-	///
-	/// This [request] generates [`Focus`] and [`Unfocus`] events.
-	///
-	/// [request]: crate::message::Request
-	/// [events]: Event
-	///
-	/// [`Focus`]: super::event::Focus
-	/// [`Unfocus`]: super::event::Unfocus
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UngrabKeyboard: Request(32) {
-		/// The [time] at which the grab is recorded as having been released.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-	}
-}
-
-request_error! {
-	pub enum GrabKeyError for GrabKey {
-		Access,
-		CursorAppearance,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that establishes a passive key grab for a particular `key`
-	/// and `modifiers` combination.
-	///
-	/// If the following conditions are true, the grab is converted into an
-	/// active keyboard grab (as described in the [`GrabKeyboard` request]):
-	/// - the keyboard is not already actively grabbed; and
-	/// - the specified `key` and specified `modifiers` are held; and
-	/// - either the `grab_window` is an ancestor, or is, the currently focused
-	///   [window], or the `grab_window` is a descendent of the currently
-	///   focused [window] and contains the cursor; and
-	/// - a passive grab for the same `key` and `modifiers` combination does
-	///   not exist for any ancestor of the `grab_window`.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `grab_window` does not refer to a
-	/// defined [window].
-	///
-	/// An [`Access` error] is generated if some other client has already sent a
-	/// `GrabKey` [request] with the same `key` and `modifiers` combination on
-	/// the same `grab_window`.
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`GrabKeyboard` request]: GrabKeyboard
-	///
-	/// [`Access` error]: error::Access
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GrabKey: Request(33, GrabKeyError) {
-		/// Whether key [events] which would normally be reported to this client
-		/// are reported normally.
-		///
-		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
-		/// matter what events you have selected.
-		///
-		/// [events]: Event
-		///
-		/// [`KeyPress`]: super::event::KeyPress
-		/// [`KeyRelease`]: super::event::KeyRelease
-		#[metabyte]
-		pub owner_events: bool,
-
-		/// The [window] on which the `key` is grabbed.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// The combination of modifiers which must be held for a press of the
-		/// `key` to activate the active key grab.
-		///
-		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
-		/// at all.
-		///
-		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
-		pub modifiers: AnyModifierKeyMask,
-		/// The key for which this grab is established.
-		///
-		/// [`Any`] means that the grab is effectively established for all
-		/// possible keys.
-		///
-		/// When this key and the given `modifiers`,
-		///
-		/// [button]: Button
-		///
-		/// [`Any`]: Any::Any
-		pub key: Any<Keycode>,
-
-		/// The [freeze mode] applied to the cursor.
-		///
-		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
-		/// as normal.
-		///
-		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
-		/// freeze - cursor [events][event] generated during this time are not
-		/// lost: they are queued to be processed later. The freeze ends when
-		/// either the grabbing client sends an [`AllowEvents` request], or when
-		/// the cursor grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias("pointer_mode", "cursor_mode"))]
-		pub cursor_freeze: FreezeMode,
-		/// The [freeze mode] applied to the keyboard.
-		///
-		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
-		/// continues as normal.
-		///
-		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
-		/// to freeze - keyboard [events][event] generated during this time are
-		/// not lost: they are queued to be processed later. The freeze ends
-		/// when either the grabbing client sends an [`AllowEvents` request], or
-		/// when the keyboard grab is released.
-		///
-		/// [event]: Event
-		/// [freeze mode]: FreezeMode
-		///
-		/// [`AllowEvents` request]: AllowEvents
-		#[doc(alias = "keyboard_mode")]
-		pub keyboard_freeze: FreezeMode,
-		[_; 3],
-	}
-}
-
-request_error! {
-	pub enum UngrabKeyError for UngrabKey {
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that releases a [passive key grab] on the specified
-	/// `grab_window` if the grab was established by your client.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `grab_window` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [passive key grab]: GrabKey
-	///
-	/// [`Window` error]: error::Window
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UngrabKey: Request(34, UngrabKeyError) {
-		/// The key which the [passive key grab] was established for.
-		///
-		/// [`Any`] matches any `key` specified in the [passive key grab].
-		/// It is equivalent to sending this `UngrabKey` [request] for all
-		/// possible keys.
-		///
-		/// [request]: crate::message::Request
-		///
-		/// [passive key grab]: GrabKey
-		///
-		/// [`Any`]: Any::Any
-		#[metabyte]
-		pub key: Any<Keycode>,
-
-		/// The [window] on which the [passive key grab] was established.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [passive key grab]: GrabKey
-		///
-		/// [`Window` error]: error::Window
-		pub grab_window: Window,
-
-		/// The modifier combination specified by the [passive key grab].
-		///
-		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
-		/// [passive key grab] (including no modifiers). It is equivalent to
-		/// sending this `UngrabKey` [request] for all possible `modifiers`
-		/// combinations.
-		///
-		/// [request]: crate::message::Request
-		///
-		/// [passive key grab]: GrabKey
-		///
-		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
-		pub modifiers: AnyModifierKeyMask,
-		[_; 2],
-	}
-}
-
-/// Specifies the conditions under which queued events should be released for an
-/// [`AllowEvents` request].
-///
-/// [`AllowEvents` request]: AllowEvents
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum AllowEventsMode {
-	/// Unfreezes the cursor if it is frozen and you have active grab on the
-	/// cursor.
-	UnfreezeCursor,
-	/// Unfreezes the cursor, but freezes it again after the next
-	/// [`ButtonPress`] or [`ButtonRelease`].
-	///
-	/// Your client must have an active grab on the cursor.
-	///
-	/// The cursor is frozen again specifically after the next [`ButtonPress`]
-	/// [`ButtonRelease`] event reported to your client which does not cause
-	/// grab to be released.
-	///
-	/// [`ButtonPress`]: super::event::ButtonPress
-	/// [`ButtonRelease`]: super::event::ButtonRelease
-	RefreezeCursor,
-	/// If the cursor is frozen as a result of the activation of a passive grab
-	/// or [`RefreezeCursor`] mode from your client, the grab is released and
-	/// the [event] is completely reprocessed.
-	///
-	/// [`RefreezeCursor`]: AllowEventsMode::RefreezeCursor
-	///
-	/// [event]: Event
-	ReplayCursor,
-
-	/// Unfreezes the keyboard if it is frozen and you have an active grab on
-	/// the keyboard.
-	UnfreezeKeyboard,
-	/// Unfreezes the keyboard, but freezes it again after the next
-	/// [`KeyPress`] or [`KeyPress`].
-	///
-	/// Your client must have an active grab on the keyboard.
-	///
-	/// The keyboard is frozen again specifically after the next [`KeyPress`]
-	/// [`KeyRelease`] event reported to your client which does not cause
-	/// grab to be released.
-	///
-	/// [`KeyPress`]: super::event::KeyPress
-	/// [`KeyRelease`]: super::event::KeyRelease
-	RefreezeKeyboard,
-	/// If the keyboard is frozen as a result of the activation of a passive
-	/// grab or [`RefreezeKeyboard`] mode from your client, the grab is released
-	/// and the [event] is completely reprocessed.
-	///
-	/// [`RefreezeKeyboard`]: AllowEventsMode::RefreezeKeyboard
-	///
-	/// [event]: Event
-	ReplayKeyboard,
-
-	/// If both the cursor and the keyboard are frozen by your client, both are
-	/// unfrozen.
-	UnfreezeBoth,
-	/// If both the cursor and the keyboard are frozen by your client, both are
-	/// unfrozen but are both frozen again on the next button or key press or
-	/// release event.
-	///
-	/// Any [`ButtonPress`], [`ButtonRelease`], [`KeyPress`], or [`KeyRelease`]
-	/// event reported to your client will unfreeze both the cursor and the
-	/// keyboard.
-	///
-	/// [`ButtonPress`]: super::event::ButtonPress
-	/// [`ButtonRelease`]: super::event::ButtonRelease
-	///
-	/// [`KeyPress`]: super::event::KeyPress
-	/// [`KeyRelease`]: super::event::KeyRelease
-	RefreezeBoth,
-}
-
-derive_xrb! {
-	/// A [request] that releases some queued events if your client has caused a
-	/// device to be [frozen].
-	///
-	/// [frozen]: FreezeMode::Frozen
-	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct AllowEvents: Request(35, error::Value) {
-		/// The conditions under which the queued [events] are released.
-		///
-		/// [events]: Event
-		#[metabyte]
-		pub mode: AllowEventsMode,
-
-		/// The [time] at which this `AllowEvents` [request] is recorded as
-		/// having taken place.
-		///
-		/// This [request] has no effect if this time is earlier than the time
-		/// of your most recent active grab or later than the X server's
-		/// [current time].
-		///
-		/// [request]: crate::message::Request
-		/// [time]: crate::Timestamp
-		/// [current time]: CurrentableTime::CurrentTime
-		pub time: CurrentableTime,
-	}
-
-	/// A [request] that freezes processing of [requests][request] and
-	/// connection closes on all other clients' connections.
-	///
-	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GrabServer: Request(36);
-
-	/// A [request] that unfreezes processing of [requests][request] and
-	/// connection closes on all other clients' connections.
-	///
-	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UngrabServer: Request(37);
-
-	/// A [request] that gets the current location of the cursor.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if the `target` does not refer to a
-	/// defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct QueryCursorLocation: Request(38, error::Window) -> reply::QueryCursorLocation {
-		/// Specifies a [window] to receive relative coordinates of the cursor
-		/// in relation to, if the cursor is on the same screen.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "window")]
-		pub target: Window,
-	}
-
-	/// A [request] that returns the recorded cursor motion between the given
-	/// `start` and `end` times.
-	///
-	/// The `start` and `end` times are inclusive.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "GetMotionEvents")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetMotionHistory: Request(39, error::Window) -> reply::GetMotionHistory {
-		/// The [window] for which the motion history is returned.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		pub target: Window,
-
-		/// The start of the time period for which motion events are returned.
-		///
-		/// This is inclusive.
-		pub start: CurrentableTime,
-		/// The end of the time period for which motion events are returned.
-		///
-		/// This is inclusive.
-		pub end: CurrentableTime,
-	}
-
-	/// A [request] that converts coordinates relative to the given `original`
-	/// [window] to `output_coords` relative to the given `output` [window].
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if either `original` or `output` do not
-	/// refer to defined [windows][window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "TranslateCoordinates")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ConvertCoordinates: Request(40, error::Window) -> reply::ConvertCoordinates {
-		/// The [window] which the `original_coords` are relative to.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias("src_window", "source", "input"))]
-		pub original: Window,
-		/// The [window] which the `output_coords` will be relative to.
-		///
-		/// The `original_coords` are converted to coordinates relative to the
-		/// top-left corner of this [window].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias("dst_window", "destination"))]
-		pub output: Window,
-
-		/// The coordinates, relative to the `original` [window]'s top-left
-		/// corner, which will be converted.
-		///
-		/// These coordinates will be converted such that the `output_coords`
-		/// are relative to the `output` [window].
-		///
-		/// [window]: Window
-		pub original_coords: Coords,
-	}
-}
-
-/// Represents dimensions within the `source` [window] of a
-/// [`WarpCursor` request].
-///
-/// [window]: Window
-///
-/// [`WarpCursor` request]: WarpCursor
-#[derive(Debug, Hash, PartialEq, Eq)]
-pub enum WarpSourceDimension {
-	/// Set the `source_width` to the width of the `source` [window] minus the x
-	/// coordinate or the `source_height` to the height of the `source` [window]
-	/// minus the y coordinate.
-	///
-	/// [window]: Window
-	FillRemaining,
-	/// This specific width or height.
-	Other(u16),
-}
-
-impl ConstantX11Size for WarpSourceDimension {
-	const X11_SIZE: usize = 2;
-}
-
-impl X11Size for WarpSourceDimension {
-	fn x11_size(&self) -> usize {
-		Self::X11_SIZE
-	}
-}
-
-impl Readable for WarpSourceDimension {
-	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
-	where
-		Self: Sized,
-	{
-		Ok(match buf.get_u16() {
-			zero if zero == 0 => Self::FillRemaining,
-			other => Self::Other(other),
-		})
-	}
-}
-
-impl Writable for WarpSourceDimension {
-	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-		match self {
-			Self::FillRemaining => buf.put_u16(0),
-			Self::Other(other) => other.write_to(buf)?,
-		}
-
-		Ok(())
-	}
-}
-
-derive_xrb! {
-	/// A [request] that instantly moves the cursor to a new location.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if either the `source` or the `destination` are [`Some`] and
-	/// do not refer to defined [windows].
-	///
-	/// [windows]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Window` error]: error::Window
-	#[doc(alias = "WarpPointer")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct WarpCursor: Request(41, error::Window) {
-		/// The [window] which the cursor is being warped from.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`Some`] but does not
-		/// refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias("src", "src_window"))]
-		pub source: Option<Window>,
-		/// The [window] which the cursor is being warped to.
-		///
-		/// If this is [`None`], the cursor is simply offset by the `coords`. If
-		/// this is [`Some`], the cursor is set to the `coords` relative to this
-		/// [window].
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`Some`] but does not
-		/// refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias("dst", "dst_window"))]
-		pub destination: Option<Window>,
-
-		/// The coordinates of the top-left corner of the rectangular area
-		/// within the `source` [window] which the cursor must be within for it
-		/// to be warped.
-		///
-		/// [window]: Window
-		#[doc(alias("src_coords", "src_x", "src_y", "source_x", "source_y"))]
-		pub source_coords: Coords,
-		/// The width of the rectangular area within the `source` [window] which
-		/// the cursor must be within for it to be warped.
-		///
-		/// [window]: Window
-		#[doc(alias = "src_width")]
-		pub source_width: WarpSourceDimension,
-		/// The height of the rectangular area within the `source` [window]
-		/// which the cursor must be within for it to be warped.
-		///
-		/// [window]: Window
-		#[doc(alias = "src_height")]
-		pub source_height: WarpSourceDimension,
-
-		/// The coordinates applied to the cursor.
-		///
-		/// If `destination` is [`None`], the cursor is offset by these
-		/// coordinates. Otherwise, the cursor is moved to these coordinates
-		/// relative to the `destination` [window].
-		///
-		/// [window]: Window
-		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
-		pub coords: Coords,
-	}
-}
-
-request_error! {
-	pub enum SetFocusError for SetFocus {
-		Match,
-		Value,
-		Window,
-	}
-}
-
-/// What the focus should revert to if the focused [window] becomes unviewable.
-///
-/// This is used in the [`SetFocus` request].
-///
-/// [window]: Window
-///
-/// [`SetFocus` request]: SetFocus
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum RevertFocus {
-	/// Revert the focus to no [window].
-	///
-	/// It is recommended to use [`CursorRoot`] in place of this, because at
-	/// least the root [window] will have focus with [`CursorRoot`].
-	///
-	/// [`CursorRoot`]: RevertFocus::CursorRoot
-	///
-	/// [window]: Window
-	None,
-
-	/// Revert the focus to the root [window] which the cursor is on at the
-	/// time.
-	///
-	/// [window]: Window
-	CursorRoot,
-	/// Revert the focus to the parent of the [window] which the cursor is in at
-	/// the time.
-	///
-	/// [window]: Window
-	Parent,
-}
-
-derive_xrb! {
-	/// A [request] that changes the current focus.
-	///
-	/// This [request] generates [`Focus`] and [`Unfocus`] events.
-	///
-	/// # Errors
-	/// A [`Match` error] is generated of the specified `new_focus` is not
-	/// viewable at the time of the [request].
-	///
-	/// A [`Window` error] is generated if `new_focus` is [`FocusWindow::Other`]
-	/// and does not refer to a defined [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`Focus`]: super::event::Focus
-	/// [`Unfocus`]: super::event::Unfocus
-	///
-	/// [`Match` error]: error::Match
-	/// [`Window` error]: error::Window
-	#[doc(alias("SetInputFocus", "Focus", "FocusWindow"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct SetFocus: Request(42, SetFocusError) {
-		/// What the focus should revert to if the focused [window] becomes
-		/// unviewable.
-		///
-		/// [window]: Window
-		#[metabyte]
-		pub revert_to: RevertFocus,
-
-		/// The new focus.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this is [`FocusWindow::Other`]
-		/// but does not refer to a defined [window].
-		///
-		/// [window]: Window
-		///
-		/// [`Window` error]: error::Window
-		#[doc(alias = "focus")]
-		pub new_focus: FocusWindow,
-
-		/// The [time] at which the focus is recorded as having changed.
-		///
-		/// [time]: crate::Timestamp
-		pub time: CurrentableTime,
-	}
-
-	/// A [request] that returns the current focus.
-	///
-	/// [request]: crate::message::Request
-	#[doc(alias = "GetInputFocus")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetFocus: Request(43) -> reply::GetFocus;
-
-	/// A [request] that returns a bit vector of the currently held keys on the
-	/// keyboard.
-	///
-	/// [request]: crate::message::Request
-	#[doc(alias = "QueryKeymap")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
-}
-
-request_error! {
-	pub enum AssignFontError for AssignFont {
-		ResourceIdChoice,
-		Name,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that associates the font by the given `name` with the given
-	/// `font_id`.
-	///
-	/// [request]: crate::message::Request
-	#[doc(alias("OpenFont", "CreateFont", "LoadFont", "AddFont"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct AssignFont: Request(45, AssignFontError) {
-		/// The [`Font` ID] to associate with the font specified by `name`.
-		///
-		/// [`Font` ID]: Font
-		pub font_id: Font,
-
-		// The length of `name`.
-		#[allow(clippy::cast_possible_truncation)]
-		let name_len: u16 = name => name.len() as u16,
-		[_; 2],
-
-		/// A pattern match against the name of the font.
-		///
-		/// The name uses ISO Latin-1 encoding.
-		///
-		/// The character `?` matches against any single character (equivalent
-		/// to `.` in regular expressions) and `*` matches against any number of
-		/// characters (like `.*` in regular expressions).
-		#[context(name_len => usize::from(*name_len))]
-		pub name: String8,
-		[_; name => pad(name)],
-	}
-
-	/// A [request] that removes the association between a given [`Font` ID] and
-	/// the font it is associated with.
-	///
-	/// [request]: crate::message::Request
-	/// [`Font` ID]: Font
-	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct UnassignFont: Request(46) {
-		/// The [`Font` ID] which is having its association with a font removed.
-		///
-		/// [`Font` ID]: Font
-		pub target: Font,
-	}
-
-	/// A [request] that returns information about the given `target`
-	/// font.
-	///
-	/// # Replies
-	/// This [request] generates a [`QueryFont` reply].
-	///
-	/// # Errors
-	/// A [`Font` error] is generated if the `target` does not refer to a
-	/// defined [`Font`] nor [`GraphicsContext`].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [`GraphicsContext`]: GraphicsContext
-	///
-	/// [`QueryFont` reply]: reply::QueryFont
-	///
-	/// [`Font` error]: error::Font
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct QueryFont: Request(47, error::Font) -> reply::QueryFont {
-		/// The font which this [request] returns information about.
-		///
-		/// # Errors
-		/// A [`Font` error] is generated if this does not refer to a defined
-		/// [`Font`] nor [`GraphicsContext`].
-		///
-		/// [request]: crate::message::Request
-		///
-		/// [`GraphicsContext`]: GraphicsContext
-		///
-		/// [`Font` error]: error::Font
-		pub target: Fontable,
-	}
-}
-
-/// A private function used in [`QueryTextExtents`] to determine padding.
-#[inline]
-const fn query_text_extents_padding(odd_length: bool) -> usize {
-	if odd_length {
-		2 // Char16::X11_SIZE
-	} else {
-		0
-	}
-}
-
-derive_xrb! {
-	/// A [request] that returns the extents of the given `text` when displayed
-	/// with the given `font`.
-	///
-	/// If the font has no specified `fallback_character`, undefined characters
-	/// in the `text` are ignored.
-	///
-	/// # Replies
-	/// This [request] generates a [`QueryTextExtents` reply].
-	///
-	/// # Errors
-	/// A [`Font` error] is generated if `font` does not refer to a defined
-	/// [`Font`] nor [`GraphicsContext`].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [`GraphicsContext`]: GraphicsContext
-	///
-	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
-	///
-	/// [`Font` error]: error::Font
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct QueryTextExtents: Request(48, error::Font) -> reply::QueryTextExtents {
-		// Whether `text` is of odd length. Is it is, it has 2 bytes of padding
-		// following it.
-		#[metabyte]
-		let odd_length: bool = text => text.len() % 2 != 0,
-
-		/// The font used in the `text`.
-		///
-		/// # Errors
-		/// A [`Font` error] is generated if this does not refer to a defined
-		/// [`Font`] nor [`GraphicsContext`].
-		///
-		/// [`GraphicsContext`]: GraphicsContext
-		///
-		/// [`Font` error]: error::Font
-		pub font: Fontable,
-
-		/// The text for which this [request] gets the extents when displayed
-		/// with `font`.
-		///
-		/// [request]: crate::message::Request
-		#[context(self::remaining, odd_length => {
-			// We remove the padding at the end, which can be determined from `odd_length`.
-			let remaining = remaining - query_text_extents_padding(*odd_length);
-
-			// We then divide the length, which is the number of bytes, by the number of bytes
-			// per character.
-			remaining / Char16::X11_SIZE
-		})]
-		pub text: String16,
-		[_; odd_length => query_text_extents_padding(*odd_length)]
-	}
-
-	/// A [request] that lists the names of available fonts (as controlled by
-	/// the [font search path]).
-	///
-	/// # Replies
-	/// This [request] generates a [`ListFonts` reply].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [font search path]: SetFontSearchDirectories
-	///
-	/// [`ListFonts` reply]: reply::ListFonts
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ListFonts: Request(49) -> reply::ListFonts {
-		/// The maximum number of names that will appear in the returned font
-		/// `names`.
-		#[doc(alias("max_names", "max_names_len"))]
-		pub max_names_count: u16,
-
-		#[allow(clippy::cast_possible_truncation)]
-		let pattern_len: u16 = pattern => pattern.len() as u16,
-		/// A pattern match against the font names.
-		///
-		/// The case (uppercase or lowercase) of the pattern does not matter:
-		/// font names are converted to lowercase, as is the pattern.
-		///
-		/// Font names use ISO Latin-1 encoding.
-		///
-		/// The character `?` matches against any single character (equivalent
-		/// to `.` in regular expressions) and `*` matches against any number of
-		/// characters (like `.*` in regular expressions).
-		#[context(pattern_len => usize::from(*pattern_len))]
-		pub pattern: String8,
-		[_; pattern => pad(pattern)],
-	}
-
-	/// A [request] that lists available fonts (as controlled by the
-	/// [font search path]) with information about them.
-	///
-	/// The information returned for each font almost entirely matches that
-	/// returned in a [`QueryFont` reply].
-	///
-	/// # Replies
-	/// This [request] generates [`ListFontsWithInfo` replies].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [font search path]: SetFontSearchDirectories
-	///
-	/// [`ListFontsWithInfo` replies]: reply::ListFontsWithInfo
-	/// [`QueryFont` reply]: reply::QueryFont
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ListFontsWithInfo: Request(50) -> reply::ListFontsWithInfo {
-		/// The maximum number of [`FontWithInfo` replies] that will be returned.
-		///
-		/// [`FontWithInfo` replies]: reply::FontWithInfo
-		#[doc(alias("max_names", "max_names_len"))]
-		pub max_fonts_count: u16,
-
-		#[allow(clippy::cast_possible_truncation)]
-		let pattern_len: u16 = pattern => pattern.len() as u16,
-		/// A pattern match against the font names.
-		///
-		/// The case (uppercase or lowercase) of the pattern does not matter:
-		/// font names are converted to lowercase, as is the pattern.
-		///
-		/// Font names use ISO Latin-1 encoding.
-		///
-		/// The character `?` matches against any single character (equivalent
-		/// to `.` in regular expressions) and `*` matches against any number of
-		/// characters (like `.*` in regular expressions).
-		#[context(pattern_len => usize::from(*pattern_len))]
-		pub pattern: String8,
-		[_; pattern => pad(pattern)],
-	}
-
-	/// A [request] that defines the directories which are searched for
-	/// available fonts.
-	///
-	/// # Errors
-	/// A [`Value` error] is generated if the operating system rejects the given
-	/// paths for whatever reason.
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [`Value` error]: error::Value
-	#[doc(alias = "SetFontPath")]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetFontSearchDirectories: Request(51, error::Value) {
-		// The length of `directories`.
-		#[allow(clippy::cast_possible_truncation)]
-		let directories_len: u16 = directories => directories.len() as u16,
-		[_; 2],
-
-		/// The directories to be searched in the order listed.
-		///
-		/// Specifying an empty list here restores the default font search
-		/// directories defined for the X server.
-		#[doc(alias = "path")]
-		#[context(directories_len => usize::from(*directories_len))]
-		pub directories: Vec<LengthString8>,
-		[_; directories => pad(directories)],
-	}
-
-	/// A [request] that returns the current directories which are searched to
-	/// find available fonts.
-	///
-	/// See also: [`SetFontSearchDirectories`].
-	///
-	/// [request]: crate::message::Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
-}
-
-request_error! {
-	pub enum CreatePixmapError for CreatePixmap {
-		Drawable,
-		ResourceIdChoice,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that creates a new [pixmap] and assigns the provided
-	/// [`Pixmap` ID][pixmap] to it.
-	///
-	/// The initial contents of the [pixmap] are undefined.
-	///
-	/// # Errors
-	/// A [`Value` error] is generated if `depth` is not a depth supported by
-	/// the `drawable`'s root [window].
-	///
-	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
-	/// already used for another resource, or an ID not allocated to your
-	/// client.
-	///
-	/// A [`Drawable` error] is generated if `drawable` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [request]: crate::message::Request
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	/// [`Value` error]: error::Value
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CreatePixmap: Request(53, CreatePixmapError) {
-		/// The depth of the [pixmap].
-		///
-		/// # Errors
-		/// A [`Value` error] is generated if this depth is not supported by the
-		/// root [window] of the `drawable`.
-		///
-		/// [pixmap]: Pixmap
-		/// [window]: Window
-		///
-		/// [`Value` error]: error::Value
-		#[metabyte]
-		pub depth: u8,
-
-		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
-		///
-		/// # Errors
-		/// A [`ResourceIdChoice` error] is generated if this resource ID is
-		/// already used or if it isn't allocated to your client.
-		///
-		/// [pixmap]: Pixmap
-		///
-		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-		#[doc(alias = "pid")]
-		pub pixmap_id: Pixmap,
-		// TODO: what is this for??
-		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
-		/// [request].
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		/// [drawable]: Drawable
-		/// [request]: crate::message::Request
-		///
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Drawable` error]: error::Drawable
-		pub drawable: Drawable,
-
-		/// The width of the [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		pub width: Px<u16>,
-		/// The height of the [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		pub height: Px<u16>,
-	}
-
-	/// A [request] that removes the association between a given
-	/// [`Pixmap` ID][pixmap] and the [pixmap] it is associated with.
-	///
-	/// The stored [pixmap] will be freed when it is no longer referenced by any
-	/// other resource.
-	///
-	/// # Errors
-	/// A [`Pixmap` error] is generated if `target` does not refer to a defined
-	/// [pixmap].
-	///
-	/// [pixmap]: Pixmap
-	/// [request]: crate::message::Request
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct FreePixmap: Request(54, error::Pixmap) {
-		/// The [pixmap] which is to have its association with its ID removed.
-		///
-		/// # Errors
-		/// A [`Pixmap` error] is generated if this does not refer to a defined
-		/// [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		///
-		/// [`Pixmap` error]: error::Pixmap
-		#[doc(alias = "pixmap")]
-		pub target: Pixmap,
-	}
-}
-
-request_error! {
-	pub enum CreateGraphicsContextError for GraphicsContext {
-		Drawable,
-		Font,
-		ResourceIdChoice,
-		Match,
-		Pixmap,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that creates a new [`GraphicsContext`] and assigns the
-	/// provided [`GraphicsContext` ID] to it.
-	///
-	/// # Errors
-	/// A [`ResourceIdChoice` error] is generated if `graphics_context_id`
-	/// specifies an ID already used for another resource, or an ID which is not
-	/// allocated to your client.
-	///
-	/// A [`Drawable` error] is generated if `drawable` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// [pixmap]: Pixmap
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`GraphicsContext` ID]: GraphicsContext
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	/// [`Drawable` error]: error::Drawable
-	#[doc(alias("CreateGc", "CreateGC", "CreateGcontext", "CreateGContext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
-		/// The [`GraphicsContext` ID] which is to be assigned to the
-		/// [`GraphicsContext`].
-		///
-		/// # Errors
-		/// A [`ResourceIdChoice` error] is generated if this resource ID is
-		/// already used or if it isn't allocated to your client.
-		///
-		/// [`GraphicsContext` ID]: GraphicsContext
-		///
-		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-		#[doc(alias("cid", "gid", "gcid", "context_id"))]
-		pub graphics_context_id: GraphicsContext,
-
-		/// > *<sup>TODO</sup>*\
-		/// > ***We don't yet understand what this field is for. If you have any
-		/// > ideas, please feel free to open an issue or a discussion on the
-		/// > [GitHub repo]!***
-		/// >
-		/// > [GitHub repo]: https://github.com/XdotRS/xrb/
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		pub drawable: Drawable,
-
-		/// The [graphics options] used in graphics operations when this
-		/// [`GraphicsContext`] is provided.
-		///
-		/// These [graphics options] may be later configured through the
-		/// [`SetDashes` request], [`SetClipRectangles` request], and the
-		/// [`ChangeGraphicsOptions` request].
-		///
-		/// [graphics options]: GraphicsOptions
-		///
-		/// [`SetDashes` request]: SetDashes
-		/// [`SetClipRectangles` request]: SetClipRectangles
-		/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
-		#[doc(alias("values", "value_mask", "value_list"))]
-		#[doc(alias("options", "option_mask", "option_list"))]
-		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
-		pub graphics_options: GraphicsOptions,
-	}
-}
-
-request_error! {
-	pub enum ChangeGraphicsOptionsError for ChangeGraphicsOptions {
-		Font,
-		GraphicsContext,
-		Match,
-		Pixmap,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that changes the [graphics options] configured in a
-	/// [`GraphicsContext`].
-	///
-	/// Changing the [`clip_mask`] overrides any [`SetClipRectangles` request]
-	/// on the [`GraphicsContext`].
-	///
-	/// Changing [`dash_offset`] or [`dashes`] overrides any
-	/// [`SetDashes` request] on the [`GraphicsContext`].
-	///
-	/// The [`SetDashes` request] allows an alternating pattern of dashes to be
-	/// configured, while configuring [`dashes`] with this [request] does not.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [graphics options]: GraphicsOptions
-	///
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	/// [`dashes`]: GraphicsOptions::dashes
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	/// [`SetDashes` request]: SetDashes
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("ChangeGc", "ChangeGC", "ChangeGraphicsContext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ChangeGraphicsOptions: Request(56, ChangeGraphicsOptionsError) {
-		/// The [`GraphicsContext`] for which this [request] changes its
-		/// [graphics options].
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [graphics options]: GraphicsOptions
-		/// [request]: crate::message::Request
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "graphics_context", "context"))]
-		pub target: GraphicsContext,
-
-		/// The changes which are made to the `target`'s [graphics options].
-		///
-		/// [graphics options]: GraphicsOptions
-		#[doc(alias("values", "value_mask", "value_list"))]
-		#[doc(alias("options", "option_mask", "option_list"))]
-		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
-		pub changed_options: GraphicsOptions,
-	}
-}
-
-request_error! {
-	pub enum CopyGraphicsOptionsError for CopyGraphicsOptions {
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that copies the specified [graphics options] from the
-	/// `source` [`GraphicsContext`] into the `destination` [`GraphicsContext`].
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if either the `source` or the
-	/// `destination` do not refer to defined [`GraphicsContext`s].
-	///
-	/// A [`Match` error] is generated if the `source` and the `destination` do
-	/// not have the same root [window] and depth.
-	///
-	/// [graphics options]: GraphicsOptions
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`GraphicsContext`s]: GraphicsContext
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
-	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
-		/// The [`GraphicsContext`] from which the [options] specified in
-		/// `options_mask` are copied.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `destination`.
-		///
-		/// [options]: GraphicsOptions
-		/// [window]: Window
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		/// [`Match` error]: error::Match
-		#[doc(alias("src_gc", "source_graphics_context", "src"))]
-		pub source: GraphicsContext,
-		/// The [`GraphicsContext`] into which the [options] specified in
-		/// `options_mask` are copied from the `source`.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `source`.
-		///
-		/// [options]: GraphicsOptions
-		/// [window]: Window
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		/// [`Match` error]: error::Match
-		#[doc(alias("dst_gc", "destination_graphics_context", "dst"))]
-		pub destination: GraphicsContext,
-
-		/// A mask that specifies which options are copied from the `source`
-		/// into the `destination`.
-		#[doc(alias("value_mask"))]
-		pub options_mask: GraphicsOptionsMask,
-	}
-}
-
-request_error! {
-	pub enum SetDashesError for SetDashes {
-		GraphicsContext,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that sets the [`dash_offset`] and the pattern of dashes on a
-	/// [`GraphicsContext`].
-	///
-	/// Configuring [`dashes`] or [`dash_offset`] with a
-	/// [`ChangeGraphicsOptions` request] overrides the effects of this
-	/// [request].
-	///
-	/// Configuring [`dashes`] with a [`ChangeGraphicsOptions` request] does not
-	/// allow an alternating pattern of dashes to be specified; this [request]
-	/// does.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [`dashes`]: GraphicsOptions::dashes
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	///
-	/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetDashes: Request(58, SetDashesError) {
-		/// The [`GraphicsContext`] on which this [request] configures its
-		/// dashes.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [request]: crate::message::Request
-		pub target: GraphicsContext,
-
-		/// The offset from the endpoints or joinpoints of a dashed line before
-		/// the dashes are drawn.
-		pub dash_offset: Px<u16>,
-
-		// The length of `dashes`.
-		#[allow(clippy::cast_possible_truncation)]
-		let dashes_len: u16 = dashes => dashes.len() as u16,
-		/// The pattern of dashes used when drawing dashed lines.
-		///
-		/// Each element represents the length of a dash in the pattern,
-		/// measured in pixels. A `dashes` list of odd length is appended to
-		/// itself to produce a list of even length.
-		#[context(dashes_len => usize::from(*dashes_len))]
-		pub dashes: Vec<Px<u8>>,
-		[_; dashes => pad(dashes)],
-	}
-}
-
-request_error! {
-	pub enum SetClipRectanglesError for SetClipRectangles {
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-/// Specifies the ordering of [rectangles] given by `clip_rectangles` in a
-/// [`SetClipRectangles` request].
-///
-/// [rectangles]: Rectangle
-///
-/// [`SetClipRectangles` request]: SetClipRectangles
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum ClipRectanglesOrdering {
-	/// No particular order is specified.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are given in no particular order.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	Unsorted,
-
-	/// [Rectangles][rectangles] are ordered by their y coordinate.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high.
-	///
-	/// The ordering among [rectangles] with equal y coordinates is not
-	/// specified.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	SortedByY,
-
-	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
-	/// and secondarily by their x coordinate.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high, and those of equal y are sorted by their x coordinate from low
-	/// to high.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	SortedByYx,
-
-	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
-	/// secondarily by their x coordinate, and each one which intersects a given
-	/// y coordinate has an equal y coordinate and height.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high, those of equal y are sorted by their x coordinate from low to
-	/// high, and every [rectangle] which intersects a given y coordinate is
-	/// guaranteed to have the same y coordinate and height as every other
-	/// intersecting [rectangle][rectangles].
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	BandedByYx,
-}
-
-derive_xrb! {
-	/// A [request] that configures the clip mask of a [`GraphicsContext`] using
-	/// a list of [rectangles].
-	///
-	/// This [request] also sets the [`clip_x`] and [`clip_y`] of the clip mask.
-	/// The coordinates used in the [rectangles] are relative to the [`clip_x`]
-	/// and [`clip_y`].
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [rectangles]: Rectangle
-	/// [request]: crate::message::Request
-	///
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetClipRectangles: Request(59, SetClipRectanglesError) {
-		/// Specifies the ordering of [rectangles] within `clip_rectangles`.
-		///
-		/// See [`ClipRectanglesOrdering`] for more information.
-		///
-		/// [rectangles]: Rectangle
-		#[metabyte]
-		pub ordering: ClipRectanglesOrdering,
-
-		/// The [`GraphicsContext`] on which this [request] configures its clip
-		/// mask.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [request]: crate::message::Request
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		pub target: GraphicsContext,
-
-		/// The x coordinate of the top-left corner of the clip mask.
-		///
-		/// This is relative to the top-left corner of the destination
-		/// [drawable] used in a particular graphics operation.
-		///
-		/// The coordinates used in the [rectangles] in `clip_rectangles` are
-		/// relative to this x coordinate.
-		///
-		/// [drawable]: Drawable
-		/// [rectangles]: Rectangle
-		pub clip_x: Px<i16>,
-		/// The y coordinate of the top-left corner of the clip mask.
-		///
-		/// This is relative to the top-left corner of the destination
-		/// [drawable] used in a particular graphics operation.
-		///
-		/// The coordinates used in the [rectangles] in `clip_rectangles` are
-		/// relative to this y coordinate.
-		///
-		/// [drawable]: Drawable
-		/// [rectangles]: Rectangle
-		pub clip_y: Px<i16>,
-
-		/// A list of non-overlapping [rectangles] that are used to mask the
-		/// effects of a graphics operation.
-		///
-		/// These [rectangles] specify the areas within which the effects of a
-		/// graphics operation are applied.
-		///
-		/// If this list is empty, graphics operations will have no graphical
-		/// effect.
-		///
-		/// [rectangles]: Rectangle
-		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
-		pub clip_rectangles: Vec<Rectangle>,
-	}
-
-	/// A [request] that deletes the given [`GraphicsContext`].
-	///
-	/// The association between the [`GraphicsContext` ID] and the
-	/// [`GraphicsContext`] itself is removed in the process.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: crate::message::Request
-	///
-	/// [`GraphicsContext` ID]: GraphicsContext
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("FreeGc", "FreeGC", "FreeGcontext", "FreeGraphicsContext"))]
-	#[doc(alias("DestroyGc", "DestroyGC", "DestroyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
-		/// The [`GraphicsContext`] which is to be deleted.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "graphics_context", "context", "gcontext"))]
-		pub target: GraphicsContext,
-	}
-}
-
-request_error! {
-	pub enum ClearAreaError for ClearArea {
-		Match,
-		Value,
-		Window,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that clears a particular area of a [window].
-	///
-	/// If the [window] has a defined background ([`background_pixmap`] or
-	/// [`background_color`], the `area` is replaced by that background.
-	/// Otherwise, in the background is [`None`], the contents are not changed.
-	///
-	/// # Errors
-	/// A [`Window` error] is generated if `target` does not refer to a defined
-	/// [window].
-	///
-	/// A [`Match` error] is generated if the `target` is an [`InputOnly`]
-	/// [window].
-	///
-	/// [window]: Window
-	/// [request]: crate::message::Request
-	///
-	/// [`background_pixmap`]: Attributes::background_pixmap
-	/// [`background_color`]: Attributes::background_color
-	///
-	/// [`InputOnly`]: WindowClass::InputOnly
-	///
-	/// [`Window` error]: error::Window
-	/// [`Match` error]: error::Match
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ClearArea: Request(61, ClearAreaError) {
-		/// Whether [`GraphicsExposure` events] should be generated for regions
-		/// of the `area` which are visible or maintained.
-		///
-		/// [`GraphicsExposure` events]: super::event::GraphicsExposure
-		#[metabyte]
-		pub graphics_exposure: bool,
-
-		/// The [window] which this [request] clears an area of.
-		///
-		/// # Errors
-		/// A [`Window` error] is generated if this does not refer to a defined
-		/// [window].
-		///
-		/// A [`Match` error] is generated if this is an [`InputOnly`] [window].
-		///
-		/// [window]: Window
-		/// [request]: crate::message::Request
-		///
-		/// [`InputOnly`]: WindowClass::InputOnly
-		///
-		/// [`Window` error]: error::Window
-		/// [`Match` error]: error::Match
-		pub target: Window,
-
-		/// The area of the `target` [window] which is cleared.
-		///
-		/// The `x` and `y` coordinates are relative to the top-left corner of
-		/// the `target` [window].
-		///
-		/// [window]: Window
-		pub area: Rectangle,
-	}
-}
-
-request_error! {
-	pub enum CopyAreaError for CopyArea {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that copies an area of the given `source` [drawable] into
-	/// the given `destination` [drawable].
-	///
-	/// [Regions][regions] of the `source` that are obscured and have not been
-	/// [maintained], as well as [regions] specified by `source_coords` and
-	/// `dimensions` fall outside of the `source` itself, are not copied. If the
-	/// `destination` has a background, however, and those [regions] of the
-	/// `source` which are not copied correspond to [regions] of the
-	/// `destination` which are visible or [maintained], those [regions] will be
-	/// filled with the `destination`'s background. If the `graphics_context`'s
-	/// [`graphics_exposure`] is `true`, [`GraphicsExposure` events] will be
-	/// generated for those [regions] (or a [`NoExposure` event] if none are
-	/// generated).
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`child_mode`]
-	/// - [`graphics_exposure`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if either `source` or `destination` do
-	/// not refer to defined [windows] nor [pixmaps].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [drawable]: Drawable
-	/// [windows]: Window
-	/// [pixmaps]: Pixmap
-	/// [regions]: crate::Region
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [maintained]: crate::MaintainContents
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_y
-	///
-	/// [`GraphicsExposure` events]: super::event::GraphicsExposure
-	/// [`NoExposure` event]: super::event::NoExposure
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CopyArea: Request(62, CopyAreaError) {
-		/// The [drawable] from which the area is copied.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `destination`.
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		/// [`Match` error]: error::Match
-		pub source: Drawable,
-		/// The [drawable] into which the area is copied.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `destination`.
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		/// [`Match` error]: error::Match
-		pub destination: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		pub graphics_context: GraphicsContext,
-
-		/// The coordinates of the area which is copied from the `source`
-		/// [drawable].
-		///
-		/// These coordinates are relative to the top-left corner of the
-		/// `source`, and specify the top-left corner of the area which is
-		/// copied.
-		///
-		/// [drawable]: Drawable
-		pub source_coords: Coords,
-		/// The coordinates at which the copied area will be placed within the
-		/// `destination` [drawable].
-		///
-		/// These coordinates are relative to the top-left corner of the
-		/// `destination`, and specify what the top-left corner of the copied
-		/// area will be when it has been copied.
-		///
-		/// [drawable]: Drawable
-		pub destination_coords: Coords,
-
-		/// The dimensions of the area that is copied.
-		pub dimensions: Dimensions,
-	}
-}
-
-request_error! {
-	#[doc(alias("CopyPlaneError"))]
-	pub enum CopyBitPlaneError for CopyBitPlane {
-		Drawable,
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that copies a [region] of the `source` [drawable], masked by the given
-	/// `bit_plane`, and filled according to the [`foreground_color`] and [`background_color`] in
-	/// the `graphics_context`.
-	///
-	/// Effectively, a [pixmap] with the given `dimensions` and the same depth
-	/// as the `destination` [drawable] is created. It is filled with the
-	/// [`foreground_color`] where the `bit_plane` in the `source` [drawable]
-	/// contains a bit set to 1, and [`background_color`] where the `bit_plane`
-	/// in the `source` [drawable] contains a bit set to 0.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`child_mode`]
-	/// - [`graphics_exposure`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if either the `source` or the
-	/// `destination` do not refer to defined [windows][window] nor
-	/// [pixmaps][pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if the `graphics_context` does
-	/// not refer to a defined [`GraphicsContext`].
-	///
-	/// A [`Match` error] is generated if the `source` [drawable] does not have
-	/// the same root [window] as the `destination` [drawable].
-	///
-	/// A [`Value` error] is generated if the `bit_plane` does not have exactly
-	/// one bit set to 1, or if the value of the `bit_plane` is not less than
-	/// 2<sup>`depth`</sup>, where `depth` is the `source` [drawable]'s depth.
-	///
-	/// [drawable]: Drawable
-	/// [pixmap]: Pixmap
-	/// [window]: Window
-	/// [region]: crate::Region
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
-	/// [`Value` error]: error::Value
-	#[doc(alias("CopyPlane"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CopyBitPlane: Request(63, CopyBitPlaneError) {
-		/// The [drawable] used as the source in this graphics operation.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] as the `destination`.
-		///
-		/// [drawable]: Drawable
-		/// [pixmap]: Pixmap
-		/// [window]: Window
-		///
-		/// [`Drawable` error]: error::Drawable
-		/// [`Match` error]: error::Match
-		#[doc(alias("src", "src_drawable", "source_drawable"))]
-		pub source: Drawable,
-		/// The [drawable] which the filled [region] is copied into.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] as the `source`.
-		///
-		/// [region]: crate::Region
-		/// [drawable]: Drawable
-		/// [pixmap]: Pixmap
-		/// [window]: Window
-		///
-		/// [`Drawable` error]: error::Drawable
-		/// [`Match` error]: error::Match
-		#[doc(alias("dst", "dst_drawable", "destination_drawable"))]
-		pub destination: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The coordinates of the [region] within the `source` [drawable] which
-		/// is used.
-		///
-		/// These coordinates are relative to the top-left corner of the
-		/// `source`, and specify the top-left corner of the [region] which is
-		/// copied.
-		///
-		/// [region]: crate::Region
-		/// [drawable]: Drawable
-		#[doc(alias("src_x", "src_y", "source_x", "source_y", "src_coords"))]
-		pub source_coords: Coords,
-		/// The coordinates at which the copied [region] will be placed within
-		/// the `destination` [drawable].
-		///
-		/// These coordinates are relative to the top-left corner of the
-		/// `destination`, and specify what the top-left corner of the copied
-		/// [region] will be when it has been copied.
-		///
-		/// [region]: crate::Region
-		/// [drawable]: Drawable
-		#[doc(alias("dst_x", "dst_y", "destination_x", "destination_y", "dst_coords"))]
-		pub destination_coords: Coords,
-
-		/// The dimensions of the [region] that is copied.
-		///
-		/// [region]: crate::Region
-		#[doc(alias("width", "height"))]
-		pub dimensions: Dimensions,
-
-		/// The bit plane that is copied.
-		///
-		/// Exactly one bit must be set and the value must be less than
-		/// 2<sup>`depth`</sup>, where `depth` is the depth of the `source`
-		/// [drawable].
-		///
-		/// # Errors
-		/// A [`Value` error] is generated if this does not have exactly one bit
-		/// set to 1, or if this value is not less than 2<sup>`depth`</sup>,
-		/// where `depth` is the depth of the `source` [drawable].
-		///
-		/// [drawable]: Drawable
-		///
-		/// [`Value` error]: error::Value
-		pub bit_plane: u32,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyPointError", "DrawPointError"))]
-	pub enum DrawPointsError for DrawPoints {
-		Drawable,
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-/// Whether [coordinates] of elements to be drawn in graphics operations are
-/// relative to the [drawable] or the previous element.
-///
-/// The first element is always relative to the [drawable].
-///
-/// [coordinates]: Coords
-/// [drawable]: Drawable
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum CoordinateMode {
-	/// [Coordinates] are relative to the top-left corner of the [drawable].
-	///
-	/// [Coordinates]: Coords
-	/// [drawable]: Drawable
-	Drawable,
-
-	/// [Coordinates][coords] are relative to the [coordinates][coords] of the
-	/// previous element.
-	///
-	/// [coords]: Coords
-	Previous,
-}
-
-derive_xrb! {
-	/// A [request] that draws the given `points` on the `target` [drawable].
-	///
-	/// The points are drawn by combining the `graphics_context`'s
-	/// [`foreground_color`] with the existing color at those coordinates in the
-	/// [drawable]. They are drawn in the order that they are specified in the
-	/// list.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`foreground_color`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [drawable]: Drawable
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
-	#[doc(alias("PolyPoint", "DrawPoint"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DrawPoints: Request(64, DrawPointsError) {
-		/// Whether the `points` are drawn relative to the `target` or the
-		/// previously drawn point.
-		///
-		/// The first point is always drawn relative to the `target`.
-		///
-		/// See [`CoordinateMode`] for more information.
-		#[metabyte]
-		pub coordinate_mode: CoordinateMode,
-
-		/// The [drawable] on which the given `points` are drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The points which are to be drawn.
-		///
-		/// Each point is represented by its [coordinates].
-		///
-		/// The points are drawn in the order that they appear in the list.
-		///
-		/// Each point is drawn by combining the [`foreground_color`] with the
-		/// existing color of the pixel at the point's [coordinates].
-		///
-		/// [coordinates]: Coords
-		///
-		/// [`foreground_color`]: GraphicsOptions::foreground_color
-		#[context(self::remaining => remaining / Coords::X11_SIZE)]
-		pub points: Vec<Coords>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyLineError", "DrawLinesError", "DrawLineError"))]
-	pub enum DrawPathError for DrawPath {
-		Drawable,
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that draws a path comprised of lines that join the given
-	/// `points`.
-	///
-	/// The lines are drawn in the order that the points appear in `points`.
-	/// They join at each intermediate point. If the first and last points are
-	/// in the same location, they are also joined to create a closed path (with
-	/// no endpoints).
-	///
-	/// Intersecting [thin] lines have their intersecting pixels drawn multiple
-	/// times. Intersecting [thick] lines, however, only have their intersecting
-	/// pixels drawn once.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`line_width`]
-	/// - [`line_style`]
-	/// - [`cap_style`]
-	/// - [`join_style`]
-	/// - [`fill_style`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	/// - [`dash_offset`]
-	/// - [`dashes`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [thin]: crate::set::LineWidth::Thin
-	/// [thick]: crate::set::LineWidth::Thick
-	///
-	/// [drawable]: Drawable
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`line_width`]: GraphicsOptions::line_width
-	/// [`line_style`]: GraphicsOptions::line_style
-	/// [`cap_style`]: GraphicsOptions::cap_style
-	/// [`join_style`]: GraphicsOptions::join_style
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	/// [`dashes`]: GraphicsOptions::dashes
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolyLine", "DrawLines", "DrawLine"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DrawPath: Request(65, DrawPathError) {
-		/// Whether the [coordinates] of each point in `points` are relative to
-		/// the `target` or to the previous point.
-		///
-		/// The first point is always relative to the `target` [drawable].
-		///
-		/// [coordinates]: Coords
-		/// [drawable]: Drawable
-		#[metabyte]
-		pub coordinate_mode: CoordinateMode,
-
-		/// The [drawable] on which the path is drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The points which are to be connected by lines.
-		///
-		/// Each point is represented by its [coordinates].
-		///
-		/// The points are connected by lines in the order that they appear in
-		/// this list.
-		///
-		/// [coordinates]: Coords
-		#[context(self::remaining => remaining / Coords::X11_SIZE)]
-		pub points: Vec<Coords>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolySegmentError", "DrawSegmentError"))]
-	pub enum DrawLinesError for DrawLines {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-/// A line from the given `start` point to the given `end` point.
-#[doc(alias("Segment"))]
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-pub struct Line {
-	/// The start of the line.
-	pub start: Coords,
-	/// The end of the line.
-	pub end: Coords,
-}
-
-derive_xrb! {
-	/// A [request] that draws the given `lines`.
-	///
-	/// No join points are created. Intersecting [lines] have their intersecting
-	/// pixels drawn multiple times.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`line_width`]
-	/// - [`line_style`]
-	/// - [`cap_style`]
-	/// - [`fill_style`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	/// - [`dash_offset`]
-	/// - [`dashes`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [drawable]: Drawable
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [lines]: Line
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`line_width`]: GraphicsOptions::line_width
-	/// [`line_style`]: GraphicsOptions::line_style
-	/// [`cap_style`]: GraphicsOptions::cap_style
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	/// [`dashes`]: GraphicsOptions::dashes
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolySegment", "DrawSegment"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DrawLines: Request(66, DrawLinesError) {
-		/// The [drawable] on which the given `lines` are drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The lines which are to be drawn.
-		///
-		/// The lines are drawn in the order that they appear in this list.
-		#[context(self::remaining => remaining / Line::X11_SIZE)]
-		pub lines: Vec<Line>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyRectangleError"))]
-	pub enum DrawRectanglesError for DrawRectangles {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that draws the outlines of the given `rectangles`.
-	///
-	/// The outlines are drawn as [lines] connecting each corner of the
-	/// [rectangles], starting at the top-left corner and going clockwise, with
-	/// a join point at each corner - thus forming a closed path.
-	///
-	/// If any of the given `rectangles` intersect, the intersecting pixels are
-	/// drawn multiple times.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`line_width`]
-	/// - [`line_style`]
-	/// - [`cap_style`]
-	/// - [`join_style`]
-	/// - [`fill_style`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	/// - [`dash_offset`]
-	/// - [`dashes`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [lines]: Line
-	/// [rectangles]: Rectangle
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`line_width`]: GraphicsOptions::line_width
-	/// [`line_style`]: GraphicsOptions::line_style
-	/// [`cap_style`]: GraphicsOptions::cap_style
-	/// [`join_style`]: GraphicsOptions::join_style
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	/// [`dashes`]: GraphicsOptions::dashes
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolyRectangle"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DrawRectangles: Request(67, DrawRectanglesError) {
-		/// The [drawable] on which the `rectangles`' outlines are drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The [rectangles] which are to have their outlines drawn.
-		///
-		/// Their `x` and `y` coordinates are relative to the top-left corner of
-		/// the `target` [drawable].
-		///
-		/// The [rectangles] are drawn in the order that they appear in this
-		/// list.
-		///
-		/// [rectangles]: Rectangle
-		/// [drawable]: Drawable
-		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
-		pub rectangles: Vec<Rectangle>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyArcError"))]
-	pub enum DrawArcsError for DrawArcs {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that draws circular or elliptical [arcs][arc].
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`line_width`]
-	/// - [`line_style`]
-	/// - [`cap_style`]
-	/// - [`join_style`]
-	/// - [`fill_style`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	/// - [`dash_offset`]
-	/// - [`dashes`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [arc]: Arc
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`line_width`]: GraphicsOptions::line_width
-	/// [`line_style`]: GraphicsOptions::line_style
-	/// [`cap_style`]: GraphicsOptions::cap_style
-	/// [`join_style`]: GraphicsOptions::join_style
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	/// [`dashes`]: GraphicsOptions::dashes
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolyArc"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DrawArcs: Request(68, DrawArcsError) {
-		/// The [drawable] on which the [arcs] are drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [arcs]: Arc
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The [arcs][arc] which are to be drawn.
-		///
-		/// If the last point in an [arc] is in the same location as the first
-		/// point in the next [arc], the two [arcs][arc] are joined with a
-		/// joinpoint. If the last point of the last [arc] and the first point
-		/// of the first [arc] are in the same location, they will also be
-		/// joined.
-		///
-		/// [arc]: Arc
-		#[context(self::remaining => remaining / Arc::X11_SIZE)]
-		pub arcs: Vec<Arc>,
-	}
-}
-
-request_error! {
-	#[doc(alias("FillPolyError"))]
-	pub enum FillPolygonError for FillPolygon {
-		Drawable,
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-/// Specifies properties of a polygon that may allow for optimizations when
-/// drawing it.
-///
-/// This is used in the [`FillPolygon` request].
-///
-/// [`FillPolygon` request]: FillPolygon
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum ShapeMode {
-	/// The shape may intersect itself.
-	Complex,
-
-	/// The shape may not intersect itself, but it is not (fully) convex.
-	///
-	/// If these properties are known to be true by the client, specifying this
-	/// mode may improve performance over [`Complex`](ShapeMode::Complex).
-	Nonconvex,
-
-	/// The shape may not intersect itself and it is convex.
-	///
-	/// Convex means that no [line] could be drawn between two points in the
-	/// shape which intersects the shape's path.
-	///
-	/// If these properties are known to be true by the client, specifying this
-	/// mode may improve performance over [`Nonconvex`](ShapeMode::Nonconvex).
-	///
-	/// [line]: Line
-	Convex,
-}
-
-derive_xrb! {
-	/// A [request] that fills the area enclosed the given path.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`fill_style`]
-	/// - [`fill_rule`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`fill_rule`]: GraphicsOptions::fill_rule
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("FillPoly"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct FillPolygon: Request(69, FillPolygonError) {
-		/// The [drawable] on which the filled polygon is drawn.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// Specifies whether the polygon self-intersects and whether it is
-		/// convex.
-		///
-		/// If the relevant properties of the specified polygon are known by the
-		/// client, specifying a more restrictive [shape mode] may improve
-		/// performance.
-		///
-		/// See [`ShapeMode`] for more information.
-		///
-		/// [shape mode]: ShapeMode
-		pub shape: ShapeMode,
-		/// Whether the [coordinates] of each point in `points` are relative to
-		/// the `target` or to the previous point.
-		///
-		/// The first point is always relative to the `target` [drawable].
-		///
-		/// [coordinates]: Coords
-		/// [drawable]: Drawable
-		pub coordinate_mode: CoordinateMode,
-		[_; 2],
-
-		/// The points which, when connected, specify the path of the polygon.
-		///
-		/// Each point is represented by its [coordinates].
-		///
-		/// The points are connected in the order that they appear in this list.
-		/// If the last point is not in the same location as the first point, it
-		/// is automatically connected to the first point to close the path.
-		///
-		/// [coordinates]: Coords
-		#[context(self::remaining => remaining / Coords::X11_SIZE)]
-		pub points: Vec<Coords>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyFillRectangleError"))]
-	pub enum FillRectanglesError for FillRectangles {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that fills the given `rectangles`.
-	///
-	/// This is effectively the same as if a [`FillPolygon` request] were sent
-	/// for each [rectangle] with the [rectangle]'s four points, starting with
-	/// the top-left corner and going clockwise.
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`fill_style`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [rectangle]: Rectangle
-	/// [request]: crate::message::Request
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	///
-	/// [`FillPolygon` request]: FillPolygon
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolyFillRectangle"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct FillRectangles: Request(70, FillRectanglesError) {
-		/// The [drawable] on which the [rectangles] are filled.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		/// [rectangles]: Rectangle
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The [rectangles] which are to be filled.
-		///
-		/// The [rectangles] are filled in the order that they appear in this
-		/// list. For intersecting [rectangles], the intersecting pixels are
-		/// drawn multiple times.
-		///
-		/// [rectangles]: Rectangle
-		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
-		pub rectangles: Vec<Rectangle>,
-	}
-}
-
-request_error! {
-	#[doc(alias("PolyFillArcError"))]
-	pub enum FillArcsError for FillArcs {
-		Drawable,
-		GraphicsContext,
-		Match,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that fills the given `arcs`.
-	///
-	/// If the `graphics_context`'s [`arc_mode`] is [`ArcMode::Chord`], the
-	/// [arcs][arc] are filled by joining each [arc]'s endpoints with a single
-	/// [line]. If the [`arc_mode`] is [`ArcMode::PieSlice`], however, the
-	/// [arcs][arc] are filled by joining each [arc]'s endpoints with the center
-	/// of that [arc], thus using two [lines][line].
-	///
-	/// # Graphics options used
-	/// This [request] uses the following [options] of the `graphics_context`:
-	/// - [`function`]
-	/// - [`plane_mask`]
-	/// - [`fill_style`]
-	/// - [`arc_mode`]
-	/// - [`child_mode`]
-	/// - [`clip_x`]
-	/// - [`clip_y`]
-	/// - [`clip_mask`]
-	///
-	/// This [request] may also use these [options], depending on the
-	/// configuration of the `graphics_context`:
-	/// - [`foreground_color`]
-	/// - [`background_color`]
-	/// - [`tile`]
-	/// - [`stipple`]
-	/// - [`tile_stipple_x`]
-	/// - [`tile_stipple_y`]
-	///
-	/// # Errors
-	/// A [`Drawable` error] is generated if `target` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
-	/// refer to a defined [`GraphicsContext`].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [options]: GraphicsOptions
-	/// [arc]: Arc
-	/// [line]: Line
-	/// [request]: crate::message::Request
-	///
-	/// [`ArcMode::Chord`]: crate::set::ArcMode::Chord
-	/// [`ArcMode::PieSlice`]: crate::set::ArcMode::PieSlice
-	///
-	/// [`function`]: GraphicsOptions::function
-	/// [`plane_mask`]: GraphicsOptions::plane_mask
-	/// [`fill_style`]: GraphicsOptions::fill_style
-	/// [`arc_mode`]: GraphicsOptions::arc_mode
-	/// [`child_mode`]: GraphicsOptions::child_mode
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	///
-	/// [`foreground_color`]: GraphicsOptions::foreground_color
-	/// [`background_color`]: GraphicsOptions::background_color
-	/// [`tile`]: GraphicsOptions::tile
-	/// [`stipple`]: GraphicsOptions::stipple
-	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
-	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("PolyFillArc"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct FillArcs: Request(71, FillArcsError) {
-		/// The [drawable] on which the [arcs] are filled.
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		/// [arcs]: Arc
-		///
-		/// [`Drawable` error]: error::Drawable
-		#[doc(alias("drawable"))]
-		pub target: Drawable,
-
-		/// The [`GraphicsContext`] used in this graphics operation.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "context", "gcontext"))]
-		pub graphics_context: GraphicsContext,
-
-		/// The [arcs] which are to be filled.
-		///
-		/// The [arcs] are filled in the order that they appear in this list. If
-		/// there are intersecting [arcs], the intersecting pixels will be drawn
-		/// multiple times.
-		///
-		/// [arcs]: Arc
-		#[context(self::remaining => remaining / Arc::X11_SIZE)]
-		pub arcs: Vec<Arc>,
-	}
-}
+// TODO: should these modules be private and re-exported, or public?
+//       or public and also re-exported?
+
+pub use color::*;
+pub use font::*;
+pub use graphics::*;
+pub use input::*;
+pub use meta::*;
+pub use miscellaneous::*;
+pub use window::*;
+
+pub mod color;
+pub mod font;
+pub mod graphics;
+pub mod input;
+pub mod meta;
+pub mod miscellaneous;
+pub mod window;
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
new file mode 100644
index 00000000..175cd091
--- /dev/null
+++ b/src/x11/request/color.rs
@@ -0,0 +1,10 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to colors.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
diff --git a/src/x11/request/font.rs b/src/x11/request/font.rs
new file mode 100644
index 00000000..84c0aacf
--- /dev/null
+++ b/src/x11/request/font.rs
@@ -0,0 +1,320 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to fonts.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk::{pad, ConstantX11Size};
+use xrbk_macro::derive_xrb;
+
+use crate::{
+	x11::{error, reply},
+	Char16,
+	Font,
+	Fontable,
+	LengthString8,
+	String16,
+	String8,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum AssignFontError for AssignFont {
+		ResourceIdChoice,
+		Name,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that associates the font by the given `name` with the given
+	/// `font_id`.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias("OpenFont", "CreateFont", "LoadFont", "AddFont"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AssignFont: Request(45, AssignFontError) {
+		/// The [`Font` ID] to associate with the font specified by `name`.
+		///
+		/// [`Font` ID]: Font
+		pub font_id: Font,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// A pattern match against the name of the font.
+		///
+		/// The name uses ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+
+	/// A [request] that removes the association between a given [`Font` ID] and
+	/// the font it is associated with.
+	///
+	/// [request]: crate::message::Request
+	/// [`Font` ID]: Font
+	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UnassignFont: Request(46) {
+		/// The [`Font` ID] which is having its association with a font removed.
+		///
+		/// [`Font` ID]: Font
+		pub target: Font,
+	}
+
+	/// A [request] that returns information about the given `target`
+	/// font.
+	///
+	/// # Replies
+	/// This [request] generates a [`QueryFont` reply].
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if the `target` does not refer to a
+	/// defined [`Font`] nor [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`]: crate::GraphicsContext
+	///
+	/// [`QueryFont` reply]: reply::QueryFont
+	///
+	/// [`Font` error]: error::Font
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct QueryFont: Request(47, error::Font) -> reply::QueryFont {
+		/// The font which this [request] returns information about.
+		///
+		/// # Errors
+		/// A [`Font` error] is generated if this does not refer to a defined
+		/// [`Font`] nor [`GraphicsContext`].
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext`]: crate::GraphicsContext
+		///
+		/// [`Font` error]: error::Font
+		pub target: Fontable,
+	}
+}
+
+/// A private function used in [`QueryTextExtents`] to
+/// determine padding.
+#[inline]
+const fn query_text_extents_padding(odd_length: bool) -> usize {
+	if odd_length {
+		2 // Char16::X11_SIZE
+	} else {
+		0
+	}
+}
+
+derive_xrb! {
+	/// A [request] that returns the extents of the given `text` when displayed
+	/// with the given `font`.
+	///
+	/// If the font has no specified `fallback_character`, undefined characters
+	/// in the `text` are ignored.
+	///
+	/// # Replies
+	/// This [request] generates a [`QueryTextExtents` reply].
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if `font` does not refer to a defined
+	/// [`Font`] nor [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`]: crate::GraphicsContext
+	///
+	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
+	///
+	/// [`Font` error]: error::Font
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryTextExtents: Request(48, error::Font) -> reply::QueryTextExtents {
+		// Whether `text` is of odd length. Is it is, it has 2 bytes of padding
+		// following it.
+		#[metabyte]
+		let odd_length: bool = text => text.len() % 2 != 0,
+
+		/// The font used in the `text`.
+		///
+		/// # Errors
+		/// A [`Font` error] is generated if this does not refer to a defined
+		/// [`Font`] nor [`GraphicsContext`].
+		///
+		/// [`GraphicsContext`]: crate::GraphicsContext
+		///
+		/// [`Font` error]: error::Font
+		pub font: Fontable,
+
+		/// The text for which this [request] gets the extents when displayed
+		/// with `font`.
+		///
+		/// [request]: crate::message::Request
+		#[context(self::remaining, odd_length => {
+			// We remove the padding at the end, which can be determined from `odd_length`.
+			let remaining = remaining - query_text_extents_padding(*odd_length);
+
+			// We then divide the length, which is the number of bytes, by the number of bytes
+			// per character.
+			remaining / Char16::X11_SIZE
+		})]
+		pub text: String16,
+		[_; odd_length => query_text_extents_padding(*odd_length)]
+	}
+
+	/// A [request] that lists the names of available fonts (as controlled by
+	/// the [font search path]).
+	///
+	/// # Replies
+	/// This [request] generates a [`ListFonts` reply].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [font search path]: SetFontSearchDirectories
+	///
+	/// [`ListFonts` reply]: reply::ListFonts
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListFonts: Request(49) -> reply::ListFonts {
+		/// The maximum number of names that will appear in the returned font
+		/// `names`.
+		#[doc(alias("max_names", "max_names_len"))]
+		pub max_names_count: u16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let pattern_len: u16 = pattern => pattern.len() as u16,
+		/// A pattern match against the font names.
+		///
+		/// The case (uppercase or lowercase) of the pattern does not matter:
+		/// font names are converted to lowercase, as is the pattern.
+		///
+		/// Font names use ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(pattern_len => usize::from(*pattern_len))]
+		pub pattern: String8,
+		[_; pattern => pad(pattern)],
+	}
+
+	/// A [request] that lists available fonts (as controlled by the
+	/// [font search path]) with information about them.
+	///
+	/// The information returned for each font almost entirely matches that
+	/// returned in a [`QueryFont` reply].
+	///
+	/// # Replies
+	/// This [request] generates [`ListFontsWithInfo` replies].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [font search path]: SetFontSearchDirectories
+	///
+	/// [`ListFontsWithInfo` replies]: reply::ListFontsWithInfo
+	/// [`QueryFont` reply]: reply::QueryFont
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListFontsWithInfo: Request(50) -> reply::ListFontsWithInfo {
+		/// The maximum number of [`FontWithInfo` replies] that will be returned.
+		///
+		/// [`FontWithInfo` replies]: reply::FontWithInfo
+		#[doc(alias("max_names", "max_names_len"))]
+		pub max_fonts_count: u16,
+
+		#[allow(clippy::cast_possible_truncation)]
+		let pattern_len: u16 = pattern => pattern.len() as u16,
+		/// A pattern match against the font names.
+		///
+		/// The case (uppercase or lowercase) of the pattern does not matter:
+		/// font names are converted to lowercase, as is the pattern.
+		///
+		/// Font names use ISO Latin-1 encoding.
+		///
+		/// The character `?` matches against any single character (equivalent
+		/// to `.` in regular expressions) and `*` matches against any number of
+		/// characters (like `.*` in regular expressions).
+		#[context(pattern_len => usize::from(*pattern_len))]
+		pub pattern: String8,
+		[_; pattern => pad(pattern)],
+	}
+
+	/// A [request] that defines the directories which are searched for
+	/// available fonts.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if the operating system rejects the given
+	/// paths for whatever reason.
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`Value` error]: error::Value
+	#[doc(alias = "SetFontPath")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetFontSearchDirectories: Request(51, error::Value) {
+		// The length of `directories`.
+		#[allow(clippy::cast_possible_truncation)]
+		let directories_len: u16 = directories => directories.len() as u16,
+		[_; 2],
+
+		/// The directories to be searched in the order listed.
+		///
+		/// Specifying an empty list here restores the default font search
+		/// directories defined for the X server.
+		#[doc(alias = "path")]
+		#[context(directories_len => usize::from(*directories_len))]
+		pub directories: Vec<LengthString8>,
+		[_; directories => pad(directories)],
+	}
+
+	/// A [request] that returns the current directories which are searched to
+	/// find available fonts.
+	///
+	/// See also: [`SetFontSearchDirectories`].
+	///
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
+}
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
new file mode 100644
index 00000000..a1dc9b50
--- /dev/null
+++ b/src/x11/request/graphics.rs
@@ -0,0 +1,1998 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to graphics
+//! operations.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk::{pad, ConstantX11Size};
+use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
+
+use crate::{
+	set::{GraphicsOptions, GraphicsOptionsMask},
+	unit::Px,
+	x11::{error, reply},
+	Arc,
+	Coords,
+	Dimensions,
+	Drawable,
+	GraphicsContext,
+	Pixmap,
+	Rectangle,
+	Window,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum CreatePixmapError for CreatePixmap {
+		Drawable,
+		ResourceIdChoice,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [pixmap] and assigns the provided
+	/// [`Pixmap` ID][pixmap] to it.
+	///
+	/// The initial contents of the [pixmap] are undefined.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if `depth` is not a depth supported by
+	/// the `drawable`'s root [window].
+	///
+	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
+	/// already used for another resource, or an ID not allocated to your
+	/// client.
+	///
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [request]: crate::message::Request
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Value` error]: error::Value
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CreatePixmap: Request(53, CreatePixmapError) {
+		/// The depth of the [pixmap].
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this depth is not supported by the
+		/// root [window] of the `drawable`.
+		///
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Value` error]: error::Value
+		#[metabyte]
+		pub depth: u8,
+
+		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias = "pid")]
+		pub pixmap_id: Pixmap,
+		// TODO: what is this for??
+		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
+		/// [request].
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [drawable]: Drawable
+		/// [request]: crate::message::Request
+		///
+		/// [`InputOnly`]: crate::WindowClass::InputOnly
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub drawable: Drawable,
+
+		/// The width of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub width: Px<u16>,
+		/// The height of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub height: Px<u16>,
+	}
+
+	/// A [request] that removes the association between a given
+	/// [`Pixmap` ID][pixmap] and the [pixmap] it is associated with.
+	///
+	/// The stored [pixmap] will be freed when it is no longer referenced by any
+	/// other resource.
+	///
+	/// # Errors
+	/// A [`Pixmap` error] is generated if `target` does not refer to a defined
+	/// [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [request]: crate::message::Request
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct FreePixmap: Request(54, error::Pixmap) {
+		/// The [pixmap] which is to have its association with its ID removed.
+		///
+		/// # Errors
+		/// A [`Pixmap` error] is generated if this does not refer to a defined
+		/// [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Pixmap` error]: error::Pixmap
+		#[doc(alias = "pixmap")]
+		pub target: Pixmap,
+	}
+}
+
+request_error! {
+	pub enum CreateGraphicsContextError for GraphicsContext {
+		Drawable,
+		Font,
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [`GraphicsContext`] and assigns the
+	/// provided [`GraphicsContext` ID] to it.
+	///
+	/// # Errors
+	/// A [`ResourceIdChoice` error] is generated if `graphics_context_id`
+	/// specifies an ID already used for another resource, or an ID which is not
+	/// allocated to your client.
+	///
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Drawable` error]: error::Drawable
+	#[doc(alias("CreateGc", "CreateGC", "CreateGcontext", "CreateGContext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
+		/// The [`GraphicsContext` ID] which is to be assigned to the
+		/// [`GraphicsContext`].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [`GraphicsContext` ID]: GraphicsContext
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias("cid", "gid", "gcid", "context_id"))]
+		pub graphics_context_id: GraphicsContext,
+
+		/// > *<sup>TODO</sup>*\
+		/// > ***We don't yet understand what this field is for. If you have any
+		/// > ideas, please feel free to open an issue or a discussion on the
+		/// > [GitHub repo]!***
+		/// >
+		/// > [GitHub repo]: https://github.com/XdotRS/xrb/
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub drawable: Drawable,
+
+		/// The [graphics options] used in graphics operations when this
+		/// [`GraphicsContext`] is provided.
+		///
+		/// These [graphics options] may be later configured through the
+		/// [`SetDashes` request], [`SetClipRectangles` request], and the
+		/// [`ChangeGraphicsOptions` request].
+		///
+		/// [graphics options]: GraphicsOptions
+		///
+		/// [`SetDashes` request]: SetDashes
+		/// [`SetClipRectangles` request]: SetClipRectangles
+		/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
+		pub graphics_options: GraphicsOptions,
+	}
+}
+
+request_error! {
+	pub enum ChangeGraphicsOptionsError for ChangeGraphicsOptions {
+		Font,
+		GraphicsContext,
+		Match,
+		Pixmap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the [graphics options] configured in a
+	/// [`GraphicsContext`].
+	///
+	/// Changing the [`clip_mask`] overrides any [`SetClipRectangles` request]
+	/// on the [`GraphicsContext`].
+	///
+	/// Changing [`dash_offset`] or [`dashes`] overrides any
+	/// [`SetDashes` request] on the [`GraphicsContext`].
+	///
+	/// The [`SetDashes` request] allows an alternating pattern of dashes to be
+	/// configured, while configuring [`dashes`] with this [request] does not.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [graphics options]: GraphicsOptions
+	///
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	/// [`SetDashes` request]: SetDashes
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("ChangeGc", "ChangeGC", "ChangeGraphicsContext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeGraphicsOptions: Request(56, ChangeGraphicsOptionsError) {
+		/// The [`GraphicsContext`] for which this [request] changes its
+		/// [graphics options].
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [graphics options]: GraphicsOptions
+		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context"))]
+		pub target: GraphicsContext,
+
+		/// The changes which are made to the `target`'s [graphics options].
+		///
+		/// [graphics options]: GraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
+		pub changed_options: GraphicsOptions,
+	}
+}
+
+request_error! {
+	pub enum CopyGraphicsOptionsError for CopyGraphicsOptions {
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies the specified [graphics options] from the
+	/// `source` [`GraphicsContext`] into the `destination` [`GraphicsContext`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if either the `source` or the
+	/// `destination` do not refer to defined [`GraphicsContext`s].
+	///
+	/// A [`Match` error] is generated if the `source` and the `destination` do
+	/// not have the same root [window] and depth.
+	///
+	/// [graphics options]: GraphicsOptions
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext`s]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
+		/// The [`GraphicsContext`] from which the [options] specified in
+		/// `options_mask` are copied.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("src_gc", "source_graphics_context", "src"))]
+		pub source: GraphicsContext,
+		/// The [`GraphicsContext`] into which the [options] specified in
+		/// `options_mask` are copied from the `source`.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `source`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("dst_gc", "destination_graphics_context", "dst"))]
+		pub destination: GraphicsContext,
+
+		/// A mask that specifies which options are copied from the `source`
+		/// into the `destination`.
+		#[doc(alias("value_mask"))]
+		pub options_mask: GraphicsOptionsMask,
+	}
+}
+
+request_error! {
+	pub enum SetDashesError for SetDashes {
+		GraphicsContext,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that sets the [`dash_offset`] and the pattern of dashes on a
+	/// [`GraphicsContext`].
+	///
+	/// Configuring [`dashes`] or [`dash_offset`] with a
+	/// [`ChangeGraphicsOptions` request] overrides the effects of this
+	/// [request].
+	///
+	/// Configuring [`dashes`] with a [`ChangeGraphicsOptions` request] does not
+	/// allow an alternating pattern of dashes to be specified; this [request]
+	/// does.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	///
+	/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetDashes: Request(58, SetDashesError) {
+		/// The [`GraphicsContext`] on which this [request] configures its
+		/// dashes.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [request]: crate::message::Request
+		pub target: GraphicsContext,
+
+		/// The offset from the endpoints or joinpoints of a dashed line before
+		/// the dashes are drawn.
+		pub dash_offset: Px<u16>,
+
+		// The length of `dashes`.
+		#[allow(clippy::cast_possible_truncation)]
+		let dashes_len: u16 = dashes => dashes.len() as u16,
+		/// The pattern of dashes used when drawing dashed lines.
+		///
+		/// Each element represents the length of a dash in the pattern,
+		/// measured in pixels. A `dashes` list of odd length is appended to
+		/// itself to produce a list of even length.
+		#[context(dashes_len => usize::from(*dashes_len))]
+		pub dashes: Vec<Px<u8>>,
+		[_; dashes => pad(dashes)],
+	}
+}
+
+request_error! {
+	pub enum SetClipRectanglesError for SetClipRectangles {
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies the ordering of [rectangles] given by `clip_rectangles` in a
+/// [`SetClipRectangles` request].
+///
+/// [rectangles]: Rectangle
+///
+/// [`SetClipRectangles` request]: SetClipRectangles
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ClipRectanglesOrdering {
+	/// No particular order is specified.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are given in no particular order.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	Unsorted,
+
+	/// [Rectangles][rectangles] are ordered by their y coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high.
+	///
+	/// The ordering among [rectangles] with equal y coordinates is not
+	/// specified.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByY,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// and secondarily by their x coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, and those of equal y are sorted by their x coordinate from low
+	/// to high.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByYx,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// secondarily by their x coordinate, and each one which intersects a given
+	/// y coordinate has an equal y coordinate and height.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, those of equal y are sorted by their x coordinate from low to
+	/// high, and every [rectangle][rectangles] which intersects a given y
+	/// coordinate is guaranteed to have the same y coordinate and height as
+	/// every other intersecting [rectangle][rectangles].
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	BandedByYx,
+}
+
+derive_xrb! {
+	/// A [request] that configures the clip mask of a [`GraphicsContext`] using
+	/// a list of [rectangles].
+	///
+	/// This [request] also sets the [`clip_x`] and [`clip_y`] of the clip mask.
+	/// The coordinates used in the [rectangles] are relative to the [`clip_x`]
+	/// and [`clip_y`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [rectangles]: Rectangle
+	/// [request]: crate::message::Request
+	///
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetClipRectangles: Request(59, SetClipRectanglesError) {
+		/// Specifies the ordering of [rectangles] within `clip_rectangles`.
+		///
+		/// See [`ClipRectanglesOrdering`] for more information.
+		///
+		/// [rectangles]: Rectangle
+		#[metabyte]
+		pub ordering: ClipRectanglesOrdering,
+
+		/// The [`GraphicsContext`] on which this [request] configures its clip
+		/// mask.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		pub target: GraphicsContext,
+
+		/// The x coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this x coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_x: Px<i16>,
+		/// The y coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this y coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_y: Px<i16>,
+
+		/// A list of non-overlapping [rectangles] that are used to mask the
+		/// effects of a graphics operation.
+		///
+		/// These [rectangles] specify the areas within which the effects of a
+		/// graphics operation are applied.
+		///
+		/// If this list is empty, graphics operations will have no graphical
+		/// effect.
+		///
+		/// [rectangles]: Rectangle
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub clip_rectangles: Vec<Rectangle>,
+	}
+
+	/// A [request] that deletes the given [`GraphicsContext`].
+	///
+	/// The association between the [`GraphicsContext` ID] and the
+	/// [`GraphicsContext`] itself is removed in the process.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: crate::message::Request
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("FreeGc", "FreeGC", "FreeGcontext", "FreeGraphicsContext"))]
+	#[doc(alias("DestroyGc", "DestroyGC", "DestroyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
+		/// The [`GraphicsContext`] which is to be deleted.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context", "gcontext"))]
+		pub target: GraphicsContext,
+	}
+}
+
+request_error! {
+	pub enum ClearAreaError for ClearArea {
+		Match,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that clears a particular area of a [window].
+	///
+	/// If the [window] has a defined background ([`background_pixmap`] or
+	/// [`background_color`], the `area` is replaced by that background.
+	/// Otherwise, in the background is [`None`], the contents are not changed.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// A [`Match` error] is generated if the `target` is an [`InputOnly`]
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`background_pixmap`]: crate::set::Attributes::background_pixmap
+	/// [`background_color`]: crate::set::Attributes::background_color
+	///
+	/// [`InputOnly`]: crate::WindowClass::InputOnly
+	///
+	/// [`Window` error]: error::Window
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ClearArea: Request(61, ClearAreaError) {
+		/// Whether [`GraphicsExposure` events] should be generated for regions
+		/// of the `area` which are visible or maintained.
+		///
+		/// [`GraphicsExposure` events]: crate::x11::event::GraphicsExposure
+		#[metabyte]
+		pub graphics_exposure: bool,
+
+		/// The [window] which this [request] clears an area of.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// A [`Match` error] is generated if this is an [`InputOnly`] [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`InputOnly`]: crate::WindowClass::InputOnly
+		///
+		/// [`Window` error]: error::Window
+		/// [`Match` error]: error::Match
+		pub target: Window,
+
+		/// The area of the `target` [window] which is cleared.
+		///
+		/// The `x` and `y` coordinates are relative to the top-left corner of
+		/// the `target` [window].
+		///
+		/// [window]: Window
+		pub area: Rectangle,
+	}
+}
+
+request_error! {
+	pub enum CopyAreaError for CopyArea {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies an area of the given `source` [drawable] into
+	/// the given `destination` [drawable].
+	///
+	/// [Regions][regions] of the `source` that are obscured and have not been
+	/// [maintained], as well as [regions] specified by `source_coords` and
+	/// `dimensions` fall outside of the `source` itself, are not copied. If the
+	/// `destination` has a background, however, and those [regions] of the
+	/// `source` which are not copied correspond to [regions] of the
+	/// `destination` which are visible or [maintained], those [regions] will be
+	/// filled with the `destination`'s background. If the `graphics_context`'s
+	/// [`graphics_exposure`] is `true`, [`GraphicsExposure` events] will be
+	/// generated for those [regions] (or a [`NoExposure` event] if none are
+	/// generated).
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`child_mode`]
+	/// - [`graphics_exposure`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if either `source` or `destination` do
+	/// not refer to defined [windows] nor [pixmaps].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [windows]: Window
+	/// [pixmaps]: Pixmap
+	/// [regions]: crate::Region
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [maintained]: crate::MaintainContents
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_y
+	///
+	/// [`GraphicsExposure` events]: crate::x11::event::GraphicsExposure
+	/// [`NoExposure` event]: crate::x11::event::NoExposure
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CopyArea: Request(62, CopyAreaError) {
+		/// The [drawable] from which the area is copied.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		pub source: Drawable,
+		/// The [drawable] into which the area is copied.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		pub destination: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		pub graphics_context: GraphicsContext,
+
+		/// The coordinates of the area which is copied from the `source`
+		/// [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `source`, and specify the top-left corner of the area which is
+		/// copied.
+		///
+		/// [drawable]: Drawable
+		pub source_coords: Coords,
+		/// The coordinates at which the copied area will be placed within the
+		/// `destination` [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `destination`, and specify what the top-left corner of the copied
+		/// area will be when it has been copied.
+		///
+		/// [drawable]: Drawable
+		pub destination_coords: Coords,
+
+		/// The dimensions of the area that is copied.
+		pub dimensions: Dimensions,
+	}
+}
+
+request_error! {
+	#[doc(alias("CopyPlaneError"))]
+	pub enum CopyBitPlaneError for CopyBitPlane {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies a [region] of the `source` [drawable], masked by the given
+	/// `bit_plane`, and filled according to the [`foreground_color`] and [`background_color`] in
+	/// the `graphics_context`.
+	///
+	/// Effectively, a [pixmap] with the given `dimensions` and the same depth
+	/// as the `destination` [drawable] is created. It is filled with the
+	/// [`foreground_color`] where the `bit_plane` in the `source` [drawable]
+	/// contains a bit set to 1, and [`background_color`] where the `bit_plane`
+	/// in the `source` [drawable] contains a bit set to 0.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`child_mode`]
+	/// - [`graphics_exposure`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if either the `source` or the
+	/// `destination` do not refer to defined [windows][window] nor
+	/// [pixmaps][pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if the `graphics_context` does
+	/// not refer to a defined [`GraphicsContext`].
+	///
+	/// A [`Match` error] is generated if the `source` [drawable] does not have
+	/// the same root [window] as the `destination` [drawable].
+	///
+	/// A [`Value` error] is generated if the `bit_plane` does not have exactly
+	/// one bit set to 1, or if the value of the `bit_plane` is not less than
+	/// 2<sup>`depth`</sup>, where `depth` is the `source` [drawable]'s depth.
+	///
+	/// [drawable]: Drawable
+	/// [pixmap]: Pixmap
+	/// [window]: Window
+	/// [region]: crate::Region
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`graphics_exposure`]: GraphicsOptions::graphics_exposure
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	/// [`Value` error]: error::Value
+	#[doc(alias("CopyPlane"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CopyBitPlane: Request(63, CopyBitPlaneError) {
+		/// The [drawable] used as the source in this graphics operation.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] as the `destination`.
+		///
+		/// [drawable]: Drawable
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		#[doc(alias("src", "src_drawable", "source_drawable"))]
+		pub source: Drawable,
+		/// The [drawable] which the filled [region] is copied into.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] as the `source`.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		#[doc(alias("dst", "dst_drawable", "destination_drawable"))]
+		pub destination: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The coordinates of the [region] within the `source` [drawable] which
+		/// is used.
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `source`, and specify the top-left corner of the [region] which is
+		/// copied.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		#[doc(alias("src_x", "src_y", "source_x", "source_y", "src_coords"))]
+		pub source_coords: Coords,
+		/// The coordinates at which the copied [region] will be placed within
+		/// the `destination` [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// `destination`, and specify what the top-left corner of the copied
+		/// [region] will be when it has been copied.
+		///
+		/// [region]: crate::Region
+		/// [drawable]: Drawable
+		#[doc(alias("dst_x", "dst_y", "destination_x", "destination_y", "dst_coords"))]
+		pub destination_coords: Coords,
+
+		/// The dimensions of the [region] that is copied.
+		///
+		/// [region]: crate::Region
+		#[doc(alias("width", "height"))]
+		pub dimensions: Dimensions,
+
+		/// The bit plane that is copied.
+		///
+		/// Exactly one bit must be set and the value must be less than
+		/// 2<sup>`depth`</sup>, where `depth` is the depth of the `source`
+		/// [drawable].
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this does not have exactly one bit
+		/// set to 1, or if this value is not less than 2<sup>`depth`</sup>,
+		/// where `depth` is the depth of the `source` [drawable].
+		///
+		/// [drawable]: Drawable
+		///
+		/// [`Value` error]: error::Value
+		pub bit_plane: u32,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyPointError", "DrawPointError"))]
+	pub enum DrawPointsError for DrawPoints {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Whether [coordinates] of elements to be drawn in graphics operations are
+/// relative to the [drawable] or the previous element.
+///
+/// The first element is always relative to the [drawable].
+///
+/// [coordinates]: Coords
+/// [drawable]: Drawable
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum CoordinateMode {
+	/// [Coordinates] are relative to the top-left corner of the [drawable].
+	///
+	/// [Coordinates]: Coords
+	/// [drawable]: Drawable
+	Drawable,
+
+	/// [Coordinates][coords] are relative to the [coordinates][coords] of the
+	/// previous element.
+	///
+	/// [coords]: Coords
+	Previous,
+}
+
+derive_xrb! {
+	/// A [request] that draws the given `points` on the `target` [drawable].
+	///
+	/// The points are drawn by combining the `graphics_context`'s
+	/// [`foreground_color`] with the existing color at those coordinates in the
+	/// [drawable]. They are drawn in the order that they are specified in the
+	/// list.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("PolyPoint", "DrawPoint"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawPoints: Request(64, DrawPointsError) {
+		/// Whether the `points` are drawn relative to the `target` or the
+		/// previously drawn point.
+		///
+		/// The first point is always drawn relative to the `target`.
+		///
+		/// See [`CoordinateMode`] for more information.
+		#[metabyte]
+		pub coordinate_mode: CoordinateMode,
+
+		/// The [drawable] on which the given `points` are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The points which are to be drawn.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are drawn in the order that they appear in the list.
+		///
+		/// Each point is drawn by combining the [`foreground_color`] with the
+		/// existing color of the pixel at the point's [coordinates].
+		///
+		/// [coordinates]: Coords
+		///
+		/// [`foreground_color`]: GraphicsOptions::foreground_color
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyLineError", "DrawLinesError", "DrawLineError"))]
+	pub enum DrawPathError for DrawPath {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws a path comprised of lines that join the given
+	/// `points`.
+	///
+	/// The lines are drawn in the order that the points appear in `points`.
+	/// They join at each intermediate point. If the first and last points are
+	/// in the same location, they are also joined to create a closed path (with
+	/// no endpoints).
+	///
+	/// Intersecting [thin] lines have their intersecting pixels drawn multiple
+	/// times. Intersecting [thick] lines, however, only have their intersecting
+	/// pixels drawn once.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [thin]: crate::set::LineWidth::Thin
+	/// [thick]: crate::set::LineWidth::Thick
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyLine", "DrawLines", "DrawLine"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawPath: Request(65, DrawPathError) {
+		/// Whether the [coordinates] of each point in `points` are relative to
+		/// the `target` or to the previous point.
+		///
+		/// The first point is always relative to the `target` [drawable].
+		///
+		/// [coordinates]: Coords
+		/// [drawable]: Drawable
+		#[metabyte]
+		pub coordinate_mode: CoordinateMode,
+
+		/// The [drawable] on which the path is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The points which are to be connected by lines.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are connected by lines in the order that they appear in
+		/// this list.
+		///
+		/// [coordinates]: Coords
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolySegmentError", "DrawSegmentError"))]
+	pub enum DrawLinesError for DrawLines {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+/// A line from the given `start` point to the given `end` point.
+#[doc(alias("Segment"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+pub struct Line {
+	/// The start of the line.
+	pub start: Coords,
+	/// The end of the line.
+	pub end: Coords,
+}
+
+derive_xrb! {
+	/// A [request] that draws the given `lines`.
+	///
+	/// No join points are created. Intersecting [lines] have their intersecting
+	/// pixels drawn multiple times.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [lines]: Line
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolySegment", "DrawSegment"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawLines: Request(66, DrawLinesError) {
+		/// The [drawable] on which the given `lines` are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The lines which are to be drawn.
+		///
+		/// The lines are drawn in the order that they appear in this list.
+		#[context(self::remaining => remaining / Line::X11_SIZE)]
+		pub lines: Vec<Line>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyRectangleError"))]
+	pub enum DrawRectanglesError for DrawRectangles {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws the outlines of the given `rectangles`.
+	///
+	/// The outlines are drawn as [lines] connecting each corner of the
+	/// [rectangles], starting at the top-left corner and going clockwise, with
+	/// a join point at each corner - thus forming a closed path.
+	///
+	/// If any of the given `rectangles` intersect, the intersecting pixels are
+	/// drawn multiple times.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [lines]: Line
+	/// [rectangles]: Rectangle
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyRectangle"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawRectangles: Request(67, DrawRectanglesError) {
+		/// The [drawable] on which the `rectangles`' outlines are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [rectangles] which are to have their outlines drawn.
+		///
+		/// Their `x` and `y` coordinates are relative to the top-left corner of
+		/// the `target` [drawable].
+		///
+		/// The [rectangles] are drawn in the order that they appear in this
+		/// list.
+		///
+		/// [rectangles]: Rectangle
+		/// [drawable]: Drawable
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub rectangles: Vec<Rectangle>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyArcError"))]
+	pub enum DrawArcsError for DrawArcs {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws circular or elliptical [arcs][arc].
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`line_width`]
+	/// - [`line_style`]
+	/// - [`cap_style`]
+	/// - [`join_style`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	/// - [`dash_offset`]
+	/// - [`dashes`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [arc]: Arc
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`line_width`]: GraphicsOptions::line_width
+	/// [`line_style`]: GraphicsOptions::line_style
+	/// [`cap_style`]: GraphicsOptions::cap_style
+	/// [`join_style`]: GraphicsOptions::join_style
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	/// [`dashes`]: GraphicsOptions::dashes
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyArc"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DrawArcs: Request(68, DrawArcsError) {
+		/// The [drawable] on which the [arcs] are drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [arcs]: Arc
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [arcs][arc] which are to be drawn.
+		///
+		/// If the last point in an [arc] is in the same location as the first
+		/// point in the next [arc], the two [arcs][arc] are joined with a
+		/// joinpoint. If the last point of the last [arc] and the first point
+		/// of the first [arc] are in the same location, they will also be
+		/// joined.
+		///
+		/// [arc]: Arc
+		#[context(self::remaining => remaining / Arc::X11_SIZE)]
+		pub arcs: Vec<Arc>,
+	}
+}
+
+request_error! {
+	#[doc(alias("FillPolyError"))]
+	pub enum FillPolygonError for FillPolygon {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies properties of a polygon that may allow for optimizations when
+/// drawing it.
+///
+/// This is used in the [`FillPolygon` request].
+///
+/// [`FillPolygon` request]: FillPolygon
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ShapeMode {
+	/// The shape may intersect itself.
+	Complex,
+
+	/// The shape may not intersect itself, but it is not (fully) convex.
+	///
+	/// If these properties are known to be true by the client, specifying this
+	/// mode may improve performance over [`Complex`](ShapeMode::Complex).
+	Nonconvex,
+
+	/// The shape may not intersect itself and it is convex.
+	///
+	/// Convex means that no [line] could be drawn between two points in the
+	/// shape which intersects the shape's path.
+	///
+	/// If these properties are known to be true by the client, specifying this
+	/// mode may improve performance over [`Nonconvex`](ShapeMode::Nonconvex).
+	///
+	/// [line]: Line
+	Convex,
+}
+
+derive_xrb! {
+	/// A [request] that fills the area enclosed the given path.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`fill_rule`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`fill_rule`]: GraphicsOptions::fill_rule
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("FillPoly"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillPolygon: Request(69, FillPolygonError) {
+		/// The [drawable] on which the filled polygon is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// Specifies whether the polygon self-intersects and whether it is
+		/// convex.
+		///
+		/// If the relevant properties of the specified polygon are known by the
+		/// client, specifying a more restrictive [shape mode] may improve
+		/// performance.
+		///
+		/// See [`ShapeMode`] for more information.
+		///
+		/// [shape mode]: ShapeMode
+		pub shape: ShapeMode,
+		/// Whether the [coordinates] of each point in `points` are relative to
+		/// the `target` or to the previous point.
+		///
+		/// The first point is always relative to the `target` [drawable].
+		///
+		/// [coordinates]: Coords
+		/// [drawable]: Drawable
+		pub coordinate_mode: CoordinateMode,
+		[_; 2],
+
+		/// The points which, when connected, specify the path of the polygon.
+		///
+		/// Each point is represented by its [coordinates].
+		///
+		/// The points are connected in the order that they appear in this list.
+		/// If the last point is not in the same location as the first point, it
+		/// is automatically connected to the first point to close the path.
+		///
+		/// [coordinates]: Coords
+		#[context(self::remaining => remaining / Coords::X11_SIZE)]
+		pub points: Vec<Coords>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyFillRectangleError"))]
+	pub enum FillRectanglesError for FillRectangles {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that fills the given `rectangles`.
+	///
+	/// This is effectively the same as if a [`FillPolygon` request] were sent
+	/// for each [rectangle] with the [rectangle]'s four points, starting with
+	/// the top-left corner and going clockwise.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [rectangle]: Rectangle
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`FillPolygon` request]: FillPolygon
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyFillRectangle"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillRectangles: Request(70, FillRectanglesError) {
+		/// The [drawable] on which the [rectangles] are filled.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [rectangles]: Rectangle
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [rectangles] which are to be filled.
+		///
+		/// The [rectangles] are filled in the order that they appear in this
+		/// list. For intersecting [rectangles], the intersecting pixels are
+		/// drawn multiple times.
+		///
+		/// [rectangles]: Rectangle
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub rectangles: Vec<Rectangle>,
+	}
+}
+
+request_error! {
+	#[doc(alias("PolyFillArcError"))]
+	pub enum FillArcsError for FillArcs {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that fills the given `arcs`.
+	///
+	/// If the `graphics_context`'s [`arc_mode`] is [`ArcMode::Chord`], the
+	/// [arcs][arc] are filled by joining each [arc]'s endpoints with a single
+	/// [line]. If the [`arc_mode`] is [`ArcMode::PieSlice`], however, the
+	/// [arcs][arc] are filled by joining each [arc]'s endpoints with the center
+	/// of that [arc], thus using two [lines][line].
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`fill_style`]
+	/// - [`arc_mode`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// configuration of the `graphics_context`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`tile`]
+	/// - [`stipple`]
+	/// - [`tile_stipple_x`]
+	/// - [`tile_stipple_y`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [arc]: Arc
+	/// [line]: Line
+	/// [request]: crate::message::Request
+	///
+	/// [`ArcMode::Chord`]: crate::set::ArcMode::Chord
+	/// [`ArcMode::PieSlice`]: crate::set::ArcMode::PieSlice
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`fill_style`]: GraphicsOptions::fill_style
+	/// [`arc_mode`]: GraphicsOptions::arc_mode
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`tile`]: GraphicsOptions::tile
+	/// [`stipple`]: GraphicsOptions::stipple
+	/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+	/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("PolyFillArc"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct FillArcs: Request(71, FillArcsError) {
+		/// The [drawable] on which the [arcs] are filled.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [arcs]: Arc
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The [arcs] which are to be filled.
+		///
+		/// The [arcs] are filled in the order that they appear in this list. If
+		/// there are intersecting [arcs], the intersecting pixels will be drawn
+		/// multiple times.
+		///
+		/// [arcs]: Arc
+		#[context(self::remaining => remaining / Arc::X11_SIZE)]
+		pub arcs: Vec<Arc>,
+	}
+}
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
new file mode 100644
index 00000000..e01caac2
--- /dev/null
+++ b/src/x11/request/input.rs
@@ -0,0 +1,1270 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to input devices,
+//! grabs, and coordinates.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	x11::{error, reply},
+	Any,
+	AnyModifierKeyMask,
+	Button,
+	Coords,
+	CurrentableTime,
+	CursorAppearance,
+	CursorEventMask,
+	FocusWindow,
+	FreezeMode,
+	Keycode,
+	Window,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum GrabCursorError for GrabCursor {
+		CursorAppearance,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that actively grabs control of the cursor.
+	///
+	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
+	///
+	/// # Replies
+	/// This [request] generates a [`GrabCursor` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `grab_window` or the
+	/// `confine_to` [window] do not refer to defined [windows][window].
+	///
+	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
+	/// [`Some`] and does not refer to a defined [cursor appearance].
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`EnterWindow`]: crate::x11::event::EnterWindow
+	/// [`LeaveWindow`]: crate::x11::event::LeaveWindow
+	/// [`GrabCursor` reply]: reply::GrabCursor
+	///
+	/// [`Window` error]: error::Window
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[doc(alias = "GrabPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GrabCursor: Request(26, GrabCursorError) -> reply::GrabCursor {
+		/// Whether cursor [events] which would normally be reported to this
+		/// client are reported normally.
+		///
+		/// [events]: crate::message::Event
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the cursor is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// your client.
+		///
+		/// [events]: crate::message::Event
+		pub event_mask: CursorEventMask,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+
+		/// Optionally confines the cursor to the given [window].
+		///
+		/// This [window] does not need to have any relation to the
+		/// `grab_window`.
+		///
+		/// The cursor will be warped to the closest edge of this [window] if it
+		/// is not already within it. Subsequent changes to the configuration of
+		/// the [window] which cause the cursor to be outside of the [window]
+		/// will also trigger the cursor to be warped to the [window] again.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] and does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub confine_to: Option<Window>,
+
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias = "cursor")]
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The [time] at which this grab is recorded as having been initiated.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+	}
+
+	/// A [request] that ends an active cursor grab by your client.
+	///
+	/// Any queued [events] are released.
+	///
+	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
+	///
+	/// [request]: crate::message::Request
+	/// [events]: crate::message::Event
+	///
+	/// [`EnterWindow`]: crate::x11::event::EnterWindow
+	/// [`LeaveWindow`]: crate::x11::event::LeaveWindow
+	#[doc(alias = "UngrabPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UngrabCursor: Request(27) {
+		/// The [time] at which the grab is recorded as having been released.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+	}
+}
+
+request_error! {
+	pub enum GrabButtonError for GrabButton {
+		Access,
+		CursorAppearance,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that establishes a passive cursor grab for a given `button`
+	/// and `modifiers` combination.
+	///
+	/// If the following conditions are true, the grab is converted into an
+	/// active cursor grab (as described in the [`GrabCursor` request]):
+	/// - the cursor is not already actively grabbed; and
+	/// - the specified `button` and specified `modifiers` are held; and
+	/// - the cursor is within the `grab_window`; and
+	/// - if the `confine_to` [window] is specified, it is viewable; and
+	/// - a passive grab for the same `button` and `modifiers` combination does
+	///   not exist for any ancestor of the `grab_window`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `grab_window` or the
+	/// `confine_to` [window] do not refer to defined [windows][window].
+	///
+	/// A [`CursorAppearance` error] is generated if the `cursor_appearance` is
+	/// [`Some`] and does not refer to a defined [cursor appearance].
+	///
+	/// An [`Access` error] is generated if some other client has already sent a
+	/// `GrabButton` [request] with the same `button` and `modifiers`
+	/// combination on the same `grab_window`.
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GrabCursor` request]: GrabCursor
+	///
+	/// [`Access` error]: error::Access
+	/// [`Window` error]: error::Window
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GrabButton: Request(28, GrabButtonError) {
+		/// Whether cursor [events] which would normally be reported to this
+		/// client are reported normally.
+		///
+		/// [events]: crate::message::Event
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the `button` is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// grabbing client.
+		///
+		/// [events]: crate::message::Event
+		pub event_mask: CursorEventMask,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+
+		/// Optionally confines the cursor to the given [window].
+		///
+		/// This [window] does not need to have any relation to the
+		/// `grab_window`.
+		///
+		/// The cursor will be warped to the closest edge of this [window] if it
+		/// is not already within it. Subsequent changes to the configuration of
+		/// the [window] which cause the cursor to be outside of the [window]
+		/// will also trigger the cursor to be warped to the [window] again.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] and does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub confine_to: Option<Window>,
+
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The [button] for which this grab is established.
+		///
+		/// [`Any`] means that the grab is effectively established for all
+		/// possible [buttons][button].
+		///
+		/// When this button and the given `modifiers`,
+		///
+		/// [button]: Button
+		///
+		/// [`Any`]: Any::Any
+		pub button: Any<Button>,
+		_,
+
+		/// The combination of modifiers which must be held for a press of the
+		/// `button` to activate the active cursor grab.
+		///
+		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
+		/// at all.
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+	}
+}
+
+request_error! {
+	pub enum UngrabButtonError for UngrabButton {
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that releases a [passive button grab] on the specified
+	/// `grab_window` if the grab was established by your client.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [passive button grab]: GrabButton
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UngrabButton: Request(29, UngrabButtonError) {
+		/// The [button] which the [passive button grab] was established for.
+		///
+		/// [`Any`] matches any `button` specified in the [passive button grab].
+		/// It is equivalent to sending this `UngrabButton` [request] for all
+		/// possible [buttons][button].
+		///
+		/// [button]: Button
+		/// [request]: crate::message::Request
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub button: Any<Button>,
+
+		/// The [window] on which the [passive button grab] was established.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The modifier combination specified by the [passive button grab].
+		///
+		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
+		/// [passive button grab] (including no modifiers). It is equivalent to
+		/// sending this `UngrabButton` [request] for all possible `modifiers`
+		/// combinations.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive button grab]: GrabButton
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		[_; 2],
+	}
+}
+
+request_error! {
+	pub enum ChangeActiveCursorGrabError for ChangeActiveCursorGrab {
+		CursorAppearance,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that modifies the `event_mask` or `cursor_appearance` of an
+	/// [active cursor grab].
+	///
+	/// # Errors
+	/// A [`CursorAppearance` error] is generated if `cursor_appearance` does
+	/// not refer to a defined [cursor appearance].
+	///
+	/// [cursor appearance]: CursorAppearance
+	/// [request]: crate::message::Request
+	///
+	/// [active cursor grab]: GrabCursor
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[doc(alias = "ChangeActivePointerGrab")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ChangeActiveCursorGrab: Request(30, ChangeActiveCursorGrabError) {
+		/// Optionally overrides the [appearance of the cursor], no matter which
+		/// [window] it is within, for the duration of the grab.
+		///
+		/// This replaces the previously specified `cursor_appearance` for the
+		/// grab - [`None`] means that the `cursor_appearance` is no longer
+		/// overridden.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [cursor appearance].
+		///
+		/// [cursor appearance]: CursorAppearance
+		/// [appearance of the cursor]: CursorAppearance
+		/// [window]: Window
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias = "cursor")]
+		pub cursor_appearance: Option<CursorAppearance>,
+
+		/// The [time] at which this change is recorded as having taken place.
+		///
+		/// This must be later than the [time] of the last cursor grab, and
+		/// equal to or earlier than the X server's [current time].
+		///
+		/// [time]: crate::Timestamp
+		/// [current time]: CurrentableTime::CurrentTime
+		pub time: CurrentableTime,
+
+		/// A mask of the cursor [events] which are to be reported to the
+		/// your client.
+		///
+		/// [events]: crate::message::Event
+		pub event_mask: CursorEventMask,
+		[_; 2],
+	}
+}
+
+request_error! {
+	pub enum GrabKeyboardError for GrabKeyboard {
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that actively grabs control of the keyboard.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// # Replies
+	/// This [request] generates a [`GrabKeyboard` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Focus`]: crate::x11::event::Focus
+	/// [`Unfocus`]: crate::x11::event::Unfocus
+	///
+	/// [`GrabKeyboard` reply]: reply::GrabKeyboard
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GrabKeyboard: Request(31, GrabKeyboardError) -> reply::GrabKeyboard {
+		/// Whether key [events] which would normally be reported to this client
+		/// are reported normally.
+		///
+		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
+		/// matter what events you have selected.
+		///
+		/// [events]: crate::message::Event
+		///
+		/// [`KeyPress`]: crate::x11::event::KeyPress
+		/// [`KeyRelease`]: crate::x11::event::KeyRelease
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the keyboard is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The [time] at which this grab is recorded as having been initiated.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+		[_; 2],
+	}
+
+	/// A [request] that ends an active keyboard grab by your client.
+	///
+	/// Any queued [events] are released.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// [request]: crate::message::Request
+	/// [events]: crate::message::Event
+	///
+	/// [`Focus`]: crate::x11::event::Focus
+	/// [`Unfocus`]: crate::x11::event::Unfocus
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UngrabKeyboard: Request(32) {
+		/// The [time] at which the grab is recorded as having been released.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+	}
+}
+
+request_error! {
+	pub enum GrabKeyError for GrabKey {
+		Access,
+		CursorAppearance,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that establishes a passive key grab for a particular `key`
+	/// and `modifiers` combination.
+	///
+	/// If the following conditions are true, the grab is converted into an
+	/// active keyboard grab (as described in the [`GrabKeyboard` request]):
+	/// - the keyboard is not already actively grabbed; and
+	/// - the specified `key` and specified `modifiers` are held; and
+	/// - either the `grab_window` is an ancestor, or is, the currently focused
+	///   [window], or the `grab_window` is a descendent of the currently
+	///   focused [window] and contains the cursor; and
+	/// - a passive grab for the same `key` and `modifiers` combination does
+	///   not exist for any ancestor of the `grab_window`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Access` error] is generated if some other client has already sent a
+	/// `GrabKey` [request] with the same `key` and `modifiers` combination on
+	/// the same `grab_window`.
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`GrabKeyboard` request]: GrabKeyboard
+	///
+	/// [`Access` error]: error::Access
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GrabKey: Request(33, GrabKeyError) {
+		/// Whether key [events] which would normally be reported to this client
+		/// are reported normally.
+		///
+		/// Both [`KeyPress`] and [`KeyRelease`] events are always reported, no
+		/// matter what events you have selected.
+		///
+		/// [events]: crate::message::Event
+		///
+		/// [`KeyPress`]: crate::x11::event::KeyPress
+		/// [`KeyRelease`]: crate::x11::event::KeyRelease
+		#[metabyte]
+		pub owner_events: bool,
+
+		/// The [window] on which the `key` is grabbed.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The combination of modifiers which must be held for a press of the
+		/// `key` to activate the active key grab.
+		///
+		/// [`ANY_MODIFIER`] means _any_ modifiers: that includes no modifiers
+		/// at all.
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		/// The key for which this grab is established.
+		///
+		/// [`Any`] means that the grab is effectively established for all
+		/// possible keys.
+		///
+		/// When this key and the given `modifiers`,
+		///
+		/// [button]: Button
+		///
+		/// [`Any`]: Any::Any
+		pub key: Any<Keycode>,
+
+		/// The [freeze mode] applied to the cursor.
+		///
+		/// For [`FreezeMode::Unfrozen`], cursor [event] processing continues
+		/// as normal.
+		///
+		/// For [`FreezeMode::Frozen`], cursor [event] processing appears to
+		/// freeze - cursor [events][event] generated during this time are not
+		/// lost: they are queued to be processed later. The freeze ends when
+		/// either the grabbing client sends an [`AllowEvents` request], or when
+		/// the cursor grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias("pointer_mode", "cursor_mode"))]
+		pub cursor_freeze: FreezeMode,
+		/// The [freeze mode] applied to the keyboard.
+		///
+		/// For [`FreezeMode::Unfrozen`], keyboard [event] processing
+		/// continues as normal.
+		///
+		/// For [`FreezeMode::Frozen`], keyboard [event] processing appears
+		/// to freeze - keyboard [events][event] generated during this time are
+		/// not lost: they are queued to be processed later. The freeze ends
+		/// when either the grabbing client sends an [`AllowEvents` request], or
+		/// when the keyboard grab is released.
+		///
+		/// [event]: crate::message::Event
+		/// [freeze mode]: FreezeMode
+		///
+		/// [`AllowEvents` request]: AllowEvents
+		#[doc(alias = "keyboard_mode")]
+		pub keyboard_freeze: FreezeMode,
+		[_; 3],
+	}
+}
+
+request_error! {
+	pub enum UngrabKeyError for UngrabKey {
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that releases a [passive key grab] on the specified
+	/// `grab_window` if the grab was established by your client.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `grab_window` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [passive key grab]: GrabKey
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UngrabKey: Request(34, UngrabKeyError) {
+		/// The key which the [passive key grab] was established for.
+		///
+		/// [`Any`] matches any `key` specified in the [passive key grab].
+		/// It is equivalent to sending this `UngrabKey` [request] for all
+		/// possible keys.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub key: Any<Keycode>,
+
+		/// The [window] on which the [passive key grab] was established.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`Window` error]: error::Window
+		pub grab_window: Window,
+
+		/// The modifier combination specified by the [passive key grab].
+		///
+		/// [`ANY_MODIFIER`] matches any `modifiers` specified in the
+		/// [passive key grab] (including no modifiers). It is equivalent to
+		/// sending this `UngrabKey` [request] for all possible `modifiers`
+		/// combinations.
+		///
+		/// [request]: crate::message::Request
+		///
+		/// [passive key grab]: GrabKey
+		///
+		/// [`ANY_MODIFIER`]: AnyModifierKeyMask::ANY_MODIFIER
+		pub modifiers: AnyModifierKeyMask,
+		[_; 2],
+	}
+}
+
+/// Specifies the conditions under which queued events should be released for an
+/// [`AllowEvents` request].
+///
+/// [`AllowEvents` request]: AllowEvents
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum AllowEventsMode {
+	/// Unfreezes the cursor if it is frozen and you have active grab on the
+	/// cursor.
+	UnfreezeCursor,
+	/// Unfreezes the cursor, but freezes it again after the next
+	/// [`ButtonPress`] or [`ButtonRelease`].
+	///
+	/// Your client must have an active grab on the cursor.
+	///
+	/// The cursor is frozen again specifically after the next [`ButtonPress`]
+	/// [`ButtonRelease`] event reported to your client which does not cause
+	/// grab to be released.
+	///
+	/// [`ButtonPress`]: crate::x11::event::ButtonPress
+	/// [`ButtonRelease`]: crate::x11::event::ButtonRelease
+	RefreezeCursor,
+	/// If the cursor is frozen as a result of the activation of a passive grab
+	/// or [`RefreezeCursor`] mode from your client, the grab is released and
+	/// the [event] is completely reprocessed.
+	///
+	/// [`RefreezeCursor`]: AllowEventsMode::RefreezeCursor
+	///
+	/// [event]: crate::message::Event
+	ReplayCursor,
+
+	/// Unfreezes the keyboard if it is frozen and you have an active grab on
+	/// the keyboard.
+	UnfreezeKeyboard,
+	/// Unfreezes the keyboard, but freezes it again after the next
+	/// [`KeyPress`] or [`KeyPress`].
+	///
+	/// Your client must have an active grab on the keyboard.
+	///
+	/// The keyboard is frozen again specifically after the next [`KeyPress`]
+	/// [`KeyRelease`] event reported to your client which does not cause
+	/// grab to be released.
+	///
+	/// [`KeyPress`]: crate::x11::event::KeyPress
+	/// [`KeyRelease`]: crate::x11::event::KeyRelease
+	RefreezeKeyboard,
+	/// If the keyboard is frozen as a result of the activation of a passive
+	/// grab or [`RefreezeKeyboard`] mode from your client, the grab is released
+	/// and the [event] is completely reprocessed.
+	///
+	/// [`RefreezeKeyboard`]: AllowEventsMode::RefreezeKeyboard
+	///
+	/// [event]: crate::message::Event
+	ReplayKeyboard,
+
+	/// If both the cursor and the keyboard are frozen by your client, both are
+	/// unfrozen.
+	UnfreezeBoth,
+	/// If both the cursor and the keyboard are frozen by your client, both are
+	/// unfrozen but are both frozen again on the next button or key press or
+	/// release event.
+	///
+	/// Any [`ButtonPress`], [`ButtonRelease`], [`KeyPress`], or [`KeyRelease`]
+	/// event reported to your client will unfreeze both the cursor and the
+	/// keyboard.
+	///
+	/// [`ButtonPress`]: crate::x11::event::ButtonPress
+	/// [`ButtonRelease`]: crate::x11::event::ButtonRelease
+	///
+	/// [`KeyPress`]: crate::x11::event::KeyPress
+	/// [`KeyRelease`]: crate::x11::event::KeyRelease
+	RefreezeBoth,
+}
+
+derive_xrb! {
+	/// A [request] that releases some queued events if your client has caused a
+	/// device to be [frozen].
+	///
+	/// [frozen]: FreezeMode::Frozen
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct AllowEvents: Request(35, error::Value) {
+		/// The conditions under which the queued [events] are released.
+		///
+		/// [events]: crate::message::Event
+		#[metabyte]
+		pub mode: AllowEventsMode,
+
+		/// The [time] at which this `AllowEvents` [request] is recorded as
+		/// having taken place.
+		///
+		/// This [request] has no effect if this time is earlier than the time
+		/// of your most recent active grab or later than the X server's
+		/// [current time].
+		///
+		/// [request]: crate::message::Request
+		/// [time]: crate::Timestamp
+		/// [current time]: CurrentableTime::CurrentTime
+		pub time: CurrentableTime,
+	}
+
+	/// A [request] that freezes processing of [requests][request] and
+	/// connection closes on all other clients' connections.
+	///
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GrabServer: Request(36);
+
+	/// A [request] that unfreezes processing of [requests][request] and
+	/// connection closes on all other clients' connections.
+	///
+	/// [request]: crate::message::Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UngrabServer: Request(37);
+
+	/// A [request] that gets the current location of the cursor.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct QueryCursorLocation: Request(38, error::Window) -> reply::QueryCursorLocation {
+		/// Specifies a [window] to receive relative coordinates of the cursor
+		/// in relation to, if the cursor is on the same screen.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that returns the recorded cursor motion between the given
+	/// `start` and `end` times.
+	///
+	/// The `start` and `end` times are inclusive.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "GetMotionEvents")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetMotionHistory: Request(39, error::Window) -> reply::GetMotionHistory {
+		/// The [window] for which the motion history is returned.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+
+		/// The start of the time period for which motion events are returned.
+		///
+		/// This is inclusive.
+		pub start: CurrentableTime,
+		/// The end of the time period for which motion events are returned.
+		///
+		/// This is inclusive.
+		pub end: CurrentableTime,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that converts coordinates relative to the given `original`
+	/// [window] to `output_coords` relative to the given `output` [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either `original` or `output` do not
+	/// refer to defined [windows][window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "TranslateCoordinates")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ConvertCoordinates: Request(40, error::Window) -> reply::ConvertCoordinates {
+		/// The [window] which the `original_coords` are relative to.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("src_window", "source", "input"))]
+		pub original: Window,
+		/// The [window] which the `output_coords` will be relative to.
+		///
+		/// The `original_coords` are converted to coordinates relative to the
+		/// top-left corner of this [window].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("dst_window", "destination"))]
+		pub output: Window,
+
+		/// The coordinates, relative to the `original` [window]'s top-left
+		/// corner, which will be converted.
+		///
+		/// These coordinates will be converted such that the `output_coords`
+		/// are relative to the `output` [window].
+		///
+		/// [window]: Window
+		pub original_coords: Coords,
+	}
+}
+
+/// Represents dimensions within the `source` [window] of a
+/// [`WarpCursor` request].
+///
+/// [window]: Window
+///
+/// [`WarpCursor` request]: WarpCursor
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum WarpSourceDimension {
+	/// Set the `source_width` to the width of the `source` [window] minus the x
+	/// coordinate or the `source_height` to the height of the `source` [window]
+	/// minus the y coordinate.
+	///
+	/// [window]: Window
+	FillRemaining,
+	/// This specific width or height.
+	Other(u16),
+}
+
+impl ConstantX11Size for WarpSourceDimension {
+	const X11_SIZE: usize = 2;
+}
+
+impl X11Size for WarpSourceDimension {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Readable for WarpSourceDimension {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		Ok(match buf.get_u16() {
+			zero if zero == 0 => Self::FillRemaining,
+			other => Self::Other(other),
+		})
+	}
+}
+
+impl Writable for WarpSourceDimension {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::FillRemaining => buf.put_u16(0),
+			Self::Other(other) => other.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that instantly moves the cursor to a new location.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `source` or the `destination` are [`Some`] and
+	/// do not refer to defined [windows].
+	///
+	/// [windows]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "WarpPointer")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct WarpCursor: Request(41, error::Window) {
+		/// The [window] which the cursor is being warped from.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("src", "src_window"))]
+		pub source: Option<Window>,
+		/// The [window] which the cursor is being warped to.
+		///
+		/// If this is [`None`], the cursor is simply offset by the `coords`. If
+		/// this is [`Some`], the cursor is set to the `coords` relative to this
+		/// [window].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("dst", "dst_window"))]
+		pub destination: Option<Window>,
+
+		/// The coordinates of the top-left corner of the rectangular area
+		/// within the `source` [window] which the cursor must be within for it
+		/// to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias("src_coords", "src_x", "src_y", "source_x", "source_y"))]
+		pub source_coords: Coords,
+		/// The width of the rectangular area within the `source` [window] which
+		/// the cursor must be within for it to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias = "src_width")]
+		pub source_width: WarpSourceDimension,
+		/// The height of the rectangular area within the `source` [window]
+		/// which the cursor must be within for it to be warped.
+		///
+		/// [window]: Window
+		#[doc(alias = "src_height")]
+		pub source_height: WarpSourceDimension,
+
+		/// The coordinates applied to the cursor.
+		///
+		/// If `destination` is [`None`], the cursor is offset by these
+		/// coordinates. Otherwise, the cursor is moved to these coordinates
+		/// relative to the `destination` [window].
+		///
+		/// [window]: Window
+		#[doc(alias("dst_x", "dst_y", "dst_coords", "destination_coords"))]
+		pub coords: Coords,
+	}
+}
+
+request_error! {
+	pub enum SetFocusError for SetFocus {
+		Match,
+		Value,
+		Window,
+	}
+}
+
+/// What the focus should revert to if the focused [window] becomes unviewable.
+///
+/// This is used in the [`SetFocus` request].
+///
+/// [window]: Window
+///
+/// [`SetFocus` request]: SetFocus
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum RevertFocus {
+	/// Revert the focus to no [window].
+	///
+	/// It is recommended to use [`CursorRoot`] in place of this, because at
+	/// least the root [window] will have focus with [`CursorRoot`].
+	///
+	/// [`CursorRoot`]: RevertFocus::CursorRoot
+	///
+	/// [window]: Window
+	None,
+
+	/// Revert the focus to the root [window] which the cursor is on at the
+	/// time.
+	///
+	/// [window]: Window
+	CursorRoot,
+	/// Revert the focus to the parent of the [window] which the cursor is in at
+	/// the time.
+	///
+	/// [window]: Window
+	Parent,
+}
+
+derive_xrb! {
+	/// A [request] that changes the current focus.
+	///
+	/// This [request] generates [`Focus`] and [`Unfocus`] events.
+	///
+	/// # Errors
+	/// A [`Match` error] is generated of the specified `new_focus` is not
+	/// viewable at the time of the [request].
+	///
+	/// A [`Window` error] is generated if `new_focus` is [`FocusWindow::Other`]
+	/// and does not refer to a defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Focus`]: crate::x11::event::Focus
+	/// [`Unfocus`]: crate::x11::event::Unfocus
+	///
+	/// [`Match` error]: error::Match
+	/// [`Window` error]: error::Window
+	#[doc(alias("SetInputFocus", "Focus", "FocusWindow"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct SetFocus: Request(42, SetFocusError) {
+		/// What the focus should revert to if the focused [window] becomes
+		/// unviewable.
+		///
+		/// [window]: Window
+		#[metabyte]
+		pub revert_to: RevertFocus,
+
+		/// The new focus.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`FocusWindow::Other`]
+		/// but does not refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "focus")]
+		pub new_focus: FocusWindow,
+
+		/// The [time] at which the focus is recorded as having changed.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+	}
+
+	/// A [request] that returns the current focus.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias = "GetInputFocus")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetFocus: Request(43) -> reply::GetFocus;
+
+	/// A [request] that returns a bit vector of the currently held keys on the
+	/// keyboard.
+	///
+	/// [request]: crate::message::Request
+	#[doc(alias = "QueryKeymap")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
+}
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
new file mode 100644
index 00000000..ec65cde5
--- /dev/null
+++ b/src/x11/request/meta.rs
@@ -0,0 +1,119 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to an X client or
+//! the X server.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{x11::error, Window};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum ChangeSavedWindowsError for ChangeSavedWindows {
+		Match,
+		Value,
+		Window,
+	}
+}
+
+/// Whether something is added or removed.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum AddOrRemove {
+	/// The thing is added.
+	Add,
+	/// The thing is removed.
+	Remove,
+}
+
+derive_xrb! {
+	/// A [request] that [adds] or [removes] the specified [window] from the
+	/// set of [windows][window] which you have chosen to save.
+	///
+	/// When a client's resources are destroyed, each of the client's saved
+	/// [windows] which are descendents of [windows] created by the client is
+	/// [reparented] to the closest ancestor which is not created by the client.
+	///
+	/// # Errors
+	/// The given `window` must not be a [window] created by you, else a
+	/// [`Match` error] is generated.
+	///
+	/// A [`Window` error] is generated if the `window` does not refer to a
+	/// defined [window].
+	///
+	/// A [`Value` error] is generated if the `change_mode` is encoded
+	/// incorrectly. It is a bug in X Rust Bindings if that happens.
+	///
+	/// [window]: Window
+	/// [windows]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [adds]: AddOrRemove::Add
+	/// [removes]: AddOrRemove::Remove
+	///
+	/// [reparented]: super::ReparentWindow
+	#[doc(alias = "ChangeSaveSet")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ChangeSavedWindows: Request(6, ChangeSavedWindowsError) {
+		#[metabyte]
+		/// Whether the `window` is added to or removed from your saved
+		/// [windows].
+		///
+		/// [windows]: Window
+		#[doc(alias = "mode")]
+		pub change_mode: AddOrRemove,
+
+		/// The [window] which is added to or removed from your saved
+		/// [windows][window].
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if you created this [window].
+		///
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Match` error]: error::Match
+		/// [`Window` error]: error::Window
+		pub window: Window,
+	}
+}
diff --git a/src/x11/request/miscellaneous.rs b/src/x11/request/miscellaneous.rs
new file mode 100644
index 00000000..4e29004a
--- /dev/null
+++ b/src/x11/request/miscellaneous.rs
@@ -0,0 +1,857 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to [atoms],
+//! properties, selections, and sending [events].
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [atoms]: Atom
+//! [events]: Event
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk::{
+	pad,
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadError::UnrecognizedDiscriminant,
+	ReadResult,
+	ReadableWithContext,
+	Wrap,
+	Writable,
+	WriteResult,
+	X11Size,
+};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	message::Event,
+	x11::{error, reply},
+	Any,
+	Atom,
+	CurrentableTime,
+	DestinationWindow,
+	EventMask,
+	String8,
+	Window,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+derive_xrb! {
+	/// A [request] that returns the [atom] with the given `name`.
+	///
+	/// If `no_creation` is false and an [atom] by the specified `name` does not
+	/// already exist, a new [atom] will be created and then returned. If an
+	/// [atom] by the specified `name` already exists, that [atom] will be
+	/// returned.
+	///
+	/// # Replies
+	/// This [request] generates a [`GetAtom` reply].
+	///
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`GetAtom` reply]: reply::GetAtom
+	#[doc(alias("InternAtom", "CreateAtom"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetAtom: Request(16, error::Value) -> reply::GetAtom {
+		#[metabyte]
+		/// Whether the X server should avoid creating a new [atom] for an
+		/// unrecognised `name`.
+		///
+		/// If this is `true`, the X server won't create a new [atom] for a
+		/// `name` which doesn't already refer to an [atom]. If it is `false`,
+		/// the X server will create a new [atom] for the given `name`.
+		///
+		/// [atom]: Atom
+		#[doc(alias = "only_if_exists")]
+		pub no_creation: bool,
+
+		// Encodes the length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// The name of the [atom] to either create or retrieve.
+		///
+		/// If an [atom] by this name does not already exist and `no_creation`
+		/// is `false`, a new [atom] with this name will be created and
+		/// returned.
+		///
+		/// If an [atom] by this name already exists, that [atom] will be
+		/// returned.
+		///
+		/// [atom]: Atom
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+
+	/// A [request] that returns the name of the given [atom].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetAtomName` reply].
+	///
+	/// # Errors
+	/// An [`Atom` error] is generated if the `target` does not refer to a
+	/// defined [atom].
+	///
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`GetAtomName` reply]: reply::GetAtomName
+	///
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetAtomName: Request(17, error::Atom) -> reply::GetAtomName {
+		/// The [atom] for which this [request] gets its name.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		#[doc(alias = "atom")]
+		pub target: Atom,
+	}
+}
+
+request_error! {
+	pub enum ModifyPropertyError for ModifyProperty {
+		Atom,
+		Match,
+		Value,
+		Window,
+	}
+}
+
+/// Whether a property is [replaced], [prepended] to a [window]'s list of
+/// properties, or [appended] to the [window]'s list of properties.
+///
+/// [replaced]: ModifyPropertyMode::Replace
+/// [prepended]: ModifyPropertyMode::Prepend
+/// [appended]: ModifyPropertyMode::Append
+///
+/// [window]: Window
+#[doc(alias = "ChangePropertyMode")]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ModifyPropertyMode {
+	/// The property replaces an existing property; the previous value is
+	/// discarded.
+	Replace,
+
+	/// The property is prepended to the list of properties.
+	Prepend,
+
+	/// The property is appended to the list of properties.
+	Append,
+}
+
+/// Whether a [`DataList`] is formatted as a list of `i8` values, `i16` values,
+/// or `i32` values.
+#[derive(Copy, Clone, Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum DataFormat {
+	/// The list is formatted as `i8` values.
+	I8 = 8,
+	/// The list is formatted as `i16` values.
+	I16 = 16,
+	/// The list is formatted as `i32` values.
+	I32 = 32,
+}
+
+impl ConstantX11Size for DataFormat {
+	const X11_SIZE: usize = 1;
+}
+
+impl Wrap for DataFormat {
+	type Integer = u8;
+}
+
+impl TryFrom<u8> for DataFormat {
+	type Error = ReadError;
+
+	fn try_from(value: u8) -> Result<Self, Self::Error> {
+		match value {
+			i8 if i8 == 8 => Ok(Self::I8),
+			i16 if i16 == 16 => Ok(Self::I16),
+			i32 if i32 == 32 => Ok(Self::I32),
+
+			other => Err(UnrecognizedDiscriminant(usize::from(other))),
+		}
+	}
+}
+
+impl From<DataFormat> for u8 {
+	fn from(format: DataFormat) -> Self {
+		match format {
+			DataFormat::I8 => 8,
+			DataFormat::I16 => 16,
+			DataFormat::I32 => 32,
+		}
+	}
+}
+
+/// A list of either `i8` values, `i16` values, or `i32` values.
+///
+/// This represents uninterpreted 'raw' data.
+#[derive(Clone, Debug, Hash, PartialEq, Eq)]
+pub enum DataList {
+	/// A list of `i8` values.
+	I8(Vec<i8>),
+	/// A list of `i16` values.
+	I16(Vec<i16>),
+	/// A list of `i32` values.
+	I32(Vec<i32>),
+}
+
+impl DataList {
+	/// The length of the data.
+	///
+	/// This is how many values there are - not the number of bytes.
+	#[must_use]
+	pub fn len(&self) -> usize {
+		match self {
+			Self::I8(list) => list.len(),
+			Self::I16(list) => list.len(),
+			Self::I32(list) => list.len(),
+		}
+	}
+
+	/// Whether the `DataList` is empty.
+	#[must_use]
+	pub fn is_empty(&self) -> bool {
+		match self {
+			Self::I8(list) => list.is_empty(),
+			Self::I16(list) => list.is_empty(),
+			Self::I32(list) => list.is_empty(),
+		}
+	}
+}
+
+impl X11Size for DataList {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::I8(list) => list.x11_size(),
+			Self::I16(list) => list.x11_size(),
+			Self::I32(list) => list.x11_size(),
+		}
+	}
+}
+
+impl ReadableWithContext for DataList {
+	type Context = (DataFormat, u32);
+
+	fn read_with(buf: &mut impl Buf, (format, length): &(DataFormat, u32)) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		let length = &(*length as usize);
+
+		Ok(match format {
+			DataFormat::I8 => Self::I8(<Vec<i8>>::read_with(buf, length)?),
+			DataFormat::I16 => Self::I16(<Vec<i16>>::read_with(buf, length)?),
+			DataFormat::I32 => Self::I32(<Vec<i32>>::read_with(buf, length)?),
+		})
+	}
+}
+
+impl Writable for DataList {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::I8(list) => list.write_to(buf)?,
+			Self::I16(list) => list.write_to(buf)?,
+			Self::I32(list) => list.write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that modifies the given `property` for the [window].
+	///
+	/// A [`Property` event] is generated on the `target` [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// An [`Atom` error] is generated if either `property` or `type` do not
+	/// refer to defined [windows][window].
+	///
+	/// If the `modify_mode` is [`Prepend`] or [`Append`], the `type` and
+	/// `format` must match that of the existing property's value, else a
+	/// [`Match` error] is generated.
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Prepend`]: ModifyPropertyMode::Prepend
+	/// [`Append`]: ModifyPropertyMode::Append
+	///
+	/// [`Property` event]: crate::x11::event::Property
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	/// [`Match` error]: error::Match
+	#[doc(alias = "ChangeProperty")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ModifyProperty: Request(18, ModifyPropertyError) {
+		#[metabyte]
+		/// The way in which the property is modified.
+		///
+		/// If the mode is [`Replace`], the previous property value is
+		/// discarded.
+		///
+		/// If the mode is [`Prepend`], the data is prepended to the existing
+		/// data. If the mode is [`Append`], the data is appended to the
+		/// existing data.
+		///
+		/// # Errors
+		/// If the mode is [`Prepend`] or [`Append`], the `type` and `format`
+		/// must match that of the existing property's value, else a
+		/// [`Match` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`Replace`]: ModifyPropertyMode::Replace
+		/// [`Prepend`]: ModifyPropertyMode::Prepend
+		/// [`Append`]: ModifyPropertyMode::Append
+		///
+		/// [`Match` error]: error::Match
+		#[doc(alias = "mode")]
+		pub modify_mode: ModifyPropertyMode,
+
+		/// The [window] which the `property` is modified for.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+
+		/// The property which is modified.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		///
+		/// [`Atom` error]: error::Atom
+		pub property: Atom,
+		/// The type of the property's data.
+		///
+		/// For example, if the property is of type [`Window`], then this would
+		/// be [`atom::WINDOW`].
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [`atom::WINDOW`]: crate::atom::WINDOW
+		///
+		/// [`Atom` error]: error::Atom
+		pub r#type: Atom,
+
+		// Whether the `data` is formatted as `i8` values, `i16` values, or
+		// `i32` values.
+		let format: DataFormat = data => match data {
+			DataList::I8(_) => DataFormat::I8,
+			DataList::I16(_) => DataFormat::I16,
+			DataList::I32(_) => DataFormat::I32,
+		},
+		[_; 3],
+
+		// The length of `data` in number of values (i.e., an `i32` value is
+		// counted as one, rather than the number of bytes).
+		#[allow(clippy::cast_possible_truncation)]
+		let data_len: u32 = data => data.len() as u32,
+
+		/// The property's value.
+		///
+		/// See [`DataList`] for information on the format of this data.
+		#[context(format, data_len => (*format, *data_len))]
+		pub data: DataList,
+	}
+}
+
+request_error! {
+	pub enum DeletePropertyError for DeleteProperty {
+		Atom,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that removes the given `property` from a [window].
+	///
+	/// If the `property` does not exist on the [window], this [request] has no
+	/// effect. Otherwise, a [`Property` event] is generated on the [window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Atom` error] is generated if the `property` does not refer to a
+	/// defined [atom].
+	///
+	/// [window]: Window
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`Property` event]: crate::x11::event::Property
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DeleteProperty: Request(19, DeletePropertyError) {
+		/// The [window] for which this [request] removes the `property`.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+
+		/// The property which is to be removed from the `target` [window].
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [window]: Window
+		///
+		/// [`Atom` error]: error::Atom
+		pub property: Atom,
+	}
+}
+
+request_error! {
+	pub enum GetPropertyError for GetProperty {
+		Atom,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that gets the value of the given `property` on the given
+	/// [window].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetProperty` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// An [`Atom` error] is generated if either `property` or `type` do not
+	/// refer to defined [atoms].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	/// [atoms]: Atom
+	///
+	/// [`GetProperty` reply]: reply::GetProperty
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetProperty: Request(20, GetPropertyError) -> reply::GetProperty {
+		/// Whether the `property` should be deleted from the `target` [window].
+		///
+		/// If the `type` matches the `property`'s actual type (or is [`Any`]),
+		/// the property is removed from the [window]. Otherwise, this is
+		/// ignored.
+		///
+		/// [window]: Window
+		///
+		/// [`Any`]: Any::Any
+		#[metabyte]
+		pub delete: bool,
+
+		/// The [window] on which the requested `property` is found.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+
+		/// The property for which this [request] gets its value.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		pub property: Atom,
+		/// The property type to filter the [window]'s properties by.
+		///
+		/// This specifies that specifically a `property` of this type is
+		/// requested. If the type does not match, the value is not provided in
+		/// [the reply].
+		///
+		/// [window]: Window
+		///
+		/// [the reply]: reply::GetProperty
+		pub r#type: Any<Atom>,
+
+		/// The offset of the value of the `property` that is requested in
+		/// 4-byte units.
+		///
+		/// This offset is multiplied by 4 when applied to the start of the
+		/// `property`'s data.
+		#[doc(alias = "long_offset")]
+		pub offset: u32,
+		/// The length of the value of the `property` that is requested in
+		/// 4-byte units.
+		///
+		/// This length is multiplied by 4 and added to the `offset` to find the
+		/// endpoint of the value that is requested.
+		#[doc(alias = "long_length")]
+		pub length: u32,
+	}
+
+	/// A [request] that returns the list of properties defined for the given
+	/// [window].
+	///
+	/// # Replies
+	/// This [request] generates a [`ListProperties` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`ListProperties` reply]: reply::ListProperties
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ListProperties: Request(21, error::Window) -> reply::ListProperties {
+		/// The [window] for which this [request] returns its properties.
+		///
+		/// # Errors
+		/// A [`Window` error] is returned if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+}
+
+request_error! {
+	pub enum SetSelectionOwnerError for SetSelectionOwner {
+		Atom,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the owner of the given selection.
+	///
+	/// If the `new_owner` is different to the previous owner of the selection,
+	/// and the previous owner was not [`None`], then a [`SelectionClear` event]
+	/// is sent to the previous owner.
+	///
+	/// If the given `time` is earlier than the [time] of the previous owner
+	/// change or is later than the X server's [current time], this [request]
+	/// has no effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `owner` is [`Some`] but does not
+	/// refer to a defined [window].
+	///
+	/// An [`Atom` error] is generated if `selection` does not refer to a
+	/// defined [atom].
+	///
+	/// [window]: Window
+	/// [atom]: Atom
+	/// [time]: crate::Timestamp
+	/// [request]: crate::message::Request
+	///
+	/// [current time]: CurrentableTime::CurrentTime
+	///
+	/// [`SelectionClear` event]: crate::x11::event::SelectionClear
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct SetSelectionOwner: Request(22, SetSelectionOwnerError) {
+		/// Sets the new owner of the `selection`.
+		///
+		/// [`None`] specifies that the `selection` is to have no owner.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "owner")]
+		pub new_owner: Option<Window>,
+		/// The selection for which this [request] changes its owner.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub selection: Atom,
+
+		/// The [time] at which this change is recorded to occur at.
+		///
+		/// If this [time] is earlier than the server's current 'last-change'
+		/// [time] for the selection's owner, or this [time] is later than the
+		/// server's [current time], this [request] has no effect.
+		///
+		/// [time]: crate::Timestamp
+		/// [current time]: CurrentableTime::CurrentTime
+		/// [request]: crate::message::Request
+		pub time: CurrentableTime,
+	}
+
+	/// A [request] that returns the owner of a given selection.
+	///
+	/// # Replies
+	/// This [request] generates a [`GetSelectionOwner` reply].
+	///
+	/// # Errors
+	/// An [`Atom` error] is generated if `target` does not refer to a defined
+	/// [atom].
+	///
+	/// [atom]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`GetSelectionOwner` reply]: reply::GetSelectionOwner
+	///
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetSelectionOwner: Request(23) -> reply::GetSelectionOwner {
+		/// The selection for which this [request] returns its owner.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub target: Atom,
+	}
+}
+
+request_error! {
+	pub enum ConvertSelectionError for ConvertSelection {
+		Atom,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that asks the given selection's owner to convert it to the
+	/// given `target_type`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `requester` does not refer to a
+	/// defined [window].
+	///
+	/// An [`Atom` error] is generated if any `selection`, `target_type`, or
+	/// `property` do not refer to defined [atoms].
+	///
+	/// [window]: Window
+	/// [atoms]: Atom
+	/// [request]: crate::message::Request
+	///
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ConvertSelection: Request(24, ConvertSelectionError) {
+		/// Your [window] which is requesting this conversion.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		pub requester: Window,
+
+		/// The selection which this [request] asks to be converted.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		/// [request]: crate::message::Request
+		///
+		/// [`Atom` error]: error::Atom
+		pub selection: Atom,
+
+		/// The type which the selection should be converted into.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if this does not refer to a defined
+		/// [atom].
+		///
+		/// [atom]: Atom
+		///
+		/// [`Atom` error]: error::Atom
+		pub target_type: Atom,
+		pub property: Option<Atom>,
+
+		/// The [time] at which this conversion is recorded as having taken
+		/// place.
+		///
+		/// [time]: crate::Timestamp
+		pub time: CurrentableTime,
+	}
+}
+
+request_error! {
+	pub enum SendEventError for SendEvent {
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that sends the given [event] to the given [window].
+	///
+	/// If the `event_mask` is empty, the [event] is sent to the client that
+	/// created the [window] - if that client no longer exists, the [event] is
+	/// not sent.
+	///
+	/// If `propagate` is `false`, the [event] is sent to every client selecting
+	/// any of the [events][event] indicated in the `event_mask`.
+	///
+	/// If `propagate` is `true` and no clients have selected any of the
+	/// [events][event] indicated in the `event_mask` on the [window], the
+	/// [event] is sent to the closest ancestor [window] of the [window] which
+	/// some client has selected at least one of the indicated [events][event]
+	/// for (provided no [windows][window] between the original destination and
+	/// the closest ancestor have that [event] in their
+	/// [`do_not_propagate_mask`]). The [event] is sent to every client
+	/// selecting any of the [events][event] indicated in the `event_mask` on
+	/// the final destination.
+	///
+	/// Active grabs are ignored for this [request].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `destination` is [`DestinationWindow::Other`] and the
+	/// specified [window] is not defined.
+	///
+	/// [window]: Window
+	/// [event]: Event
+	/// [request]: crate::message::Request
+	///
+	/// [`do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
+	///
+	/// [`Window` error]: error::Window
+	// FIXME: this requires that the event is absolutely 32 bytes, which is
+	//        currently not bounded.
+	//
+	// This feature would be nice for this:
+	// <https://github.com/rust-lang/rust/issues/92827>
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct SendEvent<E: Event + ConstantX11Size>: Request(25, SendEventError) {
+		/// Whether the `event` should be propagated to the closest appropriate
+		/// ancestor, if necessary.
+		///
+		/// That is, whether the `event` should be propagated to the closest
+		/// ancestor of the `destination` [window] which some client has
+		/// selected any of the [events] indicated in the `event_mask` on if no
+		/// clients have selected any of the [events] in the `event_mask` on the
+		/// `destination` [window].
+		///
+		/// [window]: Window
+		/// [events]: Event
+		#[metabyte]
+		pub propagate: bool,
+
+		/// The destination [window] for the `event`.
+		///
+		/// [window]: Window
+		pub destination: DestinationWindow,
+
+		/// The mask of [events][event] which should be selected for the [event]
+		/// to be sent to the selecting clients.
+		///
+		/// [event]: Event
+		pub event_mask: EventMask,
+
+		/// The [event] that is sent.
+		///
+		/// [event]: Event
+		pub event: E,
+	}
+}
diff --git a/src/x11/request/window.rs b/src/x11/request/window.rs
new file mode 100644
index 00000000..d4244acb
--- /dev/null
+++ b/src/x11/request/window.rs
@@ -0,0 +1,796 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to [windows] and
+//! their management.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [windows]: Window
+//! [Requests]: crate::message::Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	set::{Attributes, WindowConfig},
+	unit::Px,
+	visual::VisualId,
+	x11::{error, reply},
+	Coords,
+	CopyableFromParent,
+	Drawable,
+	Rectangle,
+	Window,
+	WindowClass,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum CreateWindowError for CreateWindow {
+		Colormap,
+		CursorAppearance,
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new unmapped [window] and assigns the
+	/// provided [`Window` ID][window] to it.
+	///
+	/// [request]: crate::message::Request
+	/// [window]: Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateWindow: Request(1, CreateWindowError) {
+		#[metabyte]
+		/// The [window]'s depth.
+		///
+		/// For a `class` of [`CopyFromParent`] or
+		/// <code>[Other]\([InputOutput])</code>, [`CopyFromParent`] for `depth`
+		/// means that the depth is copied from the `parent`.
+		///
+		/// # Errors
+		/// For a `class` of <code>[Other]\([InputOnly])</code>, however,
+		/// [`CopyFromParent`] is *required*, else a [`Match` error] is
+		/// generated, and _does not_ mean that the depth is copied from the
+		/// `parent`.
+		///
+		/// [window]: Window
+		///
+		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
+		/// [Other]: CopyableFromParent::Other
+		/// [InputOutput]: WindowClass::InputOutput
+		/// [InputOnly]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub depth: CopyableFromParent<u8>,
+
+		/// The [`Window` ID][window] which is to be assigned to the [window].
+		///
+		/// # Errors
+		/// If the provided [`Window` ID][window] is already used or it is not
+		/// allocated to your client, a [`ResourceIdChoice` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias = "wid")]
+		pub window_id: Window,
+		/// The [window] which should be used as the new [window]'s parent.
+		///
+		/// # Errors
+		/// For a `class` of [`InputOutput`], the parent cannot be an
+		/// [`InputOnly`] [window], else a [`Match` error] is generated.
+		///
+		/// [window]: Window
+		///
+		/// [`InputOutput`]: WindowClass::InputOutput
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub parent: Window,
+
+		/// The coordinates and dimensions of the [window].
+		///
+		/// The coordinates are of the top-left corner of the [window], and are
+		/// relative to the top-left corner of the [window]'s `parent`.
+		///
+		/// [window]: Window
+		pub geometry: Rectangle,
+		/// The width of the [window]'s border.
+		///
+		/// [window]: Window
+		pub border_width: Px<u16>,
+
+		/// The [window]'s [class].
+		///
+		/// [`CopyFromParent`] means the class is taken from the `parent`.
+		///
+		/// # Errors
+		/// For [`InputOutput`], the `visual` type and `depth` must be
+		/// combination supported by the [screen], else a [`Match` error] is
+		/// generated.
+		///
+		/// For [`InputOnly`], the `visual` must be one supported by the
+		/// [screen], else a [`Match` error] is generated.
+		///
+		/// [window]: Window
+		/// [class]: WindowClass
+		/// [screen]: crate::visual::Screen
+		///
+		/// [`CopyFromParent`]: CopyableFromParent::CopyFromParent
+		/// [`InputOutput`]: WindowClass::InputOutput
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		pub class: CopyableFromParent<WindowClass>,
+		/// The visual used by the [window].
+		///
+		/// See [`VisualType`] for more information.
+		///
+		/// [window]: Window
+		///
+		/// [`VisualType`]: crate::visual::VisualType
+		pub visual: CopyableFromParent<VisualId>,
+
+		/// Additional [attributes] configured for the [window].
+		///
+		/// See [`Attributes`] for more information.
+		///
+		/// [window]: Window
+		/// [attributes]: Attributes
+		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
+		pub attributes: Attributes,
+	}
+}
+
+request_error! {
+	pub enum ChangeWindowAttributesError for ChangeWindowAttributes {
+		Access,
+		Colormap,
+		CursorAppearance,
+		Match,
+		Pixmap,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that configures the [attributes] of a [window].
+	///
+	/// The [`event_mask`] attribute on the [window] is not shared between
+	/// clients: one client modifying the [`event_mask`] only selects interest
+	/// in the relevant events for that client. There are three exceptions to
+	/// this: only one client at a time may select [`SUBSTRUCTURE_REDIRECT`],
+	/// [`RESIZE_REDIRECT`], or [`BUTTON_PRESS`] on the [window].
+	///
+	/// [request]: crate::message::Request
+	/// [window]: Window
+	/// [attributes]: Attributes
+	///
+	/// [`event_mask`]: Attributes::event_mask
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	/// [`RESIZE_REDIRECT`]: crate::EventMask::RESIZE_REDIRECT
+	/// [`BUTTON_PRESS`]: crate::EventMask::BUTTON_PRESS
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeWindowAttributes: Request(2, ChangeWindowAttributesError) {
+		/// The [window] which the `attributes` are changed on.
+		///
+		/// [window]: Window
+		#[doc(alias = "window")]
+		pub target: Window,
+
+		/// The [attributes] which are changed.
+		///
+		/// [attributes]: Attributes
+		#[doc(alias("values", "value_mask", "value_list", "attribute_mask", "attribute_list"))]
+		pub attributes: Attributes,
+	}
+
+	/// A [request] that returns the current [attributes] of the [window].
+	///
+	/// [request]: crate::message::Request
+	/// [attributes]: Attributes
+	/// [window]: Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetWindowAttributes: Request(3, error::Window) -> reply::GetWindowAttributes {
+		/// The [window] for which this [request] gets the [attributes].
+		///
+		/// [request]: crate::message::Request
+		/// [attributes]: Attributes
+		/// [window]: Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that destroys the given [window] and all its descendents.
+	///
+	/// If the `target` [window] is mapped, an [`UnmapWindow` request] is
+	/// automatically performed.
+	///
+	/// The ordering of [`Destroy` events][event] is such that a
+	/// [`Destroy` event][event] is generated on every descendent of the target
+	/// [window] before being generated on the [window] itself.
+	///
+	/// This [request] has no effect on root [windows][window].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [event]: crate::x11::event::Destroy
+	///
+	/// [`UnmapWindow` request]: UnmapWindow
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DestroyWindow: Request(4, error::Window) {
+		/// The [window] which is the target of the `DestroyWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that [destroys] every child of the given [window] in
+	/// bottom-to-top stacking order.
+	///
+	/// A [`DestroyWindow` request][destroys] is performed on each child.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [destroys]: DestroyWindow
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "DestroySubwindows")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DestroyChildren: Request(5, error::Window) {
+		/// The [window] which will have its children [destroyed].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [destroyed]: DestroyWindow
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+}
+
+request_error! {
+	pub enum ReparentWindowError for ReparentWindow {
+		Match,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes a [window]'s parent to a different one.
+	///
+	/// If the [window] is mapped, an [`UnmapWindow` request] is first
+	/// automatically performed. The [window] is then removed from its current
+	/// parent and inserted as a child of the `new_parent`. If the [window] was
+	/// mapped originally, then a [`MapWindow` request] is then automatically
+	/// performed to map it again.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if either the `target` or the
+	/// `new_parent` do not refer to defined [windows][window].
+	///
+	/// A [`Match` error] is generated if the `new_parent` is not on the same
+	/// [screen] as the old parent.
+	///
+	/// A [`Match` error] is generated if the `new_parent` is the `target`
+	/// [window] itself, or a descendent of the `target` [window].
+	///
+	/// A [`Match` error] is generated if the `new_parent` is [`InputOnly`] but
+	/// the `target` [window] is not.
+	///
+	/// A [`Match` error] is generated if the `target` [window] has a
+	/// [`ParentRelative`] [`background_pixmap`] and the `new_parent` does not
+	/// have the same depth as the `target` [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	/// [screen]: crate::visual::Screen
+	///
+	/// [`UnmapWindow` request]: UnmapWindow
+	/// [`MapWindow` request]: MapWindow
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	/// [`ParentRelative`]: crate::ParentRelatable::ParentRelative
+	///
+	/// [`background_pixmap`]: Attributes::background_pixmap
+	///
+	/// [`Match` error]: error::Match
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ReparentWindow: Request(7, ReparentWindowError) {
+		/// The [window] which will be transferred to be a child of the
+		/// `new_parent`.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+		/// The `target`'s new parent [window].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// A [`Match` error] is generated if this [window] is not on the same
+		/// [screen] as the `target` [window].
+		///
+		/// A [`Match` error] is generated if this [window] is the same [window]
+		/// as the `target`, or is a descendent of the `target` [window].
+		///
+		/// A [`Match` error] is generated if this [window] is [`InputOnly`] but
+		/// the `target` [window] is not.
+		///
+		/// [window]: Window
+		/// [screen]: crate::visual::Screen
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		/// [`Window` error]: error::Window
+		#[doc(alias = "parent")]
+		pub new_parent: Window,
+
+		/// The `target`'s new coordinates relative to its `new_parent`'s
+		/// top-left corner.
+		#[doc(alias("x", "y"))]
+		pub coords: Coords,
+	}
+
+	/// A [request] that maps the given [window].
+	///
+	/// If the [window]'s [`override_redirect` attribute] is `false` and some
+	/// other client has selected [`SUBSTRUCTURE_REDIRECT`] on its parent, then
+	/// a [`MapWindowRequest` event] is generated, but the [window] remains
+	/// unmapped. Otherwise, the [window] is mapped and a [`Map` event] is
+	/// generated.
+	///
+	/// If the [window] is already mapped, this [request] has no effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Map` event]: crate::x11::event::Map
+	/// [`MapWindowRequest` event]: crate::x11::event::MapWindowRequest
+	///
+	/// [`override_redirect` attribute]: Attributes::override_redirect
+	///
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct MapWindow: Request(8, error::Window) {
+		/// The [window] which is the target of the `MapWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that [maps] every unmapped child of the given [window] in
+	/// top-to-bottom stacking order.
+	///
+	/// A [`MapWindow` request][maps] is performed on each unmapped child.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [maps]: MapWindow
+	///
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "MapSubwindows")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct MapChildren: Request(9, error::Window) {
+		/// The [window] which will have its unmapped children [mapped].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [mapped]: MapWindow
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that unmaps the given [window].
+	///
+	/// If the [window] is currently mapped, the [window] is unmapped and an
+	/// [`Unmap` event] is generated.
+	///
+	/// If the [window] is already unmapped, this [request] has no effect.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`Unmap` event]: crate::x11::event::Unmap
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UnmapWindow: Request(10, error::Window) {
+		/// The [window] which is the target of the `UnmapWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that [unmaps] every mapped child of the
+	/// given [window] in bottom-to-top stacking order.
+	///
+	/// An [`UnmapWindow` request][unmaps] is performed on each mapped child.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [unmaps]: UnmapWindow
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias = "UnmapSubwindows")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct UnmapChildren: Request(11, error::Window) {
+		/// The [window] which will have its mapped children [unmapped].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [unmapped]: UnmapWindow
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+}
+
+request_error! {
+	pub enum ConfigureWindowError for ConfigureWindow {
+		Match,
+		Value,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that [configures] a [window].
+	///
+	/// See [`WindowConfig`] for more information.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// A [`Match` error] is generated if either the [`width`] or [`height`] is
+	/// configured to be zero.
+	///
+	/// A [`Match` error] is generated if the [`border_width`] is configured to
+	/// be anything other than zero if the `target` [window] is [`InputOnly`].
+	///
+	/// A [`Match` error] is generated if [`sibling`] is configured without a
+	/// specified [`stack_mode`].
+	///
+	/// A [`Match` error] is generated if [`sibling`] is specified but that
+	/// specified [window] is not actually a sibling of the `target` [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [configures]: WindowConfig
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	///
+	/// [`width`]: WindowConfig::width
+	/// [`height`]: WindowConfig::height
+	/// [`border_width`]: WindowConfig::border_width
+	/// [`sibling`]: WindowConfig::sibling
+	/// [`stack_mode`]: WindowConfig::stack_mode
+	///
+	/// [`Window` error]: error::Window
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ConfigureWindow: Request(12, ConfigureWindowError) {
+		/// The [window] which is the target of the `ConfigureWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+
+		/// The changes to the `target` [window]'s [configuration].
+		///
+		/// See [`WindowConfig`] for more information.
+		///
+		/// If the `target` [window] is a root [window], this [request] has no
+		/// effect.
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if either the [`width`] or the
+		/// [`height`] is zero.
+		///
+		/// A [`Match` error] is generated if the [`border_width`] is set to
+		/// zero if the `target` [window] is [`InputOnly`].
+		///
+		/// A [`Match` error] is generated if [`sibling`] is configured without
+		/// a specified [`stack_mode`].
+		///
+		/// A [`Match` error] is generated if [`sibling`] is specified but that
+		/// specified [window] is not actually a sibling of the `target`
+		/// [window].
+		///
+		/// [configuration]: WindowConfig
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`width`]: WindowConfig::width
+		/// [`height`]: WindowConfig::height
+		/// [`border_width`]: WindowConfig::border_width
+		/// [`sibling`]: WindowConfig::sibling
+		/// [`stack_mode`]: WindowConfig::stack_mode
+		///
+		/// [`InputOnly`]: WindowClass::InputOnly
+		///
+		/// [`Match` error]: error::Match
+		#[doc(alias("values", "value_mask", "value_list", "window_config"))]
+		pub config: WindowConfig,
+	}
+}
+
+request_error! {
+	pub enum CirculateWindowError for CirculateWindow {
+		Value,
+		Window,
+	}
+}
+
+/// The direction with which a [window]'s mapped children are circulated in
+/// their stacking order.
+///
+/// This is used in the [`CirculateWindow` request].
+///
+/// [window]: Window
+///
+/// [`CirculateWindow` request]: CirculateWindow
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum CirculateDirection {
+	/// Raises the lowest mapped child that is occluded by another child, if
+	/// any, to the top of the stack.
+	RaiseLowest,
+
+	/// Lowers the highest mapped child that occludes another child, if any, to
+	/// the bottom of the stack.
+	LowerHighest,
+}
+
+derive_xrb! {
+	/// A [request] that [circulates] the mapped children of the given [window].
+	///
+	/// If some other client has selected [`SUBSTRUCTURE_REDIRECT`] on the
+	/// `target` [window], then a [`CirculateWindowRequest` event] is generated
+	/// and no further processing occurs. Otherwise, a [`Circulate` event] is
+	/// generated if one of the [window]'s children is actually restacked.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if the `target` does not refer to a
+	/// defined [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [circulates]: CirculateDirection
+	///
+	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
+	///
+	/// [`CirculateWindowRequest` event]: crate::x11::event::CirculateWindowRequest
+	/// [`Circulate` event]: crate::x11::event::Circulate
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CirculateWindow: Request(13, CirculateWindowError) {
+		#[metabyte]
+		/// Which of the [window]'s children might be circulated and in which
+		/// direction.
+		///
+		/// [window]: Window
+		pub direction: CirculateDirection,
+
+		/// The [window] which is the target of the `CirculateWindow` [request].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window error`]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+
+	/// A [request] that returns the root [window] and current geometry of the
+	/// given [drawable].
+	///
+	/// It is legal to pass an [`InputOnly`] [window] as a [drawable] to this
+	/// [request].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetGeometry` reply].
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if the `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [window]: Window
+	/// [pixmap]: crate::Pixmap
+	/// [drawable]: Drawable
+	/// [request]: crate::message::Request
+	///
+	/// [`InputOnly`]: WindowClass::InputOnly
+	///
+	/// [`GetGeometry` reply]: reply::GetGeometry
+	///
+	/// [`Drawable` error]: error::Drawable
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetGeometry: Request(14, error::Drawable) -> reply::GetGeometry {
+		/// The [drawable] for which this [request] gets its geometry.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [window]: Window
+		/// [pixmap]: crate::Pixmap
+		/// [drawable]: Drawable
+		/// [request]: crate::message::Request
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias = "drawable")]
+		pub target: Drawable,
+	}
+
+	/// A [request] that returns the root [window], the parent, and the children
+	/// of the given [window].
+	///
+	/// # Replies
+	/// This [request] generates a [`QueryWindowTree` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [window]: Window
+	/// [request]: crate::message::Request
+	///
+	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
+	///
+	/// [`Window` error]: error::Window
+	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
+	#[doc(alias("QueryParent", "QueryChildren", "QueryRoot"))]
+	#[doc(alias("GetParent", "GetChildren", "GetRoot"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct QueryWindowTree: Request(15, error::Window) -> reply::QueryWindowTree {
+		/// The [window] for which this [request] gets its root [window],
+		/// parent, and children.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [request]: crate::message::Request
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias = "window")]
+		pub target: Window,
+	}
+}

From cd6a87e5f29157dc5eec68795508a0e14f4814a8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Jan 2023 10:19:22 +0000
Subject: [PATCH 095/157] [CI861] applied recommended clippy fixes

---
 src/x11/request/graphics.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index a1dc9b50..ab7d6d76 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -18,7 +18,7 @@ use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 use crate::{
 	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
-	x11::{error, reply},
+	x11::{error},
 	Arc,
 	Coords,
 	Dimensions,

From 9411bd861b0919e21c18f6b33f8f0aff4dac838a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Jan 2023 10:19:24 +0000
Subject: [PATCH 096/157] [CI861] formatted code with rustfmt

---
 src/x11/request/graphics.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index ab7d6d76..30799acc 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -18,7 +18,7 @@ use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 use crate::{
 	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
-	x11::{error},
+	x11::error,
 	Arc,
 	Coords,
 	Dimensions,

From 52ff1c2acaa3399df86d06ad24f53c405c696f7f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 11:07:06 +0000
Subject: [PATCH 097/157] PlaceImage r equest

---
 src/connection.rs           |   2 +-
 src/x11/request/graphics.rs | 187 ++++++++++++++++++++++++++++++++++++
 2 files changed, 188 insertions(+), 1 deletion(-)

diff --git a/src/connection.rs b/src/connection.rs
index 6063a7fa..e275de68 100644
--- a/src/connection.rs
+++ b/src/connection.rs
@@ -149,7 +149,7 @@ derive_xrb! {
 		pub image_byte_order: ImageEndianness,
 		pub bitmap_format_bit_order: ImageEndianness,
 		pub bitmap_format_scanline_unit: u8,
-		pub bitmap_format_scanline_pad: u8,
+		pub bitmap_format_scanline_padding: u8,
 
 		pub min_keycode: Keycode,
 		pub max_keycode: Keycode,
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index 30799acc..e48480c4 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -1996,3 +1996,190 @@ derive_xrb! {
 		pub arcs: Vec<Arc>,
 	}
 }
+
+request_error! {
+	#[doc(alias("PutImageError"))]
+	pub enum PlaceImageError for PlaceImage {
+		Drawable,
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// The format of an image sent in a [`PlaceImage` request].
+///
+/// [`PlaceImage` request]: PlaceImage
+#[doc(alias("PutImageFormat"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum PlaceImageFormat {
+	/// The image must be in XY format.
+	///
+	/// The `graphics_context`'s [`foreground_color`] is used where the image
+	/// has bits set to `1`, while the [`background_color`] is used where the
+	/// image has bits set to `0`.
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	Bitmap,
+
+	/// The image must be in XY format.
+	XyPixmap,
+
+	/// The image must be in Z format.
+	Zpixmap,
+}
+
+derive_xrb! {
+	/// A [request] that places the given image on the given [drawable].
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`function`]
+	/// - [`plane_mask`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// This [request] may also use these [options], depending on the
+	/// provided `format`:
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// A [`Match` error] is generated if [`PlaceImageFormat::XyPixmap`] or
+	/// [`PlaceImageFormat::Zpixmap`] is used and `depth` does not match the
+	/// depth of the `target` [drawable].
+	///
+	/// A [`Match` error] is generated if [`PlaceImageFormat::Bitmap`] is used
+	/// and `depth` is not `1`.
+	///
+	/// A [`Match` error] is generated if [`PlaceImageFormat::Bitmap`] or
+	/// [`PlaceImageFormat::XyPixmap`] is used and `left_padding` is not less
+	/// than `bitmap_scanline_padding` (given in
+	/// [`connection::ConnectionSuccess`]).
+	///
+	/// A [`Match` error] is generated if [`PlaceImageFormat::Zpixmap`] is used
+	/// and `left_padding` is not `0`.
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [options]: GraphicsOptions
+	/// [request]: crate::message::Request
+	///
+	/// [`function`]: GraphicsOptions::function
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	///
+	/// [`connection::ConnectionSuccess`]: crate::connection::ConnectionSuccess
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("PutImage"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct PlaceImage: Request(72, PlaceImageError) {
+		/// The [image format] used.
+		///
+		/// [image format]: PlaceImageFormat
+		#[metabyte]
+		pub format: PlaceImageFormat,
+
+		/// The [drawable] on which the image is placed.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The image's width and height.
+		pub dimensions: Dimensions,
+		/// The [coordinates] at which the image will be placed on the `target`
+		/// [drawable].
+		///
+		/// These coordinates are relative to the top-left corner of the
+		/// [drawable].
+		///
+		/// [drawable]: Drawable
+		/// [coordinates]: Coords
+		pub coordinates: Coords,
+
+		/// The number of bits in each scanline of the image which are to be
+		/// ignored by the X server.
+		///
+		/// The actual image begins this many bits into the scanline.
+		///
+		/// This is only used for [`PlaceImageFormat::Bitmap`] and
+		/// [`PlaceImageFormat::XyPixmap`]. It must be `0` for
+		/// [`PlaceImageFormat::Zpixmap`].
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if `format` is
+		/// [`PlaceImageFormat::Bitmap`] or [`PlaceImageFormat::XyPixmap`] and
+		/// this is not less than `bitmap_scanline_padding` (given in
+		/// [`connection::ConnectionSuccess`]).
+		///
+		/// A [`Match` error] is generated if `format` is
+		/// [`PlaceImageFormat::Zpixmap`] and this is not `0`.
+		///
+		/// [`connection::ConnectionSuccess`]: crate::connection::ConnectionSuccess
+		///
+		/// [`Match` error]: error::Match
+		pub left_padding: u8,
+
+		/// The depth of the image.
+		///
+		/// If `format` is [`PlaceImageFormat::Bitmap`], this must be `1`.
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if `format` is
+		/// [`PlaceImageFormat::XyPixmap`] or [`PlaceImageFormat::Zpixmap`]
+		/// and this does not match the depth of the `target` [drawable].
+		///
+		/// A [`Match` error] is generated if `format` is
+		/// [`PlaceImageFormat::Bitmap`] and this is not `1`.
+		///
+		/// [drawable]: Drawable
+		///
+		/// [`Match` error]: error::Match
+		pub depth: u8,
+		[_; 2],
+
+		// FIXME: how do we know what is padding and what is data??????
+		/// The image's data.
+		#[context(self::remaining => remaining)]
+		pub data: Vec<u8>,
+		[_; data => pad(data)],
+	}
+}

From 87d6183eaa63dd83673524ec39a45b38a08b9905 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 11:59:38 +0000
Subject: [PATCH 098/157] CaptureImage request and reply

---
 src/x11/reply/graphics.rs   |  54 ++++++++++++++++
 src/x11/request/graphics.rs | 120 +++++++++++++++++++++++++++++++++++-
 2 files changed, 173 insertions(+), 1 deletion(-)

diff --git a/src/x11/reply/graphics.rs b/src/x11/reply/graphics.rs
index 0d346e6c..85b2a0a8 100644
--- a/src/x11/reply/graphics.rs
+++ b/src/x11/reply/graphics.rs
@@ -13,3 +13,57 @@
 //! [core X11 protocol]: crate::x11
 //!
 //! [requests that relate to graphics operations]: request::graphics
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk::pad;
+use xrbk_macro::derive_xrb;
+
+use crate::{visual::VisualId, x11::request};
+
+derive_xrb! {
+	/// The [reply] to a [`CaptureImage` request].
+	///
+	/// [reply]: crate::message::Reply
+	///
+	/// [`CaptureImage` request]: request::CaptureImage
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct CaptureImage: Reply for request::CaptureImage {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: crate::message::Reply
+		///
+		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The depth of the `target` [drawable] when it was created.
+		///
+		/// [drawable]: crate::Drawable
+		#[metabyte]
+		pub depth: u8,
+
+		/// The visual type of the `target` if it is a [window].
+		///
+		/// If the `target` is a [pixmap], this is [`None`].
+		///
+		/// [window]: crate::Window
+		/// [pixmap]: crate::Pixmap
+		pub visual: Option<VisualId>,
+		[_; 20],
+
+		// FIXME: how do we know what is padding and what is data?????
+		/// The image's data.
+		#[context(self::remaining => remaining)]
+		pub data: Vec<u8>,
+		[_; data => pad(data)],
+	}
+}
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index e48480c4..dfa62849 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -18,7 +18,7 @@ use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 use crate::{
 	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
-	x11::error,
+	x11::{error, reply},
 	Arc,
 	Coords,
 	Dimensions,
@@ -2183,3 +2183,121 @@ derive_xrb! {
 		[_; data => pad(data)],
 	}
 }
+
+request_error! {
+	#[doc(alias("GetImageError"))]
+	pub enum CaptureImageError for CaptureImage {
+		Drawable,
+		Match,
+		Value,
+	}
+}
+
+/// The format of the image returned in a [`CaptureImage` reply].
+///
+/// This is used in the [`CaptureImage` request].
+///
+/// [`CaptureImage` request]: CaptureImage
+/// [`CaptureImage` reply]: reply::CaptureImage
+#[doc(alias("GetImageFormat"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum CaptureImageFormat {
+	/// The image is returned in XY format.
+	XyPixmap,
+
+	/// The image is returned in Z format.
+	Zpixmap,
+}
+
+derive_xrb! {
+	/// A [request] that returns the contents of the given `area` of the given
+	/// [drawable] as an image.
+	///
+	/// If the `target` is a [window], the [window]'s border may be included in
+	/// the image.
+	///
+	/// If the `target` is a [window], its contents are [maintained], and it is
+	/// obscured by a [window] which is not one of its descendents, the
+	/// [maintained] contents will be returned for those obscured regions.
+	/// Otherwise, if the contents are not [maintained], or the [window] is
+	/// obscured by one of its descendents, the contents of those obscured
+	/// regions in the returned image are undefined. The contents of visible
+	/// regions of descendents with a different depth than the `target` are also
+	/// undefined.
+	///
+	/// The cursor is never included in the returned image.
+	///
+	/// # Replies
+	/// This [request] generates a [`CaptureImage` reply].
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`Match` error] is generated if the given area is not fully contained
+	/// within the `target` [drawable].
+	///
+	/// A [`Match` error] is generated if the `target` is a [window] and the
+	/// [window] is not viewable.
+	///
+	/// A [`Match` error] is generated if the `target` is a [window] and the
+	/// [window] is not fully contained within the [screen].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [screen]: crate::visual::Screen
+	/// [request]: crate::message::Request
+	///
+	/// [maintained]: crate::MaintainContents
+	///
+	/// [`CaptureImage` reply]: reply::CaptureImage
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`Match` error]: error::Match
+	#[doc(alias("GetImage"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CaptureImage: Request(73, CaptureImageError) -> reply::CaptureImage {
+		/// The [image format] of the image that is returned in the
+		/// [`CaptureImage` reply].
+		///
+		/// [image format]: CaptureImageFormat
+		/// [`CaptureImage` reply]: reply::CaptureImage
+		#[metabyte]
+		pub format: CaptureImageFormat,
+
+		/// The [drawable] for which this [request] captures an image from the
+		/// given `area`.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [request]: crate::message::Request
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The area of the `target` [drawable] which this [request] captures an
+		/// image of.
+		///
+		/// [drawable]: Drawable
+		/// [request]: crate::message::Request
+		#[doc(alias("x", "y", "width", "height"))]
+		pub area: Rectangle,
+
+		/// A mask applied to the returned image's bit planes.
+		///
+		/// If the given `format` is [`CaptureImageFormat::XyPixmap`], only the
+		/// bit planes specified in this mask are transmitted, and they are
+		/// transmitted from most significant to least significant in bit order.
+		///
+		/// If the given `format` is [`CaptureImageFormat::Zpixmap`], all bits
+		/// in planes not specified by this mask are zero.
+		pub plane_mask: u32,
+	}
+}

From be6fdf5d7a891378ac9c7962cfb63742216c9f02 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 14:26:43 +0000
Subject: [PATCH 099/157] DrawText8 request

---
 src/x11/request/graphics.rs | 449 +++++++++++++++++++++++++++++++++---
 1 file changed, 419 insertions(+), 30 deletions(-)

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index dfa62849..d69c2ebf 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -7,15 +7,29 @@
 //!
 //! [Requests] are messages sent from an X client to the X server.
 //!
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
 
-use xrbk::{pad, ConstantX11Size};
+use thiserror::Error;
+
+use xrbk::{
+	pad,
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadResult,
+	Readable,
+	ReadableWithContext,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 
 use crate::{
+	message::Request,
 	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
 	x11::{error, reply},
@@ -23,9 +37,11 @@ use crate::{
 	Coords,
 	Dimensions,
 	Drawable,
+	Font,
 	GraphicsContext,
 	Pixmap,
 	Rectangle,
+	String8,
 	Window,
 };
 
@@ -87,7 +103,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [pixmap]: Pixmap
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Drawable` error]: error::Drawable
 	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
@@ -129,7 +145,7 @@ derive_xrb! {
 		/// [window]: Window
 		/// [pixmap]: Pixmap
 		/// [drawable]: Drawable
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`InputOnly`]: crate::WindowClass::InputOnly
 		///
@@ -157,7 +173,7 @@ derive_xrb! {
 	/// [pixmap].
 	///
 	/// [pixmap]: Pixmap
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Pixmap` error]: error::Pixmap
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
@@ -201,7 +217,7 @@ derive_xrb! {
 	///
 	/// [pixmap]: Pixmap
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GraphicsContext` ID]: GraphicsContext
 	///
@@ -287,7 +303,7 @@ derive_xrb! {
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [graphics options]: GraphicsOptions
 	///
@@ -310,7 +326,7 @@ derive_xrb! {
 		/// defined [`GraphicsContext`].
 		///
 		/// [graphics options]: GraphicsOptions
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`GraphicsContext` error]: error::GraphicsContext
 		#[doc(alias("gc", "graphics_context", "context"))]
@@ -347,7 +363,7 @@ derive_xrb! {
 	///
 	/// [graphics options]: GraphicsOptions
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GraphicsContext`s]: GraphicsContext
 	///
@@ -421,7 +437,7 @@ derive_xrb! {
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`dashes`]: GraphicsOptions::dashes
 	/// [`dash_offset`]: GraphicsOptions::dash_offset
@@ -438,7 +454,7 @@ derive_xrb! {
 		/// A [`GraphicsContext` error] is generated if this does not refer to a
 		/// defined [`GraphicsContext`].
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		pub target: GraphicsContext,
 
 		/// The offset from the endpoints or joinpoints of a dashed line before
@@ -542,7 +558,7 @@ derive_xrb! {
 	/// defined [`GraphicsContext`].
 	///
 	/// [rectangles]: Rectangle
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`clip_x`]: GraphicsOptions::clip_x
 	/// [`clip_y`]: GraphicsOptions::clip_y
@@ -565,7 +581,7 @@ derive_xrb! {
 		/// A [`GraphicsContext` error] is generated if this does not refer to a
 		/// defined [`GraphicsContext`].
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`GraphicsContext` error]: error::GraphicsContext
 		pub target: GraphicsContext,
@@ -616,7 +632,7 @@ derive_xrb! {
 	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
 	/// defined [`GraphicsContext`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GraphicsContext` ID]: GraphicsContext
 	///
@@ -660,7 +676,7 @@ derive_xrb! {
 	/// [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`background_pixmap`]: crate::set::Attributes::background_pixmap
 	/// [`background_color`]: crate::set::Attributes::background_color
@@ -687,7 +703,7 @@ derive_xrb! {
 		/// A [`Match` error] is generated if this is an [`InputOnly`] [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`InputOnly`]: crate::WindowClass::InputOnly
 		///
@@ -750,7 +766,7 @@ derive_xrb! {
 	/// [pixmaps]: Pixmap
 	/// [regions]: crate::Region
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [maintained]: crate::MaintainContents
 	///
@@ -889,7 +905,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [region]: crate::Region
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1062,7 +1078,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1190,7 +1206,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1326,7 +1342,7 @@ derive_xrb! {
 	/// [pixmap]: Pixmap
 	/// [lines]: Line
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1441,7 +1457,7 @@ derive_xrb! {
 	/// [lines]: Line
 	/// [rectangles]: Rectangle
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1556,7 +1572,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1695,7 +1711,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1823,7 +1839,7 @@ derive_xrb! {
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
 	/// [rectangle]: Rectangle
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -1934,7 +1950,7 @@ derive_xrb! {
 	/// [options]: GraphicsOptions
 	/// [arc]: Arc
 	/// [line]: Line
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`ArcMode::Chord`]: crate::set::ArcMode::Chord
 	/// [`ArcMode::PieSlice`]: crate::set::ArcMode::PieSlice
@@ -2073,7 +2089,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [options]: GraphicsOptions
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`function`]: GraphicsOptions::function
 	/// [`plane_mask`]: GraphicsOptions::plane_mask
@@ -2247,7 +2263,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: Pixmap
 	/// [screen]: crate::visual::Screen
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [maintained]: crate::MaintainContents
 	///
@@ -2276,7 +2292,7 @@ derive_xrb! {
 		/// [drawable]: Drawable
 		/// [window]: Window
 		/// [pixmap]: Pixmap
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Drawable` error]: error::Drawable
 		#[doc(alias("drawable"))]
@@ -2286,7 +2302,7 @@ derive_xrb! {
 		/// image of.
 		///
 		/// [drawable]: Drawable
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		#[doc(alias("x", "y", "width", "height"))]
 		pub area: Rectangle,
 
@@ -2301,3 +2317,376 @@ derive_xrb! {
 		pub plane_mask: u32,
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyText8Error"))]
+	pub enum DrawText8Error for DrawText8 {
+		Drawable,
+		Font,
+		GraphicsContext,
+		Match,
+	}
+}
+
+/// A 'text item' specified in a [`DrawText8` request].
+///
+/// [`DrawText8` request]: DrawText8
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum TextItem8 {
+	/// Specifies text that is to be drawn with the `graphics_context`'s current
+	/// [font].
+	///
+	/// [font]: Font
+	Text(Box<Text8>),
+
+	/// Changes the `graphics_context`'s current [font].
+	///
+	/// This new [font] will be used for subsequent text items.
+	///
+	/// [font]: Font
+	// Font must always be big-endian
+	Font(Font),
+}
+
+impl X11Size for TextItem8 {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::Text(text) => text.x11_size(),
+			Self::Font(font) => font.x11_size() + u8::X11_SIZE,
+		}
+	}
+}
+
+impl Readable for TextItem8 {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		Ok(match buf.get_u8() {
+			font_shift if font_shift == 255 => Self::Font(Font::new(buf.get_u32())),
+			string_len => Self::Text(Box::new(Text8::read_with(buf, &string_len)?)),
+		})
+	}
+}
+
+impl Writable for TextItem8 {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Text(text) => text.write_to(buf)?,
+
+			Self::Font(font) => {
+				// Font-shift indicator
+				buf.put_u8(255);
+
+				font.write_to(buf)?;
+			},
+		}
+
+		Ok(())
+	}
+}
+
+/// A [text item] that specifies text to be drawn using the `graphics_context`'s
+/// current [`font`].
+///
+/// This is used in the [`DrawText8` request].
+///
+/// [text item]: TextItem8
+/// [`font`]: GraphicsOptions::font
+///
+/// [`DrawText8` request]: DrawText8
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct Text8 {
+	horizontal_offset: Px<i8>,
+	string: String8,
+}
+
+/// An error returned when the given string is too long.
+#[derive(Debug, Hash, PartialEq, Eq, Error)]
+#[error("the maximum length allowed here is {max}, found {found}")]
+pub struct TextTooLong {
+	/// The maximum length of the string.
+	pub max: u8,
+	/// The length of the string that was given.
+	pub found: usize,
+}
+
+impl Text8 {
+	/// Creates a new `Text8` with the given `horizontal_offset` and `string`.
+	///
+	/// `horizontal_offset` specifies the offset that is applied to the start of
+	/// the `string`.
+	///
+	/// # Errors
+	/// A [`TextTooLong`] error is returned if `string.len() > 255`.
+	pub fn new(horizontal_offset: Px<i8>, string: String8) -> Result<Self, TextTooLong> {
+		if string.len() > 255 {
+			Err(TextTooLong {
+				max: 255,
+				found: string.len(),
+			})
+		} else {
+			Ok(Self {
+				horizontal_offset,
+				string,
+			})
+		}
+	}
+
+	/// The horizontal offset applied to the start of the [`string`].
+	///
+	/// [`string`]: Text8::string
+	#[must_use]
+	pub const fn horizontal_offset(&self) -> Px<i8> {
+		self.horizontal_offset
+	}
+
+	/// The text which is to be drawn.
+	#[must_use]
+	pub const fn string(&self) -> &String8 {
+		&self.string
+	}
+
+	/// Unwraps this `Text8`, returning the `horizontal_offset` and `string`.
+	#[must_use]
+	#[allow(clippy::missing_const_for_fn, reason = "false positive")]
+	pub fn unwrap(self) -> (Px<i8>, String8) {
+		(self.horizontal_offset, self.string)
+	}
+}
+
+impl X11Size for Text8 {
+	fn x11_size(&self) -> usize {
+		u8::X11_SIZE + i8::X11_SIZE + self.string.x11_size()
+	}
+}
+
+impl ReadableWithContext for Text8 {
+	type Context = u8;
+
+	fn read_with(buf: &mut impl Buf, string_len: &u8) -> ReadResult<Self> {
+		Ok(Self {
+			horizontal_offset: Px(i8::read_from(buf)?),
+			string: String8::read_with(buf, &usize::from(*string_len))?,
+		})
+	}
+}
+
+impl Writable for Text8 {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		buf.put_u8(self.string.len() as u8);
+		self.horizontal_offset.write_to(buf)?;
+		self.string.write_to(buf)?;
+
+		Ok(())
+	}
+}
+
+/// A [request] that draws the given text on the given [drawable].
+///
+/// # Graphics options used
+/// This [request] uses the following [options] of the `graphics_context`:
+/// - [`function`]
+/// - [`plane_mask`]
+/// - [`fill_style`]
+/// - [`font`]
+/// - [`child_mode`]
+/// - [`clip_x`]
+/// - [`clip_y`]
+/// - [`clip_mask`]
+///
+/// This [request] may also use these [options], depending on the configuration
+/// of the `graphics_context`:
+/// - [`foreground_color`]
+/// - [`background_color`]
+/// - [`tile`]
+/// - [`stipple`]
+/// - [`tile_stipple_x`]
+/// - [`tile_stipple_y`]
+///
+/// # Errors
+/// A [`Drawable` error] is generated if `target` does not refer to a defined
+/// [window] nor [pixmap].
+///
+/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+/// refer to a defined [`GraphicsContext`].
+///
+/// A [`Font` error] is generated if a [font item] given in `text_items` does
+/// not refer to a defined [font]. Previous [text items] may have already been
+/// drawn.
+///
+/// [drawable]: Drawable
+/// [window]: Window
+/// [pixmap]: Pixmap
+/// [font]: Font
+/// [font item]: TextItem8::Font
+/// [text items]: TextItem8
+/// [options]: GraphicsOptions
+/// [request]: Request
+///
+/// [`function`]: GraphicsOptions::function
+/// [`plane_mask`]: GraphicsOptions::plane_mask
+/// [`fill_style`]: GraphicsOptions::fill_style
+/// [`font`]: GraphicsOptions::font
+/// [`child_mode`]: GraphicsOptions::child_mode
+/// [`clip_x`]: GraphicsOptions::clip_x
+/// [`clip_y`]: GraphicsOptions::clip_y
+/// [`clip_mask`]: GraphicsOptions::clip_mask
+///
+/// [`foreground_color`]: GraphicsOptions::foreground_color
+/// [`background_color`]: GraphicsOptions::background_color
+/// [`tile`]: GraphicsOptions::tile
+/// [`stipple`]: GraphicsOptions::stipple
+/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+///
+/// [`Drawable` error]: error::Drawable
+/// [`GraphicsContext` error]: error::GraphicsContext
+/// [`Font` error]: error::Font
+#[doc(alias("PolyText8"))]
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct DrawText8 {
+	/// The [drawable] on which the text is drawn.
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if this does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	///
+	/// [`Drawable` error]: error::Drawable
+	#[doc(alias("drawable"))]
+	pub target: Drawable,
+
+	/// The [`GraphicsContext`] used in this graphics operation.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if this does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("gc", "context", "gcontext"))]
+	pub graphics_context: GraphicsContext,
+
+	/// The starting position of the first character of text.
+	///
+	/// These coordinates are relative to the top-left corner of the `target`
+	/// [drawable].
+	///
+	/// [drawable]: Drawable
+	#[doc(alias("x", "y"))]
+	pub coordinates: Coords,
+
+	/// The [text items] which control the drawing of the text.
+	///
+	/// Each item can either [specify text], in which case that text is drawn
+	/// (with the provided [`horizontal_offset`] applied), or a [font item], in
+	/// which case that [font] is stored in the `graphics_context` and used for
+	/// subsequent text.
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if a [font item] does not refer to a
+	/// defined [font]. Previous [text items] may have already been drawn.
+	///
+	/// [specify text]: TextItem8::Text
+	/// [font item]: TextItem8::Font
+	/// [`horizontal_offset`]: Text8::horizontal_offset
+	/// [text items]: TextItem8
+	///
+	/// [font]: Font
+	#[doc(alias("items"))]
+	pub text_items: Vec<TextItem8>,
+}
+
+impl Request for DrawText8 {
+	type OtherErrors = DrawText8Error;
+	type Reply = ();
+
+	const MAJOR_OPCODE: u8 = 74;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl X11Size for DrawText8 {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 4;
+
+		const CONSTANT_SIZES: usize = {
+			HEADER
+			+ Drawable::X11_SIZE // `target`
+			+ GraphicsContext::X11_SIZE // `graphics_context`
+			+ Coords::X11_SIZE // `coordinates`
+		};
+
+		CONSTANT_SIZES + self.text_items.x11_size() + pad(&self.text_items)
+	}
+}
+
+impl Readable for DrawText8 {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		/// The maximum number of padding bytes that there could be at the end.
+		///
+		/// As long as there are more than this many bytes remaining, we know
+		/// that there are still text items left to read.
+		const MAX_PADDING: usize = 1;
+
+		// major opcode is already read
+
+		// Metabyte position is unused.
+		buf.advance(1);
+
+		// Read the length and bound buf to not read more than it.
+		let length = (usize::from(buf.get_u16()) * 4) - 2;
+		let buf = &mut buf.take(length);
+
+		let target = Drawable::read_from(buf)?;
+		let graphics_context = GraphicsContext::read_from(buf)?;
+		let coordinates = Coords::read_from(buf)?;
+
+		let text_items = {
+			let mut text_items = Vec::new();
+
+			while buf.remaining() > MAX_PADDING {
+				text_items.push(TextItem8::read_from(buf)?);
+			}
+
+			text_items
+		};
+
+		// Advance the padding bytes at the end.
+		buf.advance(pad(&text_items));
+
+		Ok(Self {
+			target,
+			graphics_context,
+			coordinates,
+			text_items,
+		})
+	}
+}
+
+impl Writable for DrawText8 {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		let buf = &mut buf.limit(self.x11_size());
+
+		buf.put_u8(Self::MAJOR_OPCODE);
+		// Unused metabyte position.
+		buf.put_u8(0);
+		buf.put_u16(self.length());
+
+		self.target.write_to(buf)?;
+		self.graphics_context.write_to(buf)?;
+		self.coordinates.write_to(buf)?;
+		self.text_items.write_to(buf)?;
+
+		// Unused padding bytes at the end.
+		buf.put_bytes(0, pad(&self.text_items));
+
+		Ok(())
+	}
+}

From 3995f8374a469ca02d09598c855b01512fda1969 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 14:37:59 +0000
Subject: [PATCH 100/157] DrawText16 request

---
 src/x11/request/graphics.rs | 370 +++++++++++++++++++++++++++++++++++-
 1 file changed, 367 insertions(+), 3 deletions(-)

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index d69c2ebf..ba9bbd3b 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -41,6 +41,7 @@ use crate::{
 	GraphicsContext,
 	Pixmap,
 	Rectangle,
+	String16,
 	String8,
 	Window,
 };
@@ -2386,8 +2387,8 @@ impl Writable for TextItem8 {
 	}
 }
 
-/// A [text item] that specifies text to be drawn using the `graphics_context`'s
-/// current [`font`].
+/// A [text item] that specifies [`String8`] text to be drawn using the
+/// `graphics_context`'s current [`font`].
 ///
 /// This is used in the [`DrawText8` request].
 ///
@@ -2483,7 +2484,7 @@ impl Writable for Text8 {
 	}
 }
 
-/// A [request] that draws the given text on the given [drawable].
+/// A [request] that draws the given [`String8`] text on the given [drawable].
 ///
 /// # Graphics options used
 /// This [request] uses the following [options] of the `graphics_context`:
@@ -2690,3 +2691,366 @@ impl Writable for DrawText8 {
 		Ok(())
 	}
 }
+
+request_error! {
+	#[doc(alias("PolyText16Error"))]
+	pub enum DrawText16Error for DrawText16 {
+		Drawable,
+		Font,
+		GraphicsContext,
+		Match,
+	}
+}
+
+/// A 'text item' specified in a [`DrawText16` request].
+///
+/// [`DrawText16` request]: DrawText16
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum TextItem16 {
+	/// Specifies text that is to be drawn with the `graphics_context`'s current
+	/// [font].
+	///
+	/// [font]: Font
+	Text(Box<Text16>),
+
+	/// Changes the `graphics_context`'s current [font].
+	///
+	/// This new [font] will be used for subsequent text items.
+	///
+	/// [font]: Font
+	// Font must always be big-endian
+	Font(Font),
+}
+
+impl X11Size for TextItem16 {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::Text(text) => text.x11_size(),
+			Self::Font(font) => font.x11_size() + u8::X11_SIZE,
+		}
+	}
+}
+
+impl Readable for TextItem16 {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		Ok(match buf.get_u8() {
+			font_shift if font_shift == 255 => Self::Font(Font::new(buf.get_u32())),
+			string_len => Self::Text(Box::new(Text16::read_with(buf, &string_len)?)),
+		})
+	}
+}
+
+impl Writable for TextItem16 {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Text(text) => text.write_to(buf)?,
+
+			Self::Font(font) => {
+				// Font-shift indicator
+				buf.put_u8(255);
+
+				font.write_to(buf)?;
+			},
+		}
+
+		Ok(())
+	}
+}
+
+/// A [text item] that specifies [`String16`] text to be drawn using the
+/// `graphics_context`'s current [`font`].
+///
+/// This is used in the [`DrawText16` request].
+///
+/// [text item]: TextItem16
+/// [`font`]: GraphicsOptions::font
+///
+/// [`DrawText16` request]: DrawText16
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct Text16 {
+	horizontal_offset: Px<i8>,
+	string: String16,
+}
+
+impl Text16 {
+	/// Creates a new `Text16` with the given `horizontal_offset` and `string`.
+	///
+	/// `horizontal_offset` specifies the offset that is applied to the start of
+	/// the `string`.
+	///
+	/// # Errors
+	/// A [`TextTooLong`] error is returned if `string.len() > 255`.
+	pub fn new(horizontal_offset: Px<i8>, string: String16) -> Result<Self, TextTooLong> {
+		if string.len() > 255 {
+			Err(TextTooLong {
+				max: 255,
+				found: string.len(),
+			})
+		} else {
+			Ok(Self {
+				horizontal_offset,
+				string,
+			})
+		}
+	}
+
+	/// The horizontal offset applied to the start of the [`string`].
+	///
+	/// [`string`]: Text16::string
+	#[must_use]
+	pub const fn horizontal_offset(&self) -> Px<i8> {
+		self.horizontal_offset
+	}
+
+	/// The text which is to be drawn.
+	#[must_use]
+	pub const fn string(&self) -> &String16 {
+		&self.string
+	}
+
+	/// Unwraps this `Text16`, returning the `horizontal_offset` and `string`.
+	#[must_use]
+	#[allow(clippy::missing_const_for_fn, reason = "false positive")]
+	pub fn unwrap(self) -> (Px<i8>, String16) {
+		(self.horizontal_offset, self.string)
+	}
+}
+
+impl X11Size for Text16 {
+	fn x11_size(&self) -> usize {
+		u8::X11_SIZE + i8::X11_SIZE + self.string.x11_size()
+	}
+}
+
+impl ReadableWithContext for Text16 {
+	type Context = u8;
+
+	fn read_with(buf: &mut impl Buf, string_len: &u8) -> ReadResult<Self> {
+		Ok(Self {
+			horizontal_offset: Px(i8::read_from(buf)?),
+			string: String16::read_with(buf, &usize::from(*string_len))?,
+		})
+	}
+}
+
+impl Writable for Text16 {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		buf.put_u8(self.string.len() as u8);
+		self.horizontal_offset.write_to(buf)?;
+		self.string.write_to(buf)?;
+
+		Ok(())
+	}
+}
+
+/// A [request] that draws the given [`String16`] text on the given [drawable].
+///
+/// # Graphics options used
+/// This [request] uses the following [options] of the `graphics_context`:
+/// - [`function`]
+/// - [`plane_mask`]
+/// - [`fill_style`]
+/// - [`font`]
+/// - [`child_mode`]
+/// - [`clip_x`]
+/// - [`clip_y`]
+/// - [`clip_mask`]
+///
+/// This [request] may also use these [options], depending on the configuration
+/// of the `graphics_context`:
+/// - [`foreground_color`]
+/// - [`background_color`]
+/// - [`tile`]
+/// - [`stipple`]
+/// - [`tile_stipple_x`]
+/// - [`tile_stipple_y`]
+///
+/// # Errors
+/// A [`Drawable` error] is generated if `target` does not refer to a defined
+/// [window] nor [pixmap].
+///
+/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+/// refer to a defined [`GraphicsContext`].
+///
+/// A [`Font` error] is generated if a [font item] given in `text_items` does
+/// not refer to a defined [font]. Previous [text items] may have already been
+/// drawn.
+///
+/// [drawable]: Drawable
+/// [window]: Window
+/// [pixmap]: Pixmap
+/// [font]: Font
+/// [font item]: TextItem16::Font
+/// [text items]: TextItem16
+/// [options]: GraphicsOptions
+/// [request]: Request
+///
+/// [`function`]: GraphicsOptions::function
+/// [`plane_mask`]: GraphicsOptions::plane_mask
+/// [`fill_style`]: GraphicsOptions::fill_style
+/// [`font`]: GraphicsOptions::font
+/// [`child_mode`]: GraphicsOptions::child_mode
+/// [`clip_x`]: GraphicsOptions::clip_x
+/// [`clip_y`]: GraphicsOptions::clip_y
+/// [`clip_mask`]: GraphicsOptions::clip_mask
+///
+/// [`foreground_color`]: GraphicsOptions::foreground_color
+/// [`background_color`]: GraphicsOptions::background_color
+/// [`tile`]: GraphicsOptions::tile
+/// [`stipple`]: GraphicsOptions::stipple
+/// [`tile_stipple_x`]: GraphicsOptions::tile_stipple_x
+/// [`tile_stipple_y`]: GraphicsOptions::tile_stipple_y
+///
+/// [`Drawable` error]: error::Drawable
+/// [`GraphicsContext` error]: error::GraphicsContext
+/// [`Font` error]: error::Font
+#[doc(alias("PolyText16"))]
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct DrawText16 {
+	/// The [drawable] on which the text is drawn.
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if this does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	///
+	/// [`Drawable` error]: error::Drawable
+	#[doc(alias("drawable"))]
+	pub target: Drawable,
+
+	/// The [`GraphicsContext`] used in this graphics operation.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if this does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("gc", "context", "gcontext"))]
+	pub graphics_context: GraphicsContext,
+
+	/// The starting position of the first character of text.
+	///
+	/// These coordinates are relative to the top-left corner of the `target`
+	/// [drawable].
+	///
+	/// [drawable]: Drawable
+	#[doc(alias("x", "y"))]
+	pub coordinates: Coords,
+
+	/// The [text items] which control the drawing of the text.
+	///
+	/// Each item can either [specify text], in which case that text is drawn
+	/// (with the provided [`horizontal_offset`] applied), or a [font item], in
+	/// which case that [font] is stored in the `graphics_context` and used for
+	/// subsequent text.
+	///
+	/// # Errors
+	/// A [`Font` error] is generated if a [font item] does not refer to a
+	/// defined [font]. Previous [text items] may have already been drawn.
+	///
+	/// [specify text]: TextItem16::Text
+	/// [font item]: TextItem16::Font
+	/// [`horizontal_offset`]: Text16::horizontal_offset
+	/// [text items]: TextItem16
+	///
+	/// [font]: Font
+	#[doc(alias("items"))]
+	pub text_items: Vec<TextItem16>,
+}
+
+impl Request for DrawText16 {
+	type OtherErrors = DrawText8Error;
+	type Reply = ();
+
+	const MAJOR_OPCODE: u8 = 75;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl X11Size for DrawText16 {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 4;
+
+		const CONSTANT_SIZES: usize = {
+			HEADER
+				+ Drawable::X11_SIZE // `target`
+				+ GraphicsContext::X11_SIZE // `graphics_context`
+				+ Coords::X11_SIZE // `coordinates`
+		};
+
+		CONSTANT_SIZES + self.text_items.x11_size() + pad(&self.text_items)
+	}
+}
+
+impl Readable for DrawText16 {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		/// The maximum number of padding bytes that there could be at the end.
+		///
+		/// As long as there are more than this many bytes remaining, we know
+		/// that there are still text items left to read.
+		const MAX_PADDING: usize = 1;
+
+		// major opcode is already read
+
+		// Metabyte position is unused.
+		buf.advance(1);
+
+		// Read the length and bound buf to not read more than it.
+		let length = (usize::from(buf.get_u16()) * 4) - 2;
+		let buf = &mut buf.take(length);
+
+		let target = Drawable::read_from(buf)?;
+		let graphics_context = GraphicsContext::read_from(buf)?;
+		let coordinates = Coords::read_from(buf)?;
+
+		let text_items = {
+			let mut text_items = Vec::new();
+
+			while buf.remaining() > MAX_PADDING {
+				text_items.push(TextItem16::read_from(buf)?);
+			}
+
+			text_items
+		};
+
+		// Advance the padding bytes at the end.
+		buf.advance(pad(&text_items));
+
+		Ok(Self {
+			target,
+			graphics_context,
+			coordinates,
+			text_items,
+		})
+	}
+}
+
+impl Writable for DrawText16 {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		let buf = &mut buf.limit(self.x11_size());
+
+		buf.put_u8(Self::MAJOR_OPCODE);
+		// Unused metabyte position.
+		buf.put_u8(0);
+		buf.put_u16(self.length());
+
+		self.target.write_to(buf)?;
+		self.graphics_context.write_to(buf)?;
+		self.coordinates.write_to(buf)?;
+		self.text_items.write_to(buf)?;
+
+		// Unused padding bytes at the end.
+		buf.put_bytes(0, pad(&self.text_items));
+
+		Ok(())
+	}
+}

From 4fa02f05f9793a1ea5191557368ec596ae6ce3a3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 15:48:29 +0000
Subject: [PATCH 101/157] ImageText8 and ImageText16 requests

---
 src/unit.rs                 | 103 +++++++++++++-
 src/x11/request/graphics.rs | 277 ++++++++++++++++++++++++++++++++++++
 2 files changed, 376 insertions(+), 4 deletions(-)

diff --git a/src/unit.rs b/src/unit.rs
index 56fc15d8..023cbd85 100644
--- a/src/unit.rs
+++ b/src/unit.rs
@@ -5,7 +5,22 @@
 //! Types representing units like millimeters or hertz.
 
 use std::fmt::{Display, Formatter};
+
+use derive_more::{
+	Add,
+	AddAssign,
+	Div,
+	DivAssign,
+	Mul,
+	MulAssign,
+	Rem,
+	RemAssign,
+	Sub,
+	SubAssign,
+	Sum,
+};
 use thiserror::Error;
+
 use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
 
 /// An error generated when a value is outside of the required bounds.
@@ -62,7 +77,27 @@ macro_rules! impl_xrbk_traits {
 }
 
 /// A value measured in pixels.
-#[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
+#[derive(
+	Debug,
+	Hash,
+	Copy,
+	Clone,
+	PartialEq,
+	Eq,
+	PartialOrd,
+	Ord,
+	Add,
+	AddAssign,
+	Sub,
+	SubAssign,
+	Mul,
+	MulAssign,
+	Div,
+	DivAssign,
+	Rem,
+	RemAssign,
+	Sum,
+)]
 pub struct Px<Num>(pub Num);
 
 impl<Num> Display for Px<Num>
@@ -77,7 +112,27 @@ where
 impl_xrbk_traits!(Px<Num>(Num));
 
 /// A value measured in millimeters.
-#[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
+#[derive(
+	Debug,
+	Hash,
+	Copy,
+	Clone,
+	PartialEq,
+	Eq,
+	PartialOrd,
+	Ord,
+	Add,
+	AddAssign,
+	Sub,
+	SubAssign,
+	Mul,
+	MulAssign,
+	Div,
+	DivAssign,
+	Rem,
+	RemAssign,
+	Sum,
+)]
 pub struct Mm<Num>(pub Num);
 
 impl<Num> Display for Mm<Num>
@@ -92,7 +147,27 @@ where
 impl_xrbk_traits!(Mm<Num>(Num));
 
 /// A value measured in milliseconds.
-#[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
+#[derive(
+	Debug,
+	Hash,
+	Copy,
+	Clone,
+	PartialEq,
+	Eq,
+	PartialOrd,
+	Ord,
+	Add,
+	AddAssign,
+	Sub,
+	SubAssign,
+	Mul,
+	MulAssign,
+	Div,
+	DivAssign,
+	Rem,
+	RemAssign,
+	Sum,
+)]
 pub struct Ms<Num>(pub Num);
 
 impl<Num> Display for Ms<Num>
@@ -107,7 +182,27 @@ where
 impl_xrbk_traits!(Ms<Num>(Num));
 
 /// A value measured in hertz.
-#[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
+#[derive(
+	Debug,
+	Hash,
+	Copy,
+	Clone,
+	PartialEq,
+	Eq,
+	PartialOrd,
+	Ord,
+	Add,
+	AddAssign,
+	Sub,
+	SubAssign,
+	Mul,
+	MulAssign,
+	Div,
+	DivAssign,
+	Rem,
+	RemAssign,
+	Sum,
+)]
 pub struct Hz<Num>(pub Num);
 
 impl<Num> Display for Hz<Num>
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index ba9bbd3b..f5688cac 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -2849,6 +2849,9 @@ impl Writable for Text16 {
 
 /// A [request] that draws the given [`String16`] text on the given [drawable].
 ///
+/// For [fonts][font] using linear indexing rather than two-byte matrix
+/// indexing, the X server will interpret each [`Char16`] as a `u16` index.
+///
 /// # Graphics options used
 /// This [request] uses the following [options] of the `graphics_context`:
 /// - [`function`]
@@ -2889,6 +2892,8 @@ impl Writable for Text16 {
 /// [options]: GraphicsOptions
 /// [request]: Request
 ///
+/// [`Char16`]: crate::Char16
+///
 /// [`function`]: GraphicsOptions::function
 /// [`plane_mask`]: GraphicsOptions::plane_mask
 /// [`fill_style`]: GraphicsOptions::fill_style
@@ -3054,3 +3059,275 @@ impl Writable for DrawText16 {
 		Ok(())
 	}
 }
+
+request_error! {
+	pub enum ImageText8Error for ImageText8 {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws [`String8`] text on a rectangular background on
+	/// the given [drawable].
+	///
+	/// The text is filled with the `graphics_context`'s [`foreground_color`],
+	/// while the background is filled with the `graphics_context`'s
+	/// [`background_color`]
+	///
+	/// In relation to the text extents returned in the
+	/// [`QueryTextExtents` reply], the background [rectangle] is defined as:
+	/// ```
+	/// # use xrb::{Rectangle, Coords, unit::Px};
+	/// #
+	/// # fn main() -> Rectangle {
+	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// #
+	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// #     let overall_width = Px(1);
+	/// #
+	/// Rectangle {
+	///     x: coordinates.x,
+	///     y: coordinates.y - font_ascent,
+	///     width: overall_width,
+	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
+	/// }
+	/// # }
+	/// ```
+	///
+	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this
+	/// [request]. Effectively, [`Function::Copy`] and [`FillStyle::Solid`] are
+	/// used.
+	///
+	/// For [fonts] using two-byte indexing, each [`Char8`] `char` is
+	/// interpreted as <code>[Char16]::[new](0, char.[unwrap()])</code>.
+	///
+	/// [`Char8`]: crate::Char8
+	/// [unwrap()]: crate::Char8::unwrap
+	///
+	/// [Char16]: crate::Char16
+	/// [new]: crate::Char16::new
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`font`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [fonts]: Font
+	/// [rectangle]: Rectangle
+	/// [options]: GraphicsOptions
+	/// [request]: Request
+	///
+	/// [`Function::Copy`]: crate::set::Function
+	/// [`FillStyle::Solid`]: crate::set::FillStyle::Solid
+	///
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`font`]: GraphicsOptions::font
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ImageText8: Request(76, ImageText8Error) {
+		// The length of `string`.
+		#[metabyte]
+		#[allow(clippy::cast_possible_truncation)]
+		let string_len: u8 = string => string.len() as u8,
+
+		/// The [drawable] on which the text is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The coordinates of the background [rectangle] before the
+		/// `font_ascent` is subtracted[^subtracted].
+		///
+		/// [^subtracted]: See the [request docs].
+		///
+		/// [rectangle]: Rectangle
+		/// [request docs]: ImageText8
+		pub coordinates: Coords,
+
+		/// The text which is to be drawn.
+		#[context(string_len => usize::from(*string_len))]
+		pub string: String8,
+		[_; string => pad(string)],
+	}
+}
+
+request_error! {
+	pub enum ImageText16Error for ImageText16 {
+		Drawable,
+		GraphicsContext,
+		Match,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that draws [`String16`] text on a rectangular background on
+	/// the given [drawable].
+	///
+	/// The text is filled with the `graphics_context`'s [`foreground_color`],
+	/// while the background is filled with the `graphics_context`'s
+	/// [`background_color`]
+	///
+	/// In relation to the text extents returned in the
+	/// [`QueryTextExtents` reply], the background [rectangle] is defined as:
+	/// ```
+	/// # use xrb::{Rectangle, Coords, unit::Px};
+	/// #
+	/// # fn main() -> Rectangle {
+	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// #
+	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// #     let overall_width = Px(1);
+	/// #
+	/// Rectangle {
+	///     x: coordinates.x,
+	///     y: coordinates.y - font_ascent,
+	///     width: overall_width,
+	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
+	/// }
+	/// # }
+	/// ```
+	///
+	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this
+	/// [request]. Effectively, [`Function::Copy`] and [`FillStyle::Solid`] are
+	/// used.
+	///
+	/// For [fonts] using linear indexing, each [`Char16`] `char` is interpreted
+	/// as a big-endian `u16` value.
+	///
+	/// # Graphics options used
+	/// This [request] uses the following [options] of the `graphics_context`:
+	/// - [`plane_mask`]
+	/// - [`foreground_color`]
+	/// - [`background_color`]
+	/// - [`font`]
+	/// - [`child_mode`]
+	/// - [`clip_x`]
+	/// - [`clip_y`]
+	/// - [`clip_mask`]
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `target` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`GraphicsContext` error] is generated if `graphics_context` does not
+	/// refer to a defined [`GraphicsContext`].
+	///
+	/// [drawable]: Drawable
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [fonts]: Font
+	/// [rectangle]: Rectangle
+	/// [options]: GraphicsOptions
+	/// [request]: Request
+	///
+	/// [`Char16`]: crate::Char16
+	///
+	/// [`Function::Copy`]: crate::set::Function
+	/// [`FillStyle::Solid`]: crate::set::FillStyle::Solid
+	///
+	/// [`plane_mask`]: GraphicsOptions::plane_mask
+	/// [`foreground_color`]: GraphicsOptions::foreground_color
+	/// [`background_color`]: GraphicsOptions::background_color
+	/// [`font`]: GraphicsOptions::font
+	/// [`child_mode`]: GraphicsOptions::child_mode
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	///
+	/// [`QueryTextExtents` reply]: reply::QueryTextExtents
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ImageText16: Request(77, ImageText16Error) {
+		// The length of `string`.
+		#[metabyte]
+		#[allow(clippy::cast_possible_truncation)]
+		let string_len: u8 = string => string.len() as u8,
+
+		/// The [drawable] on which the text is drawn.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		#[doc(alias("drawable"))]
+		pub target: Drawable,
+
+		/// The [`GraphicsContext`] used in this graphics operation.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "context", "gcontext"))]
+		pub graphics_context: GraphicsContext,
+
+		/// The coordinates of the background [rectangle] before the
+		/// `font_ascent` is subtracted[^subtracted].
+		///
+		/// [^subtracted]: See the [request docs].
+		///
+		/// [rectangle]: Rectangle
+		/// [request docs]: ImageText16
+		pub coordinates: Coords,
+
+		/// The text which is to be drawn.
+		#[context(string_len => usize::from(*string_len))]
+		pub string: String16,
+		[_; string => pad(string)],
+	}
+}

From bb38fdd255f808a1f33a9fb1f50c4734395f21a9 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 15:57:09 +0000
Subject: [PATCH 102/157] fix x11::request::graphics doc tests

---
 src/x11/request/graphics.rs | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index f5688cac..8f54d136 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -3081,11 +3081,10 @@ derive_xrb! {
 	/// ```
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
-	/// # fn main() -> Rectangle {
-	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// # let coordinates = Coords { x: Px(0), y: Px(0) };
 	/// #
-	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
-	/// #     let overall_width = Px(1);
+	/// # let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// # let overall_width = Px(1);
 	/// #
 	/// Rectangle {
 	///     x: coordinates.x,
@@ -3093,7 +3092,7 @@ derive_xrb! {
 	///     width: overall_width,
 	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
 	/// }
-	/// # }
+	/// # ;
 	/// ```
 	///
 	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this
@@ -3219,11 +3218,10 @@ derive_xrb! {
 	/// ```
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
-	/// # fn main() -> Rectangle {
-	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// # let coordinates = Coords { x: Px(0), y: Px(0) };
 	/// #
-	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
-	/// #     let overall_width = Px(1);
+	/// # let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// # let overall_width = Px(1);
 	/// #
 	/// Rectangle {
 	///     x: coordinates.x,
@@ -3231,7 +3229,7 @@ derive_xrb! {
 	///     width: overall_width,
 	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
 	/// }
-	/// # }
+	/// # ;
 	/// ```
 	///
 	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this

From bbc46d8fa033a52bfead27de63e029aa794a0da7 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 17:26:21 +0000
Subject: [PATCH 103/157] XRBK macro: use message trait paths directly

This means that the message traits are imported directly, which (a) makes more sense, and (b) makes referring to the traits in docs a hell of a lot easier.
---
 src/x11/event.rs                              | 308 +++++++++---------
 src/x11/reply/graphics.rs                     |  10 +-
 src/x11/reply/input.rs                        |  45 +--
 src/x11/reply/miscellaneous.rs                |  31 +-
 src/x11/reply/window.rs                       |  22 +-
 src/x11/request/font.rs                       |  23 +-
 src/x11/request/input.rs                      |  51 +--
 src/x11/request/meta.rs                       |   6 +-
 src/x11/request/miscellaneous.rs              |  40 +--
 src/x11/request/window.rs                     |  49 +--
 .../src/definition/expansion/message_trait.rs |  12 +-
 11 files changed, 306 insertions(+), 291 deletions(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index fba89938..5d05ae16 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -6,11 +6,20 @@
 //!
 //! [Events] are messages sent from the X server to an X client.
 //!
-//! [Events]: crate::message::Event
+//! [Events]: Event
 //! [core X11 protocol]: super
 
+extern crate self as xrb;
+
+use bitflags::bitflags;
+use derivative::Derivative;
+
+use xrbk::{Buf, ConstantX11Size, ReadResult, Readable, ReadableWithContext, X11Size};
+use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
+
 use crate::{
 	atom::Atom,
+	message::Event,
 	set::WindowConfigMask,
 	unit::Px,
 	Button,
@@ -27,13 +36,6 @@ use crate::{
 	Window,
 };
 
-use bitflags::bitflags;
-use derivative::Derivative;
-use xrbk::{Buf, ConstantX11Size, ReadResult, Readable, ReadableWithContext, X11Size};
-
-use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
-extern crate self as xrb;
-
 derive_xrb! {
 	/// An [event] generated when a key is pressed.
 	///
@@ -43,7 +45,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`KEY_PRESS`] on the
 	/// `event_window`.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`KEY_PRESS`]: crate::EventMask::KEY_PRESS
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -52,9 +54,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -65,13 +67,13 @@ derive_xrb! {
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which this [event] was generated in relation to.
 		///
@@ -85,7 +87,7 @@ derive_xrb! {
 		/// Active grabs or the currently focused window may modify how the
 		/// `event_window` is chosen.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`do_not_propagate_mask`]: crate::Attributes::do_not_propagate_mask
 		pub event_window: Window,
 		/// If a child of the `event_window` contains the cursor, this is that
@@ -97,19 +99,19 @@ derive_xrb! {
 		/// The coordinates of the cursor at the `time` this [event] was
 		/// generated, relative to the `root` [window]'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [window]: Window
 		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was
 		/// generated, relative to the `event_window`'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub event_coords: Coords,
 
 		/// The state of mouse buttons and modifier keys immediately
 		/// before this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub modifiers: ModifierMask,
 
 		/// Whether the cursor is on the same screen as the `event_window`.
@@ -125,7 +127,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`KEY_RELEASE`] on the
 	/// `event_window`.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`KEY_RELEASE`]: crate::EventMask::KEY_RELEASE
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
@@ -133,9 +135,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -146,14 +148,14 @@ derive_xrb! {
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root [window] containing the [window] in which the cursor was located
 		/// within when this [event] was generated.
 		///
 		/// [window]: Window
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which this [event] was generated in relation to.
 		///
@@ -167,7 +169,7 @@ derive_xrb! {
 		/// Active grabs or the currently focused window may modify how the
 		/// `event_window` is chosen.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`do_not_propagate_mask`]: crate::Attributes::do_not_propagate_mask
 		pub event_window: Window,
 		/// If a child of the `event_window` contains the cursor, this is that
@@ -180,18 +182,18 @@ derive_xrb! {
 		/// generated, relative to the `root` [window]'s origin.
 		///
 		/// [window]: Window
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was
 		/// generated, relative to the `event_window`'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [mouse buttons]: Button
 		pub modifiers: ModifierMask,
 
@@ -208,7 +210,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`BUTTON_PRESS`] on the
 	/// `event_window`.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [mouse button]: Button
 	/// [`BUTTON_PRESS`]: crate::EventMask::BUTTON_PRESS
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -217,9 +219,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -230,13 +232,13 @@ derive_xrb! {
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which this [event] was generated in relation to.
 		///
@@ -249,7 +251,7 @@ derive_xrb! {
 		///
 		/// Active grabs may modify how the `event_window` is chosen.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`do_not_propagate_mask`]: crate::Attributes::do_not_propagate_mask
 		pub event_window: Window,
 		/// If a child of the `event_window` contains the cursor, this is that
@@ -261,20 +263,20 @@ derive_xrb! {
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `root` [window]'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [window]: Window
 		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
 		///
 		/// [mouse buttons]: Button
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub modifiers: ModifierMask,
 
 		/// Whether the cursor is on the same [screen] as the `event_window`.
@@ -290,7 +292,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`BUTTON_RELEASE`] on the
 	/// `event_window`.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [mouse button]: Button
 	/// [`BUTTON_RELEASE`]: crate::EventMask::BUTTON_RELEASE
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -299,9 +301,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -312,13 +314,13 @@ derive_xrb! {
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which this [event] was generated in relation to.
 		///
@@ -331,7 +333,7 @@ derive_xrb! {
 		///
 		/// Active grabs may modify how the `event_window` is chosen.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`do_not_propagate_mask`]: crate::Attributes::do_not_propagate_mask
 		pub event_window: Window,
 		/// If a child of the `event_window` contains the cursor, this is that
@@ -343,19 +345,19 @@ derive_xrb! {
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `root` window's origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
 		///
 		/// [mouse buttons]: Button
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub modifiers: ModifierMask,
 
 		/// Whether the cursor is on the same [screen] as the `event_window`.
@@ -436,7 +438,7 @@ derive_xrb! {
 	/// [`QueryCursor`]: super::request::QueryCursorLocation
 	/// [`GetMotionEvents`]: super::request::GetMotionEvents
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
@@ -444,9 +446,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -461,7 +463,7 @@ derive_xrb! {
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which this [event] was generated in relation to.
 		///
@@ -474,7 +476,7 @@ derive_xrb! {
 		///
 		/// Active grabs may modify how the `event_window` is chosen.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`do_not_propagate_mask`]: crate::Attributes::do_not_propagate_mask
 		pub event_window: Window,
 		/// If a child of the `event_window` contains the cursor, this is that
@@ -486,20 +488,20 @@ derive_xrb! {
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `root` [window]'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [window]: Window
 		pub root_coords: Coords,
 		/// The coordinates of the cursor at the `time` this [event] was generated,
 		/// relative to the `event_window`'s origin.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub event_coords: Coords,
 
 		/// The state of [mouse buttons] and modifier keys immediately
 		/// before this [event] was generated.
 		///
 		/// [mouse buttons]: Button
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub modifiers: ModifierMask,
 
 		/// Whether the cursor is on the same [screen] as the `event_window`.
@@ -556,7 +558,7 @@ derive_xrb! {
 /// [`Nonlinear`]: EnterLeaveDetail::Nonlinear
 /// [`NonlinearIntermediate`]: EnterLeaveDetail::NonlinearIntermediate
 ///
-/// [event]: crate::message::Event
+/// [event]: Event
 /// [window]: Window
 #[derive(Copy, Clone, Eq, PartialEq, Debug, Hash, X11Size, Readable, Writable)]
 pub enum EnterLeaveDetail {
@@ -640,7 +642,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`ENTER_WINDOW`] on the
 	/// [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`ENTER_WINDOW`]: crate::EventMask::ENTER_WINDOW
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -649,9 +651,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -660,19 +662,19 @@ derive_xrb! {
 		///
 		/// See [`EnterLeaveDetail`] for more information.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[metabyte]
 		pub detail: EnterLeaveDetail,
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window that the cursor entered.
 		pub event_window: Window,
@@ -731,7 +733,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`LEAVE_WINDOW`] on the
 	/// [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`LEAVE_WINDOW`]: crate::EventMask::LEAVE_WINDOW
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -740,9 +742,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -751,19 +753,19 @@ derive_xrb! {
 		///
 		/// See [`EnterLeaveDetail`] for more information.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[metabyte]
 		pub detail: EnterLeaveDetail,
 
 		/// The time at which this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub time: Timestamp,
 
 		/// The root window containing the window in which the cursor was
 		/// located when this [event] was generated.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub root: Window,
 		/// The window which the cursor left.
 		pub event_window: Window,
@@ -779,7 +781,7 @@ derive_xrb! {
 		/// This is always the final position of the cursor, not its initial
 		/// position.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [window]: Window
 		pub root_coords: Coords,
 		/// The position of the cursor at the `time` this [event] was generated,
@@ -792,7 +794,7 @@ derive_xrb! {
 		/// This is always the final position of the cursor, not its initial
 		/// position.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`SAME_SCREEN`]: EnterLeaveMask::SAME_SCREEN
 		/// [screen]: crate::Screen
 		pub event_coords: Coords,
@@ -801,7 +803,7 @@ derive_xrb! {
 		/// before this [event] was generated.
 		///
 		/// [mouse buttons]: Button
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub modifiers: ModifierMask,
 		/// [`Normal`] for normal `LeaveWindow` events, [`Grab`] and
 		/// [`Ungrab`] for events generated by grabs and ungrabs.
@@ -937,7 +939,7 @@ derive_xrb! {
 ///
 /// [`None`]: FocusDetail::None
 ///
-/// [event]: crate::message::Event
+/// [event]: Event
 /// [window]: Window
 #[derive(Copy, Clone, Eq, PartialEq, Debug, Hash, X11Size, Readable, Writable)]
 pub enum FocusDetail {
@@ -1020,7 +1022,7 @@ derive_xrb! {
 	/// `Focus` events are reported to clients selecting [`FOCUS_CHANGE`] on the
 	/// [window] that was focused.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`FOCUS_CHANGE`]: crate::EventMask::FOCUS_CHANGE
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -1029,9 +1031,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1040,7 +1042,7 @@ derive_xrb! {
 		///
 		/// See [`FocusDetail`] for more information.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[metabyte]
 		pub detail: FocusDetail,
 
@@ -1054,7 +1056,7 @@ derive_xrb! {
 		/// generated by a [`SetInputFocus` request] while the keyboard is
 		/// grabbed.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		///
 		/// [`Normal`]: FocusGrabMode::Normal
 		/// [`Grab`]: FocusGrabMode::Grab
@@ -1079,7 +1081,7 @@ derive_xrb! {
 	/// `Unfocus` events are reported to clients selecting [`FOCUS_CHANGE`] on the
 	/// [window] that was unfocused.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`FOCUS_CHANGE`]: crate::EventMask::FOCUS_CHANGE
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -1088,9 +1090,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1099,7 +1101,7 @@ derive_xrb! {
 		///
 		/// See [`FocusDetail`] for more information.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[metabyte]
 		pub detail: FocusDetail,
 
@@ -1113,7 +1115,7 @@ derive_xrb! {
 		/// generated by a [`SetInputFocus` request] while the keyboard is
 		/// grabbed.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		///
 		/// [`Normal`]: FocusGrabMode::Normal
 		/// [`Grab`]: FocusGrabMode::Grab
@@ -1131,7 +1133,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`KEYBOARD_STATE`] on a
 	/// [window] immediately after every [`EnterWindow`] and [`Focus`] event.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`KEYBOARD_STATE`]: crate::EventMask::KEYBOARD_STATE
 	#[derive(Debug, Hash, X11Size, Readable, Writable)]
@@ -1167,7 +1169,7 @@ derive_xrb! {
 	/// # Recipients
 	/// This [event] is reported to clients selecting [`EXPOSURE`] on a [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	///
 	/// [`maintain_contents` attribute]: crate::set::Attributes::maintain_contents
@@ -1182,8 +1184,8 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
-		/// [event]: crate::message::Event
+		/// [sequence number]: Event::sequence
+		/// [event]: Event
 		/// [request]: crate::message::Request
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
@@ -1212,7 +1214,7 @@ derive_xrb! {
 	/// This [event] is reported to a client using a [`GraphicsContext`] with
 	/// [`graphics_exposure`] enabled.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`GraphicsContext`]: crate::GraphicsContext
 	/// [`graphics_exposure`]: crate::set::GraphicsOptions::graphics_exposure
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -1221,8 +1223,8 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
-		/// [event]: crate::message::Event
+		/// [sequence number]: Event::sequence
+		/// [event]: Event
 		/// [request]: crate::message::Request
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
@@ -1266,7 +1268,7 @@ derive_xrb! {
 	/// This [event] is reported to a client using a [`GraphicsContext`] with
 	/// [`graphics_exposure`] enabled.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`GraphicsExposure` events]: GraphicsExposure
 	/// [`GraphicsContext`]: crate::GraphicsContext
 	/// [`graphics_exposure`]: crate::set::GraphicsOptions::graphics_exposure
@@ -1276,9 +1278,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1366,7 +1368,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`VISIBILITY_CHANGE`] on
 	/// the [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	///
 	/// [`Unobscured`]: VisibilityState::Unobscured
@@ -1380,9 +1382,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1400,7 +1402,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`SUBSTRUCTURE_NOTIFY`] on
 	/// the [window]'s parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -1409,9 +1411,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1456,7 +1458,7 @@ derive_xrb! {
 	/// [window], as well as to clients selecting [`SUBSTRUCTURE_NOTIFY`] on its
 	/// parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
@@ -1466,9 +1468,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1496,7 +1498,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`STRUCTURE_NOTIFY`] on the
 	/// window, and to clients selecting [`SUBSTRUCTURE_NOTIFY`] on its parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
@@ -1506,9 +1508,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1528,7 +1530,7 @@ derive_xrb! {
 		/// Whether this [event] was generated as a result of its parent being
 		/// resized when the unmapped [window] had [`WindowGravity::Unmap`].
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [window]: Window
 		/// [`WindowGravity::Unmap`]: crate::WindowGravity::Unmap
 		pub from_configure: bool,
@@ -1544,7 +1546,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`STRUCTURE_NOTIFY`] on the
 	/// [window] and to clients selecting [`SUBSTRUCTURE_NOTIFY`] on the parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
@@ -1554,9 +1556,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1597,7 +1599,7 @@ derive_xrb! {
 	/// the client selecting [`SUBSTRUCTURE_REDIRECT`] sends its own
 	/// [`MapWindow` request] for the [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`override_redirect` attribute]: crate::Attributes::override_redirect
 	/// [`MapWindow` request]: super::request::MapWindow
@@ -1609,9 +1611,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1635,7 +1637,7 @@ derive_xrb! {
 	/// either the old parent or the `new_parent`, and to clients selecting
 	/// [`STRUCTURE_NOTIFY`] on the `window` itself.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
@@ -1645,9 +1647,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1692,7 +1694,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`STRUCTURE_NOTIFY`] on the
 	/// window, and to clients selecting [`SUBSTRUCTURE_NOTIFY`] on its parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`ConfigureWindow` request]: super::request::ConfigureWindow
 	/// [window]: Window
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
@@ -1703,9 +1705,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1774,7 +1776,7 @@ derive_xrb! {
 	/// This [event] is reported to the client selecting [`SUBSTRUCTURE_REDIRECT`]
 	/// on the window's parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`ConfigureWindow` request]: super::request::ConfigureWindow
 	///
@@ -1785,9 +1787,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1840,7 +1842,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`STRUCTURE_NOTIFY`] on the
 	/// window, and to clients selecting [`SUBSTRUCTURE_NOTIFY`] on its parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`STRUCTURE_NOTIFY`]: crate::EventMask::STRUCTURE_NOTIFY
 	/// [`SUBSTRUCTURE_NOTIFY`]: crate::EventMask::SUBSTRUCTURE_NOTIFY
@@ -1850,9 +1852,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1883,7 +1885,7 @@ derive_xrb! {
 	/// This [event] is reported to the client selecting [`RESIZE_REDIRECT`] on
 	/// the [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`RESIZE_REDIRECT`]: crate::EventMask::RESIZE_REDIRECT
 	/// [`ConfigureWindow` request]: super::request::ConfigureWindow
@@ -1893,9 +1895,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1943,7 +1945,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`STRUCTURE_NOTIFY`] on the
 	/// [window], and to clients selecting [`SUBSTRUCTURE_NOTIFY`] on its parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`CirculateWindow` request]: super::request::CirculateWindow
 	///
@@ -1955,9 +1957,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -1988,7 +1990,7 @@ derive_xrb! {
 	/// This [event] is reported to the client selecting [`SUBSTRUCTURE_REDIRECT`]
 	/// on the [window]'s parent.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`SUBSTRUCTURE_REDIRECT`]: crate::EventMask::SUBSTRUCTURE_REDIRECT
 	/// [`CirculateWindow` request]: super::request::CirculateWindow
@@ -1998,9 +2000,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2049,7 +2051,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`PROPERTY_CHANGE`] on the
 	/// [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [`PROPERTY_CHANGE`]: crate::EventMask::PROPERTY_CHANGE
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -2058,9 +2060,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2089,7 +2091,7 @@ derive_xrb! {
 	/// # Recipients
 	/// This [event] is reported to the current owner of a selection.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`SetSelectionOwner` request]: super::request::SetSelectionOwner
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
@@ -2097,9 +2099,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2125,7 +2127,7 @@ derive_xrb! {
 	/// # Recipients
 	/// This [event] is reported to the owner of the selection.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`ConvertSelection` request]: super::request::ConvertSelection
 	/// [`Selection` event]: Selection
 	/// [`SendEvent` request]: super::request::SendEvent
@@ -2135,9 +2137,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2173,7 +2175,7 @@ derive_xrb! {
 	/// This [event] is reported to the `requester` of a
 	/// [`ConvertSelection` request].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`ConvertSelection` request]: super::request::ConvertSelection
 	/// [`SendEvent` request]: super::request::SendEvent
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -2182,9 +2184,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2250,7 +2252,7 @@ derive_xrb! {
 	/// This [event] is reported to clients selecting [`COLORMAP_CHANGE`] on the
 	/// window.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [window]: Window
 	/// [colormap]: crate::Colormap
 	/// [`colormap` attribute]: crate::Attributes::colormap
@@ -2262,16 +2264,16 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
 
 		/// The window that this [event] relates to.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		pub window: Window,
 		/// The `window`'s [colormap].
 		///
@@ -2282,7 +2284,7 @@ derive_xrb! {
 		/// [`colormap` attribute] was changed or because the `window`'s
 		/// `colormap` was installed or uninstalled.
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		/// [`colormap` attribute]: crate::Attributes::colormap
 		pub detail: ColormapDetail,
 		/// Whether the `window`'s `colormap` is currently installed.
@@ -2351,7 +2353,7 @@ derive_xrb! {
 	/// This [event] is reported to the [`SendEvent` request]'s `destination`
 	/// [window].
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`SendEvent` request]: super::request::SendEvent
 	/// [window]: Window
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
@@ -2360,9 +2362,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
@@ -2382,7 +2384,7 @@ derive_xrb! {
 
 		/// The data contained in this [event].
 		///
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[context(format => *format)]
 		pub data: ClientMessageData,
 	}
@@ -2423,7 +2425,7 @@ derive_xrb! {
 	/// # Recipients
 	/// This [event] is reported to all clients.
 	///
-	/// [event]: crate::message::Event
+	/// [event]: Event
 	/// [`SetModifierMapping`]: super::request::SetModifierMapping
 	/// [`ChangeKeyboardMapping`]: super::request::ChangeKeyboardMapping
 	/// [`SetCursorMapping`]: super::request::SetCursorMapping
@@ -2433,9 +2435,9 @@ derive_xrb! {
 		/// The [sequence number] associated with the last [request] related
 		/// to this [event] that was received before this [event] was generated.
 		///
-		/// [sequence number]: crate::message::Event::sequence
+		/// [sequence number]: Event::sequence
 		/// [request]: crate::message::Request
-		/// [event]: crate::message::Event
+		/// [event]: Event
 		#[sequence]
 		#[derivative(PartialEq = "ignore", Hash = "ignore")]
 		pub sequence: u16,
diff --git a/src/x11/reply/graphics.rs b/src/x11/reply/graphics.rs
index 85b2a0a8..63a68ed3 100644
--- a/src/x11/reply/graphics.rs
+++ b/src/x11/reply/graphics.rs
@@ -8,7 +8,7 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
@@ -21,12 +21,12 @@ use derivative::Derivative;
 use xrbk::pad;
 use xrbk_macro::derive_xrb;
 
-use crate::{visual::VisualId, x11::request};
+use crate::{message::Reply, visual::VisualId, x11::request};
 
 derive_xrb! {
 	/// The [reply] to a [`CaptureImage` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`CaptureImage` request]: request::CaptureImage
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -38,9 +38,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index cba386eb..a8740fe5 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -8,7 +8,7 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
@@ -21,6 +21,7 @@ use derivative::Derivative;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
+	message::Reply,
 	x11::{request, request::RevertFocus},
 	Coords,
 	FocusWindow,
@@ -33,7 +34,7 @@ use crate::{
 derive_xrb! {
 	/// The [reply] to a [`GrabCursor` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GrabCursor` request]: request::GrabCursor
 	#[doc(alias = "GrabPointer")]
@@ -46,9 +47,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -65,7 +66,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GrabKeyboard` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GrabKeyboard` request]: request::GrabKeyboard
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -77,9 +78,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -97,7 +98,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryCursorLocation` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryCursorLocation` request]: request::QueryCursorLocation
 	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
@@ -110,9 +111,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -175,7 +176,7 @@ pub struct TimeCoords {
 derive_xrb! {
 	/// The [reply] to a [`GetMotionHistory` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetMotionHistory` request]: request::GetMotionHistory
 	#[doc(alias = "GetMotionEvents")]
@@ -188,9 +189,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -210,7 +211,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`ConvertCoordinates` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`ConvertCoordinates` request]: request::ConvertCoordinates
 	#[doc(alias = "TranslateCoordinates")]
@@ -223,9 +224,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -262,7 +263,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetFocus` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetFocus` request]: request::GetFocus
 	#[doc(alias = "GetInputFocus")]
@@ -275,9 +276,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -296,7 +297,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryKeyboard` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryKeyboard` request]: request::QueryKeyboard
 	#[doc(alias = "QueryKeymap")]
@@ -309,9 +310,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
diff --git a/src/x11/reply/miscellaneous.rs b/src/x11/reply/miscellaneous.rs
index 9e99b9ea..4b2dcc6f 100644
--- a/src/x11/reply/miscellaneous.rs
+++ b/src/x11/reply/miscellaneous.rs
@@ -8,7 +8,7 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
@@ -22,6 +22,7 @@ use xrbk::pad;
 use xrbk_macro::derive_xrb;
 
 use crate::{
+	message::Reply,
 	x11::request::{self, DataFormat, DataList},
 	Atom,
 	String8,
@@ -31,7 +32,7 @@ use crate::{
 derive_xrb! {
 	/// The [reply] to a [`GetAtom` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetAtom` request]: request::GetAtom
 	#[doc(alias("InternAtom", "CreateAtom"))]
@@ -44,9 +45,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -75,9 +76,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -97,7 +98,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetProperty` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetProperty` request]: request::GetProperty
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -109,9 +110,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -157,7 +158,7 @@ derive_xrb! {
 
 	/// The [reply] for a [`ListProperties` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`ListProperties` request]: request::ListProperties
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -169,9 +170,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -191,7 +192,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetSelectionOwner` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetSelectionOwner` request]: request::GetSelectionOwner
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -203,9 +204,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
diff --git a/src/x11/reply/window.rs b/src/x11/reply/window.rs
index 8f4c2515..fe65f49a 100644
--- a/src/x11/reply/window.rs
+++ b/src/x11/reply/window.rs
@@ -8,7 +8,7 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
@@ -17,9 +17,11 @@
 extern crate self as xrb;
 
 use derivative::Derivative;
+
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
+	message::Reply,
 	unit::Px,
 	visual::{ColorId, VisualId},
 	x11::request,
@@ -58,7 +60,7 @@ pub enum MapState {
 derive_xrb! {
 	/// The [reply] to a [`GetWindowAttributes` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetWindowAttributes` request]: request::GetWindowAttributes
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
@@ -70,9 +72,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -235,7 +237,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`GetGeometry` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`GetGeometry` request]: request::GetGeometry
 	#[doc(alias("GetX", "GetY", "GetWidth", "GetHeight", "GetBorderWidth"))]
@@ -248,9 +250,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
@@ -291,7 +293,7 @@ derive_xrb! {
 
 	/// The [reply] to a [`QueryWindowTree` request].
 	///
-	/// [reply]: crate::message::Reply
+	/// [reply]: Reply
 	///
 	/// [`QueryWindowTree` request]: request::QueryWindowTree
 	#[doc(alias("QueryTree", "GetTree", "GetWindowTree"))]
@@ -306,9 +308,9 @@ derive_xrb! {
 		/// See [`Reply::sequence`] for more information.
 		///
 		/// [request]: crate::message::Request
-		/// [reply]: crate::message::Reply
+		/// [reply]: Reply
 		///
-		/// [`Reply::sequence`]: crate::message::Reply::sequence
+		/// [`Reply::sequence`]: Reply::sequence
 		#[sequence]
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
diff --git a/src/x11/request/font.rs b/src/x11/request/font.rs
index 84c0aacf..66c32739 100644
--- a/src/x11/request/font.rs
+++ b/src/x11/request/font.rs
@@ -6,7 +6,7 @@
 //!
 //! [Requests] are messages sent from an X client to the X server.
 //!
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
@@ -15,6 +15,7 @@ use xrbk::{pad, ConstantX11Size};
 use xrbk_macro::derive_xrb;
 
 use crate::{
+	message::Request,
 	x11::{error, reply},
 	Char16,
 	Font,
@@ -66,7 +67,7 @@ derive_xrb! {
 	/// A [request] that associates the font by the given `name` with the given
 	/// `font_id`.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[doc(alias("OpenFont", "CreateFont", "LoadFont", "AddFont"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct AssignFont: Request(45, AssignFontError) {
@@ -95,7 +96,7 @@ derive_xrb! {
 	/// A [request] that removes the association between a given [`Font` ID] and
 	/// the font it is associated with.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [`Font` ID]: Font
 	#[doc(alias("CloseFont", "DeleteFont", "UnloadFont", "RemoveFont"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
@@ -116,7 +117,7 @@ derive_xrb! {
 	/// A [`Font` error] is generated if the `target` does not refer to a
 	/// defined [`Font`] nor [`GraphicsContext`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GraphicsContext`]: crate::GraphicsContext
 	///
@@ -131,7 +132,7 @@ derive_xrb! {
 		/// A [`Font` error] is generated if this does not refer to a defined
 		/// [`Font`] nor [`GraphicsContext`].
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`GraphicsContext`]: crate::GraphicsContext
 		///
@@ -165,7 +166,7 @@ derive_xrb! {
 	/// A [`Font` error] is generated if `font` does not refer to a defined
 	/// [`Font`] nor [`GraphicsContext`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GraphicsContext`]: crate::GraphicsContext
 	///
@@ -193,7 +194,7 @@ derive_xrb! {
 		/// The text for which this [request] gets the extents when displayed
 		/// with `font`.
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		#[context(self::remaining, odd_length => {
 			// We remove the padding at the end, which can be determined from `odd_length`.
 			let remaining = remaining - query_text_extents_padding(*odd_length);
@@ -212,7 +213,7 @@ derive_xrb! {
 	/// # Replies
 	/// This [request] generates a [`ListFonts` reply].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [font search path]: SetFontSearchDirectories
 	///
@@ -250,7 +251,7 @@ derive_xrb! {
 	/// # Replies
 	/// This [request] generates [`ListFontsWithInfo` replies].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [font search path]: SetFontSearchDirectories
 	///
@@ -288,7 +289,7 @@ derive_xrb! {
 	/// A [`Value` error] is generated if the operating system rejects the given
 	/// paths for whatever reason.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Value` error]: error::Value
 	#[doc(alias = "SetFontPath")]
@@ -314,7 +315,7 @@ derive_xrb! {
 	///
 	/// See also: [`SetFontSearchDirectories`].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetFontSearchDirectories: Request(52) -> reply::GetFontSearchDirectories;
 }
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index e01caac2..e77dd94c 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -7,7 +7,7 @@
 //!
 //! [Requests] are messages sent from an X client to the X server.
 //!
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
@@ -16,6 +16,7 @@ use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteRe
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
+	message::Request,
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
@@ -86,7 +87,7 @@ derive_xrb! {
 	///
 	/// [cursor appearance]: CursorAppearance
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`EnterWindow`]: crate::x11::event::EnterWindow
 	/// [`LeaveWindow`]: crate::x11::event::LeaveWindow
@@ -202,7 +203,7 @@ derive_xrb! {
 	///
 	/// This [request] generates [`EnterWindow`] and [`LeaveWindow`] events.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [events]: crate::message::Event
 	///
 	/// [`EnterWindow`]: crate::x11::event::EnterWindow
@@ -252,7 +253,7 @@ derive_xrb! {
 	///
 	/// [cursor appearance]: CursorAppearance
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GrabCursor` request]: GrabCursor
 	///
@@ -393,7 +394,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [passive button grab]: GrabButton
 	///
@@ -407,7 +408,7 @@ derive_xrb! {
 		/// possible [buttons][button].
 		///
 		/// [button]: Button
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [passive button grab]: GrabButton
 		///
@@ -435,7 +436,7 @@ derive_xrb! {
 		/// sending this `UngrabButton` [request] for all possible `modifiers`
 		/// combinations.
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [passive button grab]: GrabButton
 		///
@@ -461,7 +462,7 @@ derive_xrb! {
 	/// not refer to a defined [cursor appearance].
 	///
 	/// [cursor appearance]: CursorAppearance
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [active cursor grab]: GrabCursor
 	///
@@ -526,7 +527,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Focus`]: crate::x11::event::Focus
 	/// [`Unfocus`]: crate::x11::event::Unfocus
@@ -608,7 +609,7 @@ derive_xrb! {
 	///
 	/// This [request] generates [`Focus`] and [`Unfocus`] events.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [events]: crate::message::Event
 	///
 	/// [`Focus`]: crate::x11::event::Focus
@@ -654,7 +655,7 @@ derive_xrb! {
 	/// the same `grab_window`.
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GrabKeyboard` request]: GrabKeyboard
 	///
@@ -760,7 +761,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [passive key grab]: GrabKey
 	///
@@ -773,7 +774,7 @@ derive_xrb! {
 		/// It is equivalent to sending this `UngrabKey` [request] for all
 		/// possible keys.
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [passive key grab]: GrabKey
 		///
@@ -801,7 +802,7 @@ derive_xrb! {
 		/// sending this `UngrabKey` [request] for all possible `modifiers`
 		/// combinations.
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [passive key grab]: GrabKey
 		///
@@ -889,7 +890,7 @@ derive_xrb! {
 	/// device to be [frozen].
 	///
 	/// [frozen]: FreezeMode::Frozen
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct AllowEvents: Request(35, error::Value) {
 		/// The conditions under which the queued [events] are released.
@@ -905,7 +906,7 @@ derive_xrb! {
 		/// of your most recent active grab or later than the X server's
 		/// [current time].
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		/// [time]: crate::Timestamp
 		/// [current time]: CurrentableTime::CurrentTime
 		pub time: CurrentableTime,
@@ -914,14 +915,14 @@ derive_xrb! {
 	/// A [request] that freezes processing of [requests][request] and
 	/// connection closes on all other clients' connections.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GrabServer: Request(36);
 
 	/// A [request] that unfreezes processing of [requests][request] and
 	/// connection closes on all other clients' connections.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct UngrabServer: Request(37);
 
@@ -932,7 +933,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias("QueryPointer, QueryCursor, GetCursorPos, GetCursorLocation"))]
@@ -962,7 +963,7 @@ derive_xrb! {
 	/// [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "GetMotionEvents")]
@@ -999,7 +1000,7 @@ derive_xrb! {
 	/// refer to defined [windows][window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "TranslateCoordinates")]
@@ -1101,7 +1102,7 @@ derive_xrb! {
 	/// do not refer to defined [windows].
 	///
 	/// [windows]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Window` error]: error::Window
 	#[doc(alias = "WarpPointer")]
@@ -1218,7 +1219,7 @@ derive_xrb! {
 	/// and does not refer to a defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Focus`]: crate::x11::event::Focus
 	/// [`Unfocus`]: crate::x11::event::Unfocus
@@ -1255,7 +1256,7 @@ derive_xrb! {
 
 	/// A [request] that returns the current focus.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[doc(alias = "GetInputFocus")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetFocus: Request(43) -> reply::GetFocus;
@@ -1263,7 +1264,7 @@ derive_xrb! {
 	/// A [request] that returns a bit vector of the currently held keys on the
 	/// keyboard.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	#[doc(alias = "QueryKeymap")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index ec65cde5..03275843 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -7,14 +7,14 @@
 //!
 //! [Requests] are messages sent from an X client to the X server.
 //!
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
 
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
-use crate::{x11::error, Window};
+use crate::{message::Request, x11::error, Window};
 
 macro_rules! request_error {
 	(
@@ -84,7 +84,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [windows]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [adds]: AddOrRemove::Add
 	/// [removes]: AddOrRemove::Remove
diff --git a/src/x11/request/miscellaneous.rs b/src/x11/request/miscellaneous.rs
index 4e29004a..1e70240c 100644
--- a/src/x11/request/miscellaneous.rs
+++ b/src/x11/request/miscellaneous.rs
@@ -9,7 +9,7 @@
 //!
 //! [atoms]: Atom
 //! [events]: Event
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
@@ -31,7 +31,7 @@ use xrbk::{
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
-	message::Event,
+	message::{Event, Request},
 	x11::{error, reply},
 	Any,
 	Atom,
@@ -85,7 +85,7 @@ derive_xrb! {
 	/// This [request] generates a [`GetAtom` reply].
 	///
 	/// [atom]: Atom
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GetAtom` reply]: reply::GetAtom
 	#[doc(alias("InternAtom", "CreateAtom"))]
@@ -133,7 +133,7 @@ derive_xrb! {
 	/// defined [atom].
 	///
 	/// [atom]: Atom
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GetAtomName` reply]: reply::GetAtomName
 	///
@@ -147,7 +147,7 @@ derive_xrb! {
 		/// [atom].
 		///
 		/// [atom]: Atom
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Atom` error]: error::Atom
 		#[doc(alias = "atom")]
@@ -323,7 +323,7 @@ derive_xrb! {
 	/// [`Match` error] is generated.
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Prepend`]: ModifyPropertyMode::Prepend
 	/// [`Append`]: ModifyPropertyMode::Append
@@ -442,7 +442,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [atom]: Atom
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Property` event]: crate::x11::event::Property
 	///
@@ -457,7 +457,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -500,7 +500,7 @@ derive_xrb! {
 	/// refer to defined [atoms].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [atoms]: Atom
 	///
 	/// [`GetProperty` reply]: reply::GetProperty
@@ -540,7 +540,7 @@ derive_xrb! {
 		/// [atom].
 		///
 		/// [atom]: Atom
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		pub property: Atom,
 		/// The property type to filter the [window]'s properties by.
 		///
@@ -580,7 +580,7 @@ derive_xrb! {
 	/// [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`ListProperties` reply]: reply::ListProperties
 	///
@@ -594,7 +594,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -630,7 +630,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [atom]: Atom
 	/// [time]: crate::Timestamp
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [current time]: CurrentableTime::CurrentTime
 	///
@@ -660,7 +660,7 @@ derive_xrb! {
 		/// [atom].
 		///
 		/// [atom]: Atom
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Atom` error]: error::Atom
 		pub selection: Atom,
@@ -673,7 +673,7 @@ derive_xrb! {
 		///
 		/// [time]: crate::Timestamp
 		/// [current time]: CurrentableTime::CurrentTime
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		pub time: CurrentableTime,
 	}
 
@@ -687,7 +687,7 @@ derive_xrb! {
 	/// [atom].
 	///
 	/// [atom]: Atom
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`GetSelectionOwner` reply]: reply::GetSelectionOwner
 	///
@@ -701,7 +701,7 @@ derive_xrb! {
 		/// [atom].
 		///
 		/// [atom]: Atom
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Atom` error]: error::Atom
 		pub target: Atom,
@@ -728,7 +728,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [atoms]: Atom
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Window` error]: error::Window
 	/// [`Atom` error]: error::Atom
@@ -752,7 +752,7 @@ derive_xrb! {
 		/// [atom].
 		///
 		/// [atom]: Atom
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Atom` error]: error::Atom
 		pub selection: Atom,
@@ -812,7 +812,7 @@ derive_xrb! {
 	///
 	/// [window]: Window
 	/// [event]: Event
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`do_not_propagate_mask`]: crate::set::Attributes::do_not_propagate_mask
 	///
diff --git a/src/x11/request/window.rs b/src/x11/request/window.rs
index d4244acb..75e6c9b1 100644
--- a/src/x11/request/window.rs
+++ b/src/x11/request/window.rs
@@ -8,7 +8,7 @@
 //! [Requests] are messages sent from an X client to the X server.
 //!
 //! [windows]: Window
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
 extern crate self as xrb;
@@ -16,6 +16,7 @@ extern crate self as xrb;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
+	message::Request,
 	set::{Attributes, WindowConfig},
 	unit::Px,
 	visual::VisualId,
@@ -75,7 +76,7 @@ derive_xrb! {
 	/// A [request] that creates a new unmapped [window] and assigns the
 	/// provided [`Window` ID][window] to it.
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [window]: Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct CreateWindow: Request(1, CreateWindowError) {
@@ -202,7 +203,7 @@ derive_xrb! {
 	/// this: only one client at a time may select [`SUBSTRUCTURE_REDIRECT`],
 	/// [`RESIZE_REDIRECT`], or [`BUTTON_PRESS`] on the [window].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [window]: Window
 	/// [attributes]: Attributes
 	///
@@ -227,14 +228,14 @@ derive_xrb! {
 
 	/// A [request] that returns the current [attributes] of the [window].
 	///
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [attributes]: Attributes
 	/// [window]: Window
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetWindowAttributes: Request(3, error::Window) -> reply::GetWindowAttributes {
 		/// The [window] for which this [request] gets the [attributes].
 		///
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		/// [attributes]: Attributes
 		/// [window]: Window
 		#[doc(alias = "window")]
@@ -257,7 +258,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [event]: crate::x11::event::Destroy
 	///
@@ -272,7 +273,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -289,7 +290,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [destroys]: DestroyWindow
 	///
@@ -347,7 +348,7 @@ derive_xrb! {
 	/// have the same depth as the `target` [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	/// [screen]: crate::visual::Screen
 	///
 	/// [`UnmapWindow` request]: UnmapWindow
@@ -420,7 +421,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Map` event]: crate::x11::event::Map
 	/// [`MapWindowRequest` event]: crate::x11::event::MapWindowRequest
@@ -439,7 +440,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -456,7 +457,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [maps]: MapWindow
 	///
@@ -492,7 +493,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`Unmap` event]: crate::x11::event::Unmap
 	///
@@ -506,7 +507,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -523,7 +524,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [unmaps]: UnmapWindow
 	///
@@ -577,7 +578,7 @@ derive_xrb! {
 	/// specified [window] is not actually a sibling of the `target` [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [configures]: WindowConfig
 	///
@@ -600,7 +601,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
@@ -629,7 +630,7 @@ derive_xrb! {
 		///
 		/// [configuration]: WindowConfig
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`width`]: WindowConfig::width
 		/// [`height`]: WindowConfig::height
@@ -684,7 +685,7 @@ derive_xrb! {
 	/// defined [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [circulates]: CirculateDirection
 	///
@@ -710,7 +711,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window error`]: error::Window
 		#[doc(alias = "window")]
@@ -733,7 +734,7 @@ derive_xrb! {
 	/// [window]: Window
 	/// [pixmap]: crate::Pixmap
 	/// [drawable]: Drawable
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`InputOnly`]: WindowClass::InputOnly
 	///
@@ -751,7 +752,7 @@ derive_xrb! {
 		/// [window]: Window
 		/// [pixmap]: crate::Pixmap
 		/// [drawable]: Drawable
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Drawable` error]: error::Drawable
 		#[doc(alias = "drawable")]
@@ -769,7 +770,7 @@ derive_xrb! {
 	/// [window].
 	///
 	/// [window]: Window
-	/// [request]: crate::message::Request
+	/// [request]: Request
 	///
 	/// [`QueryWindowTree` reply]: reply::QueryWindowTree
 	///
@@ -787,7 +788,7 @@ derive_xrb! {
 		/// [window].
 		///
 		/// [window]: Window
-		/// [request]: crate::message::Request
+		/// [request]: Request
 		///
 		/// [`Window` error]: error::Window
 		#[doc(alias = "window")]
diff --git a/xrbk_macro/src/definition/expansion/message_trait.rs b/xrbk_macro/src/definition/expansion/message_trait.rs
index 05027276..76cf4e03 100644
--- a/xrbk_macro/src/definition/expansion/message_trait.rs
+++ b/xrbk_macro/src/definition/expansion/message_trait.rs
@@ -38,10 +38,12 @@ impl Request {
 			quote!(::std::convert::Infallible)
 		};
 
+		let request_token = &self.request_token;
+
 		tokens.append_tokens({
 			quote_spanned!(self.request_token.span()=>
 				#[automatically_derived]
-				impl #impl_generics xrb::message::Request for #name #type_generics #where_clause {
+				impl #impl_generics #request_token for #name #type_generics #where_clause {
 					type Reply = #reply;
 					type OtherErrors = #other_errors;
 
@@ -89,10 +91,12 @@ impl Reply {
 			_ => panic!("replies must have a sequence field of type `u32`"),
 		};
 
+		let reply_token = &self.reply_token;
+
 		tokens.append_tokens({
 			quote_spanned!(self.reply_token.span()=>
 				#[automatically_derived]
-				impl #impl_generics xrb::message::Reply for #name #type_generics #where_clause {
+				impl #impl_generics #reply_token for #name #type_generics #where_clause {
 					type Request = #request;
 
 					#[allow(clippy::cast_possible_truncation)]
@@ -141,10 +145,12 @@ impl Event {
 			_ => quote!(None),
 		};
 
+		let event_token = &self.event_token;
+
 		tokens.append_tokens({
 			quote_spanned!(self.event_token.span()=>
 				#[automatically_derived]
-				impl #impl_generics xrb::message::Event for #name #type_generics #where_clause {
+				impl #impl_generics #event_token for #name #type_generics #where_clause {
 					const CODE: u8 = {
 						#code
 					};

From 76ab7c817bb9b863c778a2f51a8d2c38cd225111 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 18:09:48 +0000
Subject: [PATCH 104/157] WIP - CreateColormap request

Docs about which visual classes do what are still a little shaky.
---
 src/x11/request/color.rs    | 184 +++++++++++++++++++++++++++++++++++-
 src/x11/request/graphics.rs |   2 +-
 src/x11/request/window.rs   |   3 +-
 3 files changed, 185 insertions(+), 4 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 175cd091..b5da0731 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -6,5 +6,187 @@
 //!
 //! [Requests] are messages sent from an X client to the X server.
 //!
-//! [Requests]: crate::message::Request
+//! [Requests]: Request
 //! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{message::Request, visual::VisualId, x11::error, Colormap, Window};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum CreateColormapError for CreateColormap {
+		ResourceIdChoice,
+		Match,
+		Value,
+		Window,
+	}
+}
+
+// FIXME: docs for `InitialColormapAllocation` and `CreateColormap` need to be
+//        rewritten when it comes to the visual classes and what they do.
+
+/// Whether a [colormap] initially has [no entries allocated] or
+/// [all entries allocated].
+///
+/// [no entries allocated]: InitialColormapAllocation::None
+/// [all entries allocated]: InitialColormapAllocation::All
+///
+/// [colormap]: Colormap
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum InitialColormapAllocation {
+	/// The [colormap] initially has no entries, or those initial entries are
+	/// defined elsewhere.
+	///
+	/// For [`VisualClass::StaticGray`], [`VisualClass::StaticColor`], and
+	/// [`VisualClass::TrueColor`], the initial entries are defined, but by the
+	/// specific visual, not by the [core X11 protocol].
+	///
+	/// For [`VisualClass::GrayScale`], [`VisualClass::PseudoColor`], and
+	/// [`VisualClass::DirectColor`], the initial entries are undefined.
+	///
+	/// Clients can allocate entries after the [colormap] is created.
+	///
+	/// [colormap]: Colormap
+	/// [core X11 protocol]: crate::x11
+	///
+	/// [`VisualClass::StaticGray`]: crate::visual::VisualClass::StaticGray
+	/// [`VisualClass::StaticColor`]: crate::visual::VisualClass::StaticColor
+	/// [`VisualClass::TrueColor`]: crate::visual::VisualClass::TrueColor
+	///
+	/// [`VisualClass::GrayScale`]: crate::visual::VisualClass::GrayScale
+	/// [`VisualClass::PseudoColor`]: crate::visual::VisualClass::PseudoColor
+	/// [`VisualClass::DirectColor`]: crate::visual::VisualClass::DirectColor
+	None,
+
+	/// The entire [colormap] is allocated as writable.
+	///
+	/// None of these entries can be removed with [`DeleteColormapEntry`].
+	///
+	/// [colormap]: Colormap
+	All,
+}
+
+derive_xrb! {
+	/// A [request] that creates a [colormap] for the given [window]'s [screen].
+	///
+	/// # Errors
+	/// A [`ResourceIdChoice` error] is generated if the given `colormap_id` is
+	/// already in use or if it is not allocated to your client.
+	///
+	/// A [`Window` error] is generated if `window` does not refer to a defined
+	/// [window].
+	///
+	/// A [`Match` error] is generated if the given `visual` does not match the
+	/// [visual type] of the `target` [window]'s [screen].
+	///
+	/// A [`Match` error] is generated the `visual` is
+	/// [`VisualClass::StaticGray`], [`VisualClass::StaticColor`], or
+	/// [`VisualClass::TrueColor`] and `alloc` is not
+	/// [`InitialColormapAllocation::None`].
+	///
+	/// [window]: Window
+	/// [screen]: crate::visual::Screen
+	/// [visual type]: crate::visual::VisualType
+	/// [request]: Request
+	///
+	/// [`VisualClass::StaticGray`]: crate::visual::VisualClass::StaticGray
+	/// [`VisualClass::StaticColor`]: crate::visual::VisualClass::StaticColor
+	/// [`VisualClass::TrueColor`]: crate::visual::VisualClass::TrueColor
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Window` error]: error::Window
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateColormap: Request(78, CreateColormapError) {
+		/// Whether this [colormap] begins with [no entries allocated] or
+		/// [all entries allocated].
+		///
+		/// See [`InitialColormapAllocation`] for more information.
+		///
+		/// [no entries allocated]: InitialColormapAllocation::None
+		/// [all entries allocated]: InitialColormapAllocation::All
+		///
+		/// [colormap]: Colormap
+		#[metabyte]
+		pub initial_allocation: InitialColormapAllocation,
+
+		/// The [`Colormap` ID] that will be associated with the [colormap].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this [`Colormap` ID] is
+		/// already in use or if it is not allocated to your client.
+		///
+		/// [colormap]: Colormap
+		/// [`Colormap` ID]: Colormap
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		pub colormap_id: Colormap,
+
+		/// The [window] for which this [colormap] is created.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		/// [colormap]: Colormap
+		///
+		/// [`Window` error]: error::Window
+		pub window: Window,
+
+		/// The [colormap]'s [visual type].
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if the [visual type] is not one
+		/// supported by [window]'s [screen].
+		///
+		/// A [`Match` error] is generated if [visual class] is [`StaticGray`],
+		/// [`StaticColor`], or [`TrueColor`] but `alloc` is not
+		/// [`InitialColormapAllocation::None`].
+		///
+		/// [window]: Window
+		/// [screen]: crate::visual::Screen
+		/// [visual type]: crate::visual::VisualType
+		/// [visual class]: crate::visual::VisualClass
+		///
+		/// [`StaticGray`]: crate::visual::VisualClass::StaticGray
+		/// [`StaticColor`]: crate::visual::VisualClass::StaticColor
+		/// [`TrueColor`]: crate::visual::VisualClass::TrueColor
+		///
+		/// [`Match` error]: error::Match
+		pub visual: VisualId,
+	}
+}
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index 8f54d136..81bf66e0 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -3090,7 +3090,7 @@ derive_xrb! {
 	///     x: coordinates.x,
 	///     y: coordinates.y - font_ascent,
 	///     width: overall_width,
-	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
+	///     height: Px(u16::from(font_ascent.0) + u16::from(font_descent.0)),
 	/// }
 	/// # ;
 	/// ```
diff --git a/src/x11/request/window.rs b/src/x11/request/window.rs
index 75e6c9b1..9daa7364 100644
--- a/src/x11/request/window.rs
+++ b/src/x11/request/window.rs
@@ -73,8 +73,7 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A [request] that creates a new unmapped [window] and assigns the
-	/// provided [`Window` ID][window] to it.
+	/// A [request] that creates a new [window].
 	///
 	/// [request]: Request
 	/// [window]: Window

From 28245648c2a6ee74cd3eec6986f5cfd051bdface Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 19:21:26 +0000
Subject: [PATCH 105/157] DestroyColormap request

---
 src/x11/request/color.rs    | 44 +++++++++++++++++++++++++++++++++++++
 src/x11/request/graphics.rs | 28 ++++++++++++++---------
 2 files changed, 62 insertions(+), 10 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index b5da0731..6bd72b5e 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -117,6 +117,7 @@ derive_xrb! {
 	/// [`VisualClass::TrueColor`] and `alloc` is not
 	/// [`InitialColormapAllocation::None`].
 	///
+	/// [colormap]: Colormap
 	/// [window]: Window
 	/// [screen]: crate::visual::Screen
 	/// [visual type]: crate::visual::VisualType
@@ -177,6 +178,7 @@ derive_xrb! {
 		/// [`StaticColor`], or [`TrueColor`] but `alloc` is not
 		/// [`InitialColormapAllocation::None`].
 		///
+		/// [colormap]: Colormap
 		/// [window]: Window
 		/// [screen]: crate::visual::Screen
 		/// [visual type]: crate::visual::VisualType
@@ -189,4 +191,46 @@ derive_xrb! {
 		/// [`Match` error]: error::Match
 		pub visual: VisualId,
 	}
+
+	/// A [request] that deletes the given [colormap].
+	///
+	/// The association between the [`Colormap` ID] and the [colormap] itself is
+	/// removed in the process.
+	///
+	/// If the [colormap] is installed on a [screen], it is [uninstalled]. If
+	/// the [colormap] is a [window]'s [`colormap` attribute], the
+	/// [`colormap` attribute] is set to [`None`] and a [`Colormap` event] is
+	/// generated.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [window]: Window
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [uninstalled]: UninstallColormap
+	///
+	/// [`Colormap` ID]: Colormap
+	/// [`colormap` attribute]: crate::set::Attributes::colormap
+	///
+	/// [`Colormap` event]: crate::x11::event::Colormap
+	///
+	/// [`Colormap` error]: error::Colormap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DestroyColormap: Request(79) {
+		/// The [colormap] which is to be deleted.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap", "cmap", "map"))]
+		pub target: Colormap,
+	}
 }
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index 81bf66e0..e3965792 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -3081,18 +3081,22 @@ derive_xrb! {
 	/// ```
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
-	/// # let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// # fn main() -> Result<(), <u16 as TryFrom<i16>>::Error> {
+	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
 	/// #
-	/// # let (font_ascent, font_descent) = (Px(0), Px(0));
-	/// # let overall_width = Px(1);
+	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// #     let overall_width = Px(1);
 	/// #
 	/// Rectangle {
 	///     x: coordinates.x,
 	///     y: coordinates.y - font_ascent,
 	///     width: overall_width,
-	///     height: Px(u16::from(font_ascent.0) + u16::from(font_descent.0)),
+	///     height: Px(u16::try_from(font_ascent.0 + font_descent.0)?),
 	/// }
-	/// # ;
+	/// #     ;
+	/// #
+	/// #     Ok(())
+	/// # }
 	/// ```
 	///
 	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this
@@ -3218,18 +3222,22 @@ derive_xrb! {
 	/// ```
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
-	/// # let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// # fn main() -> Result<(), <u16 as TryFrom<i16>>::Error> {
+	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
 	/// #
-	/// # let (font_ascent, font_descent) = (Px(0), Px(0));
-	/// # let overall_width = Px(1);
+	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
+	/// #     let overall_width = Px(1);
 	/// #
 	/// Rectangle {
 	///     x: coordinates.x,
 	///     y: coordinates.y - font_ascent,
 	///     width: overall_width,
-	///     height: Px(font_ascent.0.into() + font_descent.0.into()),
+	///     height: Px(u16::try_from(font_ascent.0 + font_descent.0)?),
 	/// }
-	/// # ;
+	/// #     ;
+	/// #
+	/// #     Ok(())
+	/// # }
 	/// ```
 	///
 	/// `graphics_context`'s [`function`] and [`fill_style`] are ignored in this

From ccfb6608a0a87186bd7914b5a614537c721fe398 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 19:33:52 +0000
Subject: [PATCH 106/157] MoveColormap request

---
 src/x11/request/color.rs    | 57 ++++++++++++++++++++++++++++++++++++-
 src/x11/request/graphics.rs |  4 +--
 2 files changed, 58 insertions(+), 3 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 6bd72b5e..8f83530b 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -219,8 +219,9 @@ derive_xrb! {
 	/// [`Colormap` event]: crate::x11::event::Colormap
 	///
 	/// [`Colormap` error]: error::Colormap
+	#[doc(alias("FreeColormap"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct DestroyColormap: Request(79) {
+	pub struct DestroyColormap: Request(79, error::Colormap) {
 		/// The [colormap] which is to be deleted.
 		///
 		/// # Errors
@@ -234,3 +235,57 @@ derive_xrb! {
 		pub target: Colormap,
 	}
 }
+
+request_error! {
+	#[doc(alias("CopyColormapAndFreeError"))]
+	pub enum MoveColormapError for MoveColormap {
+		Colormap,
+		ResourceIdChoice,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that moves all of the values of a `source` [colormap] into a
+	/// new [colormap], then destroys the `source` [colormap].
+	///
+	/// # Errors
+	/// A [`ResourceIdChoice` error] is generated if `colormap_id` is already in
+	/// use or if it is not allocated to your client.
+	///
+	/// A [`Colormap` error] is generated if `source` does not refer to a
+	/// defined [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Colormap` error]: error::Colormap
+	#[doc(alias("CopyColormapAndFree"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct MoveColormap: Request(80, MoveColormapError) {
+		/// The [`Colormap` ID] that will be associated with the new [colormap].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this [`Colormap` ID] is
+		/// already in use or if it is not allocated to your client.
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` ID]: Colormap
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		pub colormap_id: Colormap,
+
+		/// The [colormap] which is copied to create the new [colormap], then
+		/// destroyed.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub source: Colormap,
+	}
+}
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index e3965792..986c2231 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -638,8 +638,8 @@ derive_xrb! {
 	/// [`GraphicsContext` ID]: GraphicsContext
 	///
 	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("FreeGc", "FreeGC", "FreeGcontext", "FreeGraphicsContext"))]
-	#[doc(alias("DestroyGc", "DestroyGC", "DestroyGcontext"))]
+	#[doc(alias("FreeGc", "FreeGcontext", "FreeGraphicsContext"))]
+	#[doc(alias("DestroyGc", "DestroyGcontext"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
 		/// The [`GraphicsContext`] which is to be deleted.

From 6eb93512b0865520e82d54c4590fd6b93a0359cc Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 20:42:15 +0000
Subject: [PATCH 107/157] InstallColormap request

---
 src/common/visual.rs     |  4 +--
 src/x11/request/color.rs | 55 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 2 deletions(-)

diff --git a/src/common/visual.rs b/src/common/visual.rs
index 1b53e793..6bab1092 100644
--- a/src/common/visual.rs
+++ b/src/common/visual.rs
@@ -344,8 +344,8 @@ derive_xrb! {
 		pub width_mm: Mm<u16>,
 		pub height_mm: Mm<u16>,
 
-		pub min_installed_maps: u16,
-		pub max_installed_maps: u16,
+		pub min_installed_colormaps: u16,
+		pub max_installed_colormaps: u16,
 
 		pub root_visual: VisualId,
 		pub maintain_contents_mode: MaintainContents,
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 8f83530b..d5ea6bb1 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -288,4 +288,59 @@ derive_xrb! {
 		/// [`Colormap` error]: error::Colormap
 		pub source: Colormap,
 	}
+
+	/// A [request] that installs the given [colormap] on its [screen].
+	///
+	/// All [windows] associated with the given [colormap] will immediately
+	/// switch to their true colors.
+	///
+	/// As a side effect of this [request], additional [colormaps][colormap] may
+	/// be implicitly installed or [uninstalled](UninstallColormap) by the X
+	/// server.
+	///
+	/// If the given `target` [colormap] was not already installed,
+	/// a [`Colormap` event] is generated for every [window] which specifies the
+	/// [colormap] in its [`colormap` attribute].
+	///
+	/// ## Required colormaps list
+	/// When a [colormap] is explicitly installed (that is, it is installed with
+	/// this [request]), it is added as the head of the [screen]'s required
+	/// [colormaps][colormap] list.
+	///
+	/// The length of the required [colormaps][colormap] list no more than the
+	/// [screen]'s [`min_installed_colormaps`]: if installing this [colormap]
+	/// causes the list to exceed that limit, the list is truncated at the tail
+	/// to make room.
+	///
+	/// [Explicitly uninstalling](UninstallColormap) a [colormap] will also
+	/// remove that [colormap] from the required list.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [windows]: Window
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`colormap` attribute]: crate::set::Attributes::colormap
+	/// [`min_installed_colormaps`]: crate::visual::Screen::min_installed_colormaps
+	///
+	/// [`Colormap` event]: crate::x11::event::Colormap
+	///
+	/// [`Colormap` error]: error::Colormap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct InstallColormap: Request(81, error::Colormap) {
+		/// The [colormap] that is to be installed.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub target: Colormap,
+	}
 }

From 431bc2e421a322ae714abec49fcf4c08b8ddd97c Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 21:08:58 +0000
Subject: [PATCH 108/157] UninstallColormap request

---
 src/x11/request/color.rs | 81 +++++++++++++++++++++++++++++++++++-----
 1 file changed, 72 insertions(+), 9 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index d5ea6bb1..37cb81d1 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -291,17 +291,19 @@ derive_xrb! {
 
 	/// A [request] that installs the given [colormap] on its [screen].
 	///
-	/// All [windows] associated with the given [colormap] will immediately
-	/// switch to their true colors.
-	///
-	/// As a side effect of this [request], additional [colormaps][colormap] may
-	/// be implicitly installed or [uninstalled](UninstallColormap) by the X
-	/// server.
+	/// All [windows][window] associated with the given [colormap] will
+	/// immediately switch to their true colors.
 	///
 	/// If the given `target` [colormap] was not already installed,
 	/// a [`Colormap` event] is generated for every [window] which specifies the
 	/// [colormap] in its [`colormap` attribute].
 	///
+	/// As a side effect of this [request], additional [colormaps][colormap] may
+	/// be implicitly installed or uninstalled by the X server. For each
+	/// [colormap] that is implicitly installed or uninstalled as a result of
+	/// this [request], a [`Colormap` event] is generated for every [window]
+	/// which specifies that [colormap] in its [`colormap` attribute].
+	///
 	/// ## Required colormaps list
 	/// When a [colormap] is explicitly installed (that is, it is installed with
 	/// this [request]), it is added as the head of the [screen]'s required
@@ -312,15 +314,19 @@ derive_xrb! {
 	/// causes the list to exceed that limit, the list is truncated at the tail
 	/// to make room.
 	///
-	/// [Explicitly uninstalling](UninstallColormap) a [colormap] will also
-	/// remove that [colormap] from the required list.
+	/// [Explicitly uninstalling](UninstallColormap) a [colormap] means to
+	/// remove it from the list of required [colormaps][colormap]. It may or may
+	/// not actually be uninstalled as a result.
+	///
+	/// The X server may implicitly uninstall any [colormap] _not_ in the list
+	/// of required [colormaps][colormap] at any time.
 	///
 	/// # Errors
 	/// A [`Colormap` error] is generated if `target` does not refer to a
 	/// defined [colormap].
 	///
 	/// [colormap]: Colormap
-	/// [windows]: Window
+	/// [window]: Window
 	/// [screen]: crate::visual::Screen
 	/// [request]: Request
 	///
@@ -343,4 +349,61 @@ derive_xrb! {
 		/// [`Colormap` error]: error::Colormap
 		pub target: Colormap,
 	}
+
+	/// A [request] that removes the given [colormap] from the
+	/// list of required colormaps for its [screen].
+	///
+	/// If the given [colormap] is uninstalled as a result of this [request], a
+	/// [`Colormap` event] is generated for every [window] which specifies the
+	/// [colormap] in its [`colormap` attribute].
+	///
+	/// As a side effect of this [request], additional [colormaps][colormap] may
+	/// be implicitly installed or uninstalled by the X server. For each
+	/// [colormap] that is implicitly installed or uninstalled as a result of
+	/// this [request], a [`Colormap` event] is generated for every [window]
+	/// which specifies that [colormap] in its [`colormap` attribute].
+	///
+	/// ## Required colormaps list
+	/// When a [colormap] is [explicitly installed](InstallColormap), it is
+	/// added as the head of the [screen]'s required [colormaps][colormap] list.
+	///
+	/// The length of the required [colormaps][colormap] list is no more than
+	/// the [screen]'s [`min_installed_colormaps`].
+	///
+	/// Explicitly uninstalling a [colormap] (that is, it is uninstalled with
+	/// this [request]) actually removes that [colormap] from the [screen]'s
+	/// list of required [colormaps][colormap]. As a result, it may or may not
+	/// be uninstalled by the X server.
+	///
+	/// The X server may implicitly uninstall any [colormap] _not_ in the list
+	/// of required [colormaps][colormap] at any time.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [window]: Window
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`colormap` attribute]: crate::set::Attributes::colormap
+	/// [`min_installed_colormaps`]: crate::visual::Screen::min_installed_colormaps
+	///
+	/// [`Colormap` event]: crate::x11::event::Colormap
+	///
+	/// [`Colormap` error]: error::Colormap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct UninstallColormap: Request(82, error::Colormap) {
+		/// The [colormap] that is to be uninstalled.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub target: Colormap,
+	}
 }

From 9de6c7f756fda222453861345dbcf037155919e6 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 21:39:53 +0000
Subject: [PATCH 109/157] ListInstalledColormaps request + reply

---
 src/x11/reply/color.rs   | 54 ++++++++++++++++++++++++++++++++++++++--
 src/x11/request/color.rs | 43 +++++++++++++++++++++++++++++++-
 2 files changed, 94 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 56bb008b..054dadbf 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -8,8 +8,58 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
-//! [requests that relate to colors]: crate::x11::request::color
+//! [requests that relate to colors]: request::color
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+
+use xrbk_macro::derive_xrb;
+
+use crate::{message::Reply, x11::request, Colormap};
+
+derive_xrb! {
+	/// The [reply] to a [`ListInstalledColormaps` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`ListInstalledColormaps` request]: request::ListInstalledColormaps
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListInstalledColormaps: Reply for request::ListInstalledColormaps {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `colormaps`.
+		#[allow(clippy::cast_possible_truncation)]
+		let colormaps_len: u16 = colormaps => colormaps.len() as u16,
+		[_; 22],
+
+		/// The [colormaps] which are currently installed on the given
+		/// `target`'s [screen].
+		///
+		/// This list is in no particular order.
+		///
+		/// This list has no indication as to which [colormaps] are contained in
+		/// the [screen]'s list of required [colormaps].
+		///
+		/// [colormaps]: Colormaps
+		/// [screen]: crate::visual::Screen
+		#[context(colormaps_len => usize::from(*colormaps_len))]
+		pub colormaps: Vec<Colormap>,
+	}
+}
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 37cb81d1..5eaa8b83 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -13,7 +13,13 @@ extern crate self as xrb;
 
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
-use crate::{message::Request, visual::VisualId, x11::error, Colormap, Window};
+use crate::{
+	message::Request,
+	visual::VisualId,
+	x11::{error, reply},
+	Colormap,
+	Window,
+};
 
 macro_rules! request_error {
 	(
@@ -406,4 +412,39 @@ derive_xrb! {
 		/// [`Colormap` error]: error::Colormap
 		pub target: Colormap,
 	}
+
+	/// A [request] that returns a list of the given [window]'s [screen]'s
+	/// currently installed [colormaps].
+	///
+	/// # Replies
+	/// This [request] generates a [`ListInstalledColormaps` reply].
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// [colormaps]: Colormap
+	/// [window]: Window
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`ListInstalledColormaps` reply]: reply::ListInstalledColormaps
+	///
+	/// [`Window` error]: error::Window
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListInstalledColormaps: Request(83, error::Window) -> reply::ListInstalledColormaps {
+		/// The [window] for which this [request] returns its installed
+		/// [colormaps].
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [colormaps]: Colormap
+		/// [window]: Window
+		/// [request]: Request
+		///
+		/// [`Window` error]: error::Window
+		pub target: Window,
+	}
 }

From bc3fb345f032e670434ba0be2e2895c7518bc10c Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 21:41:34 +0000
Subject: [PATCH 110/157] fix message module doctest

---
 src/message.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/message.rs b/src/message.rs
index 3064d850..2fc72988 100644
--- a/src/message.rs
+++ b/src/message.rs
@@ -102,7 +102,7 @@ pub trait Request: X11Size + Writable {
 	///
 	/// ```
 	/// use xrbk_macro::derive_xrb;
-	/// use xrb::{ColorChannelMask, Colormap, visual::ColorId, String8};
+	/// use xrb::{ColorChannelMask, Colormap, visual::ColorId, message::Request, String8};
 	///
 	/// derive_xrb! {
 	///     #[derive(Debug, Hash, PartialEq, Eq, Readable, Writable, X11Size)]

From b930319798e360d04c296ae5f919a6343c4b08f6 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Sun, 29 Jan 2023 22:00:53 +0000
Subject: [PATCH 111/157] AllocateColor request

---
 src/x11/reply/color.rs   | 41 ++++++++++++++++++++++++++++++++++-
 src/x11/request/color.rs | 47 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 86 insertions(+), 2 deletions(-)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 054dadbf..50e5fa17 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -20,7 +20,12 @@ use derivative::Derivative;
 
 use xrbk_macro::derive_xrb;
 
-use crate::{message::Reply, x11::request, Colormap};
+use crate::{
+	message::Reply,
+	visual::{ColorId, RgbColor},
+	x11::request,
+	Colormap,
+};
 
 derive_xrb! {
 	/// The [reply] to a [`ListInstalledColormaps` request].
@@ -62,4 +67,38 @@ derive_xrb! {
 		#[context(colormaps_len => usize::from(*colormaps_len))]
 		pub colormaps: Vec<Colormap>,
 	}
+
+	/// The [reply] to an [`AllocateColor` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`AllocateColor` request]: request::AllocateColor
+	#[doc(alias("AllocColor"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct AllocateColor: Reply for request::AllocateColor {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The actual RGB values that were allocated.
+		///
+		/// These are the closest RGB values to those requested that the display
+		/// could provide.
+		pub actual_color: RgbColor,
+		[_; 2],
+
+		/// The [`ColorId`] referring to the `actual_color`.
+		pub color_id: ColorId,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 5eaa8b83..b1ddefa1 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -15,7 +15,7 @@ use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
-	visual::VisualId,
+	visual::{RgbColor, VisualId},
 	x11::{error, reply},
 	Colormap,
 	Window,
@@ -447,4 +447,49 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub target: Window,
 	}
+
+	/// A [request] that allocates a read-only [colormap] entry for the given
+	/// color on the given [colormap].
+	///
+	/// The closest [RGB values] provided by the display are chosen.
+	///
+	/// Multiple clients may be assigned the same read-only [colormap] entry if
+	/// they request the same closest [RGB values].
+	///
+	/// The [`ColorId`] and [RGB values] that were actually used are returned.
+	///
+	/// # Replies
+	/// This [request] generates an [`AllocateColor` reply].
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`ColorId`]: crate::visual::ColorId
+	///
+	/// [`AllocateColor` reply]: reply::AllocateColor
+	///
+	/// [`Colormap` error]: error::Colormap
+	#[doc(alias("AllocColor"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AllocateColor: Request(84, error::Colormap) -> reply::AllocateColor {
+		/// The [colormap] for which the [colormap] entry is allocated.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub target: Colormap,
+
+		/// The color which is to be allocated.
+		pub color: RgbColor,
+		[_; 2],
+	}
 }

From 9062f5b2cbca6c46f1cf0ccfc127735af49595ac Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 30 Jan 2023 07:54:46 +0000
Subject: [PATCH 112/157] map and inspect methods for units

---
 src/unit.rs                 | 59 +++++++++++++++++++++++++++++++++++++
 src/x11/request/graphics.rs |  8 ++---
 2 files changed, 63 insertions(+), 4 deletions(-)

diff --git a/src/unit.rs b/src/unit.rs
index 023cbd85..36803f25 100644
--- a/src/unit.rs
+++ b/src/unit.rs
@@ -100,6 +100,19 @@ macro_rules! impl_xrbk_traits {
 )]
 pub struct Px<Num>(pub Num);
 
+impl<Num> Px<Num> {
+	/// Maps a `Px<Num>` to `Px<Output>` by applying the provided closure to the
+	/// contained value.
+	pub fn map<Output>(self, map: impl FnOnce(Num) -> Output) -> Px<Output> {
+		Px(map(self.0))
+	}
+
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(&Num)) {
+		inspect(&self.0);
+	}
+}
+
 impl<Num> Display for Px<Num>
 where
 	Num: Display,
@@ -135,6 +148,19 @@ impl_xrbk_traits!(Px<Num>(Num));
 )]
 pub struct Mm<Num>(pub Num);
 
+impl<Num> Mm<Num> {
+	/// Maps a `Mm<Num>` to `Mm<Output>` by applying the provided closure to the
+	/// contained value.
+	pub fn map<Output>(self, map: impl FnOnce(Num) -> Output) -> Mm<Output> {
+		Mm(map(self.0))
+	}
+
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(&Num)) {
+		inspect(&self.0);
+	}
+}
+
 impl<Num> Display for Mm<Num>
 where
 	Num: Display,
@@ -170,6 +196,19 @@ impl_xrbk_traits!(Mm<Num>(Num));
 )]
 pub struct Ms<Num>(pub Num);
 
+impl<Num> Ms<Num> {
+	/// Maps a `Ms<Num>` to `Ms<Output>` by applying the provided closure to the
+	/// contained value.
+	pub fn map<Output>(self, map: impl FnOnce(Num) -> Output) -> Ms<Output> {
+		Ms(map(self.0))
+	}
+
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(&Num)) {
+		inspect(&self.0);
+	}
+}
+
 impl<Num> Display for Ms<Num>
 where
 	Num: Display,
@@ -205,6 +244,19 @@ impl_xrbk_traits!(Ms<Num>(Num));
 )]
 pub struct Hz<Num>(pub Num);
 
+impl<Num> Hz<Num> {
+	/// Maps a `Hz<Num>` to `Hz<Output>` by applying the provided closure to the
+	/// contained value.
+	pub fn map<Output>(self, map: impl FnOnce(Num) -> Output) -> Hz<Output> {
+		Hz(map(self.0))
+	}
+
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(&Num)) {
+		inspect(&self.0);
+	}
+}
+
 impl<Num> Display for Hz<Num>
 where
 	Num: Display,
@@ -220,6 +272,13 @@ impl_xrbk_traits!(Hz<Num>(Num));
 #[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
 pub struct Percentage(u8);
 
+impl Percentage {
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(u8)) {
+		inspect(self.0);
+	}
+}
+
 impl Display for Percentage {
 	fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
 		write!(f, "{}%", self.0)
diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index 986c2231..5c010e5d 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -3082,7 +3082,7 @@ derive_xrb! {
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
 	/// # fn main() -> Result<(), <u16 as TryFrom<i16>>::Error> {
-	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// #     let coordinates = Coords::new(Px(0), Px(0));
 	/// #
 	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
 	/// #     let overall_width = Px(1);
@@ -3091,7 +3091,7 @@ derive_xrb! {
 	///     x: coordinates.x,
 	///     y: coordinates.y - font_ascent,
 	///     width: overall_width,
-	///     height: Px(u16::try_from(font_ascent.0 + font_descent.0)?),
+	///     height: (font_ascent + font_descent).map(|height| height as u16),
 	/// }
 	/// #     ;
 	/// #
@@ -3223,7 +3223,7 @@ derive_xrb! {
 	/// # use xrb::{Rectangle, Coords, unit::Px};
 	/// #
 	/// # fn main() -> Result<(), <u16 as TryFrom<i16>>::Error> {
-	/// #     let coordinates = Coords { x: Px(0), y: Px(0) };
+	/// #     let coordinates = Coords::new(Px(0), Px(0));
 	/// #
 	/// #     let (font_ascent, font_descent) = (Px(0), Px(0));
 	/// #     let overall_width = Px(1);
@@ -3232,7 +3232,7 @@ derive_xrb! {
 	///     x: coordinates.x,
 	///     y: coordinates.y - font_ascent,
 	///     width: overall_width,
-	///     height: Px(u16::try_from(font_ascent.0 + font_descent.0)?),
+	///     height: (font_ascent + font_descent).map(|height| height as u16),
 	/// }
 	/// #     ;
 	/// #

From dd0b0e01e630b5d9aff4f4d1b55da397504eb096 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 30 Jan 2023 09:06:31 +0000
Subject: [PATCH 113/157] XRBK macro: allow trailing comma in message syntaxes

---
 xrbk_macro/src/definition.rs                  | 31 ++++---
 .../src/definition/expansion/message_trait.rs |  4 +-
 xrbk_macro/src/definition/parsing.rs          | 84 +++++++++++++++----
 3 files changed, 88 insertions(+), 31 deletions(-)

diff --git a/xrbk_macro/src/definition.rs b/xrbk_macro/src/definition.rs
index 4fe4bdf3..ed0f789e 100644
--- a/xrbk_macro/src/definition.rs
+++ b/xrbk_macro/src/definition.rs
@@ -2,12 +2,11 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-mod expansion;
-mod parsing;
-
+use quote::quote;
 use syn::{
 	braced,
 	parenthesized,
+	punctuated::Punctuated,
 	token,
 	Attribute,
 	Expr,
@@ -21,14 +20,14 @@ use syn::{
 	WhereClause,
 };
 
-use quote::quote;
-use syn::punctuated::Punctuated;
-
 use crate::{
 	attribute::parsing::ParsedItemAttributes,
 	element::{Content, StructlikeContent},
 };
 
+mod expansion;
+mod parsing;
+
 /// Multiple [`Definition`]s.
 ///
 /// > **<sup>Syntax</sup>**\
@@ -170,15 +169,17 @@ pub struct Request {
 	pub paren_token: token::Paren,
 	/// An expression representing the major opcode associated with the request.
 	pub major_opcode: Expr,
-	/// An optional comma then an expression representing the minor opcode
-	/// associated with the request.
-	pub minor_opcode: Option<(Token![,], Expr)>,
+	/// A comma token: `,`. This is required before the `minor_opcode`.
+	pub comma1: Option<Token![,]>,
+	/// An expression representing the minor opcode associated with the request.
+	pub minor_opcode: Option<Expr>,
+	/// A comma token: `,`. This is required before `other_errors`.
+	pub comma2: Option<Token![,]>,
 	/// An optional type representing the `OtherErrors` generated by the
 	/// request.
-	// TODO: is this the best syntax? this syntax means the errors generated by the request appear
-	//       after the major and minor opcodes, simply separated by a comma. is this clearly
-	//       showing that these are the errors?
-	pub other_errors: Option<(Token![,], Type)>,
+	pub other_errors: Option<Type>,
+	/// A comma token: `,`.
+	pub comma3: Option<Token![,]>,
 
 	/// An optional arrow followed by a type representing replies generated by
 	/// the request.
@@ -274,6 +275,8 @@ pub struct Event {
 	/// An expression representing the unique event code associated with the
 	/// event.
 	pub event_code: Expr,
+	/// A comma token: `,`.
+	pub comma: Option<Token![,]>,
 
 	/// The content of the `Event`, containing its elements.
 	pub content: StructlikeContent,
@@ -319,6 +322,8 @@ pub struct Error {
 	/// An expression representing the unique error code associated with the
 	/// error.
 	pub error_code: Expr,
+	/// A comma token: `,`.
+	pub comma: Option<Token![,]>,
 
 	/// The content of the `Error`, containing its elements.
 	pub content: StructlikeContent,
diff --git a/xrbk_macro/src/definition/expansion/message_trait.rs b/xrbk_macro/src/definition/expansion/message_trait.rs
index 76cf4e03..393e6ba8 100644
--- a/xrbk_macro/src/definition/expansion/message_trait.rs
+++ b/xrbk_macro/src/definition/expansion/message_trait.rs
@@ -27,12 +27,12 @@ impl Request {
 		};
 
 		let major_opcode = &self.major_opcode;
-		let minor_opcode = if let Some((_, minor_opcode)) = &self.minor_opcode {
+		let minor_opcode = if let Some(minor_opcode) = &self.minor_opcode {
 			quote!(Some(#minor_opcode))
 		} else {
 			quote!(None)
 		};
-		let other_errors = if let Some((_, other_errors)) = &self.other_errors {
+		let other_errors = if let Some(other_errors) = &self.other_errors {
 			other_errors.to_token_stream()
 		} else {
 			quote!(::std::convert::Infallible)
diff --git a/xrbk_macro/src/definition/parsing.rs b/xrbk_macro/src/definition/parsing.rs
index 244eb392..16ea2ae6 100644
--- a/xrbk_macro/src/definition/parsing.rs
+++ b/xrbk_macro/src/definition/parsing.rs
@@ -2,8 +2,6 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
-use super::*;
-use crate::{definition::DefinitionType, ParseWithContext, PsExt};
 use syn::{
 	parse::{discouraged::Speculative, Parse, ParseStream},
 	spanned::Spanned,
@@ -13,6 +11,10 @@ use syn::{
 	Visibility,
 };
 
+use crate::{definition::DefinitionType, ParseWithContext, PsExt};
+
+use super::*;
+
 impl Parse for Definitions {
 	fn parse(input: ParseStream) -> Result<Self> {
 		let mut definitions = Vec::new();
@@ -150,30 +152,56 @@ impl ParseWithContext for Request {
 		let paren_token = parenthesized!(content in input);
 
 		let major_opcode = content.parse()?;
+		let mut comma1 = None;
 		let mut minor_opcode = None;
+		let mut comma2 = None;
 		let mut other_errors = None;
+		let mut comma3 = None;
 
 		if content.peek(Token![,]) {
-			let comma = content.parse()?;
+			comma1 = content.parse()?;
 			let fork = &content.fork();
 
-			if let Ok(r#type) = fork.parse::<Type>() && !fork.peek(Token![,]) {
-				// If the tokens following the comma can be parsed as a type,
-				// and there is no comma after that type, then this is the type
-				// representing the errors generated by the request.
+			if let Ok(r#type) = fork.parse::<Type>() {
+				if fork.peek(Token![,]) {
+					let comma = fork.parse()?;
+
+					if fork.is_empty() {
+						content.advance_to(fork);
+						other_errors = Some(r#type);
+						comma3 = Some(comma);
+					} else {
+						minor_opcode = Some(content.parse::<Expr>()?);
+
+						if content.peek(Token![,]) {
+							comma2 = Some(content.parse()?);
 
-				content.advance_to(fork);
-				other_errors = Some((comma, r#type));
+							if !content.is_empty() {
+								other_errors = Some(content.parse::<Type>()?);
+
+								if content.peek(Token![,]) {
+									comma3 = Some(content.parse()?);
+								}
+							}
+						}
+					}
+				} else {
+					content.advance_to(fork);
+					other_errors = Some(r#type);
+				}
 			} else {
-				// Otherwise, if the tokens following the comma couldn't be
-				// parsed as a type, or there was a comma after those tokens,
-				// then we parse those tokens as the minor opcode.
-				minor_opcode = Some((comma, content.parse::<Expr>()?));
+				minor_opcode = Some(content.parse::<Expr>()?);
 
-				// If there is a comma following the minor opcode, then we know
-				// it must be for the errors generated by the request.
 				if content.peek(Token![,]) {
-					other_errors = Some((content.parse::<Token![,]>()?, content.parse::<Type>()?));
+					comma2 = Some(content.parse()?);
+
+					if !content.is_empty() {
+						other_errors = Some(content.parse::<Type>()?);
+
+						if content.peek(Token![,]) {
+							comma3 = Some(content.parse()?);
+						}
+					}
 				}
 			}
 		}
@@ -190,9 +218,15 @@ impl ParseWithContext for Request {
 			request_token,
 
 			paren_token,
+
 			major_opcode,
+			comma1,
+
 			minor_opcode,
+			comma2,
+
 			other_errors,
+			comma3,
 
 			reply: if input.peek(Token![->]) {
 				Some((input.parse()?, input.parse()?))
@@ -243,14 +277,23 @@ impl ParseWithContext for Event {
 
 		Ok(Self {
 			item_attributes,
+
 			visibility,
 			struct_token,
 			ident,
 			generics,
+
 			colon_token,
 			event_token,
+
 			paren_token: parenthesized!(content in input),
 			event_code: content.parse()?,
+			comma: if content.peek(Token![,]) {
+				Some(content.parse()?)
+			} else {
+				None
+			},
+
 			content: input.parse_with(DefinitionType::Event)?,
 		})
 	}
@@ -270,14 +313,23 @@ impl ParseWithContext for Error {
 
 		Ok(Self {
 			item_attributes,
+
 			visibility,
 			struct_token,
 			ident,
 			generics,
+
 			colon_token,
 			error_token,
+
 			paren_token: parenthesized!(content in input),
 			error_code: content.parse()?,
+			comma: if content.peek(Token![,]) {
+				Some(content.parse()?)
+			} else {
+				None
+			},
+
 			content: input.parse_with(DefinitionType::Error)?,
 		})
 	}

From 43446ac43fbbae5c7646dc9234afa13d8fae5e1b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 30 Jan 2023 09:06:53 +0000
Subject: [PATCH 114/157] AllocateNamedColor request + reply

---
 src/x11/reply/color.rs   | 22 ++++++++++++++
 src/x11/request/color.rs | 66 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 50e5fa17..82f6cb3f 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -101,4 +101,26 @@ derive_xrb! {
 		pub color_id: ColorId,
 		[_; ..],
 	}
+
+	#[doc(alias("AllocNamedColor"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct AllocateNamedColor: Reply for request::AllocateNamedColor {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		pub ideal_color: RgbColor,
+		pub actual_color: RgbColor,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index b1ddefa1..06951d3c 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -11,6 +11,7 @@
 
 extern crate self as xrb;
 
+use xrbk::pad;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
@@ -18,6 +19,7 @@ use crate::{
 	visual::{RgbColor, VisualId},
 	x11::{error, reply},
 	Colormap,
+	String8,
 	Window,
 };
 
@@ -493,3 +495,67 @@ derive_xrb! {
 		[_; 2],
 	}
 }
+
+request_error! {
+	#[doc(alias("AllocNamedColor"))]
+	pub enum AllocateNamedColorError for AllocateNamedColor {
+		Colormap,
+		Name,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that allocates a read-only [colormap] entry on the given
+	/// [colormap] for the color by the given `name`.
+	///
+	/// The `name` is looked up on the [screen] associated with the [colormap].
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// A [`Name` error] is generated if no color by the given `name` exists for
+	/// the [screen] associated with the `target` [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`Colormap` error]: error::Colormap
+	/// [`Name` error]: error::Name
+	#[doc(alias("AllocNamedColor"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AllocateNamedColor: Request(
+		85,
+		AllocateNamedColorError,
+	) -> reply::AllocateNamedColor {
+		/// The [colormap] for which a [colormap] entry for the color by the
+		/// given `name` is allocated.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub target: Colormap,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// The name of the color that is looked up on the [screen] associated
+		/// with the [colormap].
+		///
+		/// The name should be specified in ISO Latin-1 encoding. Which case (e.g.
+		/// uppercase, lowercase) the name is specified in does not matter.
+		///
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+}

From d0bc0960898445e6ecfc7c25fba425f4f37ecabc Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Mon, 30 Jan 2023 11:54:31 +0000
Subject: [PATCH 115/157] AllocateColorCells request + reply

---
 src/x11/reply/color.rs   | 62 +++++++++++++++++++++++++++++
 src/x11/request/color.rs | 86 ++++++++++++++++++++++++++++++++++++++--
 2 files changed, 144 insertions(+), 4 deletions(-)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 82f6cb3f..5fd901fa 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -102,6 +102,11 @@ derive_xrb! {
 		[_; ..],
 	}
 
+	/// The [reply] to an [`AllocateNamedColor` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`AllocateNamedColor` request]: request::AllocateNamedColor
 	#[doc(alias("AllocNamedColor"))]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
@@ -119,8 +124,65 @@ derive_xrb! {
 		#[derivative(Hash = "ignore", PartialEq = "ignore")]
 		pub sequence: u16,
 
+		/// The ideal or 'true' color which the name represents.
 		pub ideal_color: RgbColor,
+		/// The closest color that the display was able to provide.
 		pub actual_color: RgbColor,
 		[_; ..],
 	}
+
+	/// The [reply] to an [`AllocateColorCells` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`AllocateColorCells` request]: request::AllocateColorCells
+	#[doc(alias("AllocColorCells"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct AllocateColorCells: Reply for request::AllocateColorCells {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `colors`.
+		#[allow(clippy::cast_possible_truncation)]
+		let colors_len: u16 = colors => colors.len() as u16,
+		// The length of `plane_masks`.
+		#[allow(clippy::cast_possible_truncation)]
+		let plane_masks_len: u16 = plane_masks => plane_masks.len() as u16,
+		[_; 20],
+
+		/// The colors that were used for the allocated [colormap] entries.
+		///
+		/// [colormap]: Colormap
+		#[context(colors_len => usize::from(*colors_len))]
+		pub colors: Vec<ColorId>,
+		/// The bit plane masks that were used for the allocated [colormap]
+		/// entries.
+		///
+		/// For [`VisualClass::GrayScale`] or [`VisualClass::PseudoColor`], each
+		/// plane mask will have one bit set to `1` (because there is only one
+		/// color channel).
+		///
+		/// For [`VisualClass::DirectColor`], each plane mask will have 3 bits
+		/// sets to `1` (because there are three color channels: red, green, and
+		/// blue).
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`VisualClass::GrayScale`]: crate::visual::VisualClass::GrayScale
+		/// [`VisualClass::PseudoColor`]: crate::visual::VisualClass::PseudoColor
+		/// [`VisualClass::DirectColor`]: crate::visual::VisualClass::DirectColor
+		#[context(plane_masks_len => usize::from(*plane_masks_len))]
+		pub plane_masks: Vec<u32>,
+	}
 }
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 06951d3c..3ee09c71 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -317,10 +317,10 @@ derive_xrb! {
 	/// this [request]), it is added as the head of the [screen]'s required
 	/// [colormaps][colormap] list.
 	///
-	/// The length of the required [colormaps][colormap] list no more than the
-	/// [screen]'s [`min_installed_colormaps`]: if installing this [colormap]
-	/// causes the list to exceed that limit, the list is truncated at the tail
-	/// to make room.
+	/// The length of the required [colormaps][colormap] list is no more than
+	/// the [screen]'s [`min_installed_colormaps`]: if installing this
+	/// [colormap] causes the list to exceed that limit, the list is truncated
+	/// at the tail to make room.
 	///
 	/// [Explicitly uninstalling](UninstallColormap) a [colormap] means to
 	/// remove it from the list of required [colormaps][colormap]. It may or may
@@ -559,3 +559,81 @@ derive_xrb! {
 		[_; name => pad(name)],
 	}
 }
+
+request_error! {
+	#[doc(alias("AllocColorCellsError"))]
+	pub enum AllocateColorCellsError for AllocateColorCells {
+		Colormap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	// TODO: improve docs
+	/// A [request] that allocates a [colormap] entry for every color and plane
+	/// mask combination up to the given `color_count` and `plane_mask_count`.
+	///
+	/// By applying each plane mask to each color,
+	/// <code>color_count * 2<sup>plane_count</sup></code> distinct [colormap]
+	/// entries are allocated.
+	///
+	/// Each [colormap] entry is allocated as writable.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// A [`Value` error] is generated if `color_count` is not greater than
+	/// zero.
+	///
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	#[doc(alias("AllocColorCells"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AllocateColorCells: Request(
+		86,
+		AllocateColorCellsError,
+	) -> reply::AllocateColorCells {
+		/// Whether the plane masks should be combined (i.e. bitwise OR) to form
+		/// a contiguous set of bits for each color channel.
+		///
+		/// For [`VisualClass::GrayScale`] or [`VisualClass::PseudoColor`], one
+		/// contiguous set of bits are formed by bitwise OR-ing all of the plane
+		/// masks.
+		///
+		/// For [`VisualClass::DirectColor`], three (one for each color channel:
+		/// red, green, and blue) contiguous sets of bits are formed by bitwise
+		/// OR-ing all of the plane masks.
+		///
+		/// [`VisualClass::GrayScale`]: crate::visual::VisualClass::GrayScale
+		/// [`VisualClass::PseudoColor`]: crate::visual::VisualClass::PseudoColor
+		/// [`VisualClass::DirectColor`]: crate::visual::VisualClass::DirectColor
+		#[metabyte]
+		pub contiguous: bool,
+
+		/// The [colormap] for which a [colormap] entry for the color by the
+		/// given `name` is allocated.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		pub target: Colormap,
+
+		/// The number of colors that are to be allocated.
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this is not greater than zero.
+		///
+		/// [`Value` error]: error::Value
+		pub color_count: u16,
+		/// The number of bit plane masks that are to be allocated.
+		pub plane_count: u16,
+	}
+}

From ad68c6b312594b80c719e8851863f9b2e48f7a51 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 09:51:16 +0000
Subject: [PATCH 116/157] AllocateColorPlanes request + reply

---
 src/message.rs           |   2 +-
 src/x11/reply/color.rs   |  55 +++++++++++++++++++++
 src/x11/request/color.rs | 102 ++++++++++++++++++++++++++++++++++++++-
 3 files changed, 156 insertions(+), 3 deletions(-)

diff --git a/src/message.rs b/src/message.rs
index 2fc72988..e09a1efa 100644
--- a/src/message.rs
+++ b/src/message.rs
@@ -158,7 +158,7 @@ pub enum RequestError<OtherErrors> {
 	/// An X server may generate an [`Alloc`] event if it runs out of allocation
 	/// space to allocate a requested resource.
 	///
-	/// An X server running out of allocation space is undefined behavior, but
+	/// An X server running out of allocation space is unspecified behavior, but
 	/// it is nonetheless mentioned in the X11 protocol that a server may
 	/// generate an [`Alloc`] error for any [request] for this reason.
 	///
diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 5fd901fa..592af5fc 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -177,6 +177,9 @@ derive_xrb! {
 		/// sets to `1` (because there are three color channels: red, green, and
 		/// blue).
 		///
+		/// No plane mask will have bits in common with any other plane mask,
+		/// nor with any of the `colors`.
+		///
 		/// [colormap]: Colormap
 		///
 		/// [`VisualClass::GrayScale`]: crate::visual::VisualClass::GrayScale
@@ -185,4 +188,56 @@ derive_xrb! {
 		#[context(plane_masks_len => usize::from(*plane_masks_len))]
 		pub plane_masks: Vec<u32>,
 	}
+
+	/// The [reply] to an [`AllocateColorPlanes` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`AllocateColorPlanes` request]: request::AllocateColorPlanes
+	#[doc(alias("AllocColorPlanes"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct AllocateColorPlanes: Reply for request::AllocateColorPlanes {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `colors`.
+		#[allow(clippy::cast_possible_truncation)]
+		let colors_len: u16 = colors => colors.len() as u16,
+		[_; 2],
+
+		/// The union of all the red bit plane masks which were applied to the
+		/// `colors` to produce the [colormap] entries which were allocated.
+		///
+		/// [colormap]: Colormap
+		pub red_plane_mask: u32,
+		/// The union of all the green bit plane masks which were applied to the
+		/// `colors` to produce the [colormap] entries which were allocated.
+		///
+		/// [colormap]: Colormap
+		pub green_plane_mask: u32,
+		/// The union of all the blue bit plane masks which were applied to the
+		/// `colors` to produce the [colormap] entries which were allocated.
+		///
+		/// [colormap]: Colormap
+		pub blue_plane_mask: u32,
+		[_; 8],
+
+		/// The colors that were combined with the plane masks to produce the
+		/// [colormap] entries which were allocated.
+		///
+		/// [colormap]: Colormap
+		#[context(colors_len => usize::from(*colors_len))]
+		pub colors: Vec<ColorId>,
+	}
 }
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 3ee09c71..7c014a1c 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -579,6 +579,12 @@ derive_xrb! {
 	///
 	/// Each [colormap] entry is allocated as writable.
 	///
+	/// The initial RGB values of the allocated [colormap] entries are
+	/// undefined.
+	///
+	/// # Replies
+	/// This [request] generates an [`AllocateColorCells` reply].
+	///
 	/// # Errors
 	/// A [`Colormap` error] is generated if `target` does not refer to a
 	/// defined [colormap].
@@ -589,6 +595,8 @@ derive_xrb! {
 	/// [colormap]: Colormap
 	/// [request]: Request
 	///
+	/// [`AllocateColorCells` reply]: reply::AllocateColorCells
+	///
 	/// [`Colormap` error]: error::Colormap
 	/// [`Value` error]: error::Value
 	#[doc(alias("AllocColorCells"))]
@@ -614,8 +622,7 @@ derive_xrb! {
 		#[metabyte]
 		pub contiguous: bool,
 
-		/// The [colormap] for which a [colormap] entry for the color by the
-		/// given `name` is allocated.
+		/// The [colormap] for which the [colormap] entries are allocated.
 		///
 		/// # Errors
 		/// A [`Colormap` error] is generated if this does not refer to a
@@ -624,6 +631,7 @@ derive_xrb! {
 		/// [colormap]: Colormap
 		///
 		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
 		pub target: Colormap,
 
 		/// The number of colors that are to be allocated.
@@ -637,3 +645,93 @@ derive_xrb! {
 		pub plane_count: u16,
 	}
 }
+
+request_error! {
+	#[doc(alias("AllocColorPlanesError"))]
+	pub enum AllocateColorPlanesError for AllocateColorPlanes {
+		Colormap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	// TODO: improve docs
+	/// A [request] that allocates a [colormap] entry for every color and bit
+	/// plane combination up to the given `color_count` and plane counts.
+	///
+	/// By combining subsets of plane masks with colors, a total of
+	/// <code>color_count * 2<sup>plane_count</sup></code> (where `plane_count`
+	/// represents `red_plane_count + green_plane_count + blue_plane_count`)
+	/// [colormap] entries are allocated:
+	/// <code>color_count * 2<sup>red_plane_count</sup></code> independent red
+	/// entries, <code>color_count * 2<sup>green_plane_count</sup></code>
+	/// independent green entries, and
+	/// <code>color_count * 2<sup>blue_plane_count</sup></code> independent blue
+	/// entries.
+	///
+	/// Each [colormap] entry is allocated as writable.
+	///
+	/// The initial RGB values of the allocated [colormap] entries are
+	/// undefined.
+	///
+	/// # Replies
+	/// This [request] generates an [`AllocateColorPlanes` reply].
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// A [`Value` error] is generated if `color_count` is not greater than
+	/// zero.
+	///
+	/// An [`Alloc` error] is generated if the X server failed to allocate the
+	/// requested [colormap] entries; see [`RequestError::Alloc`].
+	///
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`AllocateColorPlanes` reply]: reply::AllocateColorPlanes
+	///
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	/// [`Alloc` error]: error::Alloc
+	///
+	/// [`RequestError::Alloc`]: crate::message::RequestError::Alloc
+	#[doc(alias("AllocColorPlanes"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct AllocateColorPlanes: Request(
+		87,
+		AllocateColorPlanesError,
+	) -> reply::AllocateColorPlanes {
+		/// Whether the returned plane masks will have a contiguous set of bits.
+		#[metabyte]
+		pub contiguous: bool,
+
+		/// The [colormap] for which the [colormap] entries are allocated.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+
+		/// The number of colors that will be returned.
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this is not greater than zero.
+		///
+		/// [`Value` error]: error::Value
+		pub color_count: u16,
+
+		/// The number of bits set in the returned `red_plane_mask`.
+		pub red_plane_count: u16,
+		/// The number of bits set in the returned `green_plane_mask`.
+		pub green_plane_count: u16,
+		/// The number of bits set in the returned `blue_plane_mask`.
+		pub blue_plane_count: u16,
+	}
+}

From 040caca2fe19dcfeefd363453e3da7eec3453b81 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 10:59:44 +0000
Subject: [PATCH 117/157] DestroyColormapEntries request

---
 src/x11/request/color.rs | 92 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 90 insertions(+), 2 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 7c014a1c..68b02b99 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -11,13 +11,14 @@
 
 extern crate self as xrb;
 
-use xrbk::pad;
+use xrbk::{pad, ConstantX11Size};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
-	visual::{RgbColor, VisualId},
+	visual::{ColorId, RgbColor, VisualId},
 	x11::{error, reply},
+	ColorChannelMask,
 	Colormap,
 	String8,
 	Window,
@@ -735,3 +736,90 @@ derive_xrb! {
 		pub blue_plane_count: u16,
 	}
 }
+
+request_error! {
+	#[doc(alias("FreeColorsError"))]
+	pub enum DestroyColormapEntriesError for DestroyColormapEntries {
+		Access,
+		Colormap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that deletes every requested [colormap] entry that was
+	/// allocated by your client in the given [colormap].
+	///
+	/// The [colormap] entries to be deleted are found by applying every subset
+	/// of the given `plane_mask` with each of the given `colors` - the entries
+	/// which were allocated by your client are deleted.
+	///
+	/// The requested [colormap] entries are only actually deleted under the
+	/// following conditions:
+	/// - If you have allocated a particular [colormap] entry multiple times,
+	///   you must send a `DestroyColormapEntries` [request] for each time you
+	///   allocated it before it is actually deleted.
+	/// - A read-only [colormap] entry is not actually deleted until all clients
+	///   have deleted it.
+	///
+	/// A particular [`ColorId`] allocated by an [`AllocateColorPlanes` request]
+	/// may not be reused until all of its related [`ColorId`s] have been
+	/// deleted too.
+	///
+	/// Even if an [error] is generated because of one of the requested
+	/// [colormap] entries, all other [colormap] entries which do not generate
+	/// [errors][error] will still be deleted.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// An [`Access` error] is generated if a requested [colormap] entry is not
+	/// actually allocated, or it is not allocated by your client.
+	///
+	/// A [`Value` error] is generated if a requested [`ColorId`] is not a valid
+	/// index into the `target` [colormap].
+	///
+	/// [colormap]: Colormap
+	/// [colors]: ColorId
+	/// [request]: Request
+	/// [error]: crate::message::Error
+	///
+	/// [`ColorId`s]: ColorId
+	///
+	/// [`AllocateColorPlanes` request]: AllocateColorPlanes
+	///
+	/// [`Access` error]: error::Access
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	// TODO: rename all Destroy* requests to Delete*
+	#[doc(alias("FreeColors"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct DestroyColormapEntries: Request(88, DestroyColormapEntriesError) {
+		/// The [colormap] for which the [colormap] entries are deleted.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+
+		/// The bit plane mask every subset of which is combined with each
+		/// [`ColorId`] in `colors` to produce the requested [colormap] entries.
+		///
+		/// [colormap]: Colormap
+		pub plane_mask: u32,
+		/// The [`ColorId`s] which are combined with every subset of the
+		/// `plane_mask` to produce the requested [colormap] entries.
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`ColorId`s]: ColorId
+		#[context(self::remaining => remaining / ColorId::X11_SIZE)]
+		pub colors: Vec<ColorId>,
+	}
+}

From f0cfabcb70d078fc1e20b577d701302ef0d38d93 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 31 Jan 2023 11:02:02 +0000
Subject: [PATCH 118/157] [CI901] applied recommended clippy fixes

---
 src/x11/request/color.rs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 68b02b99..82d532b0 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -18,7 +18,6 @@ use crate::{
 	message::Request,
 	visual::{ColorId, RgbColor, VisualId},
 	x11::{error, reply},
-	ColorChannelMask,
 	Colormap,
 	String8,
 	Window,

From 55f0dc79aa3ba4c410d96c83c810415781d144f0 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 11:16:24 +0000
Subject: [PATCH 119/157] ChangeColormapEntries request

---
 src/x11/request/color.rs | 96 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 95 insertions(+), 1 deletion(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 82d532b0..85cfbd26 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -12,12 +12,13 @@
 extern crate self as xrb;
 
 use xrbk::{pad, ConstantX11Size};
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
 	visual::{ColorId, RgbColor, VisualId},
 	x11::{error, reply},
+	ColorChannelMask,
 	Colormap,
 	String8,
 	Window,
@@ -822,3 +823,96 @@ derive_xrb! {
 		pub colors: Vec<ColorId>,
 	}
 }
+
+request_error! {
+	#[doc(alias("StoreColorsError"))]
+	pub enum ChangeColormapEntriesError for ChangeColormapEntries {
+		Access,
+		Colormap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A change to a [colormap] entry made in a
+	/// [`ChangeColormapEntries` request].
+	///
+	/// [colormap]: Colormap
+	///
+	/// [`ChangeColormapEntries` request]: ChangeColormapEntries
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ColormapEntryChange {
+		/// The [`ColorId`] of the changed [colormap] entry.
+		///
+		/// [colormap]: Colormap
+		pub id: ColorId,
+
+		/// The new color.
+		pub color: RgbColor,
+		/// A mask for which color channels are changed.
+		pub mask: ColorChannelMask,
+		_,
+	}
+
+	impl ConstantX11Size for ColormapEntryChange {
+		const X11_SIZE: usize = {
+			ColorId::X11_SIZE
+			+ RgbColor::X11_SIZE
+			+ ColorChannelMask::X11_SIZE
+			+ 1
+		};
+	}
+
+	/// A [request] that changes the [RGB values] of the given [colormap]
+	/// entries.
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// An [`Access` error] is generated if a requested [colormap] entry is
+	/// read-only or it is not allocated.
+	///
+	/// A [`Value` error] is generated if a requested [`ColorId`] is not a valid
+	/// index into the `target` [colormap].
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`Access` error]: error::Access
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	#[doc(alias("StoreColors"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeColormapEntries: Request(89, ChangeColormapEntriesError) {
+		/// The [colormap] for which the [colormap] entries are changed.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+
+		/// The requested [colormap] entry changes.
+		///
+		/// # Errors
+		/// An [`Access` error] is generated if a requested [colormap] entry is
+		/// read-only or it is not allocated.
+		///
+		/// A [`Value` error] is generated if a requested [`ColorId`] is not a
+		/// valid index into the `target` [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Access` error]: error::Access
+		/// [`Value` error]: error::Value
+		#[doc(alias("items"))]
+		#[context(self::remaining => remaining / ColormapEntryChange::X11_SIZE)]
+		pub changes: Vec<ColormapEntryChange>,
+	}
+}

From f569f6e35dba909bb2e11386d3bed9e7b30f5304 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 12:58:27 +0000
Subject: [PATCH 120/157] StoreNamedColor request

---
 src/x11/request/color.rs | 101 +++++++++++++++++++++++++++++++++++----
 1 file changed, 93 insertions(+), 8 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 85cfbd26..87f93aa2 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -825,8 +825,7 @@ derive_xrb! {
 }
 
 request_error! {
-	#[doc(alias("StoreColorsError"))]
-	pub enum ChangeColormapEntriesError for ChangeColormapEntries {
+	pub enum StoreColorsError for StoreColors {
 		Access,
 		Colormap,
 		Value,
@@ -834,12 +833,11 @@ request_error! {
 }
 
 derive_xrb! {
-	/// A change to a [colormap] entry made in a
-	/// [`ChangeColormapEntries` request].
+	/// A change to a [colormap] entry made in a [`StoreColors` request].
 	///
 	/// [colormap]: Colormap
 	///
-	/// [`ChangeColormapEntries` request]: ChangeColormapEntries
+	/// [`StoreColors` request]: StoreColors
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct ColormapEntryChange {
 		/// The [`ColorId`] of the changed [colormap] entry.
@@ -849,7 +847,10 @@ derive_xrb! {
 
 		/// The new color.
 		pub color: RgbColor,
-		/// A mask for which color channels are changed.
+		/// The mask for which of the [colormap] entry's color channels are
+		/// changed.
+		///
+		/// [colormap]: Colormap
 		pub mask: ColorChannelMask,
 		_,
 	}
@@ -866,6 +867,8 @@ derive_xrb! {
 	/// A [request] that changes the [RGB values] of the given [colormap]
 	/// entries.
 	///
+	/// See also: [`StoreNamedColor`].
+	///
 	/// # Errors
 	/// A [`Colormap` error] is generated if `target` does not refer to a
 	/// defined [colormap].
@@ -883,9 +886,8 @@ derive_xrb! {
 	/// [`Access` error]: error::Access
 	/// [`Colormap` error]: error::Colormap
 	/// [`Value` error]: error::Value
-	#[doc(alias("StoreColors"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ChangeColormapEntries: Request(89, ChangeColormapEntriesError) {
+	pub struct StoreColors: Request(89, StoreColorsError) {
 		/// The [colormap] for which the [colormap] entries are changed.
 		///
 		/// # Errors
@@ -916,3 +918,86 @@ derive_xrb! {
 		pub changes: Vec<ColormapEntryChange>,
 	}
 }
+
+request_error! {
+	pub enum StoreNamedColorError for StoreNamedColor {
+		Access,
+		Colormap,
+		Name,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the [RGB values] of the given [colormap] entry
+	/// to the color of the given `name` in the given [colormap]'s [screen].
+	///
+	/// See also: [`StoreColors`], [`ColormapEntryChange`].
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// A [`Name` error] is generated if `name` does not refer to a defined
+	/// color in the `target` [colormap]'s [screen].
+	///
+	/// An [`Access` error] is generated if the requested [colormap] entry is
+	/// read-only or it is not allocated.
+	///
+	/// A [`Value` error] is generated if the requested [`ColorId`] is not a
+	/// valid into into the `target` [colormap].
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`Access` error]: error::Access
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	/// [`Name` error]: error::Name
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct StoreNamedColor: Request(90, StoreNamedColorError) {
+		/// The mask for which of the [colormap] entry's color channels are
+		/// changed.
+		///
+		/// [colormap]: Colormap
+		pub mask: ColorChannelMask,
+
+		/// The [colormap] for which the [colormap] entry is changed.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+		/// The [`ColorId`] of the [colormap] entry which is to be changed.
+		///
+		/// [colormap]: Colormap
+		pub id: ColorId,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// The name of the color in the `target`'s [screen] which the requested
+		/// [colormap] entry is changed to.
+		///
+		/// # Errors
+		/// A [`Name` error] is generated if this does not refer to a defined
+		/// color in the `target` [colormap]'s [screen].
+		///
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
+		///
+		/// [`Name` error]: error::Name
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+}

From 3d9cd73ee3ff49269f75b7f815b6bed8d811f564 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 31 Jan 2023 13:00:26 +0000
Subject: [PATCH 121/157] [CI905] applied recommended clippy fixes

---
 src/x11/request/color.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 87f93aa2..624b9923 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -12,7 +12,7 @@
 extern crate self as xrb;
 
 use xrbk::{pad, ConstantX11Size};
-use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,

From ee48571813c432cbfb5b961c441103279c41326b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 13:40:11 +0000
Subject: [PATCH 122/157] QueryColors request + reply

---
 src/x11/reply/color.rs   | 95 ++++++++++++++++++++++++++++++++++++++++
 src/x11/request/color.rs | 63 +++++++++++++++++++++++++-
 2 files changed, 157 insertions(+), 1 deletion(-)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 592af5fc..020c932f 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -17,6 +17,7 @@
 extern crate self as xrb;
 
 use derivative::Derivative;
+use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
 
 use xrbk_macro::derive_xrb;
 
@@ -241,3 +242,97 @@ derive_xrb! {
 		pub colors: Vec<ColorId>,
 	}
 }
+
+/// The [reply] to a [`QueryColors` request].
+///
+/// [reply]: Reply
+///
+/// [`QueryColors` request]: request::QueryColors
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct QueryColors {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+
+	/// The [RGB values] of the requested [colormap] entries.
+	///
+	/// The [RGB values] returned for unallocated [colormap] entries is
+	/// undefined.
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	pub colors: Vec<RgbColor>,
+}
+
+impl Reply for QueryColors {
+	type Request = request::QueryColors;
+
+	fn sequence(&self) -> u16 {
+		self.sequence
+	}
+}
+
+impl X11Size for QueryColors {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 8;
+
+		HEADER + u16::X11_SIZE + 22 + self.colors.x11_size()
+	}
+}
+
+impl Readable for QueryColors {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self> {
+		buf.advance(1);
+		let sequence = buf.get_u16();
+
+		let length = (buf.get_u32() as usize) * 4;
+		let buf = &mut buf.take(length - 8);
+
+		let colors_len = buf.get_u16();
+		buf.advance(22);
+
+		let colors = {
+			let mut colors = vec![];
+
+			for _ in 0..colors_len {
+				colors.push(RgbColor::read_from(buf)?);
+				buf.advance(2);
+			}
+
+			colors
+		};
+
+		Ok(Self { sequence, colors })
+	}
+}
+
+impl Writable for QueryColors {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		let buf = &mut buf.limit((self.length() as usize) * 4);
+
+		buf.put_u8(1);
+		buf.put_u8(0);
+		self.sequence.write_to(buf)?;
+		buf.put_u32(self.length());
+
+		buf.put_u16(self.colors.len() as u16);
+		buf.put_bytes(0, 22);
+
+		for color in &self.colors {
+			color.write_to(buf)?;
+			buf.put_bytes(0, 2);
+		}
+
+		Ok(())
+	}
+}
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 624b9923..8e0b9209 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -472,7 +472,7 @@ derive_xrb! {
 	/// [colormap]: Colormap
 	/// [request]: Request
 	///
-	/// [`ColorId`]: crate::visual::ColorId
+	/// [`ColorId`]: ColorId
 	///
 	/// [`AllocateColor` reply]: reply::AllocateColor
 	///
@@ -1001,3 +1001,64 @@ derive_xrb! {
 		[_; name => pad(name)],
 	}
 }
+
+request_error! {
+	pub enum QueryColorsError for QueryColors {
+		Colormap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that returns the [RGB values] stored for the given
+	/// [colormap] entries in the given [colormap].
+	///
+	/// # Replies
+	/// This [request] generates a [`QueryColors` reply].
+	///
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	///
+	/// A [`Value` error] is generated if a given [`ColorId`] is not a valid
+	/// index into the `target` [colormap].
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	/// [request]: Request
+	///
+	/// [`QueryColors` reply]: reply::QueryColors
+	///
+	/// [`Colormap` error]: error::Colormap
+	/// [`Value` error]: error::Value
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryColors: Request(91, QueryColorsError) -> reply::QueryColors {
+		/// The [colormap] on which the [RGB values] of the given [colormap]
+		/// entries are queried.
+		///
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		///
+		/// [RGB values]: RgbColor
+		/// [colormap]: Colormap
+		///
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+
+		/// The [`ColorId`s] of the requested [colormap] entries.
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if a given [`ColorId`] is not a valid
+		/// index into the given `target` [colormap].
+		///
+		/// [colormap]: Colormap
+		///
+		/// [`ColorId`s]: ColorId
+		///
+		/// [`Value` error]: error::Value
+		#[context(self::remaining => remaining / ColorId::X11_SIZE)]
+		pub colors: Vec<ColorId>,
+	}
+}

From d5fc6337248059eed32dea967a5317861a7ecc77 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 14:38:37 +0000
Subject: [PATCH 123/157] GetNamedColor request + reply

---
 src/x11/reply/color.rs   | 36 ++++++++++++++++++++
 src/x11/request/color.rs | 71 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 107 insertions(+)

diff --git a/src/x11/reply/color.rs b/src/x11/reply/color.rs
index 020c932f..250e5dd5 100644
--- a/src/x11/reply/color.rs
+++ b/src/x11/reply/color.rs
@@ -336,3 +336,39 @@ impl Writable for QueryColors {
 		Ok(())
 	}
 }
+
+derive_xrb! {
+	/// The [reply] to a [`GetNamedColor` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetNamedColor` request]: request::GetNamedColor
+	#[doc(alias("LookupColor"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetNamedColor: Reply for request::GetNamedColor {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The ideal [RGB values] of the color.
+		///
+		/// [RGB values]: RgbColor
+		pub ideal_color: RgbColor,
+		/// The closest [RGB values] to the `ideal_color` that the display could
+		/// provide.
+		///
+		/// [RGB values]: RgbColor
+		pub actual_color: RgbColor,
+		[_; ..],
+	}
+}
diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index 8e0b9209..d7646efb 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -1062,3 +1062,74 @@ derive_xrb! {
 		pub colors: Vec<ColorId>,
 	}
 }
+
+request_error! {
+	#[doc(alias("LookupColorError"))]
+	pub enum GetNamedColorError for GetNamedColor {
+		Colormap,
+		Name,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that returns the [RGB values] for the color by the given
+	/// `name` in the given [colormap]'s [screen].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetNamedColor` reply].
+	/// 
+	/// # Errors
+	/// A [`Colormap` error] is generated if `target` does not refer to a
+	/// defined [colormap].
+	/// 
+	/// A [`Name` error] is generated if `name` does not refer to a defined
+	/// color for the given `target` [colormap]'s [screen].
+	///
+	/// [RGB values]: RgbColor
+	/// [colormap]: Colormap
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`GetNamedColor` reply]: reply::GetNamedColor
+	///
+	/// [`Colormap` error]: error::Colormap
+	/// [`Name` error]: error::Name
+	#[doc(alias("LookupColor"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetNamedColor: Request(92, GetNamedColorError) -> reply::GetNamedColor {
+		/// The [colormap] whose [screen] defines the requested color.
+		/// 
+		/// # Errors
+		/// A [`Colormap` error] is generated if this does not refer to a
+		/// defined [colormap].
+		/// 
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
+		/// 
+		/// [`Colormap` error]: error::Colormap
+		#[doc(alias("colormap"))]
+		pub target: Colormap,
+
+		// The length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 22],
+
+		/// The name of the color which this [request] gets the [RGB values] of.
+		/// 
+		/// This name should use ISO Latin-1 encoding. The case of the name is
+		/// ignored: whether it is uppercase or lowercase does not matter.
+		/// 
+		/// # Errors
+		/// A [`Name` error] is generated if this does not refer to a color
+		/// defined for the `target` [colormap]'s [screen].
+		/// 
+		/// [RGB values]: RgbColor
+		/// [colormap]: Colormap
+		/// [screen]: crate::visual::Screen
+		/// [request]: Request
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
+}

From 5d0f85b371d3e04d0f5b2a51fcac03661be266cb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 31 Jan 2023 14:40:45 +0000
Subject: [PATCH 124/157] [CI909] formatted code with rustfmt

---
 src/x11/request/color.rs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/x11/request/color.rs b/src/x11/request/color.rs
index d7646efb..a3bdf685 100644
--- a/src/x11/request/color.rs
+++ b/src/x11/request/color.rs
@@ -1077,11 +1077,11 @@ derive_xrb! {
 	///
 	/// # Replies
 	/// This [request] generates a [`GetNamedColor` reply].
-	/// 
+	///
 	/// # Errors
 	/// A [`Colormap` error] is generated if `target` does not refer to a
 	/// defined [colormap].
-	/// 
+	///
 	/// A [`Name` error] is generated if `name` does not refer to a defined
 	/// color for the given `target` [colormap]'s [screen].
 	///
@@ -1098,14 +1098,14 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetNamedColor: Request(92, GetNamedColorError) -> reply::GetNamedColor {
 		/// The [colormap] whose [screen] defines the requested color.
-		/// 
+		///
 		/// # Errors
 		/// A [`Colormap` error] is generated if this does not refer to a
 		/// defined [colormap].
-		/// 
+		///
 		/// [colormap]: Colormap
 		/// [screen]: crate::visual::Screen
-		/// 
+		///
 		/// [`Colormap` error]: error::Colormap
 		#[doc(alias("colormap"))]
 		pub target: Colormap,
@@ -1116,14 +1116,14 @@ derive_xrb! {
 		[_; 22],
 
 		/// The name of the color which this [request] gets the [RGB values] of.
-		/// 
+		///
 		/// This name should use ISO Latin-1 encoding. The case of the name is
 		/// ignored: whether it is uppercase or lowercase does not matter.
-		/// 
+		///
 		/// # Errors
 		/// A [`Name` error] is generated if this does not refer to a color
 		/// defined for the `target` [colormap]'s [screen].
-		/// 
+		///
 		/// [RGB values]: RgbColor
 		/// [colormap]: Colormap
 		/// [screen]: crate::visual::Screen

From c6f0a5b4df8e93d951fdb048a93c686cfd26851a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 15:57:36 +0000
Subject: [PATCH 125/157] CreateCursorAppearance request

---
 src/x11/request/graphics.rs        | 582 +-------------------
 src/x11/request/graphics/config.rs | 815 +++++++++++++++++++++++++++++
 2 files changed, 818 insertions(+), 579 deletions(-)
 create mode 100644 src/x11/request/graphics/config.rs

diff --git a/src/x11/request/graphics.rs b/src/x11/request/graphics.rs
index 5c010e5d..168309f3 100644
--- a/src/x11/request/graphics.rs
+++ b/src/x11/request/graphics.rs
@@ -10,6 +10,9 @@
 //! [Requests]: Request
 //! [core X11 protocol]: crate::x11
 
+mod config;
+pub use config::*;
+
 extern crate self as xrb;
 
 use thiserror::Error;
@@ -30,7 +33,6 @@ use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
-	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
 	x11::{error, reply},
 	Arc,
@@ -39,7 +41,6 @@ use crate::{
 	Drawable,
 	Font,
 	GraphicsContext,
-	Pixmap,
 	Rectangle,
 	String16,
 	String8,
@@ -77,583 +78,6 @@ macro_rules! request_error {
 	};
 }
 
-request_error! {
-	pub enum CreatePixmapError for CreatePixmap {
-		Drawable,
-		ResourceIdChoice,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that creates a new [pixmap] and assigns the provided
-	/// [`Pixmap` ID][pixmap] to it.
-	///
-	/// The initial contents of the [pixmap] are undefined.
-	///
-	/// # Errors
-	/// A [`Value` error] is generated if `depth` is not a depth supported by
-	/// the `drawable`'s root [window].
-	///
-	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
-	/// already used for another resource, or an ID not allocated to your
-	/// client.
-	///
-	/// A [`Drawable` error] is generated if `drawable` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// [window]: Window
-	/// [pixmap]: Pixmap
-	/// [request]: Request
-	///
-	/// [`Drawable` error]: error::Drawable
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	/// [`Value` error]: error::Value
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CreatePixmap: Request(53, CreatePixmapError) {
-		/// The depth of the [pixmap].
-		///
-		/// # Errors
-		/// A [`Value` error] is generated if this depth is not supported by the
-		/// root [window] of the `drawable`.
-		///
-		/// [pixmap]: Pixmap
-		/// [window]: Window
-		///
-		/// [`Value` error]: error::Value
-		#[metabyte]
-		pub depth: u8,
-
-		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
-		///
-		/// # Errors
-		/// A [`ResourceIdChoice` error] is generated if this resource ID is
-		/// already used or if it isn't allocated to your client.
-		///
-		/// [pixmap]: Pixmap
-		///
-		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-		#[doc(alias = "pid")]
-		pub pixmap_id: Pixmap,
-		// TODO: what is this for??
-		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
-		/// [request].
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		/// [drawable]: Drawable
-		/// [request]: Request
-		///
-		/// [`InputOnly`]: crate::WindowClass::InputOnly
-		///
-		/// [`Drawable` error]: error::Drawable
-		pub drawable: Drawable,
-
-		/// The width of the [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		pub width: Px<u16>,
-		/// The height of the [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		pub height: Px<u16>,
-	}
-
-	/// A [request] that removes the association between a given
-	/// [`Pixmap` ID][pixmap] and the [pixmap] it is associated with.
-	///
-	/// The stored [pixmap] will be freed when it is no longer referenced by any
-	/// other resource.
-	///
-	/// # Errors
-	/// A [`Pixmap` error] is generated if `target` does not refer to a defined
-	/// [pixmap].
-	///
-	/// [pixmap]: Pixmap
-	/// [request]: Request
-	///
-	/// [`Pixmap` error]: error::Pixmap
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct FreePixmap: Request(54, error::Pixmap) {
-		/// The [pixmap] which is to have its association with its ID removed.
-		///
-		/// # Errors
-		/// A [`Pixmap` error] is generated if this does not refer to a defined
-		/// [pixmap].
-		///
-		/// [pixmap]: Pixmap
-		///
-		/// [`Pixmap` error]: error::Pixmap
-		#[doc(alias = "pixmap")]
-		pub target: Pixmap,
-	}
-}
-
-request_error! {
-	pub enum CreateGraphicsContextError for GraphicsContext {
-		Drawable,
-		Font,
-		ResourceIdChoice,
-		Match,
-		Pixmap,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that creates a new [`GraphicsContext`] and assigns the
-	/// provided [`GraphicsContext` ID] to it.
-	///
-	/// # Errors
-	/// A [`ResourceIdChoice` error] is generated if `graphics_context_id`
-	/// specifies an ID already used for another resource, or an ID which is not
-	/// allocated to your client.
-	///
-	/// A [`Drawable` error] is generated if `drawable` does not refer to a
-	/// defined [window] nor [pixmap].
-	///
-	/// [pixmap]: Pixmap
-	/// [window]: Window
-	/// [request]: Request
-	///
-	/// [`GraphicsContext` ID]: GraphicsContext
-	///
-	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-	/// [`Drawable` error]: error::Drawable
-	#[doc(alias("CreateGc", "CreateGC", "CreateGcontext", "CreateGContext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
-		/// The [`GraphicsContext` ID] which is to be assigned to the
-		/// [`GraphicsContext`].
-		///
-		/// # Errors
-		/// A [`ResourceIdChoice` error] is generated if this resource ID is
-		/// already used or if it isn't allocated to your client.
-		///
-		/// [`GraphicsContext` ID]: GraphicsContext
-		///
-		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
-		#[doc(alias("cid", "gid", "gcid", "context_id"))]
-		pub graphics_context_id: GraphicsContext,
-
-		/// > *<sup>TODO</sup>*\
-		/// > ***We don't yet understand what this field is for. If you have any
-		/// > ideas, please feel free to open an issue or a discussion on the
-		/// > [GitHub repo]!***
-		/// >
-		/// > [GitHub repo]: https://github.com/XdotRS/xrb/
-		///
-		/// # Errors
-		/// A [`Drawable` error] is generated if this does not refer to a
-		/// defined [window] nor [pixmap].
-		///
-		/// [drawable]: Drawable
-		/// [window]: Window
-		/// [pixmap]: Pixmap
-		///
-		/// [`Drawable` error]: error::Drawable
-		pub drawable: Drawable,
-
-		/// The [graphics options] used in graphics operations when this
-		/// [`GraphicsContext`] is provided.
-		///
-		/// These [graphics options] may be later configured through the
-		/// [`SetDashes` request], [`SetClipRectangles` request], and the
-		/// [`ChangeGraphicsOptions` request].
-		///
-		/// [graphics options]: GraphicsOptions
-		///
-		/// [`SetDashes` request]: SetDashes
-		/// [`SetClipRectangles` request]: SetClipRectangles
-		/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
-		#[doc(alias("values", "value_mask", "value_list"))]
-		#[doc(alias("options", "option_mask", "option_list"))]
-		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
-		pub graphics_options: GraphicsOptions,
-	}
-}
-
-request_error! {
-	pub enum ChangeGraphicsOptionsError for ChangeGraphicsOptions {
-		Font,
-		GraphicsContext,
-		Match,
-		Pixmap,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that changes the [graphics options] configured in a
-	/// [`GraphicsContext`].
-	///
-	/// Changing the [`clip_mask`] overrides any [`SetClipRectangles` request]
-	/// on the [`GraphicsContext`].
-	///
-	/// Changing [`dash_offset`] or [`dashes`] overrides any
-	/// [`SetDashes` request] on the [`GraphicsContext`].
-	///
-	/// The [`SetDashes` request] allows an alternating pattern of dashes to be
-	/// configured, while configuring [`dashes`] with this [request] does not.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: Request
-	///
-	/// [graphics options]: GraphicsOptions
-	///
-	/// [`clip_mask`]: GraphicsOptions::clip_mask
-	/// [`dashes`]: GraphicsOptions::dashes
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	/// [`SetDashes` request]: SetDashes
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("ChangeGc", "ChangeGC", "ChangeGraphicsContext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct ChangeGraphicsOptions: Request(56, ChangeGraphicsOptionsError) {
-		/// The [`GraphicsContext`] for which this [request] changes its
-		/// [graphics options].
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [graphics options]: GraphicsOptions
-		/// [request]: Request
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "graphics_context", "context"))]
-		pub target: GraphicsContext,
-
-		/// The changes which are made to the `target`'s [graphics options].
-		///
-		/// [graphics options]: GraphicsOptions
-		#[doc(alias("values", "value_mask", "value_list"))]
-		#[doc(alias("options", "option_mask", "option_list"))]
-		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
-		pub changed_options: GraphicsOptions,
-	}
-}
-
-request_error! {
-	pub enum CopyGraphicsOptionsError for CopyGraphicsOptions {
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that copies the specified [graphics options] from the
-	/// `source` [`GraphicsContext`] into the `destination` [`GraphicsContext`].
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if either the `source` or the
-	/// `destination` do not refer to defined [`GraphicsContext`s].
-	///
-	/// A [`Match` error] is generated if the `source` and the `destination` do
-	/// not have the same root [window] and depth.
-	///
-	/// [graphics options]: GraphicsOptions
-	/// [window]: Window
-	/// [request]: Request
-	///
-	/// [`GraphicsContext`s]: GraphicsContext
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	/// [`Match` error]: error::Match
-	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
-		/// The [`GraphicsContext`] from which the [options] specified in
-		/// `options_mask` are copied.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `destination`.
-		///
-		/// [options]: GraphicsOptions
-		/// [window]: Window
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		/// [`Match` error]: error::Match
-		#[doc(alias("src_gc", "source_graphics_context", "src"))]
-		pub source: GraphicsContext,
-		/// The [`GraphicsContext`] into which the [options] specified in
-		/// `options_mask` are copied from the `source`.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// A [`Match` error] is generated if this does not have the same root
-		/// [window] and depth as the `source`.
-		///
-		/// [options]: GraphicsOptions
-		/// [window]: Window
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		/// [`Match` error]: error::Match
-		#[doc(alias("dst_gc", "destination_graphics_context", "dst"))]
-		pub destination: GraphicsContext,
-
-		/// A mask that specifies which options are copied from the `source`
-		/// into the `destination`.
-		#[doc(alias("value_mask"))]
-		pub options_mask: GraphicsOptionsMask,
-	}
-}
-
-request_error! {
-	pub enum SetDashesError for SetDashes {
-		GraphicsContext,
-		Value,
-	}
-}
-
-derive_xrb! {
-	/// A [request] that sets the [`dash_offset`] and the pattern of dashes on a
-	/// [`GraphicsContext`].
-	///
-	/// Configuring [`dashes`] or [`dash_offset`] with a
-	/// [`ChangeGraphicsOptions` request] overrides the effects of this
-	/// [request].
-	///
-	/// Configuring [`dashes`] with a [`ChangeGraphicsOptions` request] does not
-	/// allow an alternating pattern of dashes to be specified; this [request]
-	/// does.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: Request
-	///
-	/// [`dashes`]: GraphicsOptions::dashes
-	/// [`dash_offset`]: GraphicsOptions::dash_offset
-	///
-	/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetDashes: Request(58, SetDashesError) {
-		/// The [`GraphicsContext`] on which this [request] configures its
-		/// dashes.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [request]: Request
-		pub target: GraphicsContext,
-
-		/// The offset from the endpoints or joinpoints of a dashed line before
-		/// the dashes are drawn.
-		pub dash_offset: Px<u16>,
-
-		// The length of `dashes`.
-		#[allow(clippy::cast_possible_truncation)]
-		let dashes_len: u16 = dashes => dashes.len() as u16,
-		/// The pattern of dashes used when drawing dashed lines.
-		///
-		/// Each element represents the length of a dash in the pattern,
-		/// measured in pixels. A `dashes` list of odd length is appended to
-		/// itself to produce a list of even length.
-		#[context(dashes_len => usize::from(*dashes_len))]
-		pub dashes: Vec<Px<u8>>,
-		[_; dashes => pad(dashes)],
-	}
-}
-
-request_error! {
-	pub enum SetClipRectanglesError for SetClipRectangles {
-		GraphicsContext,
-		Match,
-		Value,
-	}
-}
-
-/// Specifies the ordering of [rectangles] given by `clip_rectangles` in a
-/// [`SetClipRectangles` request].
-///
-/// [rectangles]: Rectangle
-///
-/// [`SetClipRectangles` request]: SetClipRectangles
-#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-pub enum ClipRectanglesOrdering {
-	/// No particular order is specified.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are given in no particular order.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	Unsorted,
-
-	/// [Rectangles][rectangles] are ordered by their y coordinate.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high.
-	///
-	/// The ordering among [rectangles] with equal y coordinates is not
-	/// specified.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	SortedByY,
-
-	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
-	/// and secondarily by their x coordinate.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high, and those of equal y are sorted by their x coordinate from low
-	/// to high.
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	SortedByYx,
-
-	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
-	/// secondarily by their x coordinate, and each one which intersects a given
-	/// y coordinate has an equal y coordinate and height.
-	///
-	/// The [rectangles] given by `clip_rectangles` in a
-	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
-	/// to high, those of equal y are sorted by their x coordinate from low to
-	/// high, and every [rectangle][rectangles] which intersects a given y
-	/// coordinate is guaranteed to have the same y coordinate and height as
-	/// every other intersecting [rectangle][rectangles].
-	///
-	/// [rectangles]: Rectangle
-	///
-	/// [`SetClipRectangles` request]: SetClipRectangles
-	BandedByYx,
-}
-
-derive_xrb! {
-	/// A [request] that configures the clip mask of a [`GraphicsContext`] using
-	/// a list of [rectangles].
-	///
-	/// This [request] also sets the [`clip_x`] and [`clip_y`] of the clip mask.
-	/// The coordinates used in the [rectangles] are relative to the [`clip_x`]
-	/// and [`clip_y`].
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [rectangles]: Rectangle
-	/// [request]: Request
-	///
-	/// [`clip_x`]: GraphicsOptions::clip_x
-	/// [`clip_y`]: GraphicsOptions::clip_y
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
-	pub struct SetClipRectangles: Request(59, SetClipRectanglesError) {
-		/// Specifies the ordering of [rectangles] within `clip_rectangles`.
-		///
-		/// See [`ClipRectanglesOrdering`] for more information.
-		///
-		/// [rectangles]: Rectangle
-		#[metabyte]
-		pub ordering: ClipRectanglesOrdering,
-
-		/// The [`GraphicsContext`] on which this [request] configures its clip
-		/// mask.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [request]: Request
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		pub target: GraphicsContext,
-
-		/// The x coordinate of the top-left corner of the clip mask.
-		///
-		/// This is relative to the top-left corner of the destination
-		/// [drawable] used in a particular graphics operation.
-		///
-		/// The coordinates used in the [rectangles] in `clip_rectangles` are
-		/// relative to this x coordinate.
-		///
-		/// [drawable]: Drawable
-		/// [rectangles]: Rectangle
-		pub clip_x: Px<i16>,
-		/// The y coordinate of the top-left corner of the clip mask.
-		///
-		/// This is relative to the top-left corner of the destination
-		/// [drawable] used in a particular graphics operation.
-		///
-		/// The coordinates used in the [rectangles] in `clip_rectangles` are
-		/// relative to this y coordinate.
-		///
-		/// [drawable]: Drawable
-		/// [rectangles]: Rectangle
-		pub clip_y: Px<i16>,
-
-		/// A list of non-overlapping [rectangles] that are used to mask the
-		/// effects of a graphics operation.
-		///
-		/// These [rectangles] specify the areas within which the effects of a
-		/// graphics operation are applied.
-		///
-		/// If this list is empty, graphics operations will have no graphical
-		/// effect.
-		///
-		/// [rectangles]: Rectangle
-		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
-		pub clip_rectangles: Vec<Rectangle>,
-	}
-
-	/// A [request] that deletes the given [`GraphicsContext`].
-	///
-	/// The association between the [`GraphicsContext` ID] and the
-	/// [`GraphicsContext`] itself is removed in the process.
-	///
-	/// # Errors
-	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
-	/// defined [`GraphicsContext`].
-	///
-	/// [request]: Request
-	///
-	/// [`GraphicsContext` ID]: GraphicsContext
-	///
-	/// [`GraphicsContext` error]: error::GraphicsContext
-	#[doc(alias("FreeGc", "FreeGcontext", "FreeGraphicsContext"))]
-	#[doc(alias("DestroyGc", "DestroyGcontext"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
-		/// The [`GraphicsContext`] which is to be deleted.
-		///
-		/// # Errors
-		/// A [`GraphicsContext` error] is generated if this does not refer to a
-		/// defined [`GraphicsContext`].
-		///
-		/// [`GraphicsContext` error]: error::GraphicsContext
-		#[doc(alias("gc", "graphics_context", "context", "gcontext"))]
-		pub target: GraphicsContext,
-	}
-}
-
 request_error! {
 	pub enum ClearAreaError for ClearArea {
 		Match,
diff --git a/src/x11/request/graphics/config.rs b/src/x11/request/graphics/config.rs
new file mode 100644
index 00000000..73a47202
--- /dev/null
+++ b/src/x11/request/graphics/config.rs
@@ -0,0 +1,815 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+//! [Requests] defined in the [core X11 protocol] that relate to the
+//! configuration and creation of graphics-related types.
+//!
+//! [Requests] are messages sent from an X client to the X server.
+//!
+//! [Requests]: Request
+//! [core X11 protocol]: crate::x11
+
+extern crate self as xrb;
+
+use xrbk::{pad, ConstantX11Size};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+
+use crate::{
+	message::Request,
+	set::{GraphicsOptions, GraphicsOptionsMask},
+	unit::Px,
+	visual::RgbColor,
+	x11::error,
+	CursorAppearance,
+	Drawable,
+	GraphicsContext,
+	Pixmap,
+	Rectangle,
+};
+
+macro_rules! request_error {
+	(
+		$(#[$meta:meta])*
+		$vis:vis enum $Name:ident for $Request:ty {
+			$($($Error:ident),+$(,)?)?
+		}
+	) => {
+		#[doc = concat!(
+			"An [error](crate::message::Error) generated because of a failed [`",
+			stringify!($Request),
+			"` request](",
+			stringify!($Request),
+			")."
+		)]
+		#[doc = ""]
+		$(#[$meta])*
+		$vis enum $Name {
+			$($(
+				#[doc = concat!(
+					"A [`",
+					stringify!($Error),
+					"` error](error::",
+					stringify!($Error),
+					")."
+				)]
+				$Error(error::$Error)
+			),+)?
+		}
+	};
+}
+
+request_error! {
+	pub enum CreatePixmapError for CreatePixmap {
+		Drawable,
+		ResourceIdChoice,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [pixmap] and assigns the provided
+	/// [`Pixmap` ID][pixmap] to it.
+	///
+	/// The initial contents of the [pixmap] are undefined.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if `depth` is not a depth supported by
+	/// the `drawable`'s root [window].
+	///
+	/// A [`ResourceIdChoice` error] is generated if `pixmap_id` specifies an ID
+	/// already used for another resource, or an ID not allocated to your
+	/// client.
+	///
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [window]: Window
+	/// [pixmap]: Pixmap
+	/// [request]: Request
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Value` error]: error::Value
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CreatePixmap: Request(53, CreatePixmapError) {
+		/// The depth of the [pixmap].
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this depth is not supported by the
+		/// root [window] of the `drawable`.
+		///
+		/// [pixmap]: Pixmap
+		/// [window]: Window
+		///
+		/// [`Value` error]: error::Value
+		#[metabyte]
+		pub depth: u8,
+
+		/// The [`Pixmap` ID][pixmap] which is to be assigned to the [pixmap].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias = "pid")]
+		pub pixmap_id: Pixmap,
+		// TODO: what is this for??
+		/// It is legal to use an [`InputOnly`] [window] as a [drawable] in this
+		/// [request].
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		/// [drawable]: Drawable
+		/// [request]: Request
+		///
+		/// [`InputOnly`]: crate::WindowClass::InputOnly
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub drawable: Drawable,
+
+		/// The width of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub width: Px<u16>,
+		/// The height of the [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		pub height: Px<u16>,
+	}
+
+	/// A [request] that removes the association between a given
+	/// [`Pixmap` ID][pixmap] and the [pixmap] it is associated with.
+	///
+	/// The stored [pixmap] will be freed when it is no longer referenced by any
+	/// other resource.
+	///
+	/// # Errors
+	/// A [`Pixmap` error] is generated if `target` does not refer to a defined
+	/// [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [request]: Request
+	///
+	/// [`Pixmap` error]: error::Pixmap
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct FreePixmap: Request(54, error::Pixmap) {
+		/// The [pixmap] which is to have its association with its ID removed.
+		///
+		/// # Errors
+		/// A [`Pixmap` error] is generated if this does not refer to a defined
+		/// [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Pixmap` error]: error::Pixmap
+		#[doc(alias = "pixmap")]
+		pub target: Pixmap,
+	}
+}
+
+request_error! {
+	pub enum CreateGraphicsContextError for CreateGraphicsContext {
+		Drawable,
+		Font,
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [`GraphicsContext`] and assigns the
+	/// provided [`GraphicsContext` ID] to it.
+	///
+	/// # Errors
+	/// A [`ResourceIdChoice` error] is generated if `graphics_context_id`
+	/// specifies an ID already used for another resource, or an ID which is not
+	/// allocated to your client.
+	///
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [window]: Window
+	/// [request]: Request
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Drawable` error]: error::Drawable
+	#[doc(alias("CreateGc", "CreateGC", "CreateGcontext", "CreateGContext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct CreateGraphicsContext: Request(55, CreateGraphicsContextError) {
+		/// The [`GraphicsContext` ID] which is to be assigned to the
+		/// [`GraphicsContext`].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [`GraphicsContext` ID]: GraphicsContext
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias("cid", "gid", "gcid", "context_id"))]
+		pub graphics_context_id: GraphicsContext,
+
+		/// > *<sup>TODO</sup>*\
+		/// > ***We don't yet understand what this field is for. If you have any
+		/// > ideas, please feel free to open an issue or a discussion on the
+		/// > [GitHub repo]!***
+		/// >
+		/// > [GitHub repo]: https://github.com/XdotRS/xrb/
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// [drawable]: Drawable
+		/// [window]: Window
+		/// [pixmap]: Pixmap
+		///
+		/// [`Drawable` error]: error::Drawable
+		pub drawable: Drawable,
+
+		/// The [graphics options] used in graphics operations when this
+		/// [`GraphicsContext`] is provided.
+		///
+		/// These [graphics options] may be later configured through the
+		/// [`SetDashes` request], [`SetClipRectangles` request], and the
+		/// [`ChangeGraphicsOptions` request].
+		///
+		/// [graphics options]: GraphicsOptions
+		///
+		/// [`SetDashes` request]: SetDashes
+		/// [`SetClipRectangles` request]: SetClipRectangles
+		/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
+		pub graphics_options: GraphicsOptions,
+	}
+}
+
+request_error! {
+	pub enum ChangeGraphicsOptionsError for ChangeGraphicsOptions {
+		Font,
+		GraphicsContext,
+		Match,
+		Pixmap,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the [graphics options] configured in a
+	/// [`GraphicsContext`].
+	///
+	/// Changing the [`clip_mask`] overrides any [`SetClipRectangles` request]
+	/// on the [`GraphicsContext`].
+	///
+	/// Changing [`dash_offset`] or [`dashes`] overrides any
+	/// [`SetDashes` request] on the [`GraphicsContext`].
+	///
+	/// The [`SetDashes` request] allows an alternating pattern of dashes to be
+	/// configured, while configuring [`dashes`] with this [request] does not.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: Request
+	///
+	/// [graphics options]: GraphicsOptions
+	///
+	/// [`clip_mask`]: GraphicsOptions::clip_mask
+	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	/// [`SetDashes` request]: SetDashes
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("ChangeGc", "ChangeGC", "ChangeGraphicsContext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeGraphicsOptions: Request(56, ChangeGraphicsOptionsError) {
+		/// The [`GraphicsContext`] for which this [request] changes its
+		/// [graphics options].
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [graphics options]: GraphicsOptions
+		/// [request]: Request
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context"))]
+		pub target: GraphicsContext,
+
+		/// The changes which are made to the `target`'s [graphics options].
+		///
+		/// [graphics options]: GraphicsOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("graphics_option_mask", "graphics_option_list"))]
+		pub changed_options: GraphicsOptions,
+	}
+}
+
+request_error! {
+	pub enum CopyGraphicsOptionsError for CopyGraphicsOptions {
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that copies the specified [graphics options] from the
+	/// `source` [`GraphicsContext`] into the `destination` [`GraphicsContext`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if either the `source` or the
+	/// `destination` do not refer to defined [`GraphicsContext`s].
+	///
+	/// A [`Match` error] is generated if the `source` and the `destination` do
+	/// not have the same root [window] and depth.
+	///
+	/// [graphics options]: GraphicsOptions
+	/// [window]: Window
+	/// [request]: Request
+	///
+	/// [`GraphicsContext`s]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	/// [`Match` error]: error::Match
+	#[doc(alias("CopyGc", "CopyGC", "CopyGraphicsContext", "CopyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CopyGraphicsOptions: Request(57, CopyGraphicsOptionsError) {
+		/// The [`GraphicsContext`] from which the [options] specified in
+		/// `options_mask` are copied.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `destination`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("src_gc", "source_graphics_context", "src"))]
+		pub source: GraphicsContext,
+		/// The [`GraphicsContext`] into which the [options] specified in
+		/// `options_mask` are copied from the `source`.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// A [`Match` error] is generated if this does not have the same root
+		/// [window] and depth as the `source`.
+		///
+		/// [options]: GraphicsOptions
+		/// [window]: Window
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		/// [`Match` error]: error::Match
+		#[doc(alias("dst_gc", "destination_graphics_context", "dst"))]
+		pub destination: GraphicsContext,
+
+		/// A mask that specifies which options are copied from the `source`
+		/// into the `destination`.
+		#[doc(alias("value_mask"))]
+		pub options_mask: GraphicsOptionsMask,
+	}
+}
+
+request_error! {
+	pub enum SetDashesError for SetDashes {
+		GraphicsContext,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that sets the [`dash_offset`] and the pattern of dashes on a
+	/// [`GraphicsContext`].
+	///
+	/// Configuring [`dashes`] or [`dash_offset`] with a
+	/// [`ChangeGraphicsOptions` request] overrides the effects of this
+	/// [request].
+	///
+	/// Configuring [`dashes`] with a [`ChangeGraphicsOptions` request] does not
+	/// allow an alternating pattern of dashes to be specified; this [request]
+	/// does.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: Request
+	///
+	/// [`dashes`]: GraphicsOptions::dashes
+	/// [`dash_offset`]: GraphicsOptions::dash_offset
+	///
+	/// [`ChangeGraphicsOptions` request]: ChangeGraphicsOptions
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetDashes: Request(58, SetDashesError) {
+		/// The [`GraphicsContext`] on which this [request] configures its
+		/// dashes.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [request]: Request
+		pub target: GraphicsContext,
+
+		/// The offset from the endpoints or joinpoints of a dashed line before
+		/// the dashes are drawn.
+		pub dash_offset: Px<u16>,
+
+		// The length of `dashes`.
+		#[allow(clippy::cast_possible_truncation)]
+		let dashes_len: u16 = dashes => dashes.len() as u16,
+		/// The pattern of dashes used when drawing dashed lines.
+		///
+		/// Each element represents the length of a dash in the pattern,
+		/// measured in pixels. A `dashes` list of odd length is appended to
+		/// itself to produce a list of even length.
+		#[context(dashes_len => usize::from(*dashes_len))]
+		pub dashes: Vec<Px<u8>>,
+		[_; dashes => pad(dashes)],
+	}
+}
+
+request_error! {
+	pub enum SetClipRectanglesError for SetClipRectangles {
+		GraphicsContext,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies the ordering of [rectangles] given by `clip_rectangles` in a
+/// [`SetClipRectangles` request].
+///
+/// [rectangles]: Rectangle
+///
+/// [`SetClipRectangles` request]: SetClipRectangles
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ClipRectanglesOrdering {
+	/// No particular order is specified.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are given in no particular order.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	Unsorted,
+
+	/// [Rectangles][rectangles] are ordered by their y coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high.
+	///
+	/// The ordering among [rectangles] with equal y coordinates is not
+	/// specified.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByY,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// and secondarily by their x coordinate.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, and those of equal y are sorted by their x coordinate from low
+	/// to high.
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	SortedByYx,
+
+	/// [Rectangles][rectangles] are ordered primarily by their y coordinate,
+	/// secondarily by their x coordinate, and each one which intersects a given
+	/// y coordinate has an equal y coordinate and height.
+	///
+	/// The [rectangles] given by `clip_rectangles` in a
+	/// [`SetClipRectangles` request] are sorted by their y coordinate from low
+	/// to high, those of equal y are sorted by their x coordinate from low to
+	/// high, and every [rectangle][rectangles] which intersects a given y
+	/// coordinate is guaranteed to have the same y coordinate and height as
+	/// every other intersecting [rectangle][rectangles].
+	///
+	/// [rectangles]: Rectangle
+	///
+	/// [`SetClipRectangles` request]: SetClipRectangles
+	BandedByYx,
+}
+
+derive_xrb! {
+	/// A [request] that configures the clip mask of a [`GraphicsContext`] using
+	/// a list of [rectangles].
+	///
+	/// This [request] also sets the [`clip_x`] and [`clip_y`] of the clip mask.
+	/// The coordinates used in the [rectangles] are relative to the [`clip_x`]
+	/// and [`clip_y`].
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [rectangles]: Rectangle
+	/// [request]: Request
+	///
+	/// [`clip_x`]: GraphicsOptions::clip_x
+	/// [`clip_y`]: GraphicsOptions::clip_y
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetClipRectangles: Request(59, SetClipRectanglesError) {
+		/// Specifies the ordering of [rectangles] within `clip_rectangles`.
+		///
+		/// See [`ClipRectanglesOrdering`] for more information.
+		///
+		/// [rectangles]: Rectangle
+		#[metabyte]
+		pub ordering: ClipRectanglesOrdering,
+
+		/// The [`GraphicsContext`] on which this [request] configures its clip
+		/// mask.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [request]: Request
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		pub target: GraphicsContext,
+
+		/// The x coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this x coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_x: Px<i16>,
+		/// The y coordinate of the top-left corner of the clip mask.
+		///
+		/// This is relative to the top-left corner of the destination
+		/// [drawable] used in a particular graphics operation.
+		///
+		/// The coordinates used in the [rectangles] in `clip_rectangles` are
+		/// relative to this y coordinate.
+		///
+		/// [drawable]: Drawable
+		/// [rectangles]: Rectangle
+		pub clip_y: Px<i16>,
+
+		/// A list of non-overlapping [rectangles] that are used to mask the
+		/// effects of a graphics operation.
+		///
+		/// These [rectangles] specify the areas within which the effects of a
+		/// graphics operation are applied.
+		///
+		/// If this list is empty, graphics operations will have no graphical
+		/// effect.
+		///
+		/// [rectangles]: Rectangle
+		#[context(self::remaining => remaining / Rectangle::X11_SIZE)]
+		pub clip_rectangles: Vec<Rectangle>,
+	}
+
+	/// A [request] that deletes the given [`GraphicsContext`].
+	///
+	/// The association between the [`GraphicsContext` ID] and the
+	/// [`GraphicsContext`] itself is removed in the process.
+	///
+	/// # Errors
+	/// A [`GraphicsContext` error] is generated if `target` does not refer to a
+	/// defined [`GraphicsContext`].
+	///
+	/// [request]: Request
+	///
+	/// [`GraphicsContext` ID]: GraphicsContext
+	///
+	/// [`GraphicsContext` error]: error::GraphicsContext
+	#[doc(alias("FreeGc", "FreeGcontext", "FreeGraphicsContext"))]
+	#[doc(alias("DestroyGc", "DestroyGcontext"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DestroyGraphicsContext: Request(60, error::GraphicsContext) {
+		/// The [`GraphicsContext`] which is to be deleted.
+		///
+		/// # Errors
+		/// A [`GraphicsContext` error] is generated if this does not refer to a
+		/// defined [`GraphicsContext`].
+		///
+		/// [`GraphicsContext` error]: error::GraphicsContext
+		#[doc(alias("gc", "graphics_context", "context", "gcontext"))]
+		pub target: GraphicsContext,
+	}
+}
+
+request_error! {
+	#[doc(alias("CreateCursorError"))]
+	pub enum CreateCursorAppearanceError for CreateCursorAppearance {
+		ResourceIdChoice,
+		Match,
+		Pixmap,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [`CursorAppearance`].
+	///
+	/// The given `cursor_appearance_id` is assigned to the
+	/// [`CursorAppearance`] that is created.
+	///
+	/// The options provided in this [request] may be arbitrarily transformed by
+	/// the X server to meet display limitations.
+	///
+	/// The effect of changes to the `source` or `mask` [pixmaps][pixmap] made
+	/// after the creation of this [`CursorAppearance`] have an undefined
+	/// effect: the X server may or may not create a copy of the provided
+	/// [pixmaps][pixmap].
+	///
+	/// # Errors
+	/// An [`Alloc` error] is generated if the X server failed to allocate the
+	/// [`CursorAppearance`].
+	///
+	/// A [`ResourceIdChoice` error] is generated if `cursor_appearance_id`
+	/// specifies an ID already used for another resource, or an ID not
+	/// allocated to your client.
+	///
+	/// A [`Match` error] is generated if `source`'s depth is not `1`.
+	///
+	/// A [`Match` error] is generated if `mask` is [`Some`] and `mask`'s depth
+	/// is not `1`.
+	///
+	/// A [`Match` error] is generated if `mask` is [`Some`] and `mask` is not
+	/// the same size as `source`.
+	///
+	/// A [`Match` error] is generated if `hotspot_x` is not contained within
+	/// the `source` [pixmap].
+	///
+	/// A [`Match` error] is generated if `hotspot_y` is not contained within
+	/// the `source` [pixmap].
+	///
+	/// A [`Pixmap` error] is generated if `source` does not refer to a defined
+	/// [pixmap].
+	///
+	/// A [`Pixmap` error] is generated if `mask` is [`Some`] and does not refer
+	/// to a defined [pixmap].
+	///
+	/// [pixmap]: Pixmap
+	/// [request]: Request
+	///
+	/// [`Alloc` error]: error::Alloc
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Match` error]: error::Match
+	/// [`Pixmap` error]: error::Pixmap
+	#[doc(alias("CreateCursor"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CreateCursorAppearance: Request(93, CreateCursorAppearanceError) {
+		/// The [`CursorAppearance` ID] which is to be assigned to the
+		/// [`CursorAppearance`].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [`CursorAppearance` ID]: CursorAppearance
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias("cid", "cursor_id", "caid"))]
+		pub cursor_appearance_id: CursorAppearance,
+
+		/// The [pixmap] that specifies the appearance of the cursor.
+		///
+		/// For each bit set to `1` in this [pixmap], the [`foreground_color`]
+		/// is used. For each bit set to `0`, the [`background_color`] is used.
+		///
+		/// # Errors
+		/// A [`Pixmap` error] is generated if this does not refer to a defined
+		/// [pixmap].
+		///
+		/// A [`Match` error] is generated if this [pixmap] does not have a
+		/// depth of `1`.
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`foreground_color`]: CreateCursorAppearance::foreground_color
+		/// [`background_color`]: CreateCursorAppearance::background_color
+		///
+		/// [`Pixmap` error]: error::Pixmap
+		pub source: Pixmap,
+		/// An optional [pixmap] that applies a mask to the cursor's appearance.
+		///
+		/// If this is [`Some`], it masks the `source` [pixmap]. For each bit
+		/// set to `1`, the corresponding pixel in the `source` is shown. For
+		/// each bit set to `0`, the corresponding pixel in the `source` is
+		/// hidden.
+		///
+		/// # Errors
+		/// A [`Pixmap` error] is generated if this is [`Some`] but does not
+		/// refer to a defined [pixmap].
+		///
+		/// A [`Match` error] is generated if this is [`Some`] but does not have
+		/// the same size as the `source` [pixmap].
+		///
+		/// A [`Match` error] is generated if this is [`Some`] but does not have
+		/// a depth of `1`.
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Pixmap` error]: error::Pixmap
+		/// [`Match` error]: error::Match
+		pub mask: Option<Pixmap>,
+
+		/// The foreground color used for the cursor's visual appearance.
+		///
+		/// This foreground color is used for each bit set to `1` in the
+		/// `source` [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		#[doc(alias("fore_red", "fore_green", "fore_blue"))]
+		#[doc(alias("foreground_red", "foreground_green", "foreground_blue"))]
+		#[doc(alias("fore_color"))]
+		pub foreground_color: RgbColor,
+		/// The background color used for the cursor's visual appearance.
+		///
+		/// This background color is used for each bit set to `0` in the
+		/// `source` [pixmap].
+		///
+		/// [pixmap]: Pixmap
+		#[doc(alias("back_red", "back_green", "back_blue"))]
+		#[doc(alias("background_red", "background_green", "background_blue"))]
+		#[doc(alias("back_color"))]
+		pub background_color: RgbColor,
+
+		/// The x coordinate of the cursor's 'hotspot'.
+		///
+		/// This coordinate is relative to the top-left corner of the `source`
+		/// [pixmap].
+		///
+		/// The hotspot refers to the point within the cursor's appearance which
+		/// is placed directly over the coordinates of the cursor. For example,
+		/// for a normal arrow cursor, that will be the tip of the arrow. For a
+		/// pen cursor, that will be the tip of the pen.
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if this coordinate is not within the
+		/// `source` [pixmap] (i.e. it is greater than or equal to its width).
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Match` error]: error::Match
+		#[doc(alias("x"))]
+		pub hotspot_x: Px<u16>,
+		/// The y coordinate of the cursor's 'hotspot'.
+		///
+		/// This coordinate is relative to the top-left corner of the `source`
+		/// [pixmap].
+		///
+		/// The hotspot refers to the point within the cursor's appearance which
+		/// is placed directly over the coordinates of the cursor. For example,
+		/// for a normal arrow cursor, that will be the tip of the arrow. For a
+		/// pen cursor, that will be the tip of the pen.
+		///
+		/// # Errors
+		/// A [`Match` error] is generated if this coordinate is not within the
+		/// `source` [pixmap] (i.e. it is greater than or equal to its height).
+		///
+		/// [pixmap]: Pixmap
+		///
+		/// [`Match` error]: error::Match
+		#[doc(alias("y"))]
+		pub hotspot_y: Px<u16>,
+	}
+}

From 195a001b46748b07eca8257a96a3e566515c9b9d Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 17:38:48 +0000
Subject: [PATCH 126/157] CreateGlyphCursorAppearance request

---
 src/common.rs                      |  16 +++
 src/x11/request/graphics/config.rs | 172 ++++++++++++++++++++++++++++-
 xrbk/src/lib.rs                    |   1 +
 xrbk/src/wrap.rs                   |  22 ++++
 4 files changed, 210 insertions(+), 1 deletion(-)
 create mode 100644 xrbk/src/wrap.rs

diff --git a/src/common.rs b/src/common.rs
index 0013bd64..84258b27 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -371,6 +371,22 @@ derive_xrb! {
 )]
 pub struct Char16(pub(crate) u8, pub(crate) u8);
 
+impl From<u16> for Char16 {
+	fn from(value: u16) -> Self {
+		let [byte1, byte2] = value.to_be_bytes();
+		
+		Self::new(byte1, byte2)
+	}
+}
+
+impl From<Char16> for u16 {
+	fn from(char: Char16) -> Self {
+		let (byte1, byte2) = char.unwrap();
+		
+		Self::from_be_bytes([byte1, byte2])
+	}
+}
+
 #[derive(Clone, Eq, PartialEq, Hash, Debug, From, Into, X11Size, Writable)]
 pub struct String16(Vec<Char16>);
 
diff --git a/src/x11/request/graphics/config.rs b/src/x11/request/graphics/config.rs
index 73a47202..59a2206e 100644
--- a/src/x11/request/graphics/config.rs
+++ b/src/x11/request/graphics/config.rs
@@ -23,6 +23,7 @@ use crate::{
 	x11::error,
 	CursorAppearance,
 	Drawable,
+	Font,
 	GraphicsContext,
 	Pixmap,
 	Rectangle,
@@ -660,7 +661,7 @@ derive_xrb! {
 	/// [pixmaps][pixmap].
 	///
 	/// # Errors
-	/// An [`Alloc` error] is generated if the X server failed to allocate the
+	/// An [`Alloc` error] is generated if the X server fails to allocate the
 	/// [`CursorAppearance`].
 	///
 	/// A [`ResourceIdChoice` error] is generated if `cursor_appearance_id`
@@ -813,3 +814,172 @@ derive_xrb! {
 		pub hotspot_y: Px<u16>,
 	}
 }
+
+request_error! {
+	#[doc(alias("CreateGlyphCursorError"))]
+	pub enum CreateGlyphCursorAppearanceError for CreateGlyphCursorAppearance {
+		Font,
+		ResourceIdChoice,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that creates a new [`CursorAppearance`] using the specified
+	/// glyphs.
+	///
+	/// The given `cursor_appearance_id` is assigned to the
+	/// [`CursorAppearance`] that is created.
+	///
+	/// The options provided in this [request] may be arbitrarily transformed by
+	/// the X server to meet display limitations.
+	///
+	/// # Errors
+	/// An [`Alloc` error] is generated if the X server fails to allocate the
+	/// [`CursorAppearance`]; see [`RequestError::Alloc`].
+	///
+	/// A [`ResourceIdChoice` error] is generated if `cursor_appearance_id`
+	/// specifies an ID already used for another resource, or an ID not
+	/// allocated to your client.
+	///
+	/// A [`Font` error] is generated if `source_font` does not refer to a
+	/// defined [font].
+	///
+	/// A [`Font` error] is generated if `mask_font` is [`Some`] and `mask_font`
+	/// does not refer to a defined [font].
+	///
+	/// A [`Value` error] is generated if `source_char` does not refer to a
+	/// glyph defined in the [font] specified by `source_font`.
+	///
+	/// A [`Value` error] is generated if `mask_font` is [`Some`] but
+	/// `mask_char` is [`None`].
+	///
+	/// A [`Value` error] is generated if both `mask_font` and `mask_char` are
+	/// [`Some`] but `mask_char` does not refer to a glyph defined in the font
+	/// specified by `mask_font`.
+	///
+	/// [font]: Font
+	/// [request]: Request
+	///
+	/// [`RequestError::Alloc`]: crate::message::RequestError::Alloc
+	/// [`Alloc` error]: error::Alloc
+	/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+	/// [`Font` error]: error::Font
+	/// [`Value` error]: error::Value
+	#[doc(alias("CreateGlyphCursor"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct CreateGlyphCursorAppearance: Request(94, CreateGlyphCursorAppearanceError) {
+		/// The [`CursorAppearance` ID] which is to be assigned to the
+		/// [`CursorAppearance`].
+		///
+		/// # Errors
+		/// A [`ResourceIdChoice` error] is generated if this resource ID is
+		/// already used or if it isn't allocated to your client.
+		///
+		/// [`CursorAppearance` ID]: CursorAppearance
+		///
+		/// [`ResourceIdChoice` error]: error::ResourceIdChoice
+		#[doc(alias("cid", "cursor_id", "caid"))]
+		pub cursor_appearance_id: CursorAppearance,
+
+		/// The [font] that is used for the [`source_char`].
+		///
+		/// # Errors
+		/// A [`Font` error] is generated if this does not refer to a defined
+		/// [font].
+		///
+		/// [`source_char`]: CreateGlyphCursorAppearance::source_char
+		///
+		/// [font]: Font
+		///
+		/// [`Font` error]: error::Font
+		pub source_font: Font,
+		/// The [font] that is used for the [`mask_char`].
+		///
+		/// If this is specified (is [`Some`]), the [`mask_char`] must be
+		/// specified too.
+		///
+		/// # Errors
+		/// A [`Font` error] is generated if this is [`Some`] but does not refer
+		/// to a defined [font].
+		///
+		/// [`mask_char`]: CreateGlyphCursorAppearance::mask_char
+		///
+		/// [font]: Font
+		///
+		/// [`Font` error]: error::Font
+		pub mask_font: Option<Font>,
+
+		/// The character used as the appearance of the cursor.
+		///
+		/// This character is displayed in the [font] specified by
+		/// [`source_font`].
+		///
+		/// For [fonts][font] that use two-byte matrix indexing, this value
+		/// should be specified like so:
+		/// ```
+		/// use xrb::Char16;
+		///
+		/// # let (byte1, byte2) = (0, 0);
+		/// #
+		/// let char = Char16::new(byte1, byte2);
+		///
+		/// let source_char = u16::from(char);
+		/// ```
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this does not refer to a glyph
+		/// defined in the [font] specified by [`source_font`].
+		///
+		/// [`source_font`]: CreateGlyphCursorAppearance::source_font
+		///
+		/// [font]: Font
+		///
+		/// [`Value` error]: error::Value
+		pub source_char: u16,
+		/// An optional character which masks the appearance of the cursor.
+		///
+		/// If this is [`Some`], it masks the character specified by
+		/// [`source_char`].
+		///
+		/// For [fonts][font] that use two-byte matrix indexing, this value
+		/// should be specified like so:
+		/// ```
+		/// use xrb::Char16;
+		///
+		/// # let (byte1, byte2) = (0, 0);
+		/// #
+		/// let char = Char16::new(byte1, byte2);
+		///
+		/// let mask_char = Some(u16::from(char));
+		/// ```
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if [`mask_font`] is [`Some`] but this
+		/// is [`None`].
+		///
+		/// A [`Value` error] is generated if this does not refer to a glyph
+		/// defined in the [font] specified by [`mask_font`].
+		///
+		/// [`mask_font`]: CreateGlyphCursorAppearance::mask_font
+		///
+		/// [font]: Font
+		///
+		/// [`Value` error]: error::Value
+		pub mask_char: Option<u16>,
+
+		/// The foreground color used for the cursor's visual appearance.
+		///
+		/// This foreground color is used for the [`source_char`].
+		///
+		/// [`source_char`]: CreateGlyphCursorAppearance::source_char
+		pub foreground_color: RgbColor,
+		/// The background color used for the cursor's visual appearance.
+		///
+		/// This background color is used for areas of the cursor's visual
+		/// appearance which are not the [`source_char`].
+		///
+		/// [`source_char`]: CreateGlyphCursorAppearance::source_char
+		pub background_color: RgbColor,
+	}
+}
diff --git a/xrbk/src/lib.rs b/xrbk/src/lib.rs
index 14d2b0a4..e5c89cf2 100644
--- a/xrbk/src/lib.rs
+++ b/xrbk/src/lib.rs
@@ -80,6 +80,7 @@ pub enum WriteError {
 mod readable;
 mod writable;
 mod x11_size;
+mod wrap;
 
 /// Gives the type size in bytes.
 /// The size can vary depending on the quantity of data it contains
diff --git a/xrbk/src/wrap.rs b/xrbk/src/wrap.rs
new file mode 100644
index 00000000..f1af7659
--- /dev/null
+++ b/xrbk/src/wrap.rs
@@ -0,0 +1,22 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+use crate::Wrap;
+
+macro_rules! impl_wrap {
+	($($($type:ty),+$(,)?)?) => {
+		$($(
+			impl Wrap for $type {
+				type Integer = Self;
+			}
+		)+)?
+	}
+}
+
+impl_wrap! {
+	u8,
+	u16,
+	u32,
+	u64,
+}

From a581d79906af2674b2fac465e819bc592202a854 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 31 Jan 2023 17:40:36 +0000
Subject: [PATCH 127/157] [CI913] formatted code with rustfmt

---
 src/common.rs   | 4 ++--
 xrbk/src/lib.rs | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 84258b27..285628c3 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -374,7 +374,7 @@ pub struct Char16(pub(crate) u8, pub(crate) u8);
 impl From<u16> for Char16 {
 	fn from(value: u16) -> Self {
 		let [byte1, byte2] = value.to_be_bytes();
-		
+
 		Self::new(byte1, byte2)
 	}
 }
@@ -382,7 +382,7 @@ impl From<u16> for Char16 {
 impl From<Char16> for u16 {
 	fn from(char: Char16) -> Self {
 		let (byte1, byte2) = char.unwrap();
-		
+
 		Self::from_be_bytes([byte1, byte2])
 	}
 }
diff --git a/xrbk/src/lib.rs b/xrbk/src/lib.rs
index e5c89cf2..b36ced29 100644
--- a/xrbk/src/lib.rs
+++ b/xrbk/src/lib.rs
@@ -78,9 +78,9 @@ pub enum WriteError {
 }
 
 mod readable;
+mod wrap;
 mod writable;
 mod x11_size;
-mod wrap;
 
 /// Gives the type size in bytes.
 /// The size can vary depending on the quantity of data it contains

From ba2b591bcc9a6639e987462d52a7e5dd3c941268 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 17:50:47 +0000
Subject: [PATCH 128/157] DestroyCursorAppearance request

---
 src/x11/request/graphics/config.rs | 32 ++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/src/x11/request/graphics/config.rs b/src/x11/request/graphics/config.rs
index 59a2206e..aeac0e79 100644
--- a/src/x11/request/graphics/config.rs
+++ b/src/x11/request/graphics/config.rs
@@ -831,6 +831,10 @@ derive_xrb! {
 	/// The given `cursor_appearance_id` is assigned to the
 	/// [`CursorAppearance`] that is created.
 	///
+	/// The hotspot (that is, the point that is aligned to the exact coordinates
+	/// of the cursor: for a typical arrow cursor, that's the tip of the arrow)
+	/// is the top-left corner of the `source_char`.
+	///
 	/// The options provided in this [request] may be arbitrarily transformed by
 	/// the X server to meet display limitations.
 	///
@@ -982,4 +986,32 @@ derive_xrb! {
 		/// [`source_char`]: CreateGlyphCursorAppearance::source_char
 		pub background_color: RgbColor,
 	}
+
+	/// A [request] that deletes the association between the given
+	/// [`CursorAppearance` ID] and the [`CursorAppearance`] it refers to.
+	///
+	/// The [`CursorAppearance`] will be deleted once no resources reference it
+	/// any longer.
+	///
+	/// # Errors
+	/// A [`CursorAppearance` error] is generated if `target` does not refer to
+	/// a defined [`CursorAppearance`].
+	///
+	/// [request]: Request
+	///
+	/// [`CursorAppearance` ID]: CursorAppearance
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct DestroyCursorAppearance: Request(95, error::CursorAppearance) {
+		/// The [`CursorAppearance`] that is to be deleted.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [`CursorAppearance`].
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias("cursor", "cursor_appearance"))]
+		pub target: CursorAppearance,
+	}
 }

From cb9b824032d2953d94bf004855639af683d93193 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 18:04:45 +0000
Subject: [PATCH 129/157] RecolorCursorAppearance request

---
 src/x11/request/graphics/config.rs | 48 ++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/src/x11/request/graphics/config.rs b/src/x11/request/graphics/config.rs
index aeac0e79..4569f682 100644
--- a/src/x11/request/graphics/config.rs
+++ b/src/x11/request/graphics/config.rs
@@ -1014,4 +1014,52 @@ derive_xrb! {
 		#[doc(alias("cursor", "cursor_appearance"))]
 		pub target: CursorAppearance,
 	}
+
+	/// A [request] that changes the foreground and background colors of a
+	/// [`CursorAppearance`].
+	///
+	/// If the [`CursorAppearance`] is currently being displayed, this change
+	/// will be immediately visible.
+	///
+	/// # Errors
+	/// A [`CursorAppearance` error] is generated if `target` does not refer to
+	/// a defined [`CursorAppearance`].
+	///
+	/// [request]: Request
+	///
+	/// [`CursorAppearance` error]: error::CursorAppearance
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct RecolorCursorAppearance: Request(96, error::CursorAppearance) {
+		/// The [`CursorAppearance`] which is to be recolored.
+		///
+		/// # Errors
+		/// A [`CursorAppearance` error] is generated if this does not refer to
+		/// a defined [`CursorAppearance`].
+		///
+		/// [`CursorAppearance` error]: error::CursorAppearance
+		#[doc(alias("cursor", "cursor_appearance"))]
+		pub target: CursorAppearance,
+
+		/// The new foreground color for the [`CursorAppearance`].
+		///
+		/// This foreground color is used for each bit set to `1` in the
+		/// `target` [`CursorAppearance`]'s `source` [pixmap].
+		///
+		/// If the `target`'s `source` is a character, then this foreground
+		/// color is used for that character.
+		///
+		/// [pixmap]: Pixmap
+		pub foreground_color: RgbColor,
+		/// The new background color for the [`CursorAppearance`].
+		///
+		/// This background color is used for each bit set to `0` in the
+		/// `target` [`CursorAppearance`]'s `source` [pixmap].
+		///
+		/// If the `target`'s `source` is a character, then this background
+		/// color is used for the parts of the `target`'s `source` which is not
+		/// the character.
+		///
+		/// [pixmap]: Pixmap
+		pub background_color: RgbColor,
+	}
 }

From 156783e0298990049e8e65ec228ff5ae643eaf8a Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 18:45:51 +0000
Subject: [PATCH 130/157] QueryIdealDimensions request + reply

---
 src/x11/reply/graphics.rs          |   3 +
 src/x11/reply/graphics/config.rs   |  45 ++++++++++
 src/x11/request/graphics/config.rs | 130 +++++++++++++++++++++++++++--
 3 files changed, 173 insertions(+), 5 deletions(-)
 create mode 100644 src/x11/reply/graphics/config.rs

diff --git a/src/x11/reply/graphics.rs b/src/x11/reply/graphics.rs
index 63a68ed3..7a245a2b 100644
--- a/src/x11/reply/graphics.rs
+++ b/src/x11/reply/graphics.rs
@@ -14,6 +14,9 @@
 //!
 //! [requests that relate to graphics operations]: request::graphics
 
+mod config;
+pub use config::*;
+
 extern crate self as xrb;
 
 use derivative::Derivative;
diff --git a/src/x11/reply/graphics/config.rs b/src/x11/reply/graphics/config.rs
new file mode 100644
index 00000000..a2356cfa
--- /dev/null
+++ b/src/x11/reply/graphics/config.rs
@@ -0,0 +1,45 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+extern crate self as xrb;
+
+use crate::{message::Reply, x11::request, Dimensions};
+
+use derivative::Derivative;
+use xrbk_macro::derive_xrb;
+
+derive_xrb! {
+	/// The [reply] to a [`QueryIdealDimensions` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`QueryIdealDimensions` request]: request::QueryIdealDimensions
+	#[doc(alias("QueryBestSize"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryIdealDimensions: Reply for request::QueryIdealDimensions {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The ideal [dimensions], as described in the
+		/// [`QueryIdealDimensions` request].
+		///
+		/// [dimensions]: Dimensions
+		///
+		/// [`QueryIdealDimensions` request]: request::QueryIdealDimensions
+		#[doc(alias("width", "height", "dimensions", "ideal_width", "ideal_height"))]
+		pub ideal_dimensions: Dimensions,
+		[_; ..],
+	}
+}
diff --git a/src/x11/request/graphics/config.rs b/src/x11/request/graphics/config.rs
index 4569f682..93115616 100644
--- a/src/x11/request/graphics/config.rs
+++ b/src/x11/request/graphics/config.rs
@@ -20,8 +20,9 @@ use crate::{
 	set::{GraphicsOptions, GraphicsOptionsMask},
 	unit::Px,
 	visual::RgbColor,
-	x11::error,
+	x11::{error, reply},
 	CursorAppearance,
+	Dimensions,
 	Drawable,
 	Font,
 	GraphicsContext,
@@ -696,7 +697,7 @@ derive_xrb! {
 	/// [`Match` error]: error::Match
 	/// [`Pixmap` error]: error::Pixmap
 	#[doc(alias("CreateCursor"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct CreateCursorAppearance: Request(93, CreateCursorAppearanceError) {
 		/// The [`CursorAppearance` ID] which is to be assigned to the
 		/// [`CursorAppearance`].
@@ -871,7 +872,7 @@ derive_xrb! {
 	/// [`Font` error]: error::Font
 	/// [`Value` error]: error::Value
 	#[doc(alias("CreateGlyphCursor"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct CreateGlyphCursorAppearance: Request(94, CreateGlyphCursorAppearanceError) {
 		/// The [`CursorAppearance` ID] which is to be assigned to the
 		/// [`CursorAppearance`].
@@ -1002,7 +1003,7 @@ derive_xrb! {
 	/// [`CursorAppearance` ID]: CursorAppearance
 	///
 	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct DestroyCursorAppearance: Request(95, error::CursorAppearance) {
 		/// The [`CursorAppearance`] that is to be deleted.
 		///
@@ -1028,7 +1029,7 @@ derive_xrb! {
 	/// [request]: Request
 	///
 	/// [`CursorAppearance` error]: error::CursorAppearance
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct RecolorCursorAppearance: Request(96, error::CursorAppearance) {
 		/// The [`CursorAppearance`] which is to be recolored.
 		///
@@ -1063,3 +1064,122 @@ derive_xrb! {
 		pub background_color: RgbColor,
 	}
 }
+
+request_error! {
+	#[doc(alias("QueryBestSizeError"))]
+	pub enum QueryIdealDimensionsError for QueryIdealDimensions {
+		Drawable,
+		Match,
+		Value,
+	}
+}
+
+/// Specifies how the ideal [dimensions] should be chosen in a
+/// [`QueryIdealDimensions` request].
+///
+/// [dimensions]: Dimensions
+///
+/// [`QueryIdealDimension` request]: QueryIdealDimensions
+#[doc(alias("QueryBestSizeClass", "QueryIdealDimensionsClass"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum DimensionClass {
+	/// The largest [`CursorAppearance`] [dimensions] that can be fully
+	/// displayed are returned.
+	///
+	/// [dimensions]: Dimensions
+	CursorAppearance,
+
+	/// The [dimensions] which can be tiled fastest are returned.
+	///
+	/// See [`GraphicsOptions::tile`] for more information on tiling.
+	///
+	/// [dimensions]: Dimensions
+	Tile,
+	/// The [dimensions] which can be stippled fastest are returned.
+	///
+	/// See [`GraphicsOptions::stipple`] for more information on stippling.
+	///
+	/// [dimensions]: Dimensions
+	Stipple,
+}
+
+derive_xrb! {
+	/// A [request] that returns the ideal [dimensions] for the given
+	/// [`DimensionClass`] and baseline [dimensions].
+	///
+	/// For [`DimensionClass::CursorAppearance`], the largest
+	/// [`CursorAppearance`] [dimensions] that can be fully displayed are
+	/// returned.
+	///
+	/// For [`DimensionClass::Tile`], the [dimensions] that can be tiled
+	/// fastest are returned.
+	///
+	/// For [`DimensionClass::Stipple`], the [dimensions] that can be stippled
+	/// fastest are returned.
+	///
+	/// # Errors
+	/// A [`Drawable` error] is generated if `drawable` does not refer to a
+	/// defined [window] nor [pixmap].
+	///
+	/// A [`Match` error] is generated if `class` is [`Tile`] or [`Stipple`] and
+	/// `drawable` is an [`InputOnly`] [window].
+	///
+	/// [window]: crate::Window
+	/// [pixmap]: Pixmap
+	/// [dimensions]: Dimensions
+	/// [request]: Request
+	///
+	/// [`Tile`]: DimensionClass::Tile
+	/// [`Stipple`]: DimensionClass::Stipple
+	///
+	/// [`InputOnly`]: crate::WindowClass::InputOnly
+	///
+	/// [`Drawable` error]: error::Drawable
+	/// [`Match` error]: error::Match
+	#[doc(alias("QueryBestSize"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct QueryIdealDimensions: Request(
+		97,
+		QueryIdealDimensionsError,
+	) -> reply::QueryIdealDimensions {
+		/// The [class] of ideal [dimensions] requested.
+		///
+		/// [class]: DimensionClass
+		/// [dimensions]: Dimensions
+		#[metabyte]
+		pub class: DimensionClass,
+
+		/// Indicates the desired [screen] and possibly the depth as well.
+		///
+		/// For [`DimensionClass::CursorAppearance`], this only indicates the
+		/// desired [screen].
+		///
+		/// For [`DimensionClass::Tile`] or [`DimensionClass::Stipple`], this
+		/// possibly indicates the depth as well.
+		///
+		/// # Errors
+		/// A [`Drawable` error] is generated if this does not refer to a
+		/// defined [window] nor [pixmap].
+		///
+		/// A [`Match` error] is generated if an [`InputOnly`] [window] is used
+		/// for [`DimensionClass::Tile`] or [`DimensionClass::Stipple`].
+		///
+		/// [window]: crate::Window
+		/// [pixmap]: Pixmap
+		/// [screen]: crate::visual::Screen
+		///
+		/// [window class]: crate::WindowClass
+		/// [`InputOnly`]: crate::WindowClass::InputOnly
+		///
+		/// [`Drawable` error]: error::Drawable
+		/// [`Match` error]: error::Match
+		pub drawable: Drawable,
+
+		/// The [dimensions] which the returned ideal [dimensions] are closest
+		/// to.
+		///
+		/// [dimensions]: Dimensions
+		#[doc(alias("width", "height"))]
+		pub dimensions: Dimensions,
+	}
+}

From 686c87f866fec6b4fb502aea6727ac5a851f52d3 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 19:03:24 +0000
Subject: [PATCH 131/157] QueryExtension request + reply

---
 src/x11/reply/meta.rs   | 56 +++++++++++++++++++++++++++++++++++++++--
 src/x11/request/meta.rs | 33 +++++++++++++++++++++++-
 2 files changed, 86 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
index ffa96d5e..83798b9e 100644
--- a/src/x11/reply/meta.rs
+++ b/src/x11/reply/meta.rs
@@ -8,8 +8,60 @@
 //! [Replies] are messages sent from the X server to an X client in response to
 //! a [request].
 //!
-//! [Replies]: crate::message::Reply
+//! [Replies]: Reply
 //! [request]: crate::message::Request
 //! [core X11 protocol]: crate::x11
 //!
-//! [requests that relate to an X client or the X server]: crate::x11::request::meta
+//! [requests that relate to an X client or the X server]: request::meta
+
+extern crate self as xrb;
+
+use derivative::Derivative;
+use xrbk_macro::derive_xrb;
+
+use crate::{message::Reply, x11::request};
+
+derive_xrb! {
+	/// The [reply] to a [`QueryExtension` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`QueryExtension` request]: request::QueryExtension
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct QueryExtension: Reply for request::QueryExtension {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the specified extension is present.
+		pub present: bool,
+
+		/// The [major opcode] of the specified extension if the extension is
+		/// present and it has has a [major opcode].
+		///
+		/// [major opcode]: crate::message::Request::MAJOR_OPCODE
+		pub major_opcode: Option<u8>,
+		/// The first [event code] defined by the specified extension if the
+		/// extension is present and it defines any [events].
+		///
+		/// [events]: crate::message::Event
+		/// [event code]: crate::message::Event::CODE
+		pub first_event_code: Option<u8>,
+		/// The first [error code] defined by the specified extension if the
+		/// extension is present and it defines any [errors].
+		///
+		/// [errors]: crate::message::Error
+		/// [event code]: crate::message::Event::CODE
+		pub first_error_code: Option<u8>,
+	}
+}
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 03275843..06b21eca 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -12,9 +12,15 @@
 
 extern crate self as xrb;
 
+use xrbk::pad;
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
-use crate::{message::Request, x11::error, Window};
+use crate::{
+	message::Request,
+	x11::{error, reply},
+	String8,
+	Window,
+};
 
 macro_rules! request_error {
 	(
@@ -116,4 +122,29 @@ derive_xrb! {
 		/// [`Window` error]: error::Window
 		pub window: Window,
 	}
+
+	/// A [request] that returns whether the specified extension is present and
+	/// the message codes associated with it if it is.
+	///
+	/// # Replies
+	/// This [request] generates a [`QueryExtension` reply].
+	///
+	/// [request]: Request
+	///
+	/// [`QueryExtension` reply]: reply::QueryExtension
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct QueryExtension: Request(98) -> reply::QueryExtension {
+		// Length of `name`.
+		#[allow(clippy::cast_possible_truncation)]
+		let name_len: u16 = name => name.len() as u16,
+		[_; 2],
+
+		/// The name of the extension which is to be queried.
+		///
+		/// This name should use ISO Latin-1 encoding. Uppercase and lowercase
+		/// matter.
+		#[context(name_len => usize::from(*name_len))]
+		pub name: String8,
+		[_; name => pad(name)],
+	}
 }

From 19e236b9bcc0712b1856a8fbe29150ec88a38f99 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 19:10:27 +0000
Subject: [PATCH 132/157] ListExtensions request + reply

---
 src/x11/reply/meta.rs   | 37 ++++++++++++++++++++++++++++++++++++-
 src/x11/request/meta.rs | 13 ++++++++++++-
 2 files changed, 48 insertions(+), 2 deletions(-)

diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
index 83798b9e..729a8248 100644
--- a/src/x11/reply/meta.rs
+++ b/src/x11/reply/meta.rs
@@ -17,9 +17,10 @@
 extern crate self as xrb;
 
 use derivative::Derivative;
+use xrbk::pad;
 use xrbk_macro::derive_xrb;
 
-use crate::{message::Reply, x11::request};
+use crate::{message::Reply, x11::request, LengthString8};
 
 derive_xrb! {
 	/// The [reply] to a [`QueryExtension` request].
@@ -64,4 +65,38 @@ derive_xrb! {
 		/// [event code]: crate::message::Event::CODE
 		pub first_error_code: Option<u8>,
 	}
+
+	/// The [reply] to a [`ListExtensions` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`ListExtensions` request]: request::ListExtensions
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListExtensions: Reply for request::ListExtensions {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `names`.
+		#[metabyte]
+		#[allow(clippy::cast_possible_truncation)]
+		let names_len: u8 = names => names.len() as u8,
+
+		[_; 24],
+
+		/// The names of all extensions supported by the X server.
+		#[context(names_len => usize::from(*names_len))]
+		pub names: Vec<LengthString8>,
+		[_; names => pad(names)],
+	}
 }
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 06b21eca..aa5fbe8a 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -132,7 +132,7 @@ derive_xrb! {
 	/// [request]: Request
 	///
 	/// [`QueryExtension` reply]: reply::QueryExtension
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct QueryExtension: Request(98) -> reply::QueryExtension {
 		// Length of `name`.
 		#[allow(clippy::cast_possible_truncation)]
@@ -147,4 +147,15 @@ derive_xrb! {
 		pub name: String8,
 		[_; name => pad(name)],
 	}
+
+	/// A [request] that returns the names of all extensions supported by the X server.
+	///
+	/// # Replies
+	/// This [request] generates a [`ListExtensions` reply].
+	///
+	/// [request]: Request
+	///
+	/// [`ListExtensions` reply]: reply::ListExtensions
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct ListExtensions: Request(99) -> reply::ListExtensions;
 }

From dc015f9726d2da4c07f8eace87fe3b920f876f14 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 20:38:00 +0000
Subject: [PATCH 133/157] =?UTF-8?q?ChangeKeyboardMapping=20request=20(no.?=
 =?UTF-8?q?=20100/120=20=F0=9F=8E=89)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/common.rs            |   5 ++
 src/x11/request/input.rs | 172 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 177 insertions(+)

diff --git a/src/common.rs b/src/common.rs
index 285628c3..394ff055 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -239,6 +239,11 @@ pub enum StackMode {
 )]
 pub struct Keysym(pub(crate) u32);
 
+impl Keysym {
+	pub const NO_SYMBOL: Self = Self::new(0x0000_0000);
+	pub const VOID_SYMBOL: Self = Self::new(0x00ff_ffff);
+}
+
 #[derive(
 	Copy,
 	Clone,
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index e77dd94c..c2ad4351 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -28,6 +28,7 @@ use crate::{
 	FocusWindow,
 	FreezeMode,
 	Keycode,
+	Keysym,
 	Window,
 };
 
@@ -1256,7 +1257,12 @@ derive_xrb! {
 
 	/// A [request] that returns the current focus.
 	///
+	/// # Replies
+	/// This [request] generates a [`GetFocus` reply].
+	///
 	/// [request]: Request
+	///
+	/// [`GetFocus` reply]: reply::GetFocus
 	#[doc(alias = "GetInputFocus")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetFocus: Request(43) -> reply::GetFocus;
@@ -1264,8 +1270,174 @@ derive_xrb! {
 	/// A [request] that returns a bit vector of the currently held keys on the
 	/// keyboard.
 	///
+	/// # Replies
+	/// This [request] generates a [`QueryKeyboard` reply].
+	///
 	/// [request]: Request
+	///
+	/// [`QueryKeyboard` reply]: reply::QueryKeyboard
 	#[doc(alias = "QueryKeymap")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct QueryKeyboard: Request(44) -> reply::QueryKeyboard;
 }
+
+// Issue with macro syntax for this was that it didn't support using the
+// message's generics in sources.
+
+/// A [request] that changes the mapping of [keycodes] to [keysyms] for the
+/// specified range of [keycodes].
+///
+/// You may arbitrarily choose the `KEYSYMS_PER_KEYCODE` to be a value large
+/// enough to contain all the desired [keysym] mappings.
+///
+/// # Events generated
+/// This [request] generates a [`MappingChange` event].
+///
+/// # Errors
+/// A [`Value` error] is generated if `first_keycode` is less than the
+/// [`min_keycode`] returned during [connection setup].
+///
+/// A [`Value` error] is generated if the last [keycode] in the given
+/// range is greater than the [`max_keycode`] returned during
+/// [connection setup]. That last [keycode] is given by:
+/// ```
+/// # use xrb::Keycode;
+/// #
+/// # fn main() -> Result<(), <u8 as TryFrom<usize>>::Error> {
+/// #     let first_keycode = Keycode::new(0);
+/// #     let mappings: Vec<[xrb::Keysym; 10]> = vec![[xrb::Keysym::NO_SYMBOL; 10]];
+/// #
+/// #     let _ =
+/// Keycode::new(first_keycode.unwrap() + u8::try_from(mappings.len())? - 1)
+/// #     ;
+/// #
+/// #     Ok(())
+/// # }
+/// ```
+///
+/// [keycodes]: Keycode
+/// [keycode]: Keycode
+///
+/// [keysyms]: Keysym
+/// [keysym]: Keysym
+///
+/// [request]: Request
+/// [connection setup]: crate::connection::InitConnection
+///
+/// [`min_keycode`]: crate::connection::ConnectionSuccess::min_keycode
+/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+///
+/// [`MappingChange` event]: crate::x11::event::MappingChange
+///
+/// [`Value` error]: error::Value
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct ChangeKeyboardMapping<const KEYSYMS_PER_KEYCODE: usize> {
+	/// The first [keycode] in the range of [keycodes] that are to have their
+	/// mappings to [keysyms] changed.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if this is less than the [`min_keycode`]
+	/// returned during [connection setup].
+	///
+	/// [keycode]: Keycode
+	/// [keycodes]: Keycode
+	///
+	/// [keysyms]: Keysym
+	///
+	/// [connection setup]: crate::connection::InitConnection
+	///
+	/// [`min_keycode`]: crate::connection::ConnectionSuccess::min_keycode
+	///
+	/// [`Value` error]: error::Value
+	pub first_keycode: Keycode,
+
+	/// The changed mappings from [keycodes] to [keysyms].
+	///
+	/// Each array in this list represents the [keysyms] mapped to a particular
+	/// [keycode]. The first array is the mapping for the [`first_keycode`],
+	/// while the each array after that is the mapping for the [keycode] one
+	/// greater than the one before it:
+	/// ```
+	/// # use xrb::Keycode;
+	/// #
+	/// # let previous_keycode = Keycode::new(0);
+	/// #
+	/// # let _ =
+	/// Keycode::new(previous_keycode.unwrap() + 1)
+	/// # ;
+	/// ```
+	/// Each array (after the first one) is the mapping for the [keycode] one
+	/// greater than the [keycode] of the array before it.
+	///
+	/// [`Keysym::NO_SYMBOL`] should be used to fill in unused [keysym]
+	/// mappings. [`Keysym::NO_SYMBOL`] may appear anywhere in the mappings -
+	/// i.e., not just at the end of an array.
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if the last array is for a [keycode]
+	/// greater than the [`max_keycode`] returned during [connection setup].
+	///
+	/// [`first_keycode`]: ChangeKeyboardMapping::first_keycode
+	///
+	/// [keycode]: Keycode
+	/// [keycodes]: Keycode
+	///
+	/// [keysym]: Keysym
+	/// [keysyms]: Keysym
+	///
+	/// [connection setup]: crate::connection::InitConnection
+	///
+	/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+	pub mappings: Vec<[Keysym; KEYSYMS_PER_KEYCODE]>,
+}
+
+impl<const KEYSYMS_PER_KEYCODE: usize> Request for ChangeKeyboardMapping<KEYSYMS_PER_KEYCODE> {
+	type OtherErrors = error::Value;
+	type Reply = ();
+
+	const MAJOR_OPCODE: u8 = 100;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl<const KEYSYMS_PER_KEYCODE: usize> X11Size for ChangeKeyboardMapping<KEYSYMS_PER_KEYCODE> {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 4;
+		const CONSTANT_SIZES: usize = HEADER + Keycode::X11_SIZE + u8::X11_SIZE + 2;
+
+		CONSTANT_SIZES + self.mappings.x11_size()
+	}
+}
+
+// Unfortunately `Readable` can't be implemented because the type signature
+// requires specifying the `KEYSYMS_PER_KEYCODE`, which would only be able to be
+// found out after reading that data.
+//
+// The way around that would be to use `Vec`s instead of arrays in `mappings`,
+// but considering that this is a library focused on the client side of the X11
+// protocol, not being able to read the request is a better compromise than not
+// ensuring that each inner list is of an equal length to every other one at
+// compile time.
+
+impl<const KEYSYMS_PER_KEYCODE: usize> Writable for ChangeKeyboardMapping<KEYSYMS_PER_KEYCODE> {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		// Limit `buf` by the length (converted to bytes).
+		let buf = &mut buf.limit(usize::from(self.length()) * 4);
+
+		// The major opcode.
+		Self::MAJOR_OPCODE.write_to(buf)?;
+		// Length of `mappings`.
+		(self.mappings.len() as u8).write_to(buf)?;
+		// The length of the message.
+		self.length().write_to(buf)?;
+
+		self.first_keycode.write_to(buf)?;
+		(KEYSYMS_PER_KEYCODE as u8).write_to(buf)?;
+		// 2 unused bytes.
+		buf.put_bytes(0, 2);
+
+		self.mappings.write_to(buf)?;
+
+		Ok(())
+	}
+}

From 39af6740e13c60c301319ca1a75802213afdc5c6 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 22:03:18 +0000
Subject: [PATCH 134/157] GetKeyboardMapping request + reply

---
 src/common.rs            |  22 +++++--
 src/x11/reply/input.rs   | 131 +++++++++++++++++++++++++++++++++++++++
 src/x11/request/input.rs | 129 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 277 insertions(+), 5 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 394ff055..72a6de60 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -227,9 +227,8 @@ pub enum StackMode {
 	Debug,
 	From,
 	Into,
-	// `new` and `unwrap` const fns
+	// `new` const fn
 	new,
-	unwrap,
 	// XRBK traits
 	X11Size,
 	ConstantX11Size,
@@ -242,6 +241,12 @@ pub struct Keysym(pub(crate) u32);
 impl Keysym {
 	pub const NO_SYMBOL: Self = Self::new(0x0000_0000);
 	pub const VOID_SYMBOL: Self = Self::new(0x00ff_ffff);
+
+	/// Returns the raw contained keysym value.
+	#[must_use]
+	pub const fn unwrap(&self) -> u32 {
+		self.0
+	}
 }
 
 #[derive(
@@ -253,9 +258,8 @@ impl Keysym {
 	Debug,
 	From,
 	Into,
-	// `new` and `unwrap` const fns
+	// `new` const fn
 	new,
-	unwrap,
 	// XRBK traits
 	X11Size,
 	ConstantX11Size,
@@ -263,7 +267,15 @@ impl Keysym {
 	Writable,
 	Wrap,
 )]
-pub struct Keycode(pub u8);
+pub struct Keycode(pub(crate) u8);
+
+impl Keycode {
+	/// Returns the contained `u8` keycode.
+	#[must_use]
+	pub const fn unwrap(&self) -> u8 {
+		self.0
+	}
+}
 
 #[derive(
 	Copy,
diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index a8740fe5..491d8085 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -17,6 +17,7 @@
 extern crate self as xrb;
 
 use derivative::Derivative;
+use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
 
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
@@ -26,6 +27,7 @@ use crate::{
 	Coords,
 	FocusWindow,
 	GrabStatus,
+	Keysym,
 	ModifierMask,
 	Timestamp,
 	Window,
@@ -325,3 +327,132 @@ derive_xrb! {
 		pub keys: [u8; 32],
 	}
 }
+
+/// The [keysyms] mapped to a particular [keycode].
+///
+/// [keysyms]: Keysym
+/// [keycode]: crate::Keycode
+pub type KeyMapping = Vec<Keysym>;
+
+/// The [reply] to a [`GetKeyboardMapping` request].
+///
+/// [reply]: Reply
+///
+/// [`GetKeyboardMapping` request]: request::GetKeyboardMapping
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct GetKeyboardMapping {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+
+	/// The mapping of [keysyms] for each [keycode] in the specified `range`.
+	///
+	/// [keycode]: crate::Keycode
+	/// [keysyms]: Keysym
+	pub mappings: Vec<KeyMapping>,
+}
+
+impl Reply for GetKeyboardMapping {
+	type Request = request::GetKeyboardMapping;
+
+	fn sequence(&self) -> u16 {
+		self.sequence
+	}
+}
+
+impl X11Size for GetKeyboardMapping {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 8;
+		const CONSTANT_SIZES: usize = HEADER + 24;
+
+		CONSTANT_SIZES + self.mappings.x11_size()
+	}
+}
+
+impl Readable for GetKeyboardMapping {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		const HEADER: usize = 8;
+
+		// Header {{{
+
+		// FIXME: actually, replies need to have their first 4 bytes read before
+		//        the type of reply can be determined, so `keysyms_per_keycode`
+		//        and `sequence` should be context for `ReadableWithContext`.
+		//
+		// FIXME: This is a change that needs to be done for all replies...
+		buf.advance(1);
+		let keysyms_per_keycode = buf.get_u8();
+		let sequence = buf.get_u16();
+
+		let length = (buf.get_u32() as usize) * 4;
+		let buf = &mut buf.take(length - HEADER);
+
+		// }}}
+
+		// 24 unused bytes.
+		buf.advance(24);
+
+		let mappings = {
+			let mapping_size = usize::from(keysyms_per_keycode) * Keysym::X11_SIZE;
+			let mappings_len = buf.remaining() / mapping_size;
+
+			let mut mappings = vec![];
+
+			for _ in 0..mappings_len {
+				let mut keysyms = vec![];
+
+				for _ in 0..keysyms_per_keycode {
+					keysyms.push(Keysym::read_from(buf)?);
+				}
+
+				mappings.push(keysyms);
+			}
+
+			mappings
+		};
+
+		Ok(Self { sequence, mappings })
+	}
+}
+
+impl Writable for GetKeyboardMapping {
+	#[allow(clippy::cast_possible_truncation)]
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		let buf = &mut buf.limit(self.x11_size());
+
+		// Header {{{
+
+		// Indicates that this is a reply.
+		buf.put_u8(1);
+		// The number of keysyms in each mapping.
+		let mapping_size = self.mappings.x11_size() / self.mappings.len();
+		let keysyms_per_keycode = (mapping_size / Keysym::X11_SIZE) as u8;
+		keysyms_per_keycode.write_to(buf)?;
+		// The sequence number.
+		self.sequence.write_to(buf)?;
+
+		// The message length.
+		self.length().write_to(buf)?;
+
+		// }}}
+
+		// 24 unused bytes.
+		buf.put_bytes(0, 24);
+
+		self.mappings.write_to(buf)?;
+
+		Ok(())
+	}
+}
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index c2ad4351..b915800e 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -15,6 +15,8 @@ extern crate self as xrb;
 use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
+use std::ops::RangeInclusive;
+
 use crate::{
 	message::Request,
 	x11::{error, reply},
@@ -1388,6 +1390,8 @@ pub struct ChangeKeyboardMapping<const KEYSYMS_PER_KEYCODE: usize> {
 	/// [connection setup]: crate::connection::InitConnection
 	///
 	/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+	///
+	/// [`Value` error]: error::Value
 	pub mappings: Vec<[Keysym; KEYSYMS_PER_KEYCODE]>,
 }
 
@@ -1441,3 +1445,128 @@ impl<const KEYSYMS_PER_KEYCODE: usize> Writable for ChangeKeyboardMapping<KEYSYM
 		Ok(())
 	}
 }
+
+/// A [request] that returns the mapped [keysyms] for each [keycode] in the
+/// given `range`.
+///
+/// # Replies
+/// This [request] generates a [`GetKeyboardMapping` reply].
+///
+/// # Errors
+/// A [`Value` error] is generated if the first [keycode] specified in `range`
+/// is less than the [`min_keycode`] returned during [connection setup].
+///
+/// A [`Value` error] is generated if the last [keycode] specified in `range`
+/// is greater than the [`max_keycode`] returned during [connection setup].
+///
+/// [keycode]: Keycode
+/// [keysyms]: Keysym
+/// [request]: Request
+/// [connection setup]: crate::connection::InitConnection
+///
+/// [`min_keycode`]: crate::connection::ConnectionSuccess::min_keycode
+/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+///
+/// [`GetKeyboardMapping` reply]: reply::GetKeyboardMapping
+///
+/// [`Value` error]: error::Value
+pub struct GetKeyboardMapping {
+	/// The range of [keycodes] for which this [request] returns their mapped
+	/// [keysyms].
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if the first [keycode] is less than the
+	/// [`min_keycode`] returned during [connection setup].
+	///
+	/// A [`Value` error] is generated if the last [keycode] is greater than the
+	/// [`max_keycode`] returned during [connection setup].
+	///
+	/// [keycodes]: Keycode
+	/// [keysyms]: Keysym
+	/// [request]: Request
+	/// [connection setup]: crate::connection::InitConnection
+	///
+	/// [`min_keycode`]: crate::connection::ConnectionSuccess::min_keycode
+	/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+	///
+	/// [`Value` error]: error::Value
+	// This is effectively:
+	// ```
+	// pub first_keycode: Keycode,
+	// pub count: u8,
+	// ```
+	// where `count` is given by:
+	// ```
+	// let count = keycodes.end().unwrap() - first_keycode.unwrap();
+	// ```
+	pub range: RangeInclusive<Keycode>,
+}
+
+impl Request for GetKeyboardMapping {
+	type OtherErrors = error::Value;
+	type Reply = reply::GetKeyboardMapping;
+
+	const MAJOR_OPCODE: u8 = 101;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl ConstantX11Size for GetKeyboardMapping {
+	const X11_SIZE: usize = {
+		const HEADER: usize = 4;
+
+		HEADER + Keycode::X11_SIZE + u8::X11_SIZE + 2
+	};
+}
+
+impl X11Size for GetKeyboardMapping {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Readable for GetKeyboardMapping {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		const HEADER: usize = 4;
+
+		// Unused metabyte.
+		buf.advance(1);
+
+		// The message length.
+		let length = usize::from(buf.get_u16()) * 4;
+		let buf = &mut buf.take(length - HEADER);
+
+		let first_keycode = Keycode::read_from(buf)?;
+		let keycode_count = buf.get_u8();
+		buf.advance(2);
+
+		Ok(Self {
+			range: RangeInclusive::new(
+				first_keycode,
+				Keycode::new(first_keycode.unwrap() + keycode_count - 1),
+			),
+		})
+	}
+}
+
+impl Writable for GetKeyboardMapping {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		Self::MAJOR_OPCODE.write_to(buf)?;
+		// Unused metabyte.
+		buf.put_u8(0);
+		// Message length.
+		self.length().write_to(buf)?;
+
+		// First keycode.
+		self.range.start().write_to(buf)?;
+		// Number of keycodes.
+		let keycode_count = self.range.end().unwrap() - self.range.start().unwrap() + 1;
+		keycode_count.write_to(buf)?;
+		// 2 unused bytes.
+		buf.put_bytes(0, 2);
+
+		Ok(())
+	}
+}

From a70f616cb87ba48ba2ef08f52c3e3eb685f23d70 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Tue, 31 Jan 2023 22:10:52 +0000
Subject: [PATCH 135/157] GetKeyboardMapping doc example

---
 src/x11/request/input.rs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index b915800e..6aa02c66 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -1459,8 +1459,27 @@ impl<const KEYSYMS_PER_KEYCODE: usize> Writable for ChangeKeyboardMapping<KEYSYM
 /// A [`Value` error] is generated if the last [keycode] specified in `range`
 /// is greater than the [`max_keycode`] returned during [connection setup].
 ///
+/// # Examples
+/// This would return the [keysym] mapping for all [keycodes] using the
+/// [`min_keycode`] and [`max_keycode`] returned during [connection setup] (if
+/// it were sent):
+/// ```
+/// use xrb::x11::request;
+///
+/// # let min_keycode = xrb::Keycode::new(8);
+/// # let max_keycode = xrb::Keycode::new(10);
+/// #
+/// let _ = request::GetKeyboardMapping {
+///     range: min_keycode..=max_keycode,
+/// };
+/// ```
+///
+/// [keycodes]: Keycode
 /// [keycode]: Keycode
+///
 /// [keysyms]: Keysym
+/// [keysym]: Keysym
+///
 /// [request]: Request
 /// [connection setup]: crate::connection::InitConnection
 ///

From 358af7501ce0de13236d96f81f5b558d9a637fff Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 09:06:22 +0000
Subject: [PATCH 136/157] ChangeKeyboardOptions request, GetKeyboardOptions
 request + reply

---
 src/x11/reply/input.rs   | 91 ++++++++++++++++++++++++++++++++++++++++
 src/x11/request/input.rs | 44 +++++++++++++++++++
 2 files changed, 135 insertions(+)

diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index 491d8085..15894087 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -23,6 +23,7 @@ use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Reply,
+	unit::{Hz, Ms, Percentage},
 	x11::{request, request::RevertFocus},
 	Coords,
 	FocusWindow,
@@ -30,6 +31,7 @@ use crate::{
 	Keysym,
 	ModifierMask,
 	Timestamp,
+	Toggle,
 	Window,
 };
 
@@ -456,3 +458,92 @@ impl Writable for GetKeyboardMapping {
 		Ok(())
 	}
 }
+
+derive_xrb! {
+	/// The [reply] to a [`GetKeyboardOptions` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetKeyboardOptions` request]: request::GetKeyboardOptions
+	#[doc(alias("GetKeyboardControl"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetKeyboardOptions: Reply for request::GetKeyboardOptions {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the global [auto repeat mode] is enabled.
+		///
+		/// If the global auto repeat mode is disabled, no keys can have auto
+		/// repeat applied. If the global auto repeat mode is enabled, keys
+		/// which have their own auto repeat enabled will be repeated.
+		///
+		/// [auto repeat mode]: crate::set::KeyboardOptions::auto_repeat_mode
+		#[doc(alias("global_auto_repeat"))]
+		#[metabyte]
+		pub global_auto_repeat_mode: Toggle,
+
+		/// A bitmask representing whether each [LED] is lit.
+		///
+		/// The least significant bit represents the state of [LED] 1. The most
+		/// significant bit represents the state of [LED] 32.
+		///
+		/// [LED]: crate::set::Led
+		pub led_mask: u32,
+
+		/// The volume of key clicks.
+		///
+		/// See [`KeyboardOptions::key_click_volume`] for more information.
+		///
+		/// [`KeyboardOptions::key_click_volume`]: crate::set::KeyboardOptions::key_click_volume
+		#[doc(alias("key_click_percent"))]
+		pub key_click_volume: Percentage,
+
+		/// The volume of the bell.
+		///
+		/// See [`KeyboardOptions::bell_volume`] for more information.
+		///
+		/// [`KeyboardOptions::bell_volume`]: crate::set::KeyboardOptions::bell_volume
+		#[doc(alias("bell_percent"))]
+		pub bell_volume: Percentage,
+		/// The pitch of the bell.
+		///
+		/// See [`KeyboardOptions::bell_pitch`] for more information.
+		///
+		/// [`KeyboardOptions::bell_pitch`]: crate::set::KeyboardOptions::bell_pitch
+		pub bell_pitch: Hz<u16>,
+		/// The duration for which the bell rings.
+		///
+		/// See [`KeyboardOptions::bell_duration`] for more information.
+		///
+		/// [`KeyboardOptions::bell_duration`]: crate::set::KeyboardOptions::bell_duration
+		pub bell_duration: Ms<u16>,
+		[_; 2],
+
+		/// A bit vector representing whether each key has [auto repeat mode]
+		/// enabled.
+		///
+		/// Byte `N`, starting at `0`, contains the bits for [keycodes] `8N` to
+		/// `8N + 7`. The least significant bit in each byte represents key
+		/// `8N`.
+		///
+		/// See [`KeyboardOptions::auto_repeat_mode`] for more information.
+		///
+		/// [keycodes]: crate::Keycode
+		/// [auto repeat mode]: crate::set::KeyboardOptions::auto_repeat_mode
+		///
+		/// [`KeyboardOptions::auto_repeat_mode`]: crate::set::KeyboardOptions::auto_repeat_mode
+		#[doc(alias("auto_repeats"))]
+		pub auto_repeat_modes: [u8; 32],
+	}
+}
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 6aa02c66..cb280d53 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -19,6 +19,7 @@ use std::ops::RangeInclusive;
 
 use crate::{
 	message::Request,
+	set::KeyboardOptions,
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
@@ -1489,6 +1490,7 @@ impl<const KEYSYMS_PER_KEYCODE: usize> Writable for ChangeKeyboardMapping<KEYSYM
 /// [`GetKeyboardMapping` reply]: reply::GetKeyboardMapping
 ///
 /// [`Value` error]: error::Value
+#[derive(Debug, Hash, PartialEq, Eq)]
 pub struct GetKeyboardMapping {
 	/// The range of [keycodes] for which this [request] returns their mapped
 	/// [keysyms].
@@ -1589,3 +1591,45 @@ impl Writable for GetKeyboardMapping {
 		Ok(())
 	}
 }
+
+request_error! {
+	#[doc(alias("ChangeKeyboardControlError"))]
+	pub enum ChangeKeyboardOptionsError for ChangeKeyboardOptions {
+		Match,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the
+	/// [options configured for the keyboard][options].
+	///
+	/// See [`KeyboardOptions`] for more information.
+	///
+	/// [options]: KeyboardOptions
+	#[doc(alias("ChangeKeyboardControl"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeKeyboardOptions: Request(102, ChangeKeyboardOptionsError) {
+		/// The changes that are made to the [keyboard options].
+		///
+		/// [keyboard options]: KeyboardOptions
+		#[doc(alias("values", "value_mask", "value_list"))]
+		#[doc(alias("options", "option_mask", "option_list"))]
+		#[doc(alias("keyboard_option_mask", "keyboard_option_list"))]
+		#[doc(alias("keyboard_options"))]
+		pub changed_options: KeyboardOptions,
+	}
+	
+	/// A [request] that returns the current [keyboard options].
+	/// 
+	/// # Replies
+	/// This [request] generates a [`GetKeyboardOptions` reply].
+	/// 
+	/// [keyboard options]: KeyboardOptions
+	/// [request]: Request
+	/// 
+	/// [`GetKeyboardOptions` reply]: reply::GetKeyboardOptions
+	#[doc(alias("GetKeyboardControl"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetKeyboardOptions: Request(103) -> reply::GetKeyboardOptions;
+}

From aca249938f64731d13b0aa4c9fe01ba64aeb6b90 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 1 Feb 2023 09:08:44 +0000
Subject: [PATCH 137/157] [CI933] formatted code with rustfmt

---
 src/x11/request/input.rs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index cb280d53..6fc04be0 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -1619,15 +1619,15 @@ derive_xrb! {
 		#[doc(alias("keyboard_options"))]
 		pub changed_options: KeyboardOptions,
 	}
-	
+
 	/// A [request] that returns the current [keyboard options].
-	/// 
+	///
 	/// # Replies
 	/// This [request] generates a [`GetKeyboardOptions` reply].
-	/// 
+	///
 	/// [keyboard options]: KeyboardOptions
 	/// [request]: Request
-	/// 
+	///
 	/// [`GetKeyboardOptions` reply]: reply::GetKeyboardOptions
 	#[doc(alias("GetKeyboardControl"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]

From 1360257c58abc4aaa6ac522b935990100506ac3b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 09:49:28 +0000
Subject: [PATCH 138/157] RingBell request

---
 src/unit.rs              | 113 +++++++++++++++++++++++++++++++++++++--
 src/x11/request/input.rs |  45 ++++++++++++++++
 2 files changed, 155 insertions(+), 3 deletions(-)

diff --git a/src/unit.rs b/src/unit.rs
index 36803f25..4d59b9e9 100644
--- a/src/unit.rs
+++ b/src/unit.rs
@@ -4,7 +4,10 @@
 
 //! Types representing units like millimeters or hertz.
 
-use std::fmt::{Display, Formatter};
+use std::{
+	cmp::Ordering,
+	fmt::{Display, Formatter},
+};
 
 use derive_more::{
 	Add,
@@ -289,7 +292,7 @@ impl Percentage {
 	/// Creates a new percentage.
 	///
 	/// # Errors
-	/// Return a [`ValueOutOfBounds`] error if the `percentage > 100`.
+	/// Returns a [`ValueOutOfBounds`] error if the `percentage > 100`.
 	pub const fn new(percentage: u8) -> Result<Self, ValueOutOfBounds<u8>> {
 		match percentage {
 			percentage if percentage <= 100 => Ok(Self(percentage)),
@@ -315,9 +318,113 @@ impl Percentage {
 
 	/// Returns the wrapped percentage value.
 	#[must_use]
-	pub const fn unwrap(self) -> u8 {
+	pub const fn unwrap(&self) -> u8 {
 		self.0
 	}
 }
 
+impl PartialEq<u8> for Percentage {
+	fn eq(&self, other: &u8) -> bool {
+		self.0 == *other
+	}
+}
+
+impl PartialEq<Percentage> for u8 {
+	fn eq(&self, other: &Percentage) -> bool {
+		*self == other.0
+	}
+}
+
+impl PartialOrd<u8> for Percentage {
+	fn partial_cmp(&self, other: &u8) -> Option<Ordering> {
+		self.0.partial_cmp(other)
+	}
+}
+
+impl PartialOrd<Percentage> for u8 {
+	fn partial_cmp(&self, other: &Percentage) -> Option<Ordering> {
+		self.partial_cmp(&other.0)
+	}
+}
+
 impl_xrbk_traits!(Percentage(u8));
+
+/// A value measured as a percentage from -100% to 100%.
+#[derive(Debug, Hash, Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]
+pub struct SignedPercentage(i8);
+
+impl SignedPercentage {
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(i8)) {
+		inspect(self.0);
+	}
+}
+
+impl Display for SignedPercentage {
+	fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
+		write!(f, "{}%", self.0)
+	}
+}
+
+impl SignedPercentage {
+	/// Creates a new signed percentage.
+	///
+	/// # Errors
+	/// Returns a [`ValueOutOfBounds`] error if `percentage < -100` or
+	/// `percentage > 100`.
+	pub const fn new(percentage: i8) -> Result<Self, ValueOutOfBounds<i8>> {
+		match percentage {
+			percentage if percentage >= -100 && percentage <= 100 => Ok(Self(percentage)),
+
+			other => Err(ValueOutOfBounds {
+				min: -100,
+				max: 100,
+				found: other,
+			}),
+		}
+	}
+
+	/// Creates a new signed percentage without ensuring it has the right
+	/// bounds.
+	///
+	/// # Safety
+	/// Callers of this function must ensure that the given percentage satisfies
+	/// the bounds `-100 <= percentage <= 100`. Creating a [`SignedPercentage`]
+	/// with a value less than -100 or greater than 100 is Undefined Behavior.
+	#[must_use]
+	pub const unsafe fn new_unchecked(percentage: i8) -> Self {
+		Self(percentage)
+	}
+
+	/// Returns the wrapped percentage value.
+	#[must_use]
+	pub const fn unwrap(&self) -> i8 {
+		self.0
+	}
+}
+
+impl PartialEq<i8> for SignedPercentage {
+	fn eq(&self, other: &i8) -> bool {
+		self.0 == *other
+	}
+}
+
+impl PartialEq<SignedPercentage> for i8 {
+	fn eq(&self, other: &SignedPercentage) -> bool {
+		*self == other.0
+	}
+}
+
+impl PartialOrd<i8> for SignedPercentage {
+	fn partial_cmp(&self, other: &i8) -> Option<Ordering> {
+		self.0.partial_cmp(other)
+	}
+}
+
+impl PartialOrd<SignedPercentage> for i8 {
+	fn partial_cmp(&self, other: &SignedPercentage) -> Option<Ordering> {
+		self.partial_cmp(&other.0)
+	}
+}
+
+impl_xrbk_traits!(SignedPercentage(i8));
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 6fc04be0..17428df8 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -20,6 +20,7 @@ use std::ops::RangeInclusive;
 use crate::{
 	message::Request,
 	set::KeyboardOptions,
+	unit::SignedPercentage,
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
@@ -1632,4 +1633,48 @@ derive_xrb! {
 	#[doc(alias("GetKeyboardControl"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetKeyboardOptions: Request(103) -> reply::GetKeyboardOptions;
+
+	/// A [request] that rings the bell on the keyboard at the given volume.
+	///
+	/// The given volume is relative to the base [`bell_volume`] of the
+	/// keyboard.
+	///
+	/// The volume at which the bell is rung is decided by (where `base_volume`
+	/// is the configured [`bell_volume`], and `volume` is the volume specified
+	/// in this [request]):
+	/// ```
+	/// # use xrb::unit::SignedPercentage;
+	/// #
+	/// # fn main() -> Result<(), xrb::unit::ValueOutOfBounds<i8>> {
+	/// #     let base_volume = SignedPercentage::new(100)?;
+	/// #     let volume = SignedPercentage::new(50)?;
+	/// #
+	/// let delta =
+	///     ((isize::from(base_volume.unwrap()) * isize::from(volume.unwrap())) / 100) as i8;
+	///
+	/// #     let _ =
+	/// if volume >= 0 {
+	///     SignedPercentage::new(base_volume.unwrap() - delta + volume.unwrap())?
+	/// } else {
+	///     SignedPercentage::new(base_volume.unwrap() + delta)?
+	/// }
+	/// #     ;
+	/// #
+	/// #     Ok(())
+	/// # }
+	/// ```
+	///
+	/// [request]: Request
+	///
+	/// [`bell_volume`]: KeyboardOptions::bell_volume
+	#[doc(alias("Bell"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct RingBell: Request(104, error::Value) {
+		/// The volume at which the bell is rung relative to the base
+		/// [`bell_volume`].
+		///
+		/// [`bell_volume`]: KeyboardOptions::bell_volume
+		#[doc(alias("percent"))]
+		pub volume: SignedPercentage,
+	}
 }

From ca6acf9da4d9fa1cf83c4cce95afebbc9064a44f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 11:32:07 +0000
Subject: [PATCH 139/157] ChangeCursorOptions request, GetCursorOptions request
 + reply

---
 src/x11/reply/input.rs   |  42 ++++++++++-
 src/x11/request/input.rs | 159 ++++++++++++++++++++++++++++++++++++++-
 2 files changed, 197 insertions(+), 4 deletions(-)

diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index 15894087..2bd2e89f 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -23,8 +23,11 @@ use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Reply,
-	unit::{Hz, Ms, Percentage},
-	x11::{request, request::RevertFocus},
+	unit::{Hz, Ms, Percentage, Px},
+	x11::{
+		request,
+		request::{Fraction, RevertFocus},
+	},
 	Coords,
 	FocusWindow,
 	GrabStatus,
@@ -546,4 +549,39 @@ derive_xrb! {
 		#[doc(alias("auto_repeats"))]
 		pub auto_repeat_modes: [u8; 32],
 	}
+
+	/// The [reply] to a [`GetCursorOptions` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetCursorOptions` request]: request::GetCursorOptions
+	#[doc(alias("GetPointerControl", "GetPointerOptions", "GetCursorControl"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetCursorOptions: Reply for request::GetCursorOptions {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// The multiplier applied to the acceleration of the cursor when the
+		/// [`threshold`] is exceeded.
+		///
+		/// [`threshold`]: GetCursorOptions::threshold
+		pub acceleration: Fraction<Px<u16>>,
+		/// The threshold speed which the cursor must exceed for the
+		/// [`acceleration`] multiplier to be applied.
+		///
+		/// [`acceleration`]: GetCursorOptions::acceleration
+		pub threshold: Px<u16>,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 17428df8..9537c9d2 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -12,15 +12,26 @@
 
 extern crate self as xrb;
 
-use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
+use xrbk::{
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadResult,
+	Readable,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use std::ops::RangeInclusive;
+use thiserror::Error;
 
 use crate::{
 	message::Request,
 	set::KeyboardOptions,
-	unit::SignedPercentage,
+	unit::{Px, SignedPercentage},
 	x11::{error, reply},
 	Any,
 	AnyModifierKeyMask,
@@ -1678,3 +1689,147 @@ derive_xrb! {
 		pub volume: SignedPercentage,
 	}
 }
+
+/// Represents a type that may be chosen as its default value.
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum OrDefault<T> {
+	/// The default value is chosen.
+	Default,
+	/// The default value is not chosen.
+	Other(T),
+}
+
+impl ConstantX11Size for OrDefault<Px<u8>> {
+	const X11_SIZE: usize = <Px<i16>>::X11_SIZE;
+}
+
+impl X11Size for OrDefault<Px<u8>> {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Readable for OrDefault<Px<u8>> {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		match buf.get_i16() {
+			default if default == -1 => Ok(Self::Default),
+
+			other => match u8::try_from(other) {
+				Ok(value) => Ok(Self::Other(Px(value))),
+				Err(error) => Err(ReadError::FailedConversion(Box::new(error))),
+			},
+		}
+	}
+}
+
+impl Writable for OrDefault<Px<u8>> {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Default => buf.put_i16(-1),
+			Self::Other(Px(value)) => i16::from(*value).write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+/// A fraction with a numerator and a denominator.
+///
+/// The denominator may not be zero.
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub struct Fraction<T: X11Size + Readable + Writable>(T, T);
+
+impl<T: X11Size + Readable + Writable> Fraction<T> {
+	/// Returns the fraction's numerator.
+	#[must_use]
+	pub const fn numerator(&self) -> &T {
+		&self.0
+	}
+
+	/// Returns the fraction's denominator.
+	#[must_use]
+	pub const fn denominator(&self) -> &T {
+		&self.1
+	}
+
+	/// Returns a pair of the fraction's numerator (first) and denominator
+	/// (second).
+	#[must_use]
+	pub const fn pair(&self) -> (&T, &T) {
+		(&self.0, &self.1)
+	}
+}
+
+/// A denominator of zero was provided to a [`Fraction`].
+#[derive(Error, Debug)]
+#[error("denominator was specified as 0; cannot divide by zero")]
+pub struct DivideByZero;
+
+impl Fraction<OrDefault<Px<u8>>> {
+	/// Creates a new [`Fraction`] with the given `numerator` and `denominator`.
+	///
+	/// # Errors
+	/// A [`DivideByZero`] error is returned if the denominator is zero.
+	pub const fn new(
+		numerator: OrDefault<Px<u8>>, denominator: OrDefault<Px<u8>>,
+	) -> Result<Self, DivideByZero> {
+		match denominator {
+			OrDefault::Other(Px(0)) => Err(DivideByZero),
+			denominator => Ok(Self(numerator, denominator)),
+		}
+	}
+}
+
+impl Fraction<Px<u16>> {
+	/// Creates a new [`Fraction`] with the given `numerator` and `denominator`.
+	///
+	/// # Errors
+	/// A [`DivideByZero`] error is returned if the denominator is zero.
+	pub const fn new(numerator: Px<u16>, denominator: Px<u16>) -> Result<Self, DivideByZero> {
+		match denominator {
+			Px(0) => Err(DivideByZero),
+			denominator => Ok(Self(numerator, denominator)),
+		}
+	}
+}
+
+derive_xrb! {
+	/// A [request] that changes the options configured for the cursor.
+	///
+	/// See also: [`GetCursorOptions`], [`ChangeKeyboardOptions`].
+	///
+	/// [request]: Request
+	#[doc(alias("ChangePointerControl", "ChangePointerOptions", "ChangeCursorControl"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeCursorOptions: Request(105, error::Value) {
+		/// A multiplier applied to the acceleration of the cursor when the
+		/// [`threshold`] is exceeded.
+		///
+		/// [`threshold`]: ChangeCursorOptions::threshold
+		#[doc(alias("acceleration_numerator", "acceleration_denominator"))]
+		pub acceleration: Fraction<OrDefault<Px<u8>>>,
+		/// The threshold speed which the cursor must exceed for the
+		/// [`acceleration`] multiplier to be applied.
+		///
+		/// [`acceleration`]: ChangeCursorOptions::acceleration
+		pub threshold: OrDefault<Px<u8>>,
+
+		// TODO: undocumented in the core protocol
+		pub do_acceleration: bool,
+		// TODO: undocumented in the core protocol
+		pub do_threshold: bool,
+	}
+
+	/// A [request] that gets the current [cursor options].
+	///
+	/// See also: [`ChangeCursorOptions`].
+	///
+	/// [cursor options]: ChangeCursorOptions
+	/// [request]: Request
+	#[doc(alias("GetPointerControl", "GetPointerOptions", "GetCursorControl"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetCursorOptions: Request(106) -> reply::GetCursorOptions;
+}

From 7dc28659a13b15a75d22d98031a0ae5380a9f17f Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 16:15:21 +0000
Subject: [PATCH 140/157] SetScreensaver request, GetScreenSaver request +
 reply

---
 src/unit.rs             |  81 +++++++++++++++++++++-
 src/x11/reply/meta.rs   |  62 ++++++++++++++++-
 src/x11/request/meta.rs | 145 +++++++++++++++++++++++++++++++++++++++-
 3 files changed, 285 insertions(+), 3 deletions(-)

diff --git a/src/unit.rs b/src/unit.rs
index 4d59b9e9..e2c4f1ca 100644
--- a/src/unit.rs
+++ b/src/unit.rs
@@ -24,7 +24,17 @@ use derive_more::{
 };
 use thiserror::Error;
 
-use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
+use xrbk::{
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadResult,
+	Readable,
+	Wrap,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 
 /// An error generated when a value is outside of the required bounds.
 #[derive(Clone, Debug, Hash, PartialEq, Eq, Error)]
@@ -223,6 +233,75 @@ where
 
 impl_xrbk_traits!(Ms<Num>(Num));
 
+/// A value measured in seconds.
+#[derive(
+	Debug,
+	Hash,
+	Copy,
+	Clone,
+	PartialEq,
+	Eq,
+	PartialOrd,
+	Ord,
+	Add,
+	AddAssign,
+	Sub,
+	SubAssign,
+	Mul,
+	MulAssign,
+	Div,
+	DivAssign,
+	Rem,
+	RemAssign,
+	Sum,
+)]
+pub struct Sec<Num>(pub Num);
+
+impl<Num> Sec<Num> {
+	/// Maps a `Sec<Num>` to `Sec<Output>` by applying the provided closure to
+	/// the contained value.
+	pub fn map<Output>(self, map: impl FnOnce(Num) -> Output) -> Sec<Output> {
+		Sec(map(self.0))
+	}
+
+	/// Calls the provided closure with a reference to the contained value.
+	pub fn inspect(&self, inspect: impl FnOnce(&Num)) {
+		inspect(&self.0);
+	}
+}
+
+impl<Num> Display for Sec<Num>
+where
+	Num: Display,
+{
+	fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
+		write!(f, "{} s", self.0)
+	}
+}
+
+impl<Num> Wrap for Sec<Num>
+where
+	Num: Copy + Clone + Readable + Writable + ConstantX11Size + From<Self> + TryFrom<u64>,
+	Self: TryFrom<Num>,
+	u64: From<Num>,
+{
+	type Integer = Num;
+}
+
+impl<Num> From<Num> for Sec<Num> {
+	fn from(num: Num) -> Self {
+		Self(num)
+	}
+}
+
+impl From<Sec<u16>> for u16 {
+	fn from(Sec(num): Sec<u16>) -> Self {
+		num
+	}
+}
+
+impl_xrbk_traits!(Sec<Num>(Num));
+
 /// A value measured in hertz.
 #[derive(
 	Debug,
diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
index 729a8248..7c526ad6 100644
--- a/src/x11/reply/meta.rs
+++ b/src/x11/reply/meta.rs
@@ -20,7 +20,7 @@ use derivative::Derivative;
 use xrbk::pad;
 use xrbk_macro::derive_xrb;
 
-use crate::{message::Reply, x11::request, LengthString8};
+use crate::{message::Reply, unit::Sec, x11::request, LengthString8, Toggle};
 
 derive_xrb! {
 	/// The [reply] to a [`QueryExtension` request].
@@ -99,4 +99,64 @@ derive_xrb! {
 		pub names: Vec<LengthString8>,
 		[_; names => pad(names)],
 	}
+
+	/// The [reply] to a [`GetScreenSaver` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetScreenSaver` request]: request::GetScreenSaver
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetScreenSaver: Reply for request::GetScreenSaver {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the screensaver is enabled and, if so, how long without
+		/// input before it is activated.
+		///
+		/// This is [`Some`] if the screensaver is enabled, and [`None`] if it
+		/// is not.
+		///
+		/// See [`SetScreenSaver::timeout`] for more information.
+		///
+		/// [`SetScreenSaver::timeout`]: request::SetScreenSaver::timeout
+		pub timeout: Option<Sec<u16>>,
+		/// A hint for screensavers with periodic changes as to the interval
+		/// between those changes.
+		///
+		/// If this is [`None`], this hints that no periodic change should be
+		/// made.
+		///
+		/// See [`SetScreenSaver::interval`] for more information.
+		///
+		/// [`SetScreenSaver::interval`]: request::SetScreenSaver::interval
+		pub interval: Option<Sec<u16>>,
+
+		/// Whether it is preferred that displays that support blanking go blank
+		/// when the screensaver is activated.
+		///
+		/// See [`SetScreenSaver::prefer_blanking`] for more information.
+		///
+		/// [`SetScreenSaver::prefer_blanking`]: request::SetScreenSaver::prefer_blanking
+		pub prefer_blanking: Toggle,
+		/// Whether screensavers which generate [`Expose` events] are allowed.
+		///
+		/// See [`SetScreenSaver::allow_expose_events`] for more information.
+		///
+		/// [`SetScreenSaver::allow_expose_events`]: request::SetScreenSaver::allow_expose_events
+		///
+		/// [`Expose` events]: crate::x11::event::Expose
+		pub allow_expose_events: Toggle,
+		[_; ..],
+	}
 }
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index aa5fbe8a..dcad2644 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -12,13 +12,30 @@
 
 extern crate self as xrb;
 
-use xrbk::pad;
+use std::convert::Infallible;
+use xrbk::{
+	pad,
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadError::FailedConversion,
+	ReadResult,
+	Readable,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
+	unit::Sec,
 	x11::{error, reply},
+	KillClientTarget,
 	String8,
+	Toggle,
+	ToggleOrDefault,
 	Window,
 };
 
@@ -159,3 +176,129 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ListExtensions: Request(99) -> reply::ListExtensions;
 }
+
+/// The delay used for `timeout` and `interval` in the
+/// [`SetScreenSaver` request].
+///
+/// [`SetScreenSaver` request]: SetScreenSaver
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub enum Delay {
+	/// The default option is used.
+	Default,
+	/// The option is disabled.
+	Disabled,
+
+	/// The option is enabled after the given delay.
+	Enabled(Sec<u8>),
+}
+
+impl ConstantX11Size for Delay {
+	const X11_SIZE: usize = i16::X11_SIZE;
+}
+
+impl X11Size for Delay {
+	fn x11_size(&self) -> usize {
+		Self::X11_SIZE
+	}
+}
+
+impl Readable for Delay {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		match buf.get_i16() {
+			-1 => Ok(Self::Default),
+			0 => Ok(Self::Disabled),
+
+			other => match u8::try_from(other) {
+				Ok(sec) => Ok(Self::Enabled(Sec(sec))),
+				Err(error) => Err(FailedConversion(Box::new(error))),
+			},
+		}
+	}
+}
+
+impl Writable for Delay {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Default => buf.put_i16(-1),
+			Self::Disabled => buf.put_i16(0),
+
+			Self::Enabled(Sec(sec)) => i16::from(*sec).write_to(buf)?,
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that configures options for the screensaver.
+	///
+	/// The screensaver is enabled if [`timeout`] is
+	/// [`Enabled`](Delay::Enabled). When it is enabled, after [`timeout`]
+	/// seconds without any cursor or keyboard input, the screensaver is
+	/// activated.
+	///
+	/// If [`prefer_blanking`] is [`Enabled`], displays that support blanking
+	/// will go blank when the screensaver is activated.
+	///
+	/// Otherwise, if [`prefer_blanking`] is [`Disabled`] or the display does
+	/// not support blanking and either [`allow_expose_events`] is [`Enabled`]
+	/// or the [screen] can be changed without generating [`Expose` events], the
+	/// [screen] is changed with a server-specific screensaver.
+	///
+	/// Otherwise, if [`prefer_blanking`] is [`Disabled`], the display does
+	/// not support blanking, or [`allow_expose_events`] is [`Disabled`] and the
+	/// [screen] cannot be changed without generating [`Expose` events], no
+	/// screensaver is activated.
+	///
+	/// [screen]: crate::visual::Screen
+	/// [request]: Request
+	///
+	/// [`Enabled`]: ToggleOrDefault::Enabled
+	/// [`Disabled`]: ToggleOrDefault::Disabled
+	///
+	/// [`timeout`]: SetScreenSaver::timeout
+	/// [`prefer_blanking`]: SetScreenSaver::prefer_blanking
+	/// [`allow_expose_events`]: SetScreenSaver::allow_expose_events
+	///
+	/// [`Expose` events]: crate::x11::event::Expose
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct SetScreenSaver: Request(107, error::Value) {
+		/// Whether the screensaver is [`Enabled`] and, if so, how long without
+		/// input before it is activated.
+		///
+		/// [`Enabled`]: Delay::Enabled
+		pub timeout: Delay,
+		/// A hint for screensavers with periodic changes as to the interval
+		/// between those changes.
+		///
+		/// If [`Delay::Disabled`] is specified, this hints that no periodic
+		/// change should be made.
+		pub interval: Delay,
+
+		/// Whether it is preferred that displays that support blanking go blank
+		/// when the screensaver is activated.
+		pub prefer_blanking: ToggleOrDefault,
+		/// Whether screensavers which generate [`Expose` events] are allowed.
+		///
+		/// [`Expose` events]: crate::x11::event::Expose
+		pub allow_expose_events: ToggleOrDefault,
+		[_; 2],
+	}
+
+	/// A [request] that returns the current [screensaver options].
+	///
+	/// See also: [`SetScreenSaver`].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetScreenSaver` reply].
+	///
+	/// [screensaver options]: SetScreenSaver
+	/// [request]: Request
+	///
+	/// [`GetScreenSaver` reply]: reply::GetScreenSaver
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct GetScreenSaver: Request(108) -> reply::GetScreenSaver;
+}

From 09766708951c3cf374e6f929593e5271d128fa14 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 1 Feb 2023 16:17:15 +0000
Subject: [PATCH 141/157] [CI939] applied recommended clippy fixes

---
 src/unit.rs             | 4 ++--
 src/x11/request/meta.rs | 5 +----
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/unit.rs b/src/unit.rs
index e2c4f1ca..6293031f 100644
--- a/src/unit.rs
+++ b/src/unit.rs
@@ -294,8 +294,8 @@ impl<Num> From<Num> for Sec<Num> {
 	}
 }
 
-impl From<Sec<u16>> for u16 {
-	fn from(Sec(num): Sec<u16>) -> Self {
+impl From<Sec<Self>> for u16 {
+	fn from(Sec(num): Sec<Self>) -> Self {
 		num
 	}
 }
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index dcad2644..b1d6f342 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -12,13 +12,12 @@
 
 extern crate self as xrb;
 
-use std::convert::Infallible;
+
 use xrbk::{
 	pad,
 	Buf,
 	BufMut,
 	ConstantX11Size,
-	ReadError,
 	ReadError::FailedConversion,
 	ReadResult,
 	Readable,
@@ -32,9 +31,7 @@ use crate::{
 	message::Request,
 	unit::Sec,
 	x11::{error, reply},
-	KillClientTarget,
 	String8,
-	Toggle,
 	ToggleOrDefault,
 	Window,
 };

From cb90c01099c0cac38867c4f82fe8f27fed8fa9f4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 1 Feb 2023 16:17:16 +0000
Subject: [PATCH 142/157] [CI939] formatted code with rustfmt

---
 src/x11/request/meta.rs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index b1d6f342..0b6801f8 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -12,7 +12,6 @@
 
 extern crate self as xrb;
 
-
 use xrbk::{
 	pad,
 	Buf,

From de058a77ec9640a37419cdcf92001cd2dbeb9479 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 19:43:20 +0000
Subject: [PATCH 143/157] access control requests and replies

- `ChangeHosts` request
- `ListHosts` request
- `ListHosts` reply
- `SetAccessControl` request

Also improved common::Host so that some basic understanding of the given address is enforced.
---
 Cargo.toml                         |   1 +
 src/common.rs                      | 259 ++++++++++++++++++++++++++++-
 src/common/set/graphics_options.rs |   2 +-
 src/x11/reply/meta.rs              |  43 ++++-
 src/x11/request/meta.rs            | 105 ++++++++++++
 5 files changed, 399 insertions(+), 11 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 8f38e224..b55e70f6 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -26,6 +26,7 @@ members = [ "xrbk", "xrbk_macro" ]
 [dependencies]
 xrbk = { path = "./xrbk" } # (de)serialization
 bitflags = "1.3" # bit masks - representations of masks
+array-init = "2.1.0" # easy array initialization
 thiserror = "1" # error handling
 derive_more = "0.99" # derive more useful traits
 xrbk_macro = { path = "./xrbk_macro" } # generation of XRB structures
diff --git a/src/common.rs b/src/common.rs
index 72a6de60..403db20d 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -4,13 +4,29 @@
 
 extern crate self as xrb;
 
+use array_init::array_init;
 use derive_more::{From, Into};
+use thiserror::Error;
 
 pub use atom::Atom;
 pub use mask::*;
 pub use res_id::*;
 pub use wrapper::*;
-use xrbk::{pad, Buf, ConstantX11Size, ReadError, ReadResult, ReadableWithContext, Wrap};
+
+use xrbk::{
+	pad,
+	Buf,
+	BufMut,
+	ConstantX11Size,
+	ReadError,
+	ReadError::FailedConversion,
+	ReadResult,
+	ReadableWithContext,
+	Wrap,
+	Writable,
+	WriteResult,
+	X11Size,
+};
 use xrbk_macro::{derive_xrb, new, unwrap, ConstantX11Size, Readable, Wrap, Writable, X11Size};
 
 use crate::unit::Px;
@@ -552,26 +568,251 @@ pub struct Arc {
 	pub end_angle: i16,
 }
 
+/// The address family of a host.
+///
+/// This is used in [`Host`].
 #[derive(Copy, Clone, Eq, PartialEq, Hash, Debug, X11Size, Readable, Writable)]
 pub enum HostFamily {
-	Internet,
-	Decnet,
+	/// An IPv4 address.
+	///
+	/// See [`HostAddress::Ipv4`] for more information.
+	Ipv4,
+	/// A DECnet address.
+	///
+	/// See [`HostAddress::DecNet`] for more information.
+	DecNet,
+	/// A chaos address.
+	///
+	/// See [`HostAddress::Chaos`] for more information.
 	Chaos,
+	/// A server-specific address interpreted by the X server.
+	///
+	/// See [`HostAddress::ServerInterpreted`] for more information.
 	ServerInterpreted = 5,
-	InternetV6,
+	/// An IPv6 address.
+	///
+	/// See [`HostAddress::Ipv6`] for more information.
+	Ipv6,
+}
+
+/// The string used to create an [`AsciiString`] was not encoded as ASCII.
+#[derive(Error, Debug)]
+#[error("the provided string was not encoded correctly in ASCII format")]
+pub struct NonAsciiEncoding;
+
+/// A string comprised entirely of ASCII bytes.
+///
+/// This is used for [`HostAddress::ServerInterpreted`].
+#[derive(Clone, Debug, Hash, PartialEq, Eq, X11Size, Writable)]
+pub struct AsciiString(Vec<u8>);
+
+impl AsciiString {
+	/// Creates a new `AsciiString` with the given ASCII-encoded bytes.
+	///
+	/// # Errors
+	/// Returns [`NonAsciiEncoding`] if the given `string` is not encoded
+	/// correctly as ASCII.
+	pub fn new(string: Vec<u8>) -> Result<Self, NonAsciiEncoding> {
+		if string.is_ascii() {
+			Ok(Self(string))
+		} else {
+			Err(NonAsciiEncoding)
+		}
+	}
+
+	/// Returns a slice of the string as bytes.
+	#[must_use]
+	pub fn as_bytes(&self) -> &[u8] {
+		&self.0
+	}
+
+	/// Returns the length of the string.
+	#[must_use]
+	pub fn len(&self) -> usize {
+		self.0.len()
+	}
+
+	/// Returns whether the string is empty.
+	#[must_use]
+	pub fn is_empty(&self) -> bool {
+		self.0.is_empty()
+	}
+}
+
+impl ReadableWithContext for AsciiString {
+	type Context = usize;
+
+	fn read_with(buf: &mut impl Buf, length: &usize) -> ReadResult<Self> {
+		Ok(Self(<Vec<u8>>::read_with(buf, length)?))
+	}
+}
+
+/// The address used in a [host].
+///
+/// [host]: Host
+#[derive(Clone, Debug, Hash, PartialEq, Eq)]
+pub enum HostAddress {
+	/// An IPv4 address.
+	Ipv4([u8; 4]),
+	/// A DECnet address.
+	///
+	/// The first byte contains the least significant 8 bits of the node number.
+	///
+	/// The second byte contains the most significant 2 bits of the node number
+	/// in its least significant 2 bits, and the area in the most significant 6
+	/// bits of the byte.
+	DecNet([u8; 2]),
+	/// A chaos address.
+	///
+	/// The first byte is the host number.
+	///
+	/// The second byte is the subnet number.
+	Chaos([u8; 2]),
+	/// An address type interpreted by the X server.
+	ServerInterpreted {
+		/// The type of address.
+		///
+		/// Address types and the syntax for their values are defined elsewhere.
+		address_type: AsciiString,
+		/// The value of the address.
+		///
+		/// Address types and the syntax for their values are defined elsewhere.
+		address_value: AsciiString,
+	},
+	/// An IPv6 address.
+	Ipv6([u8; 16]),
+}
+
+impl HostAddress {
+	/// The [`HostFamily`] associated with this address.
+	#[must_use]
+	pub const fn family(&self) -> HostFamily {
+		match self {
+			Self::Ipv4(..) => HostFamily::Ipv4,
+			Self::DecNet(..) => HostFamily::DecNet,
+			Self::Chaos(..) => HostFamily::Chaos,
+			Self::ServerInterpreted { .. } => HostFamily::ServerInterpreted,
+			Self::Ipv6(..) => HostFamily::Ipv6,
+		}
+	}
+}
+
+impl X11Size for HostAddress {
+	fn x11_size(&self) -> usize {
+		match self {
+			Self::Ipv4(address) => address.x11_size(),
+			Self::DecNet(address) | Self::Chaos(address) => address.x11_size(),
+
+			Self::ServerInterpreted {
+				address_type,
+				address_value,
+			} => {
+				if address_value.is_empty() {
+					address_type.x11_size()
+				} else {
+					address_type.x11_size() + 1 + address_value.x11_size()
+				}
+			},
+
+			Self::Ipv6(address) => address.x11_size(),
+		}
+	}
+}
+
+impl ReadableWithContext for HostAddress {
+	type Context = (HostFamily, usize);
+
+	fn read_with(buf: &mut impl Buf, (family, length): &(HostFamily, usize)) -> ReadResult<Self> {
+		let buf = &mut buf.take(*length);
+
+		match family {
+			HostFamily::Ipv4 => Ok(Self::Ipv4([
+				buf.get_u8(),
+				buf.get_u8(),
+				buf.get_u8(),
+				buf.get_u8(),
+			])),
+			HostFamily::DecNet => Ok(Self::DecNet([buf.get_u8(), buf.get_u8()])),
+			HostFamily::Chaos => Ok(Self::Chaos([buf.get_u8(), buf.get_u8()])),
+
+			HostFamily::ServerInterpreted => {
+				let mut address_type = vec![];
+				let mut address_value = vec![];
+
+				while buf.has_remaining() {
+					match buf.get_u8() {
+						0 => {
+							buf.advance(1);
+							address_value = <Vec<u8>>::read_with(buf, &buf.remaining())?;
+
+							break;
+						},
+
+						byte => address_type.push(byte),
+					}
+				}
+
+				match (
+					AsciiString::new(address_type),
+					AsciiString::new(address_value),
+				) {
+					(Ok(address_type), Ok(address_value)) => Ok(Self::ServerInterpreted {
+						address_type,
+						address_value,
+					}),
+
+					(Err(error), _) | (_, Err(error)) => Err(FailedConversion(Box::new(error))),
+				}
+			},
+
+			HostFamily::Ipv6 => Ok(Self::Ipv6(array_init(|_| buf.get_u8()))),
+		}
+	}
+}
+
+impl Writable for HostAddress {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		match self {
+			Self::Ipv4(address) => address.write_to(buf)?,
+			Self::DecNet(address) | Self::Chaos(address) => address.write_to(buf)?,
+
+			Self::ServerInterpreted {
+				address_type,
+				address_value,
+			} => {
+				address_type.write_to(buf)?;
+
+				if !address_value.is_empty() {
+					buf.put_u8(0);
+					address_value.write_to(buf)?;
+				}
+			},
+
+			Self::Ipv6(address) => address.write_to(buf)?,
+		}
+
+		Ok(())
+	}
 }
 
 derive_xrb! {
+	/// A host, as provided in a [`ChangeHosts` request].
+	///
+	/// [`ChangeHosts` request]: crate::x11::request::ChangeHosts
 	#[derive(Clone, Eq, PartialEq, Hash, Debug, new, X11Size, Readable, Writable)]
 	pub struct Host {
-		pub family: HostFamily,
+		// The `address`' family.
+		let family: HostFamily = address => address.family(),
 		_,
 
+		// The size of `address` in bytes.
 		#[allow(clippy::cast_possible_truncation)]
-		let address_len: u16 = address => address.len() as u16,
-
-		#[context(address_len => *address_len as usize)]
-		pub address: Vec<u8>,
+		let address_size: u16 = address => address.x11_size() as u16,
+		/// The host's address.
+		///
+		/// See [`HostAddress`] for more information.
+		#[context(family, address_size => (*family, *address_size as usize))]
+		pub address: HostAddress,
 		[_; address => pad(address)],
 	}
 }
diff --git a/src/common/set/graphics_options.rs b/src/common/set/graphics_options.rs
index 0f50fca7..78e016a5 100644
--- a/src/common/set/graphics_options.rs
+++ b/src/common/set/graphics_options.rs
@@ -1111,7 +1111,7 @@ impl GraphicsOptions {
 		self.dashes.as_ref().map(|__u8(dashes)| dashes)
 	}
 
-	/// Specified the mode with which [arcs] are drawn in
+	/// Specifies the mode with which [arcs] are drawn in
 	/// [`PolyFillArc` requests].
 	///
 	/// See [`ArcMode`] for more information.
diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
index 7c526ad6..93375a8a 100644
--- a/src/x11/reply/meta.rs
+++ b/src/x11/reply/meta.rs
@@ -20,7 +20,7 @@ use derivative::Derivative;
 use xrbk::pad;
 use xrbk_macro::derive_xrb;
 
-use crate::{message::Reply, unit::Sec, x11::request, LengthString8, Toggle};
+use crate::{message::Reply, unit::Sec, x11::request, Host, LengthString8, Toggle};
 
 derive_xrb! {
 	/// The [reply] to a [`QueryExtension` request].
@@ -159,4 +159,45 @@ derive_xrb! {
 		pub allow_expose_events: Toggle,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`ListHosts` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`ListHosts` request]: request::ListHosts
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct ListHosts: Reply for request::ListHosts {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether access control is [enabled].
+		///
+		/// [enabled]: Toggle::Enabled
+		#[metabyte]
+		pub access_control: Toggle,
+
+		// The length of `hosts`.
+		#[allow(clippy::cast_possible_truncation)]
+		let hosts_len: u16 = hosts => hosts.len() as u16,
+		[_; 22],
+
+		/// The [hosts] that are on the access control list.
+		///
+		/// [hosts]: Host
+		#[context(hosts_len => usize::from(*hosts_len))]
+		pub hosts: Vec<Host>,
+		// Since `Host`s already contain padding, no extra padding needs to be
+		// added at the end here.
+	}
 }
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 0b6801f8..3bd51f09 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -30,7 +30,9 @@ use crate::{
 	message::Request,
 	unit::Sec,
 	x11::{error, reply},
+	Host,
 	String8,
+	Toggle,
 	ToggleOrDefault,
 	Window,
 };
@@ -298,3 +300,106 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct GetScreenSaver: Request(108) -> reply::GetScreenSaver;
 }
+
+request_error! {
+	pub enum ChangeHostsError for ChangeHosts {
+		Access,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that [adds] or [removes] the specified host from the access
+	/// control list.
+	///
+	/// ***Note: the use of the access control list is deprecated: more secure
+	/// forms of authentication, such as those based on shared secrets or public
+	/// key encryption are recommended.***
+	///
+	/// When access control is enabled and a client attempts to establish a
+	/// connection to the X server, the client's host must be in the access
+	/// control list - if it is not, and the client has not been granted
+	/// permission by some other server-specific functionality, the connection
+	/// is refused.
+	///
+	/// To send this [request], your client must be on the same host as the X
+	/// server, or have been granted permission by some other server-specific
+	/// functionality.
+	///
+	/// # Errors
+	/// An [`Access` error] is generated if your client is not on the same host
+	/// as the X server and has not been granted permission to send this
+	/// [request] in some other server-specific way.
+	///
+	/// [request]: Request
+	///
+	/// [adds]: AddOrRemove::Add
+	/// [removes]: AddOrRemove::Remove
+	///
+	/// [`Access` error]: error::Access
+	#[deprecated(note = "more secure forms of authentication are preferred.")]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ChangeHosts: Request(109, ChangeHostsError) {
+		/// Whether the `host` is to be [added] to or [removed] from the access
+		/// control list.
+		///
+		/// [added]: AddOrRemove::Add
+		/// [removed]: AddOrRemove::Remove
+		#[metabyte]
+		pub mode: AddOrRemove,
+
+		/// The [host] which is to be [added] to or [removed] from the access
+		/// control list.
+		///
+		/// [host]: Host
+		///
+		/// [added]: AddOrRemove::Add
+		/// [removed]: AddOrRemove::Remove
+		pub host: Host,
+	}
+
+	/// A [request] that returns whether access control is [enabled] and the
+	/// [hosts] on the access control list.
+	///
+	/// ***Note: the use of the access control list is deprecated: more secure
+	/// forms of authentication, such as those based on shared secrets or public
+	/// key encryption are recommended.***
+	///
+	/// # Replies
+	/// This [request] generates a [`ListHosts` reply].
+	///
+	/// [hosts]: Host
+	/// [enabled]: Toggle::Enabled
+	/// [request]: Request
+	///
+	/// [`ListHosts` reply]: reply::ListHosts
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ListHosts: Request(110) -> reply::ListHosts;
+}
+
+request_error! {
+	pub enum SetAccessControlError for SetAccessControl {
+		Access,
+		Value,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that sets access control to either [enabled] or [disabled].
+	///
+	/// ***Note: the use of the access control list is deprecated: more secure
+	/// forms of authentication, such as those based on shared secrets or public
+	/// key encryption are recommended.***
+	///
+	/// [enabled]: Toggle::Enabled
+	/// [disabled]: Toggle::Disabled
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetAccessControl: Request(111, SetAccessControlError) {
+		/// Whether access control is [enabled] or [disabled].
+		///
+		/// [enabled]: Toggle::Enabled
+		/// [disabled]: Toggle::Disabled
+		#[metabyte]
+		pub mode: Toggle,
+	}
+}

From 8892a454ef2f8d892c84bb3891de5dc82531c772 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 20:31:54 +0000
Subject: [PATCH 144/157] resource retainment requests and types

- `SetRetainResourcesMode` request
- `KillClient` request
- `RetainResourcesMode`

Also updated `common::wrapper::KillClientTarget` accordingly.
---
 src/common/wrapper.rs   |  35 ++++++-----
 src/x11/request/meta.rs | 129 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 150 insertions(+), 14 deletions(-)

diff --git a/src/common/wrapper.rs b/src/common/wrapper.rs
index cbbabfe1..a5760ea7 100644
--- a/src/common/wrapper.rs
+++ b/src/common/wrapper.rs
@@ -425,20 +425,28 @@ impl_writable!(FocusWindow: &self, buf {
 	Ok(())
 }); // }}}
 
-/// The target client(s) of a [`KillClient` request].
+/// The target of a [`KillClient` request].
 ///
-/// [`KillClient` request]: crate::request::KillClient
+/// [`KillClient` request]: crate::x11::request::KillClient
 #[derive(Copy, Clone, Debug, Hash, PartialEq, Eq)]
 pub enum KillClientTarget {
-	/// Kill all clients with [`CloseDownMode::RetainTemporary`].
+	/// Destroy all remaining resources retained from connections that ended
+	/// with [`RetainResourcesMode::RetainTemporarily`].
 	///
-	/// [`CloseDownMode::RetainTemporary`]: crate::CloseDownMode::RetainTemporary
-	// FIXME: correct CloseDownMode link
-	AllTemporarilyRetainedClients,
+	/// [`RetainResourcesMode::RetainTemporarily`]: crate::x11::request::RetainResourcesMode::RetainTemporarily
+	DestroyTemporarilyRetainedResources,
 
-	/// Kill the client which created the resource specified by this resource
-	/// ID.
-	Other(u32),
+	/// Kill the client which created the specified `resource`.
+	///
+	/// If the client's connection has already ended, all remaining retained
+	/// resources created by that client are destroyed (even if the client used
+	/// [`RetainResourcesMode::RetainPermanently`]).
+	///
+	/// [`RetainResourcesMode::RetainPermanently`]: crate::x11::request::RetainResourcesMode::RetainPermanently
+	KillClient {
+		/// The resource whose client is to be killed.
+		resource: u32,
+	},
 }
 
 impl_constant_x11_size!(KillClientTarget { // {{{
@@ -447,16 +455,15 @@ impl_constant_x11_size!(KillClientTarget { // {{{
 
 impl_readable!(KillClientTarget: buf {
 	Ok(match buf.get_u32() {
-		discrim if discrim == 0 => Self::AllTemporarilyRetainedClients,
-
-		val => Self::Other(val),
+		0 => Self::DestroyTemporarilyRetainedResources,
+		resource => Self::KillClient { resource },
 	})
 });
 
 impl_writable!(KillClientTarget: &self, buf {
 	match self {
-		Self::AllTemporarilyRetainedClients => buf.put_u32(0),
-		Self::Other(val) => buf.put_u32(*val),
+		Self::DestroyTemporarilyRetainedResources => buf.put_u32(0),
+		Self::KillClient { resource } => buf.put_u32(*resource),
 	}
 
 	Ok(())
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 3bd51f09..fc973e79 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -31,6 +31,7 @@ use crate::{
 	unit::Sec,
 	x11::{error, reply},
 	Host,
+	KillClientTarget,
 	String8,
 	Toggle,
 	ToggleOrDefault,
@@ -403,3 +404,131 @@ derive_xrb! {
 		pub mode: Toggle,
 	}
 }
+
+/// Defines what happens to a client's resources when its connection ends.
+///
+/// The default mode (i.e. the mode set when a connection is first set up)
+/// is [`Destroy`].
+///
+/// [`Destroy`]: RetainResourcesMode::Destroy
+#[doc(alias("CloseDownMode"))]
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum RetainResourcesMode {
+	/// All of the client's resources are destroyed immediately.
+	///
+	/// Descendents of [windows] created by the client that are
+	/// [chosen to be saved] are reparented as described in the
+	/// [`ChangeSavedWindows` request].
+	///
+	/// Ending a connection with [`RetainResourcesMode::Destroy`] will, if it is
+	/// the only remaining connection to the X server, cause a server reset: the
+	/// X server's state is reset as if it had just been started. That includes
+	/// destroying remaining resources retained due to the end of
+	/// [`RetainResourcesMode::RetainPermanently`] or
+	/// [`RetainResourcesMode::RetainTemporarily`] connections.
+	///
+	/// [windows]: Window
+	/// [chosen to be saved]: ChangeSavedWindows
+	///
+	/// [`ChangeSavedWindows` request]: ChangeSavedWindows
+	Destroy,
+
+	/// All of the client's resources are marked as permanently retained.
+	///
+	/// Ending a connection with [`RetainResourcesMode::RetainPermanently`] will
+	/// not cause the X server to reset.
+	#[doc(alias("RetainPermanent"))]
+	RetainPermanently,
+	/// All of the client's resources are marked as temporarily retained.
+	///
+	/// Ending a connection with [`RetainResourcesMode::RetainPermanently`] will
+	/// not cause the X server to reset.
+	#[doc(alias("RetainTemporary"))]
+	RetainTemporarily,
+}
+
+derive_xrb! {
+	/// A [request] that changes your client's [`RetainResourcesMode`].
+	///
+	/// The default mode (i.e. the mode set when a connection is first set up)
+	/// is [`RetainResourcesMode::Destroy`].
+	///
+	/// See [`RetainResourcesMode`] for more information.
+	///
+	/// [request]: Request
+	#[doc(alias("SetCloseDownMode"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetRetainResourcesMode: Request(112, error::Value) {
+		/// The [`RetainResourcesMode`] set for your client.
+		///
+		/// See [`RetainResourcesMode`] for more information.
+		#[metabyte]
+		pub mode: RetainResourcesMode,
+	}
+
+	/// A [request] that either kills the `target` client or deletes retained
+	/// resources.
+	///
+	/// If [`KillClientTarget::KillClient`] is specified, the client which
+	/// created the given resource is killed if it still has an active
+	/// connection. If its connection has already ended, all resources retained
+	/// by that client (whether with [`RetainResourcesMode::RetainTemporarily`]
+	/// or with [`RetainResourcesMode::RetainPermanently`]) are destroyed.
+	///
+	/// If [`KillClientTarget::DestroyTemporarilyRetainedResources`] is
+	/// specified, all resources of all clients whose connections have ended
+	/// with [`RetainResourcesMode::RetainTemporarily`] are destroyed.
+	///
+	/// [request]: Request
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct KillClient: Request(113, error::Value) {
+		/// The target of this `KillClient` [request].
+		///
+		/// See [`KillClient`] and [`KillClientTarget`] for more information.
+		///
+		/// [request]: Request
+		pub target: KillClientTarget,
+	}
+}
+
+// #[derive(Debug, Hash, PartialEq, Eq)]
+// pub struct NoOp<const UNUSED_UNITS: usize>;
+//
+// impl<const UNUSED_UNITS: usize> Request for NoOp<UNUSED_UNITS> {
+// 	type OtherErrors = Infallible;
+// 	type Reply = ();
+//
+// 	const MAJOR_OPCODE: u8 = 127;
+// 	const MINOR_OPCODE: Option<u16> = None;
+// }
+//
+// impl<const UNUSED_UNITS: usize> ConstantX11Size for NoOp<UNUSED_UNITS> {
+// 	const X11_SIZE: usize = {
+// 		const HEADER: usize = 4;
+//
+// 		HEADER + (UNUSED_UNITS * 4)
+// 	};
+// }
+//
+// impl<const UNUSED_UNITS: usize> X11Size for NoOp<UNUSED_UNITS> {
+// 	fn x11_size(&self) -> usize {
+// 		Self::X11_SIZE
+// 	}
+// }
+//
+// impl<const UNUSED_UNITS: usize> Writable for NoOp<UNUSED_UNITS> {
+// 	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+// 		let buf = &mut buf.limit(self.x11_size());
+//
+// 		Self::MAJOR_OPCODE.write_to(buf)?;
+// 		// Unused metabyte.
+// 		buf.put_u8(0);
+// 		// Message length.
+// 		self.length().write_to(buf)?;
+//
+// 		// Unused bytes.
+// 		buf.put_bytes(0, UNUSED_UNITS * 4);
+//
+// 		Ok(())
+// 	}
+// }

From 64c7dd1cc6ac80009d3162e93032a836c2eceb63 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 20:48:43 +0000
Subject: [PATCH 145/157] NoOp request

---
 src/x11/request/meta.rs | 111 +++++++++++++++++++++++++---------------
 1 file changed, 70 insertions(+), 41 deletions(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index fc973e79..f2a8da64 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -12,6 +12,7 @@
 
 extern crate self as xrb;
 
+use std::convert::Infallible;
 use xrbk::{
 	pad,
 	Buf,
@@ -491,44 +492,72 @@ derive_xrb! {
 	}
 }
 
-// #[derive(Debug, Hash, PartialEq, Eq)]
-// pub struct NoOp<const UNUSED_UNITS: usize>;
-//
-// impl<const UNUSED_UNITS: usize> Request for NoOp<UNUSED_UNITS> {
-// 	type OtherErrors = Infallible;
-// 	type Reply = ();
-//
-// 	const MAJOR_OPCODE: u8 = 127;
-// 	const MINOR_OPCODE: Option<u16> = None;
-// }
-//
-// impl<const UNUSED_UNITS: usize> ConstantX11Size for NoOp<UNUSED_UNITS> {
-// 	const X11_SIZE: usize = {
-// 		const HEADER: usize = 4;
-//
-// 		HEADER + (UNUSED_UNITS * 4)
-// 	};
-// }
-//
-// impl<const UNUSED_UNITS: usize> X11Size for NoOp<UNUSED_UNITS> {
-// 	fn x11_size(&self) -> usize {
-// 		Self::X11_SIZE
-// 	}
-// }
-//
-// impl<const UNUSED_UNITS: usize> Writable for NoOp<UNUSED_UNITS> {
-// 	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
-// 		let buf = &mut buf.limit(self.x11_size());
-//
-// 		Self::MAJOR_OPCODE.write_to(buf)?;
-// 		// Unused metabyte.
-// 		buf.put_u8(0);
-// 		// Message length.
-// 		self.length().write_to(buf)?;
-//
-// 		// Unused bytes.
-// 		buf.put_bytes(0, UNUSED_UNITS * 4);
-//
-// 		Ok(())
-// 	}
-// }
+/// A [request] that has no effect.
+///
+/// The use of this [request] comes with padding: `4 + (4 * UNUSED_UNITS)` bytes
+/// are sent.
+///
+/// This can be used by X libraries which find it convenient to force
+/// [requests][request] to be aligned to 8 bytes.
+///
+/// [request]: Request
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct NoOp {
+	/// The number of unused 4-byte units to add to the [request] after the
+	/// initial 4-byte header.
+	pub unused_units: u16,
+}
+
+impl Request for NoOp {
+	type OtherErrors = Infallible;
+	type Reply = ();
+
+	const MAJOR_OPCODE: u8 = 127;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl X11Size for NoOp {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 4;
+		const ALIGNMENT: usize = 4;
+
+		HEADER + (usize::from(self.unused_units) * ALIGNMENT)
+	}
+}
+
+impl Readable for NoOp {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self> {
+		const ALIGNMENT: usize = 4;
+
+		// Unused metabyte.
+		buf.advance(1);
+
+		// One unit is subtracted for the header.
+		let unused_units = buf.get_u16() - 1;
+
+		let buf = &mut buf.take(usize::from(unused_units) * ALIGNMENT);
+		// Unused bytes.
+		buf.advance(buf.remaining());
+
+		Ok(Self { unused_units })
+	}
+}
+
+impl Writable for NoOp {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		const ALIGNMENT: usize = 4;
+
+		let buf = &mut buf.limit(self.x11_size());
+
+		Self::MAJOR_OPCODE.write_to(buf)?;
+		// Unused metabyte.
+		buf.put_u8(0);
+		// Message length.
+		self.length().write_to(buf)?;
+
+		// Unused bytes.
+		buf.put_bytes(0, usize::from(self.unused_units) * ALIGNMENT);
+
+		Ok(())
+	}
+}

From ea89dc2b008bbcf8e2be5f98782813975bc489bf Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 21:01:06 +0000
Subject: [PATCH 146/157] ForceScreenSaver request

---
 src/x11/request/meta.rs | 58 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 53 insertions(+), 5 deletions(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index f2a8da64..27eb48b9 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -25,7 +25,7 @@ use xrbk::{
 	WriteResult,
 	X11Size,
 };
-use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
+use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,
@@ -375,7 +375,7 @@ derive_xrb! {
 	/// [request]: Request
 	///
 	/// [`ListHosts` reply]: reply::ListHosts
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct ListHosts: Request(110) -> reply::ListHosts;
 }
 
@@ -395,7 +395,7 @@ derive_xrb! {
 	///
 	/// [enabled]: Toggle::Enabled
 	/// [disabled]: Toggle::Disabled
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct SetAccessControl: Request(111, SetAccessControlError) {
 		/// Whether access control is [enabled] or [disabled].
 		///
@@ -458,7 +458,7 @@ derive_xrb! {
 	///
 	/// [request]: Request
 	#[doc(alias("SetCloseDownMode"))]
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct SetRetainResourcesMode: Request(112, error::Value) {
 		/// The [`RetainResourcesMode`] set for your client.
 		///
@@ -481,7 +481,7 @@ derive_xrb! {
 	/// with [`RetainResourcesMode::RetainTemporarily`] are destroyed.
 	///
 	/// [request]: Request
-	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct KillClient: Request(113, error::Value) {
 		/// The target of this `KillClient` [request].
 		///
@@ -492,6 +492,54 @@ derive_xrb! {
 	}
 }
 
+/// Whether a [`ForceScreenSaver` request] [resets the activation timer] or
+/// [activates the screensaver]
+///
+/// [resets the activation timer]: ForceScreenSaverMode::Reset
+/// [activates the screensaver]: ForceScreenSaverMode::Activate
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum ForceScreenSaverMode {
+	/// If the screensaver is currently [enabled], the activation timer (i.e.
+	/// the time left before its activation) is reset and, if the screensaver is
+	/// active, the screensaver is deactivated.
+	///
+	/// [enabled]: ToggleOrDefault::Enabled
+	Reset,
+
+	/// If the screensaver is not currently active, it is forcibly activated.
+	///
+	/// The screensaver is activated even if [`timeout`] is [`Disabled`].
+	///
+	/// [`timeout`]: SetScreenSaver::timeout
+	/// [`Disabled`]: ToggleOrDefault::Disabled
+	Activate,
+}
+
+derive_xrb! {
+	/// A [request] that either
+	/// [resets the timer until the screensaver is activated][reset], or
+	/// [forcibly activates the screensaver][activate].
+	///
+	/// See [`ForceScreenSaverMode`] for more information.
+	///
+	/// [request]: Request
+	///
+	/// [reset]: ForceScreenSaverMode::Reset
+	/// [activate]: ForceScreenSaverMode::Activate
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct ForceScreenSaver: Request(115, error::Value) {
+		/// Whether the screensaver's [activation timer is reset] or the
+		/// screensaver is [forcibly activated].
+		///
+		/// See [`ForceScreenSaverMode`] for more information.
+		///
+		/// [activation timer is reset]: ForceScreenSaverMode::Reset
+		/// [forcibly activated]: ForceScreenSaverMode::Activate
+		#[metabyte]
+		pub mode: ForceScreenSaverMode,
+	}
+}
+
 /// A [request] that has no effect.
 ///
 /// The use of this [request] comes with padding: `4 + (4 * UNUSED_UNITS)` bytes

From 087b3510162040d035925bb9d3247e38b4dbb517 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 1 Feb 2023 21:03:03 +0000
Subject: [PATCH 147/157] [CI947] applied recommended clippy fixes

---
 src/x11/request/meta.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 27eb48b9..3fce7e51 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -25,7 +25,7 @@ use xrbk::{
 	WriteResult,
 	X11Size,
 };
-use xrbk_macro::{derive_xrb, ConstantX11Size, Readable, Writable, X11Size};
+use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
 use crate::{
 	message::Request,

From e4f583d285d1fbb2220823812b6c2ec4376b52fc Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 21:23:44 +0000
Subject: [PATCH 148/157] rename ListHosts to QueryAccessControl

---
 src/x11/reply/meta.rs   |  7 ++++---
 src/x11/request/meta.rs | 11 ++++++++---
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/x11/reply/meta.rs b/src/x11/reply/meta.rs
index 93375a8a..debc6a08 100644
--- a/src/x11/reply/meta.rs
+++ b/src/x11/reply/meta.rs
@@ -160,14 +160,15 @@ derive_xrb! {
 		[_; ..],
 	}
 
-	/// The [reply] to a [`ListHosts` request].
+	/// The [reply] to a [`QueryAccessControl` request].
 	///
 	/// [reply]: Reply
 	///
-	/// [`ListHosts` request]: request::ListHosts
+	/// [`QueryAccessControl` request]: request::QueryAccessControl
+	#[doc(alias("ListHosts"))]
 	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
-	pub struct ListHosts: Reply for request::ListHosts {
+	pub struct QueryAccessControl: Reply for request::QueryAccessControl {
 		/// The sequence number identifying the [request] that generated this
 		/// [reply].
 		///
diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 3fce7e51..30fd0785 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -368,15 +368,17 @@ derive_xrb! {
 	/// key encryption are recommended.***
 	///
 	/// # Replies
-	/// This [request] generates a [`ListHosts` reply].
+	/// This [request] generates a [`QueryAccessControl` reply].
 	///
 	/// [hosts]: Host
 	/// [enabled]: Toggle::Enabled
 	/// [request]: Request
 	///
-	/// [`ListHosts` reply]: reply::ListHosts
+	/// [`QueryAccessControl` reply]: reply::QueryAccessControl
+	#[doc(alias("ListHosts"))]
+	#[deprecated(note = "more secure forms of authentication are preferred.")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
-	pub struct ListHosts: Request(110) -> reply::ListHosts;
+	pub struct QueryAccessControl: Request(110) -> reply::QueryAccessControl;
 }
 
 request_error! {
@@ -393,8 +395,11 @@ derive_xrb! {
 	/// forms of authentication, such as those based on shared secrets or public
 	/// key encryption are recommended.***
 	///
+	/// [request]: Request
+	///
 	/// [enabled]: Toggle::Enabled
 	/// [disabled]: Toggle::Disabled
+	#[deprecated(note = "more secure forms of authentication are preferred.")]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
 	pub struct SetAccessControl: Request(111, SetAccessControlError) {
 		/// Whether access control is [enabled] or [disabled].

From e6f271e8318e778f3fdcc61c9d5b1a55ab17f235 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Wed, 1 Feb 2023 21:41:47 +0000
Subject: [PATCH 149/157] Update src/x11/request/input.rs

---
 src/x11/request/input.rs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 9537c9d2..75b9a57b 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -1381,8 +1381,6 @@ pub struct ChangeKeyboardMapping<const KEYSYMS_PER_KEYCODE: usize> {
 	/// Keycode::new(previous_keycode.unwrap() + 1)
 	/// # ;
 	/// ```
-	/// Each array (after the first one) is the mapping for the [keycode] one
-	/// greater than the [keycode] of the array before it.
 	///
 	/// [`Keysym::NO_SYMBOL`] should be used to fill in unused [keysym]
 	/// mappings. [`Keysym::NO_SYMBOL`] may appear anywhere in the mappings -

From 123673e5cbba18dae2b0eff2f3420582f39f451c Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 07:03:35 +0000
Subject: [PATCH 150/157] Update src/x11/request/meta.rs

---
 src/x11/request/meta.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 30fd0785..59dc9ecf 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -447,7 +447,7 @@ pub enum RetainResourcesMode {
 	RetainPermanently,
 	/// All of the client's resources are marked as temporarily retained.
 	///
-	/// Ending a connection with [`RetainResourcesMode::RetainPermanently`] will
+	/// Ending a connection with [`RetainResourcesMode::RetainTemporarily`] will
 	/// not cause the X server to reset.
 	#[doc(alias("RetainTemporary"))]
 	RetainTemporarily,

From ffa8223291f56a05d214c7f86965d92b5afc7a35 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 07:03:49 +0000
Subject: [PATCH 151/157] Update src/x11/request/meta.rs

---
 src/x11/request/meta.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/meta.rs b/src/x11/request/meta.rs
index 59dc9ecf..9ff22f58 100644
--- a/src/x11/request/meta.rs
+++ b/src/x11/request/meta.rs
@@ -547,7 +547,7 @@ derive_xrb! {
 
 /// A [request] that has no effect.
 ///
-/// The use of this [request] comes with padding: `4 + (4 * UNUSED_UNITS)` bytes
+/// The use of this [request] comes with padding: `4 + (4 * unused_units)` bytes
 /// are sent.
 ///
 /// This can be used by X libraries which find it convenient to force

From 0bff6c13eee1c27e7460cefb0d1528469b2ee9e0 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 07:04:07 +0000
Subject: [PATCH 152/157] Update xrbk/src/lib.rs

---
 xrbk/src/lib.rs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/xrbk/src/lib.rs b/xrbk/src/lib.rs
index b36ced29..f15df198 100644
--- a/xrbk/src/lib.rs
+++ b/xrbk/src/lib.rs
@@ -34,6 +34,7 @@ use std::{
 };
 
 pub use bytes::{Buf, BufMut};
+
 use thiserror::Error;
 
 /// Determines the number of unused bytes required to be inserted after the

From 5ab0b12e575703b4e567c7cf12f4b7a736114540 Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 10:10:29 +0000
Subject: [PATCH 153/157] RotateProperties request

---
 src/x11/request/miscellaneous.rs | 105 +++++++++++++++++++++++++++++++
 1 file changed, 105 insertions(+)

diff --git a/src/x11/request/miscellaneous.rs b/src/x11/request/miscellaneous.rs
index 1e70240c..076870c0 100644
--- a/src/x11/request/miscellaneous.rs
+++ b/src/x11/request/miscellaneous.rs
@@ -855,3 +855,108 @@ derive_xrb! {
 		pub event: E,
 	}
 }
+
+request_error! {
+	pub enum RotatePropertiesError for RotateProperties {
+		Atom,
+		Match,
+		Window,
+	}
+}
+
+derive_xrb! {
+	/// A [request] that rotates the given `properties` within a [window]'s list
+	/// of properties.
+	///
+	/// The given properties are swapped with one another within the list of the
+	/// [window]'s properties by the given `shift`. Properties moved beyond the
+	/// start or end of the list wrap around to the beginning, as if the list of
+	/// properties were a ring.
+	///
+	/// To put it another way, the property at index `i` in the given
+	/// `properties` is moved to the position (within the `target` [window]'s
+	/// list of properties) of the property at index
+	/// `(i + shift) % properties.len()` in the given `properties` list.
+	///
+	/// Note that properties of the `target` [window] not listed in `properties`
+	/// are not affected.
+	///
+	/// No properties are affected if a [`Window`], [`Atom`], or [`Match`] error
+	/// is generated as a result of this [request].
+	///
+	/// # Events generated
+	/// If the properties are actually rotated (that is, if
+	/// `shift % properties.len() != 0`), a [`Property` event] is generated for
+	/// each property in `properties`.
+	///
+	/// # Errors
+	/// A [`Window` error] is generated if `target` does not refer to a defined
+	/// [window].
+	///
+	/// An [`Atom` error] is generated if any properties in the given
+	/// `properties` do not refer to defined [atoms].
+	///
+	/// A [`Match` error] is generated if a property occurs more than once in
+	/// `properties`.
+	///
+	/// A [`Match` error] is generated if no property by a name given in
+	/// `properties` exists on the `target` [window].
+	///
+	/// [window]: Window
+	/// [atoms]: Atom
+	/// [request]: Request
+	///
+	/// [`Property` event]: crate::x11::event::Property
+	///
+	/// [`Window`]: error::Window
+	/// [`Atom`]: error::Atom
+	/// [`Match`]: error::Match
+	/// [`Window` error]: error::Window
+	/// [`Atom` error]: error::Atom
+	/// [`Match` error]: error::Match
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable, ConstantX11Size)]
+	pub struct RotateProperties: Request(114, RotatePropertiesError) {
+		/// The [window] for which the given `properties` are rotated.
+		///
+		/// # Errors
+		/// A [`Window` error] is generated if this does not refer to a defined
+		/// [window].
+		///
+		/// [window]: Window
+		///
+		/// [`Window` error]: error::Window
+		#[doc(alias("window"))]
+		pub target: Window,
+
+		// The length of `properties`.
+		#[allow(clippy::cast_possible_truncation)]
+		let properties_len: u16 = properties => properties.len() as u16,
+
+		/// The offset which is applied to the index of each property in
+		/// `properties` to determine where it should be moved.
+		///
+		/// See [`RotateProperties`] for more information.
+		#[doc(alias("delta"))]
+		pub shift: i16,
+
+		/// The properties which are to be rotated.
+		///
+		/// # Errors
+		/// An [`Atom` error] is generated if a property in this list does not
+		/// refer to a defined [atom].
+		///
+		/// A [`Match` error] is generated if a property occurs multiple times
+		/// in this list.
+		///
+		/// A [`Match` error] is generated if a property in this list does not
+		/// exist on the `target` [window].
+		///
+		/// [window]: Window
+		/// [atom]: Atom
+		///
+		/// [`Atom` error]: error::Atom
+		/// [`Match` error]: error::Match
+		#[context(properties_len => usize::from(*properties_len))]
+		pub properties: Vec<Atom>,
+	}
+}

From 424140345d79f009e1f4916744487bc3fbfb0bda Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 16:53:03 +0000
Subject: [PATCH 154/157] SetButtonMapping request + reply

---
 src/x11/event.rs         |  2 +-
 src/x11/reply/input.rs   | 55 ++++++++++++++++++++++++++++++++++++++++
 src/x11/request/input.rs | 53 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 109 insertions(+), 1 deletion(-)

diff --git a/src/x11/event.rs b/src/x11/event.rs
index 5d05ae16..b5130dc6 100644
--- a/src/x11/event.rs
+++ b/src/x11/event.rs
@@ -2428,7 +2428,7 @@ derive_xrb! {
 	/// [event]: Event
 	/// [`SetModifierMapping`]: super::request::SetModifierMapping
 	/// [`ChangeKeyboardMapping`]: super::request::ChangeKeyboardMapping
-	/// [`SetCursorMapping`]: super::request::SetCursorMapping
+	/// [`SetCursorMapping`]: super::request::SetButtonMapping
 	#[derive(Debug, Derivative, X11Size, Readable, Writable)]
 	#[derivative(Hash, PartialEq, Eq)]
 	pub struct MappingChange: Event(34) {
diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index 2bd2e89f..6f80e3e1 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -585,3 +585,58 @@ derive_xrb! {
 		[_; ..],
 	}
 }
+
+/// Whether a [`SetButtonMapping` request] was successful.
+///
+/// This is used in the [`SetButtonMapping` reply].
+///
+/// [`SetButtonMapping` request]: request::SetButtonMapping
+/// [`SetButtonMapping` reply]: SetButtonMapping
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum SetButtonMappingStatus {
+	/// The [`SetButtonMapping` request] was successful.
+	///
+	/// [`SetButtonMapping` request]: request::SetButtonMapping
+	Success,
+
+	/// The [`SetButtonMapping` request] was unsuccessful because it specified
+	/// buttons which are currently held.
+	///
+	/// The mapping of mouse buttons cannot be changed while they are held.
+	///
+	/// [`SetButtonMapping` request]: request::SetButtonMapping
+	Busy,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`SetButtonMapping` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`SetButtonMapping` request]: request::SetButtonMapping
+	#[doc(alias("SetPointerMapping", "SetCursorMapping"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct SetButtonMapping: Reply for request::SetButtonMapping {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the [`SetButtonMapping` request] was successful.
+		///
+		/// See [`SetButtonMappingStatus`] for more information.
+		///
+		/// [`SetButtonMapping` request]: request::SetButtonMapping
+		pub status: SetButtonMappingStatus,
+		[_; ..],
+	}
+}
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 75b9a57b..0c13698e 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -13,6 +13,7 @@
 extern crate self as xrb;
 
 use xrbk::{
+	pad,
 	Buf,
 	BufMut,
 	ConstantX11Size,
@@ -1830,4 +1831,56 @@ derive_xrb! {
 	#[doc(alias("GetPointerControl", "GetPointerOptions", "GetCursorControl"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetCursorOptions: Request(106) -> reply::GetCursorOptions;
+
+	/// A [request] that changes the mapping of the [mouse buttons].
+	///
+	/// # Events generated
+	/// A [`MappingChange` event] is generated if the change in button mapping
+	/// is [successful].
+	///
+	/// # Replies
+	/// This [request] generates a [`SetButtonMapping` reply].
+	///
+	/// # Errors
+	/// A [`Value` error] is generated if the length of `map` is not the same as
+	/// the length returned in a [`GetButtonMapping` reply].
+	///
+	/// [mouse buttons]: Button
+	/// [request]: Request
+	///
+	/// [successful]: reply::SetButtonMappingStatus::Success
+	///
+	/// [`SetButtonMapping` reply]: reply::SetButtonMapping
+	/// [`GetButtonMapping` reply]: reply::GetButtonMapping
+	///
+	/// [`MappingChange` event]: crate::x11::event::MappingChange
+	///
+	/// [`Value` error]: error::Value
+	#[doc(alias("SetPointerMapping", "SetCursorMapping"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct SetButtonMapping: Request(116, error::Value) -> reply::SetButtonMapping {
+		#[metabyte]
+		#[allow(clippy::cast_possible_truncation)]
+		let map_len: u8 = map => map.len() as u8,
+
+		/// The mapping of the [mouse buttons].
+		///
+		/// [`None`] means the mouse button at that particular index, counting
+		/// from 1, is disabled. [`Some`] means it is remapped to the given
+		/// other [button].
+		///
+		/// [mouse buttons]: Button
+		/// [button]: Button
+		///
+		/// # Errors
+		/// A [`Value` error] is generated if this is not the same length as the
+		/// [button] mapping returned in the [`GetButtonMapping` reply].
+		///
+		/// [`GetButtonMapping` reply]: reply::GetButtonMapping
+		///
+		/// [`Value` error]: error::Value
+		#[context(map_len => usize::from(*map_len))]
+		pub map: Vec<Option<Button>>,
+		[_; map => pad(map)],
+	}
 }

From da53a5337af2d7b9e676478289f4fcb3082e1b1b Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Thu, 2 Feb 2023 20:52:29 +0000
Subject: [PATCH 155/157] GetButtonMapping request + reply

---
 src/common.rs            |  6 +++++
 src/x11/reply/input.rs   | 42 ++++++++++++++++++++++++++++++
 src/x11/request/input.rs | 56 ++++++++++++++++++++++++++++++----------
 3 files changed, 91 insertions(+), 13 deletions(-)

diff --git a/src/common.rs b/src/common.rs
index 403db20d..8d6ecaf7 100644
--- a/src/common.rs
+++ b/src/common.rs
@@ -314,6 +314,12 @@ impl Keycode {
 )]
 pub struct Button(pub(crate) u8);
 
+impl Button {
+	pub const PRIMARY: Self = Self::new(1);
+	pub const MIDDLE: Self = Self::new(2);
+	pub const SECONDARY: Self = Self::new(3);
+}
+
 #[derive(
 	Copy,
 	Clone,
diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index 6f80e3e1..886366ec 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -28,6 +28,7 @@ use crate::{
 		request,
 		request::{Fraction, RevertFocus},
 	},
+	Button,
 	Coords,
 	FocusWindow,
 	GrabStatus,
@@ -639,4 +640,45 @@ derive_xrb! {
 		pub status: SetButtonMappingStatus,
 		[_; ..],
 	}
+
+	/// The [reply] to a [`GetButtonMapping` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`GetButtonMapping` request]: request::GetButtonMapping
+	#[doc(alias("GetPointerMapping", "GetCursorMapping"))]
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct GetButtonMapping: Reply for request::GetButtonMapping {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		// The length of `mappings`.
+		#[metabyte]
+		#[allow(clippy::cast_possible_truncation)]
+		let mappings_len: u8 = mappings => mappings.len() as u8,
+		[_; 24],
+
+		/// The mapping of the [mouse buttons].
+		///
+		/// [`None`] means the [mouse button] at that particular position,
+		/// starting with position 1 (at index 0), is disabled. [`Some`] means
+		/// it is remapped to the given other [button].
+		///
+		/// [mouse buttons]: Button
+		/// [mouse button]: Button
+		/// [button]: Button
+		#[context(mappings_len => usize::from(*mappings_len))]
+		pub mappings: Vec<Option<Button>>,
+	}
 }
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 0c13698e..17693e7a 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -1834,6 +1834,11 @@ derive_xrb! {
 
 	/// A [request] that changes the mapping of the [mouse buttons].
 	///
+	/// This request changes the mapping from the physical [mouse buttons] to
+	/// virtual [mouse buttons]. For example, [mouse buttons] 1 and 3 could be
+	/// swapped by specifying a [button] of value `3` in [button] 1's position
+	/// and a [button] of value `1` in [button] 3's position.
+	///
 	/// # Events generated
 	/// A [`MappingChange` event] is generated if the change in button mapping
 	/// is [successful].
@@ -1842,8 +1847,12 @@ derive_xrb! {
 	/// This [request] generates a [`SetButtonMapping` reply].
 	///
 	/// # Errors
-	/// A [`Value` error] is generated if the length of `map` is not the same as
-	/// the length returned in a [`GetButtonMapping` reply].
+	/// A [`Value` error] is generated if the length of `mappings` is not the
+	/// same as the length returned in a [`GetButtonMapping` reply].
+	///
+	/// A [`Value` error] is generated if multiple physical mouse buttons are
+	/// mapped to the same virtual mouse button; that is, if the same [button]
+	/// occurs multiple times in the `mappings`.
 	///
 	/// [mouse buttons]: Button
 	/// [request]: Request
@@ -1859,28 +1868,49 @@ derive_xrb! {
 	#[doc(alias("SetPointerMapping", "SetCursorMapping"))]
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct SetButtonMapping: Request(116, error::Value) -> reply::SetButtonMapping {
+		// The length of `mappings`.
 		#[metabyte]
 		#[allow(clippy::cast_possible_truncation)]
-		let map_len: u8 = map => map.len() as u8,
+		let mappings_len: u8 = mappings => mappings.len() as u8,
 
 		/// The mapping of the [mouse buttons].
 		///
-		/// [`None`] means the mouse button at that particular index, counting
-		/// from 1, is disabled. [`Some`] means it is remapped to the given
-		/// other [button].
-		///
-		/// [mouse buttons]: Button
-		/// [button]: Button
+		/// [`None`] means the [mouse button] at that particular position,
+		/// starting at 1, is disabled. [`Some`] means it is remapped to the
+		/// given other [button].
 		///
 		/// # Errors
 		/// A [`Value` error] is generated if this is not the same length as the
-		/// [button] mapping returned in the [`GetButtonMapping` reply].
+		/// [button] mappings returned in the [`GetButtonMapping` reply].
+		///
+		/// A [`Value` error] is generated if multiple physical [mouse buttons]
+		/// are mapped to the same virtual mouse button; that is, if the same
+		/// [button] is specified multiple times.
+		///
+		/// [mouse button]: Button
+		/// [mouse buttons]: Button
+		/// [button]: Button
 		///
 		/// [`GetButtonMapping` reply]: reply::GetButtonMapping
 		///
 		/// [`Value` error]: error::Value
-		#[context(map_len => usize::from(*map_len))]
-		pub map: Vec<Option<Button>>,
-		[_; map => pad(map)],
+		#[context(mappings_len => usize::from(*mappings_len))]
+		pub mappings: Vec<Option<Button>>,
+		[_; mappings => pad(mappings)],
 	}
+
+	/// A [request] that gets the current mapping of the [mouse buttons].
+	///
+	/// See also: [`SetButtonMapping`].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetButtonMapping` reply].
+	///
+	/// [mouse buttons]: Button
+	/// [request]: Request
+	///
+	/// [`GetButtonMapping` reply]: reply::GetButtonMapping
+	#[doc(alias("GetPointerMapping", "GetCursorMapping"))]
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetButtonMapping: Request(117) -> reply::GetButtonMapping;
 }

From 59977d8310dd1ebca923e3334b14581e6acfc25c Mon Sep 17 00:00:00 2001
From: Antikyth <104020300+Antikyth@users.noreply.github.com>
Date: Fri, 3 Feb 2023 17:03:51 +0000
Subject: [PATCH 156/157] SetModifierMapping request + reply,
 GetModifierMapping request + reply

120 out of 120 requests!
---
 src/x11/reply/input.rs   | 225 ++++++++++++++++++++++++++++++++++++++-
 src/x11/request/input.rs | 217 +++++++++++++++++++++++++++++++++++++
 2 files changed, 439 insertions(+), 3 deletions(-)

diff --git a/src/x11/reply/input.rs b/src/x11/reply/input.rs
index 886366ec..4701b594 100644
--- a/src/x11/reply/input.rs
+++ b/src/x11/reply/input.rs
@@ -16,6 +16,7 @@
 
 extern crate self as xrb;
 
+use array_init::array_init;
 use derivative::Derivative;
 use xrbk::{Buf, BufMut, ConstantX11Size, ReadResult, Readable, Writable, WriteResult, X11Size};
 
@@ -32,6 +33,7 @@ use crate::{
 	Coords,
 	FocusWindow,
 	GrabStatus,
+	Keycode,
 	Keysym,
 	ModifierMask,
 	Timestamp,
@@ -337,7 +339,7 @@ derive_xrb! {
 /// The [keysyms] mapped to a particular [keycode].
 ///
 /// [keysyms]: Keysym
-/// [keycode]: crate::Keycode
+/// [keycode]: Keycode
 pub type KeyMapping = Vec<Keysym>;
 
 /// The [reply] to a [`GetKeyboardMapping` request].
@@ -362,7 +364,7 @@ pub struct GetKeyboardMapping {
 
 	/// The mapping of [keysyms] for each [keycode] in the specified `range`.
 	///
-	/// [keycode]: crate::Keycode
+	/// [keycode]: Keycode
 	/// [keysyms]: Keysym
 	pub mappings: Vec<KeyMapping>,
 }
@@ -543,7 +545,7 @@ derive_xrb! {
 		///
 		/// See [`KeyboardOptions::auto_repeat_mode`] for more information.
 		///
-		/// [keycodes]: crate::Keycode
+		/// [keycodes]: Keycode
 		/// [auto repeat mode]: crate::set::KeyboardOptions::auto_repeat_mode
 		///
 		/// [`KeyboardOptions::auto_repeat_mode`]: crate::set::KeyboardOptions::auto_repeat_mode
@@ -682,3 +684,220 @@ derive_xrb! {
 		pub mappings: Vec<Option<Button>>,
 	}
 }
+
+/// Whether a [`SetModifierMapping` request] was [successful].
+///
+/// This is used in the [`SetModifierMapping` reply].
+///
+/// [successful]: SetModifierMappingStatus::Success
+///
+/// [`SetModifierMapping` request]: request::SetModifierMapping
+/// [`SetModifierMapping` reply]: SetModifierMapping
+#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+pub enum SetModifierMappingStatus {
+	/// The [`SetModifierMapping` request] was successful.
+	///
+	/// [`SetModifierMapping` request]: request::SetModifierMapping
+	Success,
+
+	/// The [`SetModifierMapping` request] failed because either the currently
+	/// mapped modifier keys or specified new modifier keys are currently held.
+	///
+	/// A [`SetModifierMapping` request] cannot be applied unless both the
+	/// currently mapped modifier keys and the keys which are specified to be
+	/// the new modifier keys are not held.
+	///
+	/// [`SetModifierMapping` request]: request::SetModifierMapping
+	Busy,
+	/// The [`SetModifierMapping` request] failed because the X server rejected
+	/// it.
+	///
+	/// The X server rejects a [`SetModifierMapping` request] if it has placed
+	/// some additional bounds on the modifiers which it is enforcing. For
+	/// example, this could be because multiple keys per modifier are not
+	/// supported or because auto-repeat cannot be disabled for certain keys.
+	///
+	/// [`SetModifierMapping` request]: request::SetModifierMapping
+	Rejected,
+}
+
+derive_xrb! {
+	/// The [reply] to a [`SetModifierMapping` request].
+	///
+	/// [reply]: Reply
+	///
+	/// [`SetModifierMapping` request]: request::SetModifierMapping
+	#[derive(Derivative, Debug, X11Size, Readable, Writable)]
+	#[derivative(Hash, PartialEq, Eq)]
+	pub struct SetModifierMapping: Reply for request::SetModifierMapping {
+		/// The sequence number identifying the [request] that generated this
+		/// [reply].
+		///
+		/// See [`Reply::sequence`] for more information.
+		///
+		/// [request]: crate::message::Request
+		/// [reply]: Reply
+		///
+		/// [`Reply::sequence`]: Reply::sequence
+		#[sequence]
+		#[derivative(Hash = "ignore", PartialEq = "ignore")]
+		pub sequence: u16,
+
+		/// Whether the [`SetModifierMapping` request] was [successful].
+		///
+		/// See [`SetModifierMappingStatus`] for more information.
+		///
+		/// [successful]: SetModifierMappingStatus::Success
+		///
+		/// [`SetModifierMapping` request]: request::SetModifierMapping
+		#[metabyte]
+		pub status: SetModifierMappingStatus,
+
+		[_; 24],
+	}
+}
+
+/// The [reply] to a [`GetModifierMapping` request].
+///
+/// [reply]: Reply
+///
+/// [`GetModifierMapping` request]: request::GetModifierMapping
+#[derive(Derivative, Debug)]
+#[derivative(Hash, PartialEq, Eq)]
+pub struct GetModifierMapping {
+	/// The sequence number identifying the [request] that generated this
+	/// [reply].
+	///
+	/// See [`Reply::sequence`] for more information.
+	///
+	/// [request]: crate::message::Request
+	/// [reply]: Reply
+	///
+	/// [`Reply::sequence`]: Reply::sequence
+	#[derivative(Hash = "ignore", PartialEq = "ignore")]
+	pub sequence: u16,
+
+	/// The [keycodes] mapped to the shift modifier.
+	///
+	/// [keycodes]: Keycode
+	pub shift_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the caps lock modifier.
+	///
+	/// [keycodes]: Keycode
+	pub capslock_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the control modifier.
+	///
+	/// [keycodes]: Keycode
+	pub ctrl_keycodes: Vec<Keycode>,
+
+	/// The [keycodes] mapped to the Mod1 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod1_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod2 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod2_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod3 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod3_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod4 modifier.
+	///
+	/// This is typically the key variously called 'super', 'meta', 'windows
+	/// key', 'cmd', etc.
+	///
+	/// [keycodes]: Keycode
+	pub mod4_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod5 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod5_keycodes: Vec<Keycode>,
+}
+
+impl GetModifierMapping {
+	fn max_keycodes_len(&self) -> usize {
+		[
+			&self.shift_keycodes,
+			&self.capslock_keycodes,
+			&self.ctrl_keycodes,
+			&self.mod1_keycodes,
+			&self.mod2_keycodes,
+			&self.mod3_keycodes,
+			&self.mod4_keycodes,
+			&self.mod5_keycodes,
+		]
+		.into_iter()
+		.map(Vec::len)
+		.max()
+		.expect("there's definitely more than one element")
+	}
+}
+
+impl Reply for GetModifierMapping {
+	type Request = request::GetModifierMapping;
+
+	fn sequence(&self) -> u16 {
+		self.sequence
+	}
+}
+
+impl X11Size for GetModifierMapping {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 8;
+		const CONSTANT_SIZES: usize = HEADER + 24;
+
+		let keycodes_size = self.max_keycodes_len() * Keycode::X11_SIZE;
+
+		CONSTANT_SIZES + (8 * keycodes_size)
+	}
+}
+
+impl Readable for GetModifierMapping {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		const HEADER: usize = 8;
+		const ALIGNMENT: usize = 4;
+
+		// FIXME: the first 4 bytes of the header should be read separately, with the
+		// metabyte        position and sequence being given as context. That applies to
+		// all replies.
+		buf.advance(1);
+
+		let keycodes_per_modifier = buf.get_u8();
+		let sequence = buf.get_u16();
+
+		let total_size = ((buf.get_u32() as usize) * ALIGNMENT) - HEADER;
+		let buf = &mut buf.take(total_size);
+
+		let [shift_keycodes, capslock_keycodes, ctrl_keycodes, mod1_keycodes, mod2_keycodes, mod3_keycodes, mod4_keycodes, mod5_keycodes] =
+			array_init(|_| {
+				let mut keycodes = vec![];
+
+				for _ in 0..keycodes_per_modifier {
+					match buf.get_u8() {
+						0 => {},
+						code => keycodes.push(Keycode(code)),
+					}
+				}
+
+				keycodes
+			});
+
+		Ok(Self {
+			sequence,
+
+			shift_keycodes,
+			capslock_keycodes,
+			ctrl_keycodes,
+
+			mod1_keycodes,
+			mod2_keycodes,
+			mod3_keycodes,
+			mod4_keycodes,
+			mod5_keycodes,
+		})
+	}
+}
diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 17693e7a..2f7bcb27 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -26,6 +26,7 @@ use xrbk::{
 };
 use xrbk_macro::{derive_xrb, Readable, Writable, X11Size};
 
+use array_init::array_init;
 use std::ops::RangeInclusive;
 use thiserror::Error;
 
@@ -1914,3 +1915,219 @@ derive_xrb! {
 	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
 	pub struct GetButtonMapping: Request(117) -> reply::GetButtonMapping;
 }
+
+/// A [request] that sets the mapping of [keycodes] for each modifier.
+///
+/// Each modifier has zero or more [keycodes] mapped to it. For example, the
+/// shift modifier typically has both <kbd>⇧ Left Shift</kbd> and
+/// <kbd>⇧ Right Shift</kbd> keycodes mapped to it, while the caps lock modifier
+/// only has one <kbd>Caps Lock</kbd> key mapped to it.
+///
+/// If no [keycodes] are mapped to a modifier, that modifier is disabled.
+///
+/// See also: [`GetModifierMapping`].
+///
+/// # Events generated
+/// A [`MappingChange` event] is generated if this [request] is [successful] in
+/// changing the modifier mapping.
+///
+/// # Replies
+/// This [request] generates a [`SetModifierMapping` reply].
+///
+/// # Errors
+/// A [`Value` error] is generated if any of the specified [keycodes] are either
+/// less than the [`min_keycode`] or greater than the [`max_keycode`] returned
+/// during [connection setup].
+///
+/// [keycodes]: Keycode
+/// [request]: Request
+/// [connection setup]: crate::connection::InitConnection
+///
+/// [successful]: reply::SetModifierMappingStatus::Success
+///
+/// [`min_keycode`]: crate::connection::ConnectionSuccess::min_keycode
+/// [`max_keycode`]: crate::connection::ConnectionSuccess::max_keycode
+///
+/// [`SetModifierMapping` request]: SetModifierMapping
+/// [`SetModifierMapping` reply]: reply::SetModifierMapping
+///
+/// [`MappingChange` event]: crate::x11::event::MappingChange
+///
+/// [`Value` error]: error::Value
+#[derive(Debug, Hash, PartialEq, Eq)]
+pub struct SetModifierMapping {
+	/// The [keycodes] mapped to the shift modifier.
+	///
+	/// [keycodes]: Keycode
+	pub shift_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the caps lock modifier.
+	///
+	/// [keycodes]: Keycode
+	pub capslock_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the control modifier.
+	///
+	/// [keycodes]: Keycode
+	pub ctrl_keycodes: Vec<Keycode>,
+
+	/// The [keycodes] mapped to the Mod1 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod1_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod2 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod2_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod3 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod3_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod4 modifier.
+	///
+	/// This is typically the key variously called 'super', 'meta', 'windows
+	/// key', 'cmd', etc.
+	/// 
+	/// [keycodes]: Keycode
+	pub mod4_keycodes: Vec<Keycode>,
+	/// The [keycodes] mapped to the Mod5 modifier.
+	///
+	/// [keycodes]: Keycode
+	pub mod5_keycodes: Vec<Keycode>,
+}
+
+impl SetModifierMapping {
+	fn max_keycodes_len(&self) -> usize {
+		[
+			&self.shift_keycodes,
+			&self.capslock_keycodes,
+			&self.ctrl_keycodes,
+			&self.mod1_keycodes,
+			&self.mod2_keycodes,
+			&self.mod3_keycodes,
+			&self.mod4_keycodes,
+			&self.mod5_keycodes,
+		]
+		.into_iter()
+		.map(Vec::len)
+		.max()
+		.expect("there's definitely more than one element")
+	}
+}
+
+impl Request for SetModifierMapping {
+	type OtherErrors = error::Value;
+	type Reply = reply::SetModifierMapping;
+
+	const MAJOR_OPCODE: u8 = 118;
+	const MINOR_OPCODE: Option<u16> = None;
+}
+
+impl X11Size for SetModifierMapping {
+	fn x11_size(&self) -> usize {
+		const HEADER: usize = 4;
+
+		let keycodes_size = self.max_keycodes_len() * Keycode::X11_SIZE;
+
+		HEADER + (8 * keycodes_size)
+	}
+}
+
+impl Readable for SetModifierMapping {
+	fn read_from(buf: &mut impl Buf) -> ReadResult<Self>
+	where
+		Self: Sized,
+	{
+		const ALIGNMENT: usize = 4;
+
+		let keycodes_per_modifier = buf.get_u8();
+
+		let total_size = usize::from(buf.get_u16()) * ALIGNMENT;
+		let buf = &mut buf.take(total_size);
+
+		let [shift_keycodes, capslock_keycodes, ctrl_keycodes, mod1_keycodes, mod2_keycodes, mod3_keycodes, mod4_keycodes, mod5_keycodes] =
+			array_init(|_| {
+				let mut keycodes = vec![];
+
+				for _ in 0..keycodes_per_modifier {
+					match buf.get_u8() {
+						0 => {},
+						code => keycodes.push(Keycode(code)),
+					}
+				}
+
+				keycodes
+			});
+
+		Ok(Self {
+			shift_keycodes,
+			capslock_keycodes,
+			ctrl_keycodes,
+
+			mod1_keycodes,
+			mod2_keycodes,
+			mod3_keycodes,
+			mod4_keycodes,
+			mod5_keycodes,
+		})
+	}
+}
+
+impl Writable for SetModifierMapping {
+	fn write_to(&self, buf: &mut impl BufMut) -> WriteResult {
+		const HEADER: usize = 4;
+
+		let max_keycodes_len = self.max_keycodes_len();
+		let keycodes_size = max_keycodes_len * Keycode::X11_SIZE;
+
+		let buf = &mut buf.limit(HEADER + (8 * keycodes_size));
+
+		// For each keycodes field, we want to make sure that they are written
+		// as the same length as the longest list. Fortunately, that is easy to
+		// do, because (a) the order of each list does not matter, and (b) a `0`
+		// means that position is simply ignored, so we can just fill the
+		// remaining positions with `0`s.
+
+		for field in [
+			&self.shift_keycodes,
+			&self.capslock_keycodes,
+			&self.ctrl_keycodes,
+			&self.mod1_keycodes,
+			&self.mod2_keycodes,
+			&self.mod3_keycodes,
+			&self.mod4_keycodes,
+			&self.mod5_keycodes,
+		] {
+			for index in 0..max_keycodes_len {
+				match field.get(index) {
+					Some(Keycode(code)) => buf.put_u8(*code),
+					None => buf.put_u8(0),
+				}
+			}
+		}
+
+		Ok(())
+	}
+}
+
+derive_xrb! {
+	/// A [request] that returns the [keycodes] currently mapped to each
+	/// modifier.
+	///
+	/// Each modifier has zero or more [keycodes] mapped to it. For example, the
+	/// shift modifier typically has both <kbd>⇧ Left Shift</kbd> and
+	/// <kbd>⇧ Right Shift</kbd> keycodes mapped to it, while the caps lock
+	/// modifier only has one <kbd>Caps Lock</kbd> key mapped to it.
+	///
+	/// If no [keycodes] are mapped to a modifier, that modifier is disabled.
+	///
+	/// See also: [`SetModifierMapping`].
+	///
+	/// # Replies
+	/// This [request] generates a [`GetModifierMapping` reply].
+	///
+	/// [keycodes]: Keycode
+	/// [request]: Request
+	///
+	/// [`GetModifierMapping` reply]: reply::GetModifierMapping
+	#[derive(Debug, Hash, PartialEq, Eq, X11Size, Readable, Writable)]
+	pub struct GetModifierMapping: Request(119) -> reply::GetModifierMapping;
+}

From 045a2d55326b9b2078c3ae40f7e45c77e0720257 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 3 Feb 2023 17:09:25 +0000
Subject: [PATCH 157/157] [CI965] formatted code with rustfmt

---
 src/x11/request/input.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/x11/request/input.rs b/src/x11/request/input.rs
index 2f7bcb27..efb6f949 100644
--- a/src/x11/request/input.rs
+++ b/src/x11/request/input.rs
@@ -1985,7 +1985,7 @@ pub struct SetModifierMapping {
 	///
 	/// This is typically the key variously called 'super', 'meta', 'windows
 	/// key', 'cmd', etc.
-	/// 
+	///
 	/// [keycodes]: Keycode
 	pub mod4_keycodes: Vec<Keycode>,
 	/// The [keycodes] mapped to the Mod5 modifier.