Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FVWM-CONVERT-2.6(1)					     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

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  con-
     figuration 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.  With-
     out 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 counter-
	 parts 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-con-
	 vert-2.6 comments out any ModulePath commands it finds. If you are  us-
	 ing 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 re-
	 moved	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  Window-
	 ShadeSteps 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-con-
	 vert-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@fvwm.org

				   2026-06-27		     FVWM-CONVERT-2.6(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fvwm-convert-2.6&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help