.\" t
.\" @(#)FvwmBacker.1	11/8/94
.TH FvwmBacker 1 "September 8th, 1994"
.UC
.SH NAME
FvwmBacker \- the FVWM background changer module
.SH SYNOPSIS
FvwmBacker is spawned by fvwm, so no command line invocation will work.

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

.SH COPYRIGHTS
The FvwmBacker module is the original work of Mike Finger.

Copyright 1994, Mike Finger. The author makes no guarantees or warranties of
any kind about the use of this module.  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. 

.SH INITIALIZATION
During initialization, \fIFvwmBacker\fP will scan the same configuration file
that FVWM used during startup to find the options that pertain to it.  These
options are discussed in a later section.

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

.SH CONFIGURATION OPTIONS
The follow option is the only only support at present

.IP "*FvwmWinListDesk \fIDeskNumber command\fP"
Specifies the \fIcommand\fP to execute when the specified \fIDeskNumber\fP
becomes active.

If the command begins with \fI-solid\fP FvwmBacker uses the next argument
as a color in the X database and sets the background to that color
without generating a system call to xsetroot. Only single word
color names may be used.

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

.nf
.sp
####
# 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
.sp
.fi

.SH AUTHOR
Mike Finger (mfinger@mermaid.micro.umn.edu)
            (Mike_Finger@atk.com)
            (doodman on IRC, check the #linux channel)
.SH Modified by
Andrew Davison (davison@cs.monash.edu.au)