NAME¶
fvwm-convert-2.4 - convert fvwm 2.2.x configuration file to fvwm 2.4 syntax
SYNOPSIS¶
fvwm-convert-2.4 [
source] [
dest]
DESCRIPTION¶
fvwm-convert-2.4 converts an fvwm 2.2.x configuration file into an fvwm
2.4 compatible syntax. It is not suitable to convert older 1.x configuration
files. Please use
fvwm-convert-2.2 to convert these to the 2.2.x format
first.
By default,
fvwm-convert-2.4 converts
~/.fvwm2rc, saving the
results in
~/.fvwm/.fvwm2rc. You must create the
~/.fvwm
directory before running this command. Starting with the 2.4 release, the
directory
~/.fvwm is the default location for fvwm user configuration
files. Different source and destination files may be given. If the destination
file already exists, this program exits. While the program runs it will
generate a temporary file with the same name as the destination file with the
suffix ".pass1" added.
fvwm-convert-2.4 makes the following changes:
- PixmapPath/IconPath
- In fvwm 2.4, the PixmapPath and IconPath commands are
replaced by the ImagePath command. In addition, the ImagePath can be
compiled into fvwm. fvwm-convert-2.4 changes the PixmapPath and
IconPath commands to ImagePath commands and removes any directories that
are compiled into fvwm. Paths starting with a dollar sign are also
removed.
- ModulePath
- In fvwm 2.4, the ModulePath is compiled into fvwm.
fvwm-convert-2.4 removes 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.4.
- HilightColor
- In fvwm 2.4, the HighlightColor command is replaced by a
Style command using the HilightFore and HilightBack arguments.
fvwm-convert-2.4 makes these changes.
- HilightColorset
- In fvwm 2.4, the HighlightColorset command that was present
in some of the 2.3.x beta releases is replaced by a Style command using
the HilightColorset style. fvwm-convert-2.4 makes these
changes.
- WindowShadeAnimate
- In fvwm 2.4, the WindowShadeAnimate command is replaced by
the WindowShadeSteps Style option. fvwm-convert-2.4 makes this
change.
- WindowFont
- In fvwm 2.4, the WindowFont command is replaced by a Style
command using the Font argument. fvwm-convert-2.4 makes this
change.
- ColorLimit
- In fvwm 2.4, the ColorLimit command is automatic. If you
have a limited colormap, color limiting is the default.
fvwm-convert-2.4 removes any ColorLimit command that it finds.
- GlobalOpts
- The GlobalOpts command is converted to Style options
and the BugOpts command. Some options can not be converted
automatically, though.
- Read
- Prints a message identifying any read commands found. The
files being read may need to be converted also.
- Placement Styles
- Any of the old placement Styles found in the file can not
be converted automatically. Instead, fvwm-convert-2.4 prints a
warning. For details about the conversion, please refer to the
"Window manager placement" section of the fvwm man page.
- FvwmConfig and FvwmPipe
- These modules are no longer a part of the fvwm
distribution. fvwm-convert-2.4 prints a warning if these modules
are found in the file.
- FvwmButtons panels
- The syntax of panels in FvwmButtons has changed. The
conversion can not be done automatically. fvwm-convert-2.4 prints a
message when it encounters a potential panel definition. For details about
the conversion, please refer to the "CONVERTING OLD PANEL
CONFIGURATIONS" section of the FvwmButtons man page.
BUGS¶
You need Perl to be installed.
WindowFont and
HilightColor commands embedded in functions are not
found. If you have either of these commands in functions, they are not
detected.
Known bugs can be found in the fvwm bug tracking system (accessible from the
fvwm home page).
Bug reports can be sent to the fvwm-workers mailing list (see the
FAQ).
AUTHOR¶
Dan Espen <despen@telcordia.com>.