1fvwm-convert-2.6(1)              Fvwm Modules              fvwm-convert-2.6(1)
2
3
4

NAME

6       fvwm-convert-2.6  -  convert  fvwm 2.4.x configuration file to fvwm 2.6
7       style
8

SYNOPSIS

10       fvwm-convert-2.6 [--follow-read|-f] [--help|-h] source [dest]
11

OPTIONS

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

DESCRIPTION

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

AUTHOR

97       Thomas Adam <thomas.adam22@gmail.com>
98
99
100
101Fvwm                       05 September 2019 (2.6.9)       fvwm-convert-2.6(1)
Impressum