aboutsummaryrefslogtreecommitdiffstats
path: root/man/xmonad.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/xmonad.1')
-rw-r--r--man/xmonad.1110
1 files changed, 54 insertions, 56 deletions
diff --git a/man/xmonad.1 b/man/xmonad.1
index 2c52f73..0eaf383 100644
--- a/man/xmonad.1
+++ b/man/xmonad.1
@@ -1,7 +1,7 @@
-.TH xmonad 1 "31 December 2012" xmonad-0.11 "xmonad manual".TH "" ""
+.TH xmonad 1 "31 December 2012" xmonad-0.12 "xmonad manual".TH "" "" "" "" ""
.SH Name
.PP
-xmonad - a tiling window manager
+xmonad \- a tiling window manager
.SH Description
.PP
\f[I]xmonad\f[] is a minimalist tiling window manager for X, written in
@@ -33,27 +33,27 @@ window manager in less than 1200 lines of code, with an emphasis on
correctness and robustness.
Internal properties of the window manager are checked using a
combination of static guarantees provided by the type system, and
-type-based automated testing.
+type\-based automated testing.
A benefit of this is that the code is simple to understand, and easy to
modify.
.SH Usage
.PP
\f[I]xmonad\f[] places each window into a "workspace".
Each workspace can have any number of windows, which you can cycle
-though with mod-j and mod-k.
+though with mod\-j and mod\-k.
Windows are either displayed full screen, tiled horizontally, or tiled
vertically.
-You can toggle the layout mode with mod-space, which will cycle through
+You can toggle the layout mode with mod\-space, which will cycle through
the available modes.
.PP
-You can switch to workspace N with mod-N.
-For example, to switch to workspace 5, you would press mod-5.
+You can switch to workspace N with mod\-N.
+For example, to switch to workspace 5, you would press mod\-5.
Similarly, you can move the current window to another workspace with
-mod-shift-N.
+mod\-shift\-N.
.PP
When running with multiple monitors (Xinerama), each screen has exactly
1 workspace visible.
-mod-{w,e,r} switch the focus between screens, while shift-mod-{w,e,r}
+mod\-{w,e,r} switch the focus between screens, while shift\-mod\-{w,e,r}
move the current window to that screen.
When \f[I]xmonad\f[] starts, workspace 1 is on screen 1, workspace 2 is
on screen 2, etc.
@@ -64,179 +64,179 @@ and visible workspaces are swapped.
xmonad has several flags which you may pass to the executable.
These flags are:
.TP
-.B --recompile
+.B \-\-recompile
Recompiles your configuration in \f[I]~/.xmonad/xmonad.hs\f[]
.RS
.RE
.TP
-.B --restart
+.B \-\-restart
Causes the currently running \f[I]xmonad\f[] process to restart
.RS
.RE
.TP
-.B --replace
+.B \-\-replace
Replace the current window manager with xmonad
.RS
.RE
.TP
-.B --version
+.B \-\-version
Display version of \f[I]xmonad\f[]
.RS
.RE
.TP
-.B --verbose-version
+.B \-\-verbose\-version
Display detailed version of \f[I]xmonad\f[]
.RS
.RE
.SS Default keyboard bindings
.TP
-.B mod-shift-return
+.B mod\-shift\-return
Launch terminal
.RS
.RE
.TP
-.B mod-p
+.B mod\-p
Launch dmenu
.RS
.RE
.TP
-.B mod-shift-p
+.B mod\-shift\-p
Launch gmrun
.RS
.RE
.TP
-.B mod-shift-c
+.B mod\-shift\-c
Close the focused window
.RS
.RE
.TP
-.B mod-space
+.B mod\-space
Rotate through the available layout algorithms
.RS
.RE
.TP
-.B mod-shift-space
+.B mod\-shift\-space
Reset the layouts on the current workspace to default
.RS
.RE
.TP
-.B mod-n
+.B mod\-n
Resize viewed windows to the correct size
.RS
.RE
.TP
-.B mod-tab
+.B mod\-tab
Move focus to the next window
.RS
.RE
.TP
-.B mod-shift-tab
+.B mod\-shift\-tab
Move focus to the previous window
.RS
.RE
.TP
-.B mod-j
+.B mod\-j
Move focus to the next window
.RS
.RE
.TP
-.B mod-k
+.B mod\-k
Move focus to the previous window
.RS
.RE
.TP
-.B mod-m
+.B mod\-m
Move focus to the master window
.RS
.RE
.TP
-.B mod-return
+.B mod\-return
Swap the focused window and the master window
.RS
.RE
.TP
-.B mod-shift-j
+.B mod\-shift\-j
Swap the focused window with the next window
.RS
.RE
.TP
-.B mod-shift-k
+.B mod\-shift\-k
Swap the focused window with the previous window
.RS
.RE
.TP
-.B mod-h
+.B mod\-h
Shrink the master area
.RS
.RE
.TP
-.B mod-l
+.B mod\-l
Expand the master area
.RS
.RE
.TP
-.B mod-t
+.B mod\-t
Push window back into tiling
.RS
.RE
.TP
-.B mod-comma
+.B mod\-comma
Increment the number of windows in the master area
.RS
.RE
.TP
-.B mod-period
+.B mod\-period
Deincrement the number of windows in the master area
.RS
.RE
.TP
-.B mod-shift-q
+.B mod\-shift\-q
Quit xmonad
.RS
.RE
.TP
-.B mod-q
+.B mod\-q
Restart xmonad
.RS
.RE
.TP
-.B mod-shift-slash
+.B mod\-shift\-slash
Run xmessage with a summary of the default keybindings (useful for
beginners)
.RS
.RE
.TP
-.B mod-[1..9]
+.B mod\-[1..9]
Switch to workspace N
.RS
.RE
.TP
-.B mod-shift-[1..9]
+.B mod\-shift\-[1..9]
Move client to workspace N
.RS
.RE
.TP
-.B mod-{w,e,r}
+.B mod\-{w,e,r}
Switch to physical/Xinerama screens 1, 2, or 3
.RS
.RE
.TP
-.B mod-shift-{w,e,r}
+.B mod\-shift\-{w,e,r}
Move client to screen 1, 2, or 3
.RS
.RE
.TP
-.B mod-button1
+.B mod\-button1
Set the window to floating mode and move by dragging
.RS
.RE
.TP
-.B mod-button2
+.B mod\-button2
Raise the window to the top of the stack
.RS
.RE
.TP
-.B mod-button3
+.B mod\-button3
Set the window to floating mode and resize by dragging
.RS
.RE
@@ -244,23 +244,21 @@ Set the window to floating mode and resize by dragging
.PP
To use xmonad as your window manager add to your \f[I]~/.xinitrc\f[]
file:
-.IP
-.nf
-\f[C]
-exec\ xmonad
-\f[]
-.fi
+.RS
+.PP
+exec xmonad
+.RE
.SH Customization
.PP
-xmonad is customized in ~/.xmonad/xmonad.hs, and then restarting with
-mod-q.
+xmonad is customized in ~/.xmonad/xmonad.hs, and then restarted with
+mod\-q.
.PP
-You can find many extensions to the core feature set in the xmonad-
+You can find many extensions to the core feature set in the xmonad\-
contrib package, available through your package manager or from
xmonad.org (http://xmonad.org).
.SS Modular Configuration
.PP
-As of \f[I]xmonad-0.9\f[], any additional Haskell modules may be placed
+As of \f[I]xmonad\-0.9\f[], any additional Haskell modules may be placed
in \f[I]~/.xmonad/lib/\f[] are available in GHC\[aq]s searchpath.
Hierarchical modules are supported: for example, the file
\f[I]~/.xmonad/lib/XMonad/Stack/MyAdditions.hs\f[] could contain:
@@ -268,12 +266,12 @@ Hierarchical modules are supported: for example, the file
.nf
\f[C]
module\ XMonad.Stack.MyAdditions\ (function1)\ where
-\ \ \ \ function1\ =\ error\ "function1:\ Not\ implemented\ yet!"
+\ \ function1\ =\ error\ "function1:\ Not\ implemented\ yet!"
\f[]
.fi
.PP
Your xmonad.hs may then import XMonad.Stack.MyAdditions as if that
-module was contained within xmonad or xmonad-contrib.
+module was contained within xmonad or xmonad\-contrib.
.SH Bugs
.PP
Probably.