FvwmSaveDesk(1)

NAME
FvwmSaveDesk - another fvwm desktop-layout saving module

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

DESCRIPTION
When called, this module will attempt to save your current desktop layout as a definition of extra lines for the function InitFunction into the file .fvwm2desk in your home directory. As explain in the other documentation, this function is called at startup of fvwm. You have to include this file in .fvwm2rc after the definition of the Function Initfunction. You can do this by using the module FvwmM4 or FvwmCpp. Your applications must supply certain hints to the X window system. Emacs and Netscape, for example, does not, so FvwmSaveDesk can't get any information from it. Also, FvwmSaveDesk assumes that certain command line options are globally accepted by applications, which may not be the case.

SETUP USING FVWMM4 MODULE
The M4 Macro processor substitutes its macros even in the middle of a word. Because of that you may have problems with predefined macros such as include or define. To avoid this the GNU M4 has an extra option to prefix all builtins with 'm4_'. FvwmM4 can be called with option -m4-prefix and then will provide the option -P to M4. I personally use the FvwmM4 module this way.

fvwm -cmd "FvwmM4 -m4-prefix -m4opt -I$HOME $HOME/.fvwm2rc"

Simply add the following line to the end of .fvwm2rc:

m4_include(`.fvwm2desk') .

SETUP USING FVWMCPP MODULE
With the FvwmCpp you may have the problem that the preprocessor directives starts with the comment character '#' and will complain about unknown directives, if you have comments in your .fvwm2rc.

fvwm -cmd "FvwmCpp -C-I$HOME $HOME/.fvwm2rc"

Simply add the following line to the end of .fvwm2rc:

#include ".fvwm2desk"

INVOCATION
FvwmSaveDesk can be invoked by adding it to a menu or binding it to a mouse button or key stroke in the .fvwm2rc file. Fvwm will search directory specified in the ModulePath configuration option to locate FvwmSaveDesk. To insert it to a menu, add the line

+	"Save Desktop" Module FvwmSaveDesk

to the menu definition. I thing binding it to a mouse button is not very useful, but you can do that, by adding for example this line.

Mouse 3		R	CS	Module FvwmSaveDesk

Than FvwmSaveDesk will be called if you hit the right mouse button on the root window while holding the shift and control button down. You can bind FvwmSaveDesk to a function key F10 for example you have to insert the following line:

Key	F10	A	Module FvwmSaveDesk

I personally add it as a Button to the module FvwmButtons:

*FvwmButtons SaveDesc desk.xpm   Module FvwmSaveDesk

AUTHOR
Carsten Paeth (calle@calle.in-berlin.de)