.\" t
.\" @(#)Arrange.1		01/22/2024
.TH Arrange 1x "AfterStep v.2.2.12" "Jan 22 2024" "AfterStep X11 window manager"
.UC
.SH NAME
\fBArrange\fP\ \- AfterStep module for arranging windows in a tiling or cascading order



.SH CONFIGURATION OPTIONS

.SH DESCRIPTION
Arrange was developed to replace Tile and Cascade which were present in AfterStep 1\&.8 and stopped working with the introduction of AfterStep 2\&.0\&. Like Tile and Cascade Arrange can be used to tile or cascade windows subject to certain constraints\&.

By default Arrange will cascade windows located on the current screen\&.

.SH OPTIONS

.IP "\-a"

Causes all window styles to be affected, even ones with the WindowListSkip style\&.

.IP "\-alldesks"

Causes windows on all desks to be effected\&.

.IP "\-desk"

Causes all windows on the desk to be cascaded instead of the current screen only\&.

.IP "\-H"

Causes windows to be tiled horizontaly\&. This will only have an effect if \-tile is passed\&.

.IP "\-incx arg"

Specifies a horizontal increment which is successively added to arranged windows\&. arg is a percentage of screen width, or pixel value if a p is suffixed\&. Default is 20p\&.

.IP "\-incy arg"

Specifies a vertical increment which is successively added to arranged windows\&. arg is a percentage of screen height, or pixel value if a p is suffixed\&. Default is 20p\&.

.IP "\-m"

Causes maximized windows to also be affected (implied by \-all)\&.

.IP "\-mn arg"

Tiles up to arg windows in tile direction\&. If more windows exist, a new direction row or column is created (in effect, a matrix is created)\&.

.IP "\-noraise"

Inhibits window raising, leaving the depth ordering intact\&.

.IP "\-nostretch"

Inhibits window expansion when using the \-resize option\&. Win\- dows will only shrink to fit the maximal width and height (if given)\&.

.IP "\-pattern arg"

Only arrange windows matching the supplied pattern\&.

.IP "\-r"

Reverses the window sequence\&.

.IP "\-resize"

Forces all windows to resize to the constrained width and height (if given)\&.

.IP "\-s"

Causes sticky windows to also be affected (implied by \-all)\&.

.IP "\-t"

Causes transient windows to also be affected (implied by \-all)\&.

.IP "\-tile"

Causes windows to be tiled not cascaded\&.

.IP "\-u"

Causes untitled windows to also be affected (implied by \-all)\&.


.SH INVOCATION
Arrange can be invoked from the autoexec file or by binding the action "Module Arrange [args]" to a key\-stroke in a feel file\&.

.SH CONFIGURATION OPTIONS
Command\-line arguments passed to Arrange are described in the OPTIONS section\&.

Up to four numbers can be placed on the command line that are not switches\&. The first pair specify an x and y offset to start the first window (default is 0, 0)\&. The second pair specify an absolute coordi\- nate reference denoting the lower right bounding box for tiling\&. If any number is suffixed with the letter p, then it is taken to be a pixel value, otherwise it is interpreted as a screen percentage\&. Specifying zero for any parameter is equivalent to not specifying it\&.


This invocation will horizontally tile windows with a bounding box which starts at 10 by 10 percent into and down the screen and ends at 90 by 90 percent into and down the screen\&.

Arrange 10 10 90 90 \-tile \-H


It is probably not a good idea to delete windows while windows are being arranged\&.