# User Defaults Summary for GNUstep Libraries

### Authors

Adam Fedor (`fedor@gnu.org`)
Nicola Pero (`n.pero@mi.flashnet.it`)

Version: $Revision: 28423 $

Date: $Date: 2009-07-31 08:10:07 -0600 (Fri, 31 Jul 2009) $

Copyright: (C) 2005 Free Software Foundation, Inc.

# Defaults Summary

This document contains a summary of available user default values that one can set to control the operation of the GNUstep libraries. To set a default, use the `defaults write (domain) (key) (value)` command in a terminal, with the `NSGlobalDomain` as first argument. E.g.,

              defaults write NSGlobalDomain GSBackend libgnustep-art

To read out the value set for the default, use `defaults read (domain) [(key)]`. If you do not specify the key, every key-value pair in the domain will be printed.

Other domains besides the system level domain "`NSGlobalDomain`" include the application domains, named for each application that has registered defaults, and the temporary runtime "`NSArgumentDomain`" for command line arguments. At runtime there is also a "`NSRegistrationDomain`", a second-chance domain in which "defaults for defaults" can be registered, and possibly also domains for specific locales.

## GUI Library Defaults

Below is a list of defaults used to control the gnustep-gui library. You can set them either in `NSGlobalDomain`, to be used everywhere, or in individual application domains, to be used for those apps only.

GSBackend

  A string containing the name of the backend bundle to use for display specific GUI handling. The default is "libgnustep-back". Custom backends can be created during compilation of the libraries. Any other choice for a name is thus system specific.

GSBrowserCellFontify

  A boolean value, `NO` by default. When the feature is on, NSBrowserCell draws non-leaf cells in bold system font. For example, when the feature is on, in a SavePanel (or OpenPanel), directory entries are drawn in bold, while simple files are drawn in non bold.

GSAbortKey

  The key used to abort the insertion of multi-stroke keybinding. Default is `Control-g`.

GSAppKitUserBundles

  An array listing the names of bundles that will be automatically loaded into every application at startup. Typically these will be 'theme' bundles that control the look of the application.

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

GSFileBrowserHideDotFiles

  A boolean, by default NO. If you set it to YES, files that begin with a dot ('.') are not shown in the NSSavePanel or NSOpenPanel.