FvwmConf


FvwmConf is an interactive tool for configuring the window manager
Fvwm2.  It does not write an .fvwm2rc file. Rather it keeps its own
table of variables and sends them to fvwm2.  It is not yet
complete. For instance it cannot maintain menus.  It can be used in
conjunction with an .fvwm2rc file, and you can use it to replace only
as much of the rc file's function as you like.

To scroll text in any entry or list, try putting the mouse in the
middle of the text, holding the second button, and dragging. (Up and
Down arrows, PageUp and PageDown work in help windows) See also the Tk
documentation on &&Tkedit:editing&& in text and entry widgets

Most views on lists and text (such as this help window) can be
expanded by resizing the window.

Things that turn green when the mouse moves over them will pop-up a
help window when you click on them.


The simplest way to use FvwmConf is to use the tools (color-, font-,
and image selectors) and panels to browse the possibilities and apply
them.
 You will see the changes reflected immediately.  When you are
satisfied, select "Save" from the file menu.
 When you start FvwmConf next time, your choices will be restored.
You can also dump the fvwm2 commands to a file if you prefer to
include them in your .fvwm2rc file.  To dump a configuration, choose
the 'Write' option from the 'File' menu.

**************************************************

A Little More:

You configure the window manager by specifying values for various
parameters.  I'll call a set of such specifications a "configuration".
You can define several configurations and load and save them via a
list box.

There are three classes of parameters that you can set, global, Decor,
and Style parameters.  To begin with you do not need to worry about
the differences among these classes.  However, in order to give
different decorations to different windows, you will need to know
something about them.

Global parameters apply to the entire window session.  That is, for a
given configuration, these settings apply to all windows.

Style and Decor parameters can be set differently for different
windows. For instance, you can give one application window a red
border and another a green border.  If you do nothing to create new
Decors and Styles, then all parameters will apply to the default Style
and Decor , and all windows will follow these parameters.


Styles and Decors are applied to windows in different ways.  The name
of a Style determines the windows to which it will apply. A simple
example is making a Style for an xterm.  To do this, first choose
'Style' from the 'Configure' menu.  Then choose 'Select Style' from
the Style panel.  Enter the new Style name 'xterm' , and click
'load'. Notice that the Style name on the Style panel changes to
'xterm' and the displayed values change.  Now if you change parameters
and click 'Apply' , they will only apply to xterms (roughly).  To
re-edit Styles that you've already created, go back to the 'Select
Style' box and double click on the one you want.

Notice that the xterm Style initially has the 'Use Decor' entry set to
'default'.  This means that the xterm will use all the parameters of
the default Decor.  You can edit these by choosing 'Decor' from the
'Configure' menu.  You can also create a separate Decor for xterms.
To do this, double click on the word 'default' in the 'Use Decor'
entry of the xterm Style.  Then type 'xterm' and click 'Apply'. The
Decor panel will appear with the xterm Decor initialized.  (Currently
a copy of the default Decor is made.)
	
The Decor used by the xterm Style does not need to be named 'xterm'.
The Decor used by an xterm will be whatever name you type in the 'Use
Decor' entry.  You can also have more than one Style with the same
'Use Decor' entry. In this case, they will all use the same Decor.

 You can use the wildcard characters, '*' and '?', in Style names to
match several window names with one Style.  The '*' matches any number
of letters and the '?' matches any single letter.  For instance, a
Style named, 'xterm*', will match any window whose title begins with
the word 'xterm'.

Notice that when you first open the Style panel, it says that the
current Style is named '*'.  This is the default Style. Any window
name matches this Style.

**************************************************

How to do some Things

Create A New Configuration

Choose 'Save As' from the 'File' menu, and choose a name for the new
configuration.  Choose 'Clear' from the 'File' menu to clear all the
parameters for this configuration.  Some parameters may not appear to
be cleared unless you restart fvwm2.  If you don't choose 'Clear', the
new configuration begins with the same values as the previous one.

Create a new Style

Choose 'Style' from the 'Configure' menu. Choose 'Select Style' from
the 'Style' panel. Follow the directions from the 'Select Style' help
button.

Create a new Decor

Choose 'Decor' from the 'Configure' menu. Choose 'Select Decor' from
the 'Decor' panel. Follow the directions from the 'Select Decor' help
button.  Alternatively, entering a name in the 'Use Decor' entry on
the 'Style' panel and clicking on 'Apply' will create the Decor if it
does not already exist.

Undo

See the note on history at the bottom of this page.


Change .fvwm2rc to include changes.

The parameters set by fvwmconf are not stored in the .fvwm2rc file. So
you need to start fvwmconf to read them.  However you can &&filemenu:write&& 
the commands 
to a file, and they will be read by fvwm2 without running fvwmconf.

**************************************************

Help on the &&filemenu:File Menu&&

Help on the &&configure:Configure Menu&&

**************************************************

More Documentation

Read the fvwm2 man page for more information. 

Read the .fvwconf/.fvwmconfrc file for a few parameters that 
you may need to set there.

**************************************************

Some Features to Note
      
Clicking the third mouse button in an entry or on some buttons brings
up a list of the history of the variable for that entry or button.

Single clicks select radiobuttons.  If you double click on a
radiobutton, all of the radio buttons for that parameter are
deselected.  Then fvwmconf does nothing for that parameter and fvwm
uses its default value for that parameter.

Menus are attached to the frame with a dotted line.  Releasing on the
dotted line detaches the menu and leaves it on the screen

Much of the state of the program is saved between sessions.  For
instance, tools which are open upon exiting will be opened when you
next run FvwmConf.