1fvwm-convert-2.4(1) Fvwm Modules fvwm-convert-2.4(1)
2
6 fvwm-convert-2.4 - convert fvwm 2.2.x configuration file to fvwm 2.4
7 syntax
8
10 fvwm-convert-2.4 [source] [dest]
11
13 fvwm-convert-2.4 converts an fvwm 2.2.x configuration file into an fvwm
14 2.4 compatible syntax. It is not suitable to convert older 1.x config‐
15 uration files. Please use fvwm-convert-2.2 to convert these to the
16 2.2.x format first.
17 By default, fvwm-convert-2.4 converts ~/.fvwm2rc, saving the results in
19 ~/.fvwm/.fvwm2rc. You must create the ~/.fvwm directory before running
20 this command. Starting with the 2.4 release, the directory ~/.fvwm is
21 the default location for fvwm user configuration files. Different
22 source and destination files may be given. If the destination file
23 already exists, this program exits. While the program runs it will
24 generate a temporary file with the same name as the destination file
25 with the suffix ".pass1" added.
26 fvwm-convert-2.4 makes the following changes:
28 PixmapPath/IconPath
30 In fvwm 2.4, the PixmapPath and IconPath commands are replaced by
31 the ImagePath command. In addition, the ImagePath can be compiled
32 into fvwm. fvwm-convert-2.4 changes the PixmapPath and IconPath
33 commands to ImagePath commands and removes any directories that are
34 compiled into fvwm. Paths starting with a dollar sign are also
35 removed.
36 ModulePath
38 In fvwm 2.4, the ModulePath is compiled into fvwm. fvwm-con‐
39 vert-2.4 removes any ModulePath commands it finds. If you are
40 using your own modules, (not the ones that come with fvwm), you
41 will have to fix your configuration file after using fvwm-con‐
42 vert-2.4.
43 HilightColor
45 In fvwm 2.4, the HighlightColor command is replaced by a Style com‐
46 mand using the HilightFore and HilightBack arguments. fvwm-con‐
47 vert-2.4 makes these changes.
48 HilightColorset
50 In fvwm 2.4, the HighlightColorset command that was present in some
51 of the 2.3.x beta releases is replaced by a Style command using the
52 HilightColorset style. fvwm-convert-2.4 makes these changes.
53 WindowShadeAnimate
55 In fvwm 2.4, the WindowShadeAnimate command is replaced by the Win‐
56 dowShadeSteps Style option. fvwm-convert-2.4 makes this change.
57 WindowFont
59 In fvwm 2.4, the WindowFont command is replaced by a Style command
60 using the Font argument. fvwm-convert-2.4 makes this change.
61 ColorLimit
63 In fvwm 2.4, the ColorLimit command is automatic. If you have a
64 limited colormap, color limiting is the default. fvwm-convert-2.4
65 removes any ColorLimit command that it finds.
66 GlobalOpts
68 The GlobalOpts command is converted to Style options and the
69 BugOpts command. Some options can not be converted automatically,
70 though.
71 Read
73 Prints a message identifying any read commands found. The files
74 being read may need to be converted also.
75 Placement Styles
77 Any of the old placement Styles found in the file can not be con‐
78 verted automatically. Instead, fvwm-convert-2.4 prints a warning.
79 For details about the conversion, please refer to the "Window man‐
80 ager placement" section of the fvwm man page.
81 FvwmConfig and FvwmPipe
83 These modules are no longer a part of the fvwm distribution. fvwm-
84 convert-2.4 prints a warning if these modules are found in the
85 file.
86 FvwmButtons panels
88 The syntax of panels in FvwmButtons has changed. The conversion
89 can not be done automatically. fvwm-convert-2.4 prints a message
90 when it encounters a potential panel definition. For details about
91 the conversion, please refer to the "CONVERTING OLD PANEL CONFIGU‐
92 RATIONS" section of the FvwmButtons man page.
93
95 You need Perl to be installed.
96 WindowFont and HilightColor commands embedded in functions are not
98 found. If you have either of these commands in functions, they are not
99 detected.
100 Known bugs can be found in the fvwm bug tracking system (accessible
102 from the fvwm home page).
103 Bug reports can be sent to the fvwm-workers mailing list (see the FAQ).
105
108 Dan Espen <despen@telcordia.com>.
109Fvwm 24 November 2007 (2.5.24) fvwm-convert-2.4(1)