commit 006aac6196c1691a03eddcaf6dc750af39816c5a
parent 4a6a951fa439e6439b44810af9f67a4098c07037
Author: Christoph Lohmann <20h@r-36.net>
Date: Sun, 30 Oct 2011 11:20:31 +0100
Polishing up the dwm tutorial.
Diffstat:
1 file changed, 36 insertions(+), 1 deletion(-)
diff --git a/dwm.suckless.org/tutorial.md b/dwm.suckless.org/tutorial.md
@@ -1,3 +1,6 @@
+Introduction
+------------
+
Using dwm can be done in pure keyboard control or through some extra mouse
handling. See the
[config.def.h](http://hg.suckless.org/dwm/file/tip/config.def.h) for what
@@ -6,7 +9,10 @@ are the default bindings. They are used in this tutorial.
[Shift]+[Alt]+[Enter] - launch terminal
[Alt]+[p] - dmenu for running programs like the x-www-browser
-By default there are 9 tags (~workspaces).
+By default there are 9 tags.
+
+Window model
+------------
Launch a few terminals `[Shift]+[Alt]+[Enter]` and dwm will _tile_ the windows
between the **master** and **stack**. A new terminal appears on the **master**
@@ -24,6 +30,9 @@ To kill a window:
[Shift]+[Alt]+[c]
+Layouts
+-------
+
By default dwm is in **tiled** layout mode. Ensure it is tiled mode with:
[Alt]+[t]
@@ -35,6 +44,9 @@ dwm has two further layout modes, **floating** `><>` `[Alt]+[f]` and
maximized and focused. This is useful in web kiosk environments and watching
flash videos. Further layout modes can be included through [patches](http://dwm.suckless.org/patches/).
+Floating
+--------
+
Floating layout will be familiar to Windows users. Use `[Alt]+[right mouse
button]` to resize the floating window and `[Alt]+[left mouse button]` to move
it around.
@@ -52,8 +64,31 @@ If you want to set some type of window to be always floating, look at the
[config.def.h](http://hg.suckless.org/dwm/file/tip/config.def.h) and the
`rules` array, where the last but one element defines this behaviour.
+Quitting
+--------
+
To quit dwm cleanly:
[Shift]+[Alt]+[q]
+Status
+------
+
+By default dwm is showing `dwm-X.X` in its statusbar. This text can be
+changed by setting the `WM_NAME` property of the root window.
+
+Using the tools of X.org, this can be set using:
+
+ % xsetroot -name "Some Text"
+
+There are various tools and methods to populate this text with useful
+information from your system or services running on your system. A barebone
+for doing this in C is [dwmstatus](http://dwm.suckless.org/dwmstatus/).
+See the [xinitrc](http://git.webconverger.org/?p=home.git;a=blob_plain;f=.xinitrc)
+example for how to do it using a script.
+
+Launching
+---------
+
To launch dwm, ideally you should setup an [xinitrc](http://git.webconverger.org/?p=home.git;a=blob_plain;f=.xinitrc).
+