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-convert-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 CONFIGURATIONS" 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>.