FvwmCascade
 - layer FVWM windows

SYNOPSIS

       FvwmCascade is spawned by fvwm, so no command line invoca-
       tion will work.

DESCRIPTION

       This module attempts to cascade  windows  on  the  current
       screen  subject  to certain constraints.  Layering is per-
       formed so  consecutive  windows  will  have  their  window
       titles visible underneath the previous.

INVOCATION

       FvwmCascade  is best invoked from a menu, popup 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  FvwmCascade
       with the following arguments:

            FvwmCascade -resize 10 2 80 70


       This invocation will cascade windows starting 10 by 2 per-
       cent into and down  the  screen.   Windows  will  be  con-
       strained  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.

       Command-line arguments passed to FvwmCascade are described
       here.

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

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

       -flatx Inhibits border width increment.

       -flaty Inhibits border height increment.

       -incx arg
              Specifies a horizontal increment which  is  succes-
              sively  added  to  cascaded windows.  arg is a per-
              centage of screen width, or pixel value if a  p  is
              suffixed.  Default is zero.

       -incy arg
              Specifies  a  vertical  increment  which is succes-
              sively added to cascaded windows.  arg  is  a  per-

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

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

       -nostretch
              Inhibits window expansion when  using  the  -resize
              option.   Windows will only shrink to fit the maxi-
              mal width and height (if given).

       -r     Reverses the window sequence.

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

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

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

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

              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 a maxi-
              mal 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 each number is suffixed with the letter
              p, then it is taken to be a pixel value,  otherwise
              it is interpreted as a screen percentage.  Specify-
              ing 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 cascaded.

AUTHOR

       Andrew Veliath