


FvwmScroll(1)                                       FvwmScroll(1)


NAME
       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
       FvwmScroll can be invoked by binding  the  action  'Module



1.20                      April 14 1994                         1





FvwmScroll(1)                                       FvwmScroll(1)


       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 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

























1.20                      April 14 1994                         2


