# These comments will not appear in the help text.
# the displayer will break paragraphs on blank lines
# use \n to insert real blank lines
#
FvwmConf \n

#Introduction\n

FvwmConf is an interactive tool for configuring the window manager
Fvwm2.  Many features are implemented, however, 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.

\nHow to get around\n

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\n

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

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

      
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.  You can
choose one of the previous values from this list.

\n Shift click in an entry , or on an item in a history list
brings up a tool to display 
the value (only solid colors and images).

\nSingle 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.

\nMenus 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.

You can change the fonts used by FvwmConf itself. This feature is reached via
the font selection tool.

\n******************************************************************

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' &&filemenu:menu&& . You can read  an .fvwm2rc file from the
'File' menu.


\n When restarting fvwm2, you need to restart Fvwmconf as well.
An instance of Fvwmconf from the previous session will not
be able to talk to fvwm2, and will crash when it tries.

\n**************************************************\n

A Little More:\n

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.
\n\n

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.

\n 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.

\n**************************************************\n

How to do some Things\n
\nCreate A New Configuration\n
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.\n

Create a new Style\n
Choose 'Style' from the 'Configure' menu. Choose 'Select Style' from the 
'Style' panel. Follow the directions from the 'Select Style' help button.\n

Create a new Decor\n
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.\n

Undo\n
See the note on history at the bottom of this page.

\n
Change  .fvwm2rc to include changes.\n
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.

\n**************************************************\n

Help on the &&filemenu:File Menu&&

Help on the &&configure:Configure Menu&&
\n**************************************************\n
\nMore Documentation\n
\nRead the fvwm2 man page for more information. 

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

&&CHANGELOG:CHANGELOG&&\n
&&README:Installation Instructions&&\n

\n**************************************************\n


















