2002-06-03 Emil Brink gentoo CONFIGURATION FILE FORMAT CHANGES 0. INTRODUCTION Notes to help me maintain (or at least minimize loss of) config file compatibility between various gentoo releases. Note that I always try to make gentoo auto-convert the configuration file. This means that the format loaded is not always the same as the one saved, i.e. gentoo will (silently) "convert" the configuration file. As always, gentoo will not save the config file unless you tell it to, so there is never any risk of "losing" your old config. When a config file format change occurs, it is recommended to simply start the version of gentoo in which the change occured, and let it load your old config. Then check around to see if you've lost any important settings. If not, just click "Save" in the configuration window, to convert the file into the new format. If there are losses, read below for possible tips on how to recreate relevant data... With 0.11.24, one disruptive change is that the "Smart Size" (also known as "IQSize") content type is no longer supported, and not properly detected on load either. gentoo will map *any* unknown content type into a Size column. 0.11.25 adds another disruptive change. Shortcuts are transformed from being a separate feature to being just another sheet of good old buttons. This means they get saved among the buttons, too. There is no support for loading the old-style Shortcut information, so you will simply lose your shortcuts. Luckily, redefining them should be fairly straight-forward. To minimize excess baggage in the code, I would like to get rid of the loading code for old-style config formats at some point in the future. Therefore, please convert your config file, even if it doesn't seem strictly necessary. Of course, once you make a config change and click "Save", the file is converted. There is no way to make gentoo *write* an old-style configuration file. I. FILE STYLES VERSION any pre-0.11.7 to 0.11.7 NESTING NAME TYPE FUNCTION Style Style description The entire style description format has changed. CHANGES The entire tag has a completely new internal format. Properties are now identified by name, rather than weird hard- coded index integers as they were before. COMPATIBILITY TACTICS The current code loads old-style (pre-0.11.7) config files just fine, and silently converts them into the new format the next time you save. II. BUTTON FIELDS VERSION any pre-0.11.6 to 0.11.6 NESTING