NAME

       FvwmScroll - the FVWM scroll-bar module

SYNOPSIS

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

DESCRIPTION

       The  FvwmScroll  module  prompts  the user to select a target window, if the module was not launched from
       within a window 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
       "*FvwmScrollFore 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 keyword  FvwmScroll to MoreScroll.

INVOCATION

       FvwmScroll can be invoked by binding the action 'Module FvwmScroll x y' to a menu or  key-stroke  in  the
       .fvwmrc 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 configuration  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