fvwm-convert-2.6(1) Fvwm Modules fvwm-convert-2.6(1)

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>

Fvwm 19 October 2022 (2.7.0) fvwm-convert-2.6(1)