fvwm-convert-2.4(1)						   Fvwm Modules 					       fvwm-convert-2.4(1)

NAME

       fvwm-convert-2.4 - convert fvwm 2.2.x configuration file to fvwm 2.4 syntax

SYNOPSIS

       fvwm-convert-2.4 [source] [dest]

DESCRIPTION

       fvwm-convert-2.4  converts  an  fvwm  2.2.x configuration file into an fvwm 2.4 compatible syntax.  It is not suitable to convert older 1.x
       configuration files.  Please use fvwm-convert-2.2 to convert these to the 2.2.x format first.

       By default, fvwm-convert-2.4 converts ~/.fvwm2rc, saving the results in ~/.fvwm/.fvwm2rc.  You must create  the	~/.fvwm  directory  before
       running	this  command.	 Starting  with  the 2.4 release, the directory ~/.fvwm is the default location for fvwm user configuration files.
       Different source and destination files may be given.  If the destination file already exists, this program exits.  While the  program  runs
       it will generate a temporary file with the same name as the destination file with the suffix ".pass1" added.

       fvwm-convert-2.4 makes the following changes:

       PixmapPath/IconPath
	   In  fvwm  2.4,  the PixmapPath and IconPath commands are replaced by the ImagePath command.	In addition, the ImagePath can be compiled
	   into fvwm.  fvwm-convert-2.4 changes the PixmapPath and IconPath commands to ImagePath commands and removes any  directories  that  are
	   compiled into fvwm.	Paths starting with a dollar sign are also removed.

       ModulePath
	   In  fvwm  2.4, the ModulePath is compiled into fvwm.  fvwm-convert-2.4 removes any ModulePath commands it finds.  If you are using your
	   own modules, (not the ones that come with fvwm), you will have to fix your configuration file after using fvwm-convert-2.4.

       HilightColor
	   In fvwm 2.4, the HighlightColor command is replaced by a Style command using the  HilightFore  and  HilightBack  arguments.	 fvwm-con-
	   vert-2.4 makes these changes.

       HilightColorset
	   In fvwm 2.4, the HighlightColorset command that was present in some of the 2.3.x beta releases is replaced by a Style command using the
	   HilightColorset style.  fvwm-convert-2.4 makes these changes.

       WindowShadeAnimate
	   In fvwm 2.4, the WindowShadeAnimate command is replaced by the WindowShadeSteps Style option.  fvwm-convert-2.4 makes this change.

       WindowFont
	   In fvwm 2.4, the WindowFont command is replaced by a Style command using the Font argument.	fvwm-convert-2.4 makes this change.

       ColorLimit
	   In fvwm 2.4, the ColorLimit command is automatic.  If you have a limited colormap, color limiting  is  the  default.   fvwm-convert-2.4
	   removes any ColorLimit command that it finds.

       GlobalOpts
	   The GlobalOpts command is converted to Style options and the BugOpts command.  Some options can not be converted automatically, though.

       Read
	   Prints a message identifying any read commands found.  The files being read may need to be converted also.

       Placement Styles
	   Any of the old placement Styles found in the file can not be converted automatically.  Instead, fvwm-convert-2.4 prints a warning.  For
	   details about the conversion, please refer to the "Window manager placement" section of the fvwm man page.

       FvwmConfig and FvwmPipe
	   These modules are no longer a part of the fvwm distribution.  fvwm-convert-2.4 prints a warning if these modules are found in the file.

       FvwmButtons panels
	   The syntax of panels in FvwmButtons has changed.  The conversion can not be done automatically.  fvwm-convert-2.4 prints a message when
	   it  encounters  a  potential  panel definition.  For details about the conversion, please refer to the "CONVERTING OLD PANEL CONFIGURA-
	   TIONS" section of the FvwmButtons man page.

BUGS

       You need Perl to be installed.

       WindowFont and HilightColor commands embedded in functions are not found.  If you have either of these commands in functions, they are  not
       detected.

       Known bugs can be found in the fvwm bug tracking system (accessible from the fvwm home page).

       Bug reports can be sent to the fvwm-workers mailing list (see the FAQ).

AUTHOR

       Dan Espen <despen@telcordia.com>.

Fvwm								7 May 208 (2.5.26)					       fvwm-convert-2.4(1)