X-Git-Url: http://pileus.org/git/?p=pages;a=blobdiff_plain;f=wmpus%2Fmanual.md;fp=wmpus%2Fmanual.md;h=827909341198242e5ec69bcdbd6f462739448d93;hp=0000000000000000000000000000000000000000;hb=caca1b40a87e6772f43701eb4fb89b17d0d4aac7;hpb=f291ea28052d73ee5233dcc33dfe12e208bce207 diff --git a/wmpus/manual.md b/wmpus/manual.md new file mode 100644 index 0000000..8279093 --- /dev/null +++ b/wmpus/manual.md @@ -0,0 +1,169 @@ +
+WMPUS(1) WMPUS(1) + +NAME + wmpus - cross platform window manager + +SYNOPSIS + wmpus [OPTION..] + +DESCRIPTION + wmpus is portable window manager. Currently it supports wmii like win‐ + dow management and includes x11 and win32 backends. + +OPTIONS + -n, --no-capture + Do not arrange pre-existing windows + + -b, --border=N + Draw an n pixel window border + + -m, --margin=N + Leave an n pixel margin around windows + + -i, --int=KEY=NUM + Set integer configuration option + + -s, --str=KEY=STR + Set string configuration option + + -h, --help + Print usage information + +CONFIGURATION + Wmpus supports a simple ini-like configuration file stored in the users + home directory. Currently supported configuration options include: + + Main section + no-capture=[01] + Do not arrange pre-existing windows. Same as -n + + border=N + Border width in pixels to draw around windows. X11 only, default + 2. Same as -b + + margin=N + Margin in pixels between windows for wm-wmii. X11 default 0, + Win32 default 15. Same as -m + + stack=N + Height in pixels for non-focused windows when the column is set + to stack layout + +COMPILE-TIME OPTIONS + The windowing system backend and window management modes can be changed + at compile-time by linking in the correct object file. Supported win‐ + dowing systems include X11 (sys-x11.c) and Windows (sys-win32.c). Sup‐ + ported window management modes include WMII like window management (wm- + wmii.c) and a simple tags based virtual-desktop manager (wm-tags.c). + + In addition several pre-processor settings are available which can be + set in config.mk or on the command line: + + MODKEY=key + Modifier used for window management commands, can be either alt, + ctrl, shift, or win. Default alt + + DEBUG Enable various debugging functions + +WMII WINDOW MANAGEMENT + The wmii window management mode mimics the behavior of the wmii(1) win‐ + dow manager. By default, the alt- prefix is used for most window man‐ + agement commands and is used along with the h, j, k, and l keys to + focused different windows. + + The alt-shift- prefix is used for moving windows and works similar to + changing the focus. The mouse is used for resizing windows and also for + changing focus. + + Changing focus + Alt-j Focus window below the currently focused window + + Alt-k Focus window above the currently focused window + + Alt-h Focus column to the left of the currently focused column + + Alt-l Focus column to the right of the currently focused column + + Moving windows around + Alt-Shift-j + Move the currently focused window down + + Alt-Shift-k + Move the currently focused window up + + Alt-Shift-h + Move the currently focused window to the left + + Alt-Shift-l + Move the currently focused window to the right + + Column layouts + Alt-d Switch the current column to split layout + + Alt-s Switch the current to stack layout + + Alt-m Switch the current to maximized layout + + Tagging windows + Alt-[0..n] + Switch to tag n + + Alt-Shift-[0..n] + Move the currently focused window to tag n + + Floating windows + Alt-Space + Toggle focus between the tiling and floating layers + + Alt-Shift-Space + Move the currently focused window between the tiling and float‐ + ing layers + + Other commands + Alt-f Toggle fullscreen for the focused window + + Alt-Shift-c + Close the currently focused window + + Alt-Shift-q + Restore all hidden windows and quit wmpus + + Alt-F5 Refresh the window layout (useful for debugging) + + Alt-F6 Dump a ASCII representation the window layout to standard output + (useful for debugging) + + Mouse commands + Pointer + Moving the mouse over a window focuses that window + + Button1 + Click in a floating window brings it to the top + + Alt-Button1 + Click and drag moves a floating window under the cursor + + Alt-Button3 + Click and drag resizes the window under the cursor + +X11 BACKEND + The X11 backend draws a small 2px border around each window. The border + for the currently focused window is set to a lighter color than the + rest. + +WIN32 BACKEND + The Win32 backend uses the existing window borders and title bars. It + also leaves a narrow space between the windows so that they look more + natural in a Windows environment. + +FILES + ~/.wmpus + The wmpus configuration file + +SEE ALSO + wmii(1), dwm(1), dzen(1) + +BUGS + Many +