StumpWM Manual: 1.3.4 Dynamic Group Basics

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

1.3.4 Dynamic Group Basics

Within a dynamic group, windows are organized into a master window and a window stack, with one of each per head. When a new window is added to a head within a dynamic group, that heads master window is pushed onto that heads window stack, and the new window becomes the master window. When a head becomes to full (ie more windows cannot be placed upon the stack) a overflow policy is used to determine which window to move to a separate head or group.

Command: gnew-dynamic name: Create a new dynamic group named NAME.

Command: gnewbg-dynamic name: Create a new dynamic group named NAME in the background.

Command: rotate-windows direction: Rotate all windows in the current group and head forward (clockwise) or backward (counterclockwise)

Command: change-layout layout: Change the layout of the current head and group.

Command: change-default-layout layout &optional (update-heads unset): Change the default layout for dynamic groups.

Command: change-split-ratio ratio: Change the size of the master window of the current head and group.

Command: change-default-split-ratio ratio &optional (update-heads unset): Change the default size of the master window for dynamic groups.

Command: retile &optional (retile-floats t): Force a retile of all windows.

Command: select-floating-window &optional (fmt *window-format*) window-list: Select a floating window from a menu.

Variable: *rotation-focus-policy*: A keyword determining what frame to focus after rotating the windows in a dynamic group. Valid values are: :PRESERVE, meaning to stay on the same frame :FOLLOW, meaning to follow the current window as it rotates :MASTER, meaning to always stay to the master :MASTER-OR-FOLLOW, meaning to stay on the master, or if initiating the rotation while focused on a stack window to follow that window.

When defining commands, anything restricted to tiling groups will also be active in dynamic groups. To fully restrict it to tiling groups, call the function dyn-blacklist-command on the command in question.