This section is supposed to explain the keys in the "&xwp;" section in OS2.INI. If you had XFolder installed previously, &xwp; copies this data from the "XFolder" section, which remains in OS2.INI so that you can switch back to XFolder later if you choose to de-install &xwp;.

Note: &xwp; does not rely on the INI keys. If you really mess up something bad, you can simply delete a key with an INI editor or the whole "XFolder" section altogether. After the next Desktop restart, &xwp; will reinitialize itself with safe default values.

Here we go:

Accelerators

This has the list of folder hotkeys. This data is binary, and you should not change it manually. This is an array of XFLDHOTKEY structures, as defined in \shared\common.h of the &xwp; sources. Defaults: as described on the "Folder hotkeys" page.

AutoClose

The list of items which are to be closed automatically by &xshutdown;. Each item on this list is a zero-terminated string, followed by a ULONG which signifies what to do with this item. Then comes the next item; if it's 0, the list is terminated.

BootLogoFile

The fully qualified filename of the OS/2 V1.3 .BMP file to use for the Desktop start logo, as set by the "Startup" page in the Desktop's settings notebook. This is a plain zero-terminated string.

DialogFont

The font to use for &xwp; message boxes. This gets set when you drop a font on one of them. Default: 9.WarpSans, I think.

FavoriteFolders

Well, the list of favorite folders, as hex object handles separated by spaces.

GlobalSettings

This is a large array of ULONGs with all kinds of settings, mostly from the "Workplace Shell" object. This corresponds to the GLOBALSETTINGS structure as defined in \shared\common.h of the &xwp; sources. You better not change values in here manually, but you can delete this whole key to reset &xwp; to safe default values (after the next Desktop startup). This gets rewritten every time some global setting is changed in any of the settings objects.

JustInstalled

This key only exists right after &xwp; has been installed and leads to the "Welcome" information of &xwp; and the config folder being created. Afterwards, this key is deleted again.

Language

&xwp;'s three-digit language code, from which the NLS to be loaded is determined. This can be set in "&xwp; Setup" and defaults to "001", if not found.

NameClashLastFocus

The dialog item ID which last had the focus in the "Object exists" dialog.

QuickOpenFolders

The list of quick-open folders, as hex object handles separated by spaces.

RebootTo

A list of user-reboot items (which appear in the "Reboot" drop-down box in the &xshutdown; confirmation dialog). This is a list of pairs of zero-terminated strings: the first one describes the item, the second one specifies the command to execute. The list is terminated by two extra zero bytes.

SB_*

Various status bar settings. The names are pretty self-explanatory, I think. If a key is not found, a default is loaded from the NLS DLL.

SelectSome

The last ten file filters entered in the "Select by name" dialog, each of which is terminated with a null byte.

TrashCan::Drives

A binary array of bytes specifying drives support for the &xwp; trash can.

Version

The &xwp; version which is running. This is only set for informational purposes (e.g. for other applications which might be interested), but not read by &xwp; itself.

WndPos*

Various window positions to make them reappear where you closed them. These entries use a plain SWP structure each (I don't use WinStoreWindowPos).

XFolderPath

The main directory of where &xwp; is installed. This gets set by the install script and is required by TREESIZE.EXE to find the NLS DLL. The &xwp; core however does not use this key.

XWPSound:LastDir

The "Sound" object replacement remembers the last directory used with the "Browse" button here.

XWPSound:Scheme

The "Sound" object replacement remembers the current sound scheme name here.