commit 9c5a3857480649bf34ac3a62c347b39c5e0a7b55
from: Brett Fisher <code@brettfisher.xyz>
date: Thu May 21 03:04:18 2026 UTC

bxwm.1: Initial commit.

commit - a7d2cff745b166b8ddb00ac663596cf46516b1b1
commit + 9c5a3857480649bf34ac3a62c347b39c5e0a7b55
blob - /dev/null
blob + 764a2127fe4d1a1c6bb944b24a8d8ce2dad4a087 (mode 644)
--- /dev/null
+++ bxwm.1
@@ -0,0 +1,57 @@
+.Dd May 20, 2026
+.Dt BXWM 1
+.Os
+.Sh NAME
+.Nm bxwm
+.Nd basic X window manager
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+is a stacking window manager for the X11 window system that provides a basic, opinionated set of window positions and sizes, as well as multiple workspaces. The window manager handles window mapping, focusing, and placement, and delegates key command handling to 
+.Xr bxhkd 1 .
+.Sh OPERATION
+.Nm
+manages windows in the following manner:
+.Bl -tag -width indent
+.It Sy Window Placement
+New windows are automatically centered and resized according to an opinionated
+golden ratio. Focus is managed via a stack-based model; when a new window is 
+mapped, it is placed at the top of the stack and receives focus.
+.It Sy Stacking and Focus
+Window focus follows a vertical stack order. The user can cycle focus through 
+the stack, which brings the selected window to the top.
+.It Sy Workspaces
+.Nm
+provides multiple workspaces to organize windows. Windows can be moved 
+between workspaces, and focus remains persistent within the active workspace.
+.It Sy Interoperability
+.Nm
+follows basic ICCCM and EWMH standards to ensure integration with other tools.
+.El
+.Sh CONFIGURATION
+.Nm
+is configured at compile-time by modifying the 
+.Pa config.def.h 
+header file. 
+After modifying this file, 
+.Nm
+must be recompiled and reinstalled to apply changes.
+This approach ensures minimal runtime memory overhead and adheres to the
+.Nm
+philosophy of simplicity in design.
+.Sh FILES
+.Bl -tag -width ".Pa ~/.local/tmp/bxwm.log" -compact
+.It Pa config.def.h
+The default configuration file (see CONFIGURATION).
+.It Pa ~/.local/var/log/bxwm.log
+The log file for runtime diagnostics of 
+.Nm .
+.El
+.Sh SEE ALSO
+.Xr bxhkd 1 ,
+.Xr xinit 1
+.Sh AUTHOR
+.Nm
+was developed 
+.An "Brett Fisher <code@brettfisher.xyz>."