Reflowed keystroke section of README to 75 wide, mostly for the github UI.

1 files changed, 122 insertions, 47 deletions

diff --git a/README b/README
index 4854746..32996c2 100644
--- a/README
+++ b/README
@@ -2,56 +2,131 @@
 
 Built-ins:
 
-  Mod1-RClick           Focus the clicked window, but suppress raising
-  Mod1-RClick-drag      Focus the clicked window, suppress raising, resizing the window from its nearest corner until drag completes
-  Mod1-LClick           Focus and raise the clicked window
-  Mod1-LClick-drag      Focus and raise the clicked window, moving the window until the drag completes
-* Mod1-l                Switch to virtual desktop to the right (if exists)
-* Mod1-h                Switch to virtual desktop to the left (if exists)
-  Mod1-j                Lower focused window, if the focused window is in "allscreen" mode it will simply be fullscreened first without lowering
-  Mod1-k [-k [-k]       Raise focused window [a second k raises and fullscreens the window [a third k raises and "allscreens" without a visible border
-          [-k] [-k]]    [a fourth k raises and fullscreens across all heads [a fifth k raises and "allscreens" across all heads]]]
-  Mod1-Shift-k          Shelve focused window and switch to the shelf context
-  Mod1-Shift-j          Migrate the focused window from the shelf to the last focused virtual desktop, switch to that virtual desktop, and focus the migrated window
-* Mod1-Shift-l          Migrate the focused window to the virtual desktop to the right (if exists), keeping the window focused
-* Mod1-Shift-h          Migrate the focused window to the virtual desktop to the left (if exists), keeping the window focused
-  Mod1-v                Create a new virtual desktop and switch to it
-  Mod1-Shift-v          Create a new virtual desktop, move the focused window to it, and switch to it
-* Mod1-Space            Switch to the most recently used virtual desktop (like Mod1-Tab but for virtual desktops)
-* Mod1-Shift-Space      Switch to the most recently used virtual desktop, bringing the focused window with
-  Mod1-`                Alternate between shelf (if populated) and virtual desktop contexts
-  Mod1-s                Shelve the focused window without switching to the shelf, adopting the newly shelved window as the focused window within the shelf
-* Mod1-Tab              Focus and raise the next window in the current context (shelf or virtual desktop), the focused window is not 'committed' as the MRU window
-                        until Mod1 is released, so you may peruse intermediate windows without affecting the order until releasing Mod1.  In multihead configurations
-			the next window selection is confined to the current screen.
-  Mod1-Shift-Tab	Identical to Mod1-Tab except switches to the MRU window on another screen in a multihead configuration
-  Mod1-d                Request the client destroy the focused window, or destroy the current virtual desktop when no windows exist on it
-  Mod1-Shift-d          XKillClient the focused window (useful for misbehaving clients)
-  Mod1-Enter            Alternate between full-screen and windowed dimensions for the focused window
-  Mod1-[ [-[]           Reconfigure the focused window to fill the left half of the screen [ left bottom quarter of screen ]
-  Mod1-] [-]]           Reconfigure the focused window to fill the right half of the screen [ right top quarter of screen ]
-  Mod1-Shift-[ [-[]     Reconfigure the focused window to fill the top half of the screen [ top left quarter of screen ]
-  Mod1-Shift-] [-]]     Reconfigure the focused window to fill the bottom half of the screen [ bottom right quarter of screen ]
-  Mod1-Semicolon        Toggle monitoring overlays (when active vwm becomes a compositing manager, which is slower)
-  Mod1-Apostrophe       Discard the "snowflakes" region of the focused window's monitoring overlay
-  Mod1-Right            Increase monitoring frequency (when overlays are active, too high a frequency can overload X)
-  Mod1-Left             Decrease monitoring frequency, the lowest setting halts monitoring)
-  Mod1-Esc-Esc-Esc      Exit vwm (if vwm is the child of your X server, X exits too, so your X clients all lose their connection and die.
-                        However, your clients are running under screen, and if your X server didn't exit, they won't lose their X connection.)
-
-  *'s above indicate commands which initiate an MRU-update to be committed on the next Mod1 release.  One may traverse windows and desktops without affecting
-      their MRU order by returning to the original initiating window and/or desktop before releasing Mod1.  This permits one to do quite a lot of things
-      under a single, long-duration Mod1 press only committing to a potentially different focused window/desktop at the very end.
-      Think of the Mod1 release as a transaction commit when coupled with the *'d commands.
+  Mod1-RClick         Focus the clicked window, but suppress raising
+
+  Mod1-RClick-drag    Focus the clicked window, suppress raising, resizing
+		      the window from its nearest corner until drag
+                      completes
+
+  Mod1-LClick         Focus and raise the clicked window
+
+  Mod1-LClick-drag    Focus and raise the clicked window, moving the window
+                      until the drag completes
+
+* Mod1-l              Switch to virtual desktop to the right (if exists)
+
+* Mod1-h              Switch to virtual desktop to the left (if exists)
+
+  Mod1-j              Lower focused window, if the focused window is in
+		      "allscreen" mode it will simply be fullscreened first
+                      without lowering
+
+  Mod1-k [-k [-k]     Raise focused window [a second k raises and
+          [-k] [-k]]  fullscreens the window [a third k raises and
+		      "allscreens" without a visible border [a fourth k
+		      raises and fullscreens across all heads [a fifth k
+                      raises and "allscreens" across all heads]]]
+
+  Mod1-Shift-k        Shelve focused window and switch to the shelf context
+
+  Mod1-Shift-j        Migrate the focused window from the shelf to the last
+		      focused virtual desktop, switch to that virtual
+                      desktop, and focus the migrated window
+
+* Mod1-Shift-l        Migrate the focused window to the virtual desktop
+		      to the right (if exists), keeping the window focused
+
+* Mod1-Shift-h        Migrate the focused window to the virtual desktop
+		      to the left (if exists), keeping the window focused
+
+  Mod1-v              Create a new virtual desktop and switch to it
+
+  Mod1-Shift-v        Create a new virtual desktop, move the focused window
+                      to it, and switch to it
+
+* Mod1-Space          Switch to the most recently used virtual desktop
+		      (like Mod1-Tab but for virtual desktops)
+
+* Mod1-Shift-Space    Switch to the most recently used virtual desktop,
+		      bringing the focused window with
+
+  Mod1-`              Alternate between shelf (if populated) and virtual
+                      desktop contexts
+
+  Mod1-s              Shelve the focused window without switching to the
+                      shelf, adopting the newly shelved window as the
+                      focused window within the shelf
+
+* Mod1-Tab            Focus and raise the next window in the current
+                      context (shelf or virtual desktop), the focused
+                      window is not 'committed' as the MRU window until
+                      Mod1 is released, so you may peruse intermediate
+                      windows without affecting the order until releasing
+                      Mod1.  In multihead configurations the next window
+                      selection is confined to the current screen.
+
+  Mod1-Shift-Tab      Identical to Mod1-Tab except switches to the MRU
+		      window on another screen in a multihead configuration
+
+  Mod1-d              Request the client destroy the focused window, or
+                      destroy the current virtual desktop when no windows
+                      exist on it
+
+  Mod1-Shift-d        XKillClient the focused window (useful for
+                      misbehaving clients)
+
+  Mod1-Enter          Alternate between full-screen and windowed dimensions
+                      for the focused window
+
+  Mod1-[ [-[]         Reconfigure the focused window to fill the left half
+                      of the screen [ left bottom quarter of screen ]
+
+  Mod1-] [-]]         Reconfigure the focused window to fill the right half
+                      of the screen [ right top quarter of screen ]
+
+  Mod1-Shift-[ [-[]   Reconfigure the focused window to fill the top half
+                      of the screen [ top left quarter of screen ]
+
+  Mod1-Shift-] [-]]   Reconfigure the focused window to fill the bottom
+                      half of the screen [ bottom right quarter of screen ]
+
+  Mod1-Semicolon      Toggle monitoring overlays (when active vwm becomes a
+                      compositing manager, which is slower)
+
+  Mod1-Apostrophe     Discard the "snowflakes" region of the focused
+                      window's monitoring overlay
+
+  Mod1-Right          Increase monitoring frequency (when overlays are
+                      active, too high a frequency can overload X)
+
+  Mod1-Left           Decrease monitoring frequency, the lowest setting
+                      halts monitoring)
+
+  Mod1-Esc-Esc-Esc    Exit vwm (if vwm is the child of your X server, X
+                      exits too, so your X clients all lose their
+                      connection and die.  However, your clients are
+                      running under screen, and if your X server didn't
+                      exit, they won't lose their X connection.)
+
+  *'s above indicate commands which initiate an MRU-update to be committed
+      on the next Mod1 release.  One may traverse windows and desktops
+      without affecting their MRU order by returning to the original
+      initiating window and/or desktop before releasing Mod1.  This permits
+      one to do quite a lot of things under a single, long-duration Mod1
+      press only committing to a potentially different focused
+      window/desktop at the very end.
+
+      Think of the Mod1 release as a transaction commit when coupled with
+      the *'d commands.
 
 Default launchers (configure by editing launchers.def and rebuild):
 
-  Mod1-x                xterm
-  Mod1-b                iceweasel
-  Mod1-g                gimp
-  Mod1-.                xlock
-  Mod1--                xset -dpms s off
-  Mod1-=                xset +dpms s on
+  Mod1-x              xterm
+  Mod1-b              iceweasel
+  Mod1-g              gimp
+  Mod1-.              xlock
+  Mod1--              xset -dpms s off
+  Mod1-=              xset +dpms s on
 
 
 General: