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

Fvwm                                          20 April 2012 (2.6.5)                          fvwm-convert-2.4(1)