Debian Codegraph @

README

raw
1 This is a port of OpenBSD's excellent cwm[0] to Linux and other Unices.
2
3 cwm is a window manager for X11 which contains many features that
4 concentrate on the efficiency and transparency of window
5 management. cwm also aims to maintain the simplest and most
6 pleasant aesthetic.
7
8 This port requires pkg-config, Xft, Xinerama and Xrandr. The included Makefile
9 should work with both GNU make and BSD make. It has been built successfully on
10 OpenBSD, FreeBSD, NetBSD, OS X 10.9 and Linux.
11
12 This version actively tracks changes in the OpenBSD CVS repository.
13 Releases are roughly coordinated.
14
15 The revision controlled version is at https://github.com/leahneukirchen/cwm
16 Releases can be found at http://leahneukirchen.org/releases
17
18 You are welcome to join the IRC channel ##cwm on irc.libera.chat
19 to talk about cwm.
20
21
22 ChangeLog:
23
24 2012-05-02: First public release 5.1 of portable cwm.
25
26 2014-04-13: Second public release 5.5 of portable cwm.
27
28 User visible changes (for a full list including smaller bug fixes, see
29 http://www.openbsd.org/plus.html ff.)
30
31 Changes made between OpenBSD 5.1 and 5.2
32 * Fixed cwm(1) atom (WM_PROTOCOLS) style handing; closing a window will no
33 longer close entire application if the client supports CLIENT_PROTO_DELETE.
34 * Re-implement atom handing for more consistent separation of cwm(1) and
35 Extended Window Manager Hints.
36 * cwm(1) better integrated into the freedesktop.org Window Manager
37 Specification Project.
38
39 Changes made between OpenBSD 5.2 and 5.3
40 * Set the initial cwm(1) group to "1".
41 * Added cwm(1) per-group vert/horiz tiling support with new bind commands
42 "vtile" and "htile."
43 * Made cwm(1) screen font an Xft(3) font.
44 * Specific last match for autogroup in cwmrc(5).
45 * Tab completion support for cwm(1) menus.
46 * Allow cwm(1) clients to be resized from a max state.
47 * Multibyte input to cwm(1) menu code now possible.
48
49 Changes made between OpenBSD 5.3 and 5.4
50 * Added support for mouse based group {,r}cycle to cwmrc(5).
51 * Allow mouse button4 and button5 in cwmrc(5).
52 * Made cwm(1) check for, and honour, CWStackMode and CWSibling change requests
53 during a ConfigureRequest event.
54 * Honour PATH search order for cwm(1)'s exec.
55
56 Changes made between OpenBSD 5.5 and 5.4
57 * Only set the cwm(1) urgency flag if the client is not active.
58 * Allow the cwm(1) config parser continue parsing even after encountering an
59 error.
60 * cwm(1) now follows the EWMH spec: if the cardinal returned is 0xFFFFFFFF (-1)
61 then the window should appear on all desktops.
62 * Made cwm(1) supply a more useful title for windows launched via the ssh(1)
63 command menu ("[ssh] ").
64 * Allowed cwm(1) to accept _NET_WM_DESKTOP and _NET_CURRENT_DESKTOP
65 ClientMessage.
66 * Implemented cwm(1) support for _NET_WM_STATE_FULLSCREEN hint, with keybinding
67 changes: CM-f "fullscreen", CM-m "maximize".
68 * Instead of using the work area, use the Xinerama area for cwm(1) snap
69 calculations.
70 * Save-set when cwm(1) is re-exec'ing so as to not lose State on our hidden
71 clients.
72 * Added cwmrc(5) support for XUrgency and matching
73 _NET_WM_STATE_DEMANDS_ATTENTION ewmh hint, with configurable urgencyborder.
74 * Prepend the group shortcut in the cwm(1) client search menu;
75 prepend shortcut in unhide menu.
76 * If not hidden during an UnmapNotify event, cwm(1) will now un-manage the
77 client.
78 * Like "gap", made cwm(1) "snapdist" per-screen.
79 * Removed cwmrc(5) option to bind a key by keycode with brackets, which never
80 worked. Users should be using keysym names not keycodes.
81 * Re-added cwm(1) support for WM_TAKE_FOCUS. Solves keyboard input focus loss
82 for java apps.
83 * For cwm(1) clients that support WM_TAKE_FOCUS in their WM_PROTOCOLS property,
84 send a ClientMessage event.
85
86 2015-01-24: Third public release 5.6 of portable cwm.
87
88 * Support building on FreeBSD and OS X.
89 * Support for sticky windows (_NET_WM_STATE_STICKY).
90 * Internal cleanups and bug fixes.
91
92 Changes made between OpenBSD 5.6 and 5.7
93 * Implemented _NET_WM_STATE_STICKY in cwm(1). Allows client to "stick"
94 to all desktops or groups.
95 * Ensure cwm(1) client that wants to be in nogroup stays in nogroup
96 (thus stays in view), even when (re)reading NET_WM_DESKTOP.
97
98 Changes made between OpenBSD 5.7 and 5.8
99 * In cwm(1), introduce "groupsearch" for group menu search.
100 * In cwm(1), show an empty "ssh to" menu if the known_hosts file is missing.
101 * In cwm(1), replace screen region info gathering with XRandR
102 equivalent of Xinerama queries.
103
104 Changes made between OpenBSD 5.8 and 5.9
105 * Don't allow freeze operations on fullscreen.
106 * Implement _NET_CLIENT_LIST_STACKING.
107
108 2017-10-17: Fourth public release 6.2 of portable cwm.
109
110 Changes made between OpenBSD 6.2 and 6.3
111 * Fix blocking bug during moving or resizing.
112 * window-snap-* commands to move windows to edges and corners.
113 * Add support for _NET_WM_STATE_SKIP_PAGER and _NET_WM_STATE_SKIP_TASKBAR.
114 * Add support for re-exec'ing with SIGHUP.
115
116 2018-05-14: Fifth public release 6.3 of portable cwm.
117
118 2020-01-04: Sixth public release 6.6 of portable cwm.
119
120 Changes made between OpenBSD 6.4 and 6.5
121 * Added a configtest flag (-n) to cwm(1).
122 * Introduced 'group-close-[n]' action to cwm(1) to close all windows
123 within a specified group.
124
125 2020-05-22: Seventh public release 6.7 of portable cwm.
126
127 Changes made between OpenBSD 6.6 and 6.7
128 * Allowed cwm(1) configuration of window size based on percentage of
129 the master window during horizontal and vertical tiling actions.
130 * Allowed use of window-htile and window-vtile with the "empty" group
131 clients in cwm(1).
132
133 2022-04-30: Eighth public release 7.1 of portable cwm.
134
135 Changes made between OpenBSD 6.9 and 7.0
136 * Changed cwm(1) maximization and full-screen mode toggling to keep
137 the cursor within the window, preventing focus loss.
138
139 Changes made between OpenBSD 7.0 and 7.1
140 * Added a cwm(1) "group-last" command that shows only the previously
141 active group.
142 * Allowed bare numbers for key and mouse bindings in cwm(1).
143
144 2023-10-20: Ninth public release 7.4 of portable cwm.
145
146 Changes made between OpenBSD 7.3 and 7.4:
147 * Allow cwm(1) to cycle through windows of the same window class as
148 the active window, default key binding to M-grave, respectively
149 Alt-Tilde, like with other window managers.
150
151 2026-05-19: Tenth public release 7.9 of portable cwm.
152
153 Changes made between OpenBSD 7.6 and 7.7:
154 * Grab the pointer against the root window instead of the client we're
155 attempting to move and/or resize; prevents XNextEvent() from
156 blocking on a client that might have been moved to a Withdrawn
157 state.
158
159 Changes made between OpenBSD 7.7 and 7.8:
160 * Add cwmrc(5) window-snap-center function.
161
162 Changes made between OpenBSD 7.8 and 7.9:
163 * Have cwm(1) handle Meta release as a separate mod key.
164
165 --Leah Neukirchen <[email protected]>
166
167 [0]: http://cvsweb.openbsd.org/cgi-bin/cvsweb/xenocara/app/cwm/