FvwmWinList(1)						      General Commands Manual						    FvwmWinList(1)

NAME

       FvwmWinList - the FVWM window list module

SYNOPSIS

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

DESCRIPTION

       The  FvwmWinList  module  provides  a widow list made up of buttons, each corresponding to a window that FVWM is managing.  Clicking on the
       buttons with any of the three mouse buttons will either do a default action or can be user configured.  Like the other modules, FvwmWinList
       only works when fvwm is used as the window manager.

COPYRIGHTS

       The FvwmWinList 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.

INITIALIZATION

       During initialization, FvwmWinList 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.

INVOCATION

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

       FvwmWinList  can also be bound to a keystroke, mouse button, or menu option to be invoked later, in this case using 'Transient' as an argu-
       ment will cause FvwmWinList to resemble the built in window list.

       FvwmWinList 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 options can be placed in the .fvwmrc file

       *FvwmWinListGeometry {+-}<X>x{+-}<Y>
	      Specifies the location and gravity of the FvwmWinList window.  At the current time, size	is  not  supported  and  FvwmWinList  will
	      resize  itself  as buttons are added.  If the NoAnchor option is not specified then the windows gravity corner will be anchored, and
	      the window will grow in the opposite direction.  (i.e. If the geometry is specified -5-5, that is SoutEastGravity.  This will  cause
	      the window to draw up and to the left as windows are added)

       *FvwmWinListFont font
	      Specifies the font to be used for labeling the buttons.

       *FvwmWinListFore color
	      Specifies the color to use for the button names.

       *FvwmWinListBack color
	      Specifies the color for the buttons.

       *FvwmWinListUseSkipList
	      Tells FvwmWinList to not show the windows that are listed on a WindowListSkip line if the configuration file.

       *FvwmWinListNoAnchor
	      By default, FvwmWinList will anchor the gravity corner so the window will grow in the opposite direction.  This undoes that option.

       *FvwmWinListUseIconNames
	      Tells  FvwmWinList to use the icon name of the window instead of the full window name.  This is useful to keep the width of the win-
	      dow small.

       *FvwmWinListAction action response[,reponse...]
	      Tells FvwmWinList to do response when action is done.  The currently supported actions are: Click1, Click2, Click3.   The  currently
	      supported responses are any fvwm built-in commands, including modules and functions.

SAMPLE CONFIGURATION

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

       ########
       # Pop up the window list in tranient mode on button 3 press & hold

       Mouse 3	 R   A	 Module "FvwmWinList" FvwmWinList Transient

       ########################## Window-Lister ###############################
       *FvwmWinListBack DarkOliveGreen
       *FvwmWinListFore PaleGoldenRod
       *FvwmWinListFont -*-new century schoolbook-bold-r-*-*-*-120-*-*-*-*-*-*
       *FvwmWinListAction Click1 Iconify -1,Raise
       *FvwmWinListAction Click2 Iconify
       *FvwmWinListAction Click3 Module "FvwmIdent" FvwmIdent
       *FvwmWinListUseSkipList
       *FvwmWinListUseIconNames
       *FvwmWinListGeometry -50-85
       # I like it achored
       #*FvwmWinListNoAnchor

AUTHOR

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

3rd Berkeley Distribution					   May 9th, 1994						    FvwmWinList(1)