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>