crcbl-shell 0.8.0

Crucible windowing shell: own Wayland, X11, Web/canvas and headless backends
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! The generated protocol layer.
//!
//! Produced by `crcbl-wl-scanner` from the XML in
//! `crates/crcbl-shell/wayland-protocols/`; see `build.rs`. The file is
//! `include!`d rather than checked in so that a protocol update is a one-file
//! change with no chance of the committed Rust drifting from the XML it claims
//! to come from.
//!
//! Layout of what lands here:
//!
//! ```text
//! protocol::wayland::wl_surface::{INTERFACE, REQ_COMMIT, commit, Event, decode_event}
//! protocol::xdg_shell::xdg_toplevel::{INTERFACE, set_title, state::FULLSCREEN, …}
//! ```
//!
//! Every request wrapper is `unsafe` and marshals through
//! [`ffi::marshal`](super::ffi::marshal); every event decoder is `unsafe` and
//! borrows from libwayland's closure storage for the duration of the dispatch
//! call. See `crcbl-wl-scanner`'s docs for the shape and the tests that pin the
//! signature strings and type tables.

// The generator emits every interface in every vendored XML, which is what
// makes P0.5b's `wl_seat` and P0.5c's `wl_data_device` free. Most of it is
// unused in this slice by design, and `wl_shm`/`wl_shell` will stay unused
// forever — the engine presents through Vulkan, not through shared memory.
#![allow(dead_code)]
// Event variants are upstream's names, which the generator does not rename:
// `zwp_tablet_seat_v2`'s are `tablet_added`, `tool_added` and `pad_added`.
// `expect` rather than `allow`, so dropping the tablet XML says so here.
#![expect(
    clippy::enum_variant_names,
    reason = "generated from upstream protocol XML"
)]

include!(concat!(env!("OUT_DIR"), "/wayland_protocol.rs"));