FVWM24_CONVERT(1)                               FVWM24_CONVERT(1)



NAME
       fvwm24_convert  - convert FVWM 2.2.x configuration file to
       FVWM 2.4 syntax

SYNOPSIS
       fvwm24_convert source dest

DESCRIPTION
       fvwm24_convert 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
       fvmmrc_convert to convert these to the 2.2.x format first.

       By default, fvwm24_convert 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.

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

       HilightColor
           In fvwm 2.4, the HighlightColor command is replaced by
           a  Style command using the HilightFore and HilightBack
           arguments.  fvwm24_convert 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.
           fvwm24_convert makes these changes.

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

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

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

       GlobalOpts
           The GlobalOpts command is converted to  Style  options
           and the BugOpts command.  Some options can not be con-
           verted 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,  fvwm24_con-
           vert  prints a warning.  For details about the conver-
           sion, please refer to the "Window  manager  placement"
           section of the fvwm2 man page.

       FvwmConfig and FvwmPipe
           These modules are no longer a part of the fvwm distri-
           bution.  fvwm24_convert prints a warning if these mod-
           ules are found in the file.

       FvwmButtons panels
           The  syntax of panels in FvwmButtons has changed.  The
           conversion can not be done automatically.  fvwm24_con-
           vert  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 .



                           3 July 2001          FVWM24_CONVERT(1)