fvwm-convert-2.6(1)

💖 fvwm-convert-2.6 — the glow-up machine 💖

okay bestie, listen. this page is from the Fvwm Modules manual, and it's about a lil tool called fvwm-convert-2.6 that takes your crusty old config and gives it a 2.6-era makeover. no cap. ✨

---

✨ NAME ✨

fvwm-convert-2.6 — she converts your fvwm 2.4.x config file into fvwm 2.6 style. it's giving glow-up era 💅

---

🦋 SYNOPSIS 🦋

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

---

🎀 OPTIONS 🎀

here's everything she supports, bestie:

• --help, -h — prints a usage message right to your screen. like she's explaining herself. love that for her 🫶
• --follow-read, -f — follows files she finds along with the Read command. she's nosy in the best way 💖

---

🌸 DESCRIPTION 🌸

so fvwm-convert-2.6 takes an fvwm 2.4.x configuration file and turns it into a fvwm 2.6 file with compatible syntax. main character energy, honestly.

⚠️ but heads up bestie: she is not suitable for converting older 2.x configuration files. like, don't even try it. use fvwm-convert-2.2 to convert those to the 2.2.x format first, and then — if necessary — fvwm-convert-2.4. one step at a time, okay? 😭

by default, fvwm-convert-2.6 won't go looking for a given config file. you must specify it as the first parameter to fvwm-convert-2.6. different source and destination files may be given. and if the destination file already exists? she exits. periodt. 🚪💨

if no destination file is given, then the filename is the same name as the source file with the suffix ".converted" added. and without an absolute path given as the destination path to the destination file, the program will create the destination file in the CWD.

---

💅 the changes she makes (the whole reason we're here)

⭐ Style lines

in fvwm 2.4, most style options could be negated from their counterparts using NoFoo — fvwm-convert-2.6 corrects this by now using !Foo. iconic behavior honestly.

⭐ ModulePath

in fvwm 2.4 and beyond, the ModulePath is compiled into fvwm. so fvwm-convert-2.6 comments out 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.6. she did her best but that one's on you bestie 🙈

⭐ 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 removed 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 WindowShadeSteps Style option. fvwm-convert-2.6 makes this change. slay ✨

⭐ 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.

👀 so like... double-check it, okay?

⭐ 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. she gotchu 🫶

⭐ 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-convert-2.6 attempts to convert this. key word attempts 💀

⭐ 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 💀

okay so here's where she's a little messy. not her fault, but still:

• 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. it's giving chaos but make it config 🌀
• 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.adam22@gmail.com>

---

and that's the whole page, bestie!! written by the Fvwm girlies, version 2.7.0, dated 19 October 2022. go convert that config, you absolute icon 💜🦋✨