diff --git a/Documentation/gsdoc/DefaultsSummary.gsdoc b/Documentation/gsdoc/DefaultsSummary.gsdoc index eba439a78..310d5f959 100644 --- a/Documentation/gsdoc/DefaultsSummary.gsdoc +++ b/Documentation/gsdoc/DefaultsSummary.gsdoc @@ -7,6 +7,10 @@ + + + + $Revision$ $Date$ @@ -44,44 +48,65 @@ non bold.

- GSDefaultKeyBindings + GSAbortKey

- A string, DefaultKeyBindings by default. This - string (with .dict appended) is the name of the - files the library reads to load the default keybindings. - The library first tries to read the file with that name from + The key used to abort the insertion of multi-stroke keybinding. + Default is Control-g. +

+ + GSQuoteKey + +

+ The key used to quote the next keystroke (so that it is not + interpreted as a keybinding, but just inserted into the text as + it is). Default is Control-q. +

+ + GSInsertControlKeystrokes + +

+ A boolean, by default NO. If you set it to YES, keystrokes + containing a Control are inserted into the text when they can't + be interpreted as keybindings. By default, they are ignored + and cause the computer to beep. +

+ + GSKeyBindingsFiles + +

+ An array of strings, (DefaultKeyBindings) by + default. The strings in this array (with .dict + appended) are the names of the files the library reads to + load the keybindings. For each of these files (in the order), + the library first tries to read the file with that name from the $GNUSTEP_SYSTEM_ROOT/Libraries/Resources/KeyBindings/ directory, loading all the keybindings it finds in the file, then it loads the similar file from $GNUSTEP_LOCAL_ROOT and then the similar one from $GNUSTEP_NETWORK_ROOT and at last the one - from $GNUSTEP_USER_ROOT. If you change the - GSDefaultKeyBindings user default, the library - will not load the default keybindings contained in the - system DefaultKeyBindings.dict file, but - instead load the specified files in its place. You normally - don't want this (so this option is rarely used), because you - normally just want to add your own keybindings to the - default ones, and to do this, you can just add a - DefaultKeyBindings.dict file in your - ~/GNUstep/Libraries/Resources/KeyBindings/ + from $GNUSTEP_USER_ROOT. If you have a single + set of customized keybindings which you want to be loaded in + addition to the default ones (or overriding some of the default + ones), just add a DefaultKeybindings.dict file + in your ~/GNUstep/Libraries/Resources/KeyBindings/ directory, and keybindings from this file are automatically - loaded in addition to the default ones. Setting - GSDefaultKeyBindings will instead cause the - default keybindings not to be read at all. + loaded in addition to the default ones; you do not need to + change this user default. If instead you want more keybinding + files to be loaded, or you do not want the system default keybindings + file to be loaded, you might well need to change it.

- GSCustomKeyBindings + GSKeyBindings

- An array of strings. If set, the strings are interpreted as - filenames and the keybindings from those files are loaded after - the default ones, in the order they are specified in the array. - Might be useful if you want to have different applications use - different keybindings (you can then run each application with - a different GSCustomKeyBindings default). + A dictionary, containing keybindings which are loaded by the + library after the ones found in the GSKeyBindingsFiles. + Might be useful if you have only a couple of keybindings, and + don't want to write a custom keybindings file. If you have many + keybindings, it is recommended that you keep them in a file. + The syntax of keybindings entries and files is documented elsewhere.

GSSavePanelShowProgress