Preferences File Layers


Home » Support » Index of All Documentation » Wing IDE Reference Manual » Customization » Preferences »

Wing's preferences manager runs on a layered set of preferences files, as follows:

  • For each preference, Wing defines a hardwired default internally.
  • An installation-wide preferences file may be placed inside the Wing IDE installation directory (or on OS X the Contents/MacOS directory within Wing's .app folder).
  • An individual user preferences file is stored in the User Settings Directory.
  • Additional preferences files may be specified on the command line with one or more --prefs-file options. For example:

    wing5.0 --prefs-file /path/to/myprefs
    

The values given in later files in this list override values found in earlier ones. For example, the user-specific preferences file take precedence over any values in the WINGHOME/preferences file, and a file specified with --prefs-file would override values in the user-specific preferences file.

When preferences are changed, Wing writes the changes to the lowest file present on the above list, either the last file specified with --prefs-file or the preferences file in the User Settings Directory. Wing will never modify the installation-wide preferences file.

If a preference is set to a default value, as obtained from the preceding files in the above list, then Wing removes the value from the writeable preferences file. This means that the effective value of a preference can change in later IDE sessions even if the last file on the list above is unchanged. This is by design to allow inheriting centrally managed default values.

« 2.2. PreferencesTable of Contents2.2.1. Preferences File Format »