uh-wm 0.0.11 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6e40ae2e6f815683ba49a0cf70e0a2832b15198a
-  data.tar.gz: 2f2c5eabef44d6acfa2dbb4901d81fea647b121f
+  metadata.gz: 302994d7e8174ab44aff96272ac486ee6d3fcc53
+  data.tar.gz: a1f5ac01ade9effcfa4ae1a875832f81bcdc96ca
 SHA512:
-  metadata.gz: d423c12bb61f6fce43f7c2fb28b8d3a823197abb719dbe02380706dfcf4755b7e190b0fe8e8d72a683e8e883e9659272eae7d43244abe1ab3b0ef208af9ba19a
-  data.tar.gz: 0a21755650d31e190d9df030866a2822d9fe347dc4ed7f94b90834f5312331135fb26151ab3b4a5df9014fd1e8d7debee1cd6c468392734e174aa025c877350a
+  metadata.gz: facc3a0550904db4f004883e87d889b54c4681ac1deda71d5a9d9f675abbda8e973f38634490f26bd884780ab9a897a949af157e59ac1787682fb8219b80948a
+  data.tar.gz: 6233f25d58e98557e757781038f51cb5d14582d7a005bcaee94dfe1eaa732ce715332866e377c14ec3cb0aa053b85d88ae4649eef101378c2a0713041474adfc

data/README.md

@@ -124,6 +124,50 @@ available in the [`ActionsHandler` class documentation][actions_doc]
 [actions_doc]: http://www.rubydoc.info/gems/uh-wm/Uh/WM/ActionsHandler
 
 
+Hacking uhwm
+------------
+
+### Installation with bundler
+
+``` shell
+git clone git://github.com/tjouan/uh-wm   # clone repository from github mirror
+bundle install                            # install dependencies with bundler
+```
+
+### Running the test suite
+
+``` shell
+rake            # Run all test suites
+rake features   # Run user acceptance test suite
+cucumber        # Run user acceptance test suite
+rake spec       # Run unit test suite
+rspec           # Run unit test suite
+```
+
+  Prefix the commands as `bundle exec COMMAND` to use bundler.
+
+### Running uhwm within a nested X session
+
+  For convenience, the `run` rake task is provided to execute uhwm in
+a new X session using Xephyr as the X server. The session is
+initialized with the `startx` program, the task will import the keymap
+from your current X session to the new one and change the background
+color to one that is neither used by uhwm nor commonly used by other.
+
+``` shell
+# Run uhwm (with default argument `-d', set by the task internally)
+rake run
+# Run uhwm with no argument
+rake run --
+# Run uhwm with `-v' argument
+rake run -- -v
+# Setup Xephyr with two screens
+rake run UHWM_XINERAMA=yes
+# Combine custom env and custom uhwm arguments
+rake run UHWM_XINERAMA=yes -- -v
+```
+
+
 Extensive configuration example
 -------------------------------
 
@@ -298,23 +342,23 @@ BUGS
 FAQ
 ---
 
-#### uhwm is stealing focus, how can I disable it?
+_uhwm is stealing focus, how can I avoid this behavior?_
 
   You can't (yet). The default layout will be modified to accept an
 `autofocus: false` option in a future release.
 
-#### What are the default key bindings?
+_What are the default key bindings?_
 
   Juste one: `mod+shift+q` is bound to the `quit` action.
 
-#### How can I implement my own layout?
+_How can I implement my own layout?_
 
   A layout is a simple ruby object responding to a set of messages:
 `register`, `current_client`, `suggest_geo`, `<<`, `remove`, `update`
 and `expose`. No documentation is available yet, so read the source
 code or the cucumber scenarios in `features/layout/protocol.feature`.
 
-#### Can I change the default behavior ignoring current view selection?
+_Can I change the default behavior ignoring current view selection?_
 
   Yes, just test for this condition in the key binding code. For
 example the following code will select the last historized view (if

data/lib/uh/wm/version.rb

@@ -1,5 +1,5 @@
 module Uh
   module WM
-    VERSION = '0.0.11'
+    VERSION = '0.0.12'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uh-wm
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
 platform: ruby
 authors:
 - Thibault Jouan
@@ -122,7 +122,30 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
-description: uh-wm
+description: |2
+    uhwm is a minimalistic tiling and stacking window manager for X. It
+  shares some similarities with dwm and wmii, but is written in ruby so
+  you can configure and extend features directly with ruby code.
+
+    The layout strategy is interchangeable, the default one being the
+  `uh-layout` ruby gem. A layout is a simple ruby object responding to
+  specific messages, so it's easy to write your own layout.
+
+    Main features:
+
+    * Xinerama support;
+    * different adapters for event handling: blocking, multiplexing
+      with `select()` or `kqueue()`;
+    * configuration with a run control file;
+    * key bindings with user defined code as callback;
+    * configurable modifier key;
+    * user-defined layout strategies;
+    * external program execution;
+    * no re-parenting (therefore, no window decoration either);
+    * no grabbing of the modifier key alone;
+    * no mouse event handling;
+    * no EWMH support;
+    * very limited ICCCM support.
 email: tj@a13.fr
 executables:
 - uhwm
@@ -175,6 +198,6 @@ rubyforge_project:
 rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: minimalistic tiling and stacking window manager for X
+summary: minimalistic tiling and stacking X window manager
 test_files: []
 has_rdoc: