Provided by: fvwm_2.6.5.ds-3_amd64 bug

NAME

       FvwmRearrange - rearrange fvwm windows

SYNOPSIS

       FvwmRearrange is spawned by fvwm, so no command line invocation will work.

DESCRIPTION

       This module can be called to tile or cascade windows.

       When  tiling  the  module  attempts to tile windows on the current screen subject to certain constraints.
       Horizontal or vertical tiling is performed so that each window does not overlap another, and  by  default
       each  window  is  resized to its nearest resize increment (note sometimes some space might appear between
       tiled windows -- this is why).

       When cascading the module  attempts  to  cascade  windows  on  the  current  screen  subject  to  certain
       constraints.   Layering  is  performed  so  consecutive  windows  will  have  their window titles visible
       underneath the previous.

INVOCATION

       FvwmRearrange is best invoked from a menu, pop up or button.  There are a number of command line  options
       which  can  be  used to constrain the layering, these are described below.  As an example case, one could
       call FvwmRearrange with the following arguments:
       FvwmRearrange -tile -h 10 10 90 90
       or
       FvwmRearrange -cascade -resize 10 2 80 70

       The first 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.

       The  second  invocation  will cascade windows starting 10 by 2 percent into and down the screen.  Windows
       will be constrained to 80 by 70 percent of the screen dimensions.  Since the resize  is  also  specified,
       windows will be resized to the given constrained width and height.

       FvwmRearrange  can  be  called  as  FvwmTile or FvwmCascade. This is equivalent to providing the -tile or
       -cascade option. This form is obsolete and supplied for backwards compatibility only.

       Command-line arguments passed to FvwmRearrange are described here.

       -a     Causes all window types to be affected, even ones with the WindowListSkip style.

       -animate
              Attempt to do an animated move, this is ignored if -resize or -maximize are used.

       -cascade
              Cascade windows. This argument must be the first on the command line.  This is the default.

       -desk  Causes all windows on the desk to be cascaded/tiled instead of the current screen only.

       -flatx Inhibits border width increment. Only used when cascading.

       -flaty Inhibits border height increment. Only used when cascading.

       -h     Tiles horizontally (default is to tile vertically). Used for tiling only.

       -incx arg
              Specifies a horizontal increment which is successively  added  to  cascaded  windows.   arg  is  a
              percentage  of  screen  width,  or pixel value if a p is suffixed.  Default is zero. Used only for
              cascading.

       -incy arg
              Specifies a vertical increment which  is  successively  added  to  cascaded  windows.   arg  is  a
              percentage  of  screen  height, or pixel value if a p is suffixed.  Default is zero. Used only for
              cascading.

       -m     Causes maximized windows to also be affected (implied by -a).

       -maximize
              When moving/resizing a window, put it also into maximized state.

       -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). Used only when tiling windows.

       -noanimate
              Do not attempt to do an animated move.

       -nomaximize
              Do not put windows into maximized state.

       -noraise
              Inhibits window raising, leaving the depth ordering intact.

       -noresize
              Inhibits window resizing, leaving window sizes intact. This is the default when cascading windows.

       -nostretch
              If  tiling:  inhibits  window  growth  to  fit  tile.   Windows are shrunk to fit the tile but not
              expanded.

              If cascading: inhibits window expansion when using the -resize option.  Windows will  only  shrink
              to fit the maximal width and height (if given).

       -r     Reverses the window sequence.

       -resize
              Forces  all  windows to resize to the constrained width and height (if given). This is the default
              when tiling windows.

       -s     Causes sticky windows to also be affected (implied by -a).

       -sp    Causes windows sticky across pages to also be affected (implied by -a).

       -sd    Causes windows sticky across desks to also be affected (implied by -a).

       -t     Causes transient windows to also be affected (implied by -a).

       -tile  Tile windows. This argument must be the first on the command line.

       -u     Causes untitled windows to also be affected (implied by -a).

       -ewmhiwa
              When rearranging windows, make the calculation ignore the working area, such as EwmhBaseStruts; by
              default, FvwmRearrange will honour the working area.

              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 meaning of the  second
              pair depends on operation mode:

              When  tiling  windows  it  specifies  an  absolute  coordinate  reference denoting the lower right
              bounding box for tiling.

              When cascading it specifies a maximal width and height for the layered  windows.  If  an  affected
              window exceeds either this width or height, it is resized to the maximal width or height.

              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.

BUGS

       It is probably not a good idea to delete windows while windows are being rearranged.

AUTHORS

       Andrew  Veliath (original FvwmTile and FvwmCascade modules) Dominik Vogt (merged FvwmTile and FvwmCascade
       to FvwmRearrange)