           FvwmBacker - the FVWM background changer module

## SYNOPSIS

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

## DESCRIPTION

           The FvwmBacker module provides functionality to change the
           background  when  changing  desktops.   Any command can be
           executed to change the backgrounds.  The commands used  to
           change  the  backgrounds must exit after changing the root
           window, (i.e. 'xv -root zzz.gif'  does  not,  without  the
           -quit option) otherwise FvwmBacker will hang.

## COPYRIGHTS

           The FvwmBacker module is the original work of Mike Finger.

           Copyright 1994, Mike Finger. The author makes  no  guaran-
           tees  or warranties of any kind about the use of this mod-
           ule.  Use this modules at your own risk.  You  may  freely
           use  this  module  or any portion of it for any purpose as
           long as the copyright is kept intact.

## INITIALIZATION

           During initialization, FvwmBacker will scan the same  con-
           figuration  file that FVWM used during startup to find the
           options that pertain to it.  These options  are  discussed
           in a later section.

## INVOCATION

           FvwmBacker can be invoked by fvwm during initialization by
           inserting the line  'Module  FvwmBacker'  in  the  .fvwmrc
           file.

           FvwmBacker  must  reside  in a directory that is listed in
           the ModulePath option of FVWM for it  to  be  executed  by
           FVWM.

## CONFIGURATION OPTIONS

           The following is the only supported option at present:

           *FvwmBackerDesk DeskNumber command
                  Specifies the command to execute when the specified
                  DeskNumber becomes active.

                  If the command begins with -solid  FvwmBacker  uses
                  ing  a  system  call  to xsetroot. Only single word
                  color names may be used.

## SAMPLE CONFIGURATION

           The following  are  excepts  from  a  .fvwmrc  file  which
           describe FvwmBacker initialization commands:

           ####
           # Set Up Backgrounds for different desktops.
           ####
           *FvwmBackerDesk 0 -solid steelblue
           *FvwmBackerDesk 1 -solid midnightblue
           *FvwmBackerDesk 2 -solid yellow
           *FvwmBackerDesk 3 xpmroot /usr/include/X11/pixmaps/background2.xpm

## AUTHOR

           Mike Finger (mfinger@mermaid.micro.umn.edu)
                       (Mike_Finger@atk.com)
                       (doodman on IRC, check the #linux channel)

## Modified by

           Andrew Davison (davison@cs.monash.edu.au)