           FvwmScroll - the FVWM scroll-bar module

## SYNOPSIS

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

## DESCRIPTION

           The FvwmScroll module prompts the user to select a  target
           window,  if the module was not launched from within a win-
           dow context in Fvwm.  After that, it adds scroll  bars  to
           the  selected  window,  to  reduce the total desktop space
           consumed by the window.

           FvwmScroll reads the same .fvwmrc file as fvwm reads  when
           it starts up, and looks for lines similar to "*FvwmScroll-
           Fore green".

           FvwmScroll should not be used with windows which  move  or
           resize  themselves,  nor  should  it  be used with windows
           which set the WM_COLORMAP_WINDOWS property.  Operation  is
           fine with windows that have a private colormap.

## COPYRIGHTS

           The  FvwmScroll  program,  and the concept for interfacing
           this module to the Window Manager, are all  original  work
           by Robert Nation.

           Copyright 1994, Robert Nation. No guarantees or warranties
           or anything are provided or implied in any way whatsoever.
           Use  this program at your own risk. Permission to use this
           program for any purpose is given, as long as the copyright
           is kept intact.

## INITIALIZATION

           During initialization, FvwmScroll will eventually search a
           configuration file which describes the colors to use.  The
           configuration  file is the same file that fvwm used during
           initialization.

           If the FvwmScroll executable is linked to another name, ie
           ln  -s  FvwmScroll  MoreScroll, then another module called
           MoreScroll can be started,  with  a  completely  different
           configuration than FvwmScroll, simply by changing the key-
           word  FvwmScroll to MoreScroll.

## INVOCATION

           file.  The parameter x and y are integers, which  describe
           the  horizontal  and vertical window size reduction.  Fvwm
           will search directory specified in the ModulePath configu-
           ration  option  to  attempt to locate FvwmScroll. Although
           nothing keeps you from launching  FvwmScroll  at  start-up
           time, you probably don't want to.

## CONFIGURATION OPTIONS

           FvwmScroll  reads the same .fvwmrc file as fvwm reads when
           it starts up, and looks for lines as listed below:

           *FvwmScrollFore color
                  Tells the module to use color instead of  grey  for
                  scroll bars themselves.

           *FvwmScrollBack color
                  Tells  the module to use color instead of black for
                  the window background.

## BUGS

           When the scroll bars are removed by clicking on the button
           in the lower right corner, the window does not restore its
           location correctly.

## AUTHOR

           Robert Nation