Man Linux: Main Page and Category List

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