| 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/ |