1fvwm-convert-2.6(1) Fvwm Modules fvwm-convert-2.6(1)
2
3
4
6 fvwm-convert-2.6 - convert fvwm 2.4.x configuration file to fvwm 2.6
7 style
8
10 fvwm-convert-2.6 [--follow-read|-f] [--help|-h] source [dest]
11
13 The following options are supported:
14
15 --help | -h
16 Prints a usage message to the screen.
17
18 --follow-read | -f
19 Follows files found along with the Read command.
20
22 fvwm-convert-2.6 converts an fvwm 2.4.x configuration file into a fvwm
23 2.6 file with compatible syntax. It is not suitable to convert older
24 2.x configuration files. Please use fvwm-convert-2.2 to convert these
25 to the 2.2.x format first, and then if necessary fvwm-convert-2.4
26
27 By default, fvwm-convert-2.6 won't look for a given config file. This
28 must be specified as the first parameter to fvwm-convert-2.6. Differ‐
29 ent source and destination files may be given. If the destination file
30 already exists, this program exits. If no destination file is given,
31 then the filename is the same name as the source file with the suffix
32 ".converted" added. Without an absolute path given as the destination
33 path to the destination file, the program will create the destination
34 file in the CWD.
35
36 fvwm-convert-2.6 makes the following changes:
37
38 Style lines
39 In fvwm 2.4, most style options could be negated from their coun‐
40 terparts using NoFoo -- fvwm-convert-2.6 corrects this by now using
41 !Foo.
42
43 ModulePath
44 In fvwm 2.4 and beyond, the ModulePath is compiled into fvwm.
45 fvwm-convert-2.6 comments out any ModulePath commands it finds. If
46 you are using your own modules, (not the ones that come with fvwm),
47 you will have to fix your configuration file after using fvwm-con‐
48 vert-2.6.
49
50 Conditional command syntax
51 In fvwm 2.4, the conditional command options were whitespace-sepa‐
52 rated -- they should now be comma-separated instead. In addition,
53 the older syntax to Next and Prev of using [*] to denote all win‐
54 dows has been removed entirely. Both these checks and conversions
55 are done on function commands, key/mouse bindings.
56
57 WindowShadeSteps
58 In fvwm 2.4, the WindowShadeSteps command is replaced by the Win‐
59 dowShadeSteps Style option. fvwm-convert-2.6 makes this change.
60
61 FvwmTheme
62 In fvwm 2.6, the FvwmTheme module is replaced by a series of Col‐
63 orset commands. Whilst fvwm-convert-2.6 will try and make this
64 change, it is still recommended that this is checked after conver‐
65 sion.
66
67 EdgeResistance
68 In fvwm 2.6, the EdgeResistance command is has been split to
69 include an additional style option for EdgeMoveResistance. fvwm-
70 convert-2.6 makes any changes necessary.
71
72 StartFunction / RestartFunction / InitFunction
73 In fvwm 2.6, the need for using InitFunction and/or RestartFunction
74 is redundant when StartFunction is read at both of these times.
75 fvwm-convert-2.6 attempts to convert this.
76
77 Read
78 If -f or --follow-read is given, any files fvwm-convert-2.6 can
79 detect and open will be converted automatically, else a list of
80 files that can be followed are printed to the screen.
81
82
83
84 BUGS
85
86 InitFunction and RestartFunction and hence StartFunction are
87 printed at the end of the files -- this slight reordering might
88 put some comments before in an odd spot.
89
90 When converting over FvwmTheme lines, the colorset definitions
91 might well be broken, but these cannot easily be converted.
92
93 Bug reports can be sent to the fvwm-workers mailing list (see
94 the FAQ).
95
97 Thomas Adam <thomas.adam22@gmail.com>
98
99
100
101Fvwm 05 September 2019 (2.6.9) fvwm-convert-2.6(1)