NAME

       fvwm-convert-2.6 - convert fvwm 2.4.x configuration file to fvwm 2.6 style

SYNOPSIS

       fvwm-convert-2.6 [--follow-read|-f] [--help|-h] source [dest]

OPTIONS

       The following options are supported:

       --help | -h
              Prints a usage message to the screen.

       --follow-read | -f
              Follows files found along with the Read command.

DESCRIPTION

       fvwm-convert-2.6  converts  an  fvwm  2.4.x  configuration  file into a fvwm 2.6 file with
       compatible syntax.  It is not suitable to convert older 2.x configuration  files.   Please
       use  fvwm-convert-2.2  to  convert  these to the 2.2.x format first, and then if necessary
       fvwm-convert-2.4

       By default, fvwm-convert-2.6 won't look for a given config file.  This must  be  specified
       as the first parameter to fvwm-convert-2.6.  Different source and destination files may be
       given.  If the destination file already exists, this program  exits.   If  no  destination
       file  is  given,  then  the  filename  is the same name as the source file with the suffix
       ".converted" added.  Without an absolute  path  given  as  the  destination  path  to  the
       destination file, the program will create the destination file in the CWD.

       fvwm-convert-2.6 makes the following changes:

       Style lines
           In  fvwm  2.4, most style options could be negated from their counterparts using NoFoo
           -- fvwm-convert-2.6 corrects this by now using !Foo.

       ModulePath
           In fvwm 2.4 and beyond,  the  ModulePath  is  compiled  into  fvwm.   fvwm-convert-2.6
           comments  out  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.6.

       Conditional command syntax
           In  fvwm 2.4, the conditional command options were whitespace-separated -- they should
           now be comma-separated instead.  In addition, the older syntax to  Next  and  Prev  of
           using  [*]  to  denote  all  windows has been removed entirely.  Both these checks and
           conversions are done on function commands, key/mouse bindings.

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

       FvwmTheme
           In  fvwm  2.6,  the  FvwmTheme  module  is  replaced by a series of Colorset commands.
           Whilst fvwm-convert-2.6 will try and make this change, it is  still  recommended  that
           this is checked after conversion.

       EdgeResistance
           In  fvwm  2.6,  the  EdgeResistance command is has been split to include an additional
           style option for EdgeMoveResistance.  fvwm-convert-2.6 makes any changes necessary.

       StartFunction / RestartFunction / InitFunction
           In fvwm 2.6, the need for using InitFunction and/or RestartFunction is redundant  when
           StartFunction  is  read  at both of these times.  fvwm-convert-2.6 attempts to convert
           this.

       Read
           If -f or --follow-read is given, any files fvwm-convert-2.6 can detect and  open  will
           be  converted  automatically, else a list of files that can be followed are printed to
           the screen.

       BUGS

              InitFunction and RestartFunction and hence StartFunction are printed at the end  of
              the files -- this slight reordering might put some comments before in an odd spot.

              When  converting  over  FvwmTheme  lines,  the  colorset  definitions might well be
              broken, but these cannot easily be converted.

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

AUTHOR

       Thomas Adam <thomas.adam22@gmail.com>