released at 0.0.5

.github/FUNDING.yml

@@ -1,6 +1,6 @@
 # These are supported funding model platforms
 
-github: # Replace with a single Patreon username
+github: mcpcpc
 patreon: # Replace with a single Patreon username
 open_collective: # Replace with a single Open Collective username
 ko_fi: # Replace with a single Ko-fi username

CHANGELOG

@@ -33,3 +33,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 - Crash when pointer x/y cords less than window origin.
+
+## [0.0.5] - 20202-11-11
+### Added
+- Default key bindings in man page.
+- Disclaimer section in README.

README

@@ -19,8 +19,8 @@ libxcb, along with any default or user defined utility:
 COMMANDS
 ========
 
-The following aliased commands have been implemented (although most of the
-default behaviors can be customized via the config.h file):
+The following aliased commands have been implemented (although most
+of the default behaviors can be customized via the config.h file):
 
     Win+Button1+[drag]     interactive window move
     Win+Button3+[drag]     interactive window resize
@@ -73,6 +73,13 @@ Using imagemagick to set a wallpaper:
 Patching xwm (after copying the *.patch into the source dir.):
     patch -p0 < mypatch.patch
 
+DISCLAIMER
+==========
+
+xwm ("XCB Window Manager") is an homage to the original "X Window
+Manager", which is now defunct and unmaintained. Both projects
+are unaffiliated and do not share any common source code.
+
 CONTACT
 =======
 

xwm.1

@@ -1,27 +1,67 @@
-.\" Manpage for xwm.
+.\"Manpage for xwm.
 .TH XWM 1 "NOVEMBER 2020" Linux "User Manuals"
 .SH NAME
 xwm \- a tiny XCB floating window managers
 .SH SYNOPSIS
 .B xwm [-v]
 .SH DESCRIPTION
 .B xwm
-is a tiny floating window manager implemented using 
-the XCB protocol. Other than 
+is a tiny floating window manager implemented using
+the XCB protocol. Other than
 .BR libxcb (1),
-xwm also specifies third-party utilitiies for command 
-alias, including the 
+xwm relies on third-party tools, which can be
+configured or expanded to meet the user's preference.
+The default configuration provides support and
+command aliases for the
 .BR surf (1)
 web browser,
 .BR st (1)
 terminal emulator and
 .BR dmenu (1)
-application launcher. Defaults for these command 
-aliases can be configured or patched to the user's
-preference.
+application launcher.
 .SH OPTIONS
 .IP -v
 Prints the current xwm version.
+.SH DEFAULT KEY BINDINGS
+.B xwm
+may be controlled from an attached client using a key
+combination of a prefix key, the 'Super' (Win) key by
+default, followed by a command key.
+.PP
+The default command key bindings are:
+.TS
+tab(;);
+lb l l.
+_
+Super-MouseButton1;[drag];T{
+Interactive window move.
+T}
+_
+Super-MouseButton3;[drag];T{
+Interactive window resize.
+T}
+_
+Super;Space;T{
+Run launcher menu (default: dmenu_run).
+T}
+_
+Super;Enter;T{
+Create new terminal window (default: st).
+T}
+_
+Super;b;T{
+Create new browser window (default: surf).
+T}
+_
+Super;q;T{
+Kill focused window.
+T}
+_
+Super-Shift;q;T{
+Quite window manager.
+T}
+_
+.TE
 .SH BUGS
 No known bugs.
 .SH AUTHOR

xwm.c

@@ -221,7 +221,7 @@ static int strcmp_c(char * str1, char * str2) {
 int main(int argc, char * argv[]) {
     int ret = 0;
     if ((argc == 2) && (strcmp_c("-v", argv[1]) == 0)) {
-        ret = die("xwm-0.0.4, © 2020 Michael Czigler, see LICENSE for details\n");
+        ret = die("xwm-0.0.5, © 2020 Michael Czigler, see LICENSE for details\n");
     }
     if ((ret == 0) && (argc != 1)) {
         ret = die("usage: xwm [-v]\n");

xwm.h

@@ -45,6 +45,7 @@ static handler_func_t handler_funs[] = {
 };
 
 /* intialize */
+static void subscribeToEvents(void);
 static void grabKeys(void);
 static void grabButtons(void);