2001-11-28 19:20:10 +00:00
|
|
|
<?xml version="1.0"?>
|
|
|
|
|
<!DOCTYPE gsdoc PUBLIC "-//GNUstep//DTD gsdoc 0.6.7//EN" "/usr/GNUstep/System/Libraries/Resources/DTDs/gsdoc-0_6_6.dtd" >
|
|
|
|
|
<gsdoc base="DefaultsSummary">
|
|
|
|
|
<head>
|
|
|
|
|
<title>User Defaults Summary for GNUstep Libraries</title>
|
|
|
|
|
<author name="Adam Fedor">
|
|
|
|
|
<email address="fedor@gnu.org"/>
|
|
|
|
|
<url url="http://www.gnustep.org/developers/whoiswho.html"/>
|
|
|
|
|
</author>
|
|
|
|
|
<version>$Revision$</version>
|
|
|
|
|
<date>$Date$</date>
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<chapter>
|
|
|
|
|
<heading>Defaults Summary</heading>
|
|
|
|
|
<p>
|
|
|
|
|
This document contains a summary of available user default
|
|
|
|
|
values that one can set to control the operation of the GNUstep
|
|
|
|
|
libraries.
|
|
|
|
|
</p>
|
|
|
|
|
<section>
|
|
|
|
|
<heading>GUI Library Defaults</heading>
|
|
|
|
|
<p>
|
|
|
|
|
Below is a list of defaults used to control the gnustep-gui library.
|
|
|
|
|
</p>
|
|
|
|
|
<deflist>
|
|
|
|
|
<term>GSBackend</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string containing the name of the backend bundle to use
|
|
|
|
|
for display specific GUI handling. The default is
|
2002-04-03 16:59:43 +00:00
|
|
|
"libgnustep-back". Custom backends can be created during compilation
|
|
|
|
|
of the libraries. Any other choice for a name is thus system
|
|
|
|
|
specific.
|
2001-11-28 19:20:10 +00:00
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>GSBrowserCellFontify</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value, <code>NO</code> 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.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-12-18 00:32:34 +00:00
|
|
|
<term>GSDefaultKeyBindings</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string, <code>DefaultKeyBindings</code> by default. This
|
|
|
|
|
string (with <code>.dict</code> 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
|
|
|
|
|
<code>$GNUSTEP_SYSTEM_ROOT/Libraries/Resources/KeyBindings/</code>
|
|
|
|
|
directory, loading all the keybindings it finds in the file,
|
|
|
|
|
then it loads the similar file from
|
|
|
|
|
<code>$GNUSTEP_LOCAL_ROOT</code> and then the similar one
|
|
|
|
|
from <code>$GNUSTEP_NETWORK_ROOT</code> and at last the one
|
|
|
|
|
from <code>$GNUSTEP_USER_ROOT</code>. If you change the
|
|
|
|
|
<code>GSDefaultKeyBindings</code> user default, the library
|
|
|
|
|
will not load the default keybindings contained in the
|
|
|
|
|
system <code>DefaultKeyBindings.dict</code> 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
|
|
|
|
|
<code>DefaultKeyBindings.dict</code> file in your
|
|
|
|
|
<code>~/GNUstep/Libraries/Resources/KeyBindings/</code>
|
|
|
|
|
directory, and keybindings from this file are automatically
|
|
|
|
|
loaded in addition to the default ones. Setting
|
|
|
|
|
<code>GSDefaultKeyBindings</code> will instead cause the
|
|
|
|
|
default keybindings not to be read at all.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>GSCustomKeyBindings</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
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 <code>GSCustomKeyBindings</code> default).
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-11-28 19:20:10 +00:00
|
|
|
<term>GSSavePanelShowProgress</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value, <code>NO</code> by default. When the
|
|
|
|
|
feature is on, the save panel and its subclasses (such as
|
|
|
|
|
the open panel) displays "Reading Directory ***.."
|
|
|
|
|
(progressively adding dots) in the window titlebar while
|
|
|
|
|
reading very big directories (more than 100 entries). This
|
2001-12-18 00:32:34 +00:00
|
|
|
is meant to make things friendlier for slow computers.
|
2001-11-28 19:20:10 +00:00
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>GSLogWorkspaceTimeout</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value that defaults to <code>NO</code>. This is a
|
|
|
|
|
obscure and probably not useful default. NSWorkspace tries
|
|
|
|
|
to receive distributed notifications, but if a distributed
|
|
|
|
|
objects server cannot be found or some other error occurs,
|
|
|
|
|
it raises an exception which normally terminates the
|
|
|
|
|
program. Setting this default causes NSWorkspace to just log
|
|
|
|
|
the problem without raising an exception.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-12-07 23:03:39 +00:00
|
|
|
<term>GSWorkspaceApplication</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string value that defaults to <code>"GSWorkspace"</code>.
|
|
|
|
|
This defines the application NSWorkspace will try to
|
2001-12-18 00:32:34 +00:00
|
|
|
connect to process some operations that require an external
|
2001-12-07 23:03:39 +00:00
|
|
|
application. This is a new feature and has not been tested.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-11-28 19:20:10 +00:00
|
|
|
<term>NSInterfaceStyleDefault</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string describing the interface style. Setting this may
|
|
|
|
|
change various aspects of how the library draws elements and
|
|
|
|
|
responds to user interaction. See the NSInterfaceStyle
|
|
|
|
|
documentation for more information.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>NSMenuInterfaceStyle</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
An interface style specific to menu operation. If not set
|
|
|
|
|
the NSInterfaceStyleDefault value is used.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>NSCommandKeys</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A dictionary of command key equivalents for menu items. The
|
|
|
|
|
key contains the title of the menu item and the value is the
|
|
|
|
|
command key equivalent. For instance, one might set the
|
|
|
|
|
command key for the menu item "Copy" to "C".
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>NSHost</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
Used by NSPasteboard to find the host on which the
|
|
|
|
|
pasteboard server is running.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>NSMeasurementUnit</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string describing the measurement unit for rulers (see the
|
|
|
|
|
NSRulerView class documentation). The default is
|
|
|
|
|
Centimeters. Other possible values are Inches, Points, and Picas.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term><em>System Colors</em></term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
System colors may be set using the defaults system. System
|
|
|
|
|
colors are standard colors for drawing various GUI elements,
|
|
|
|
|
such as buttons, text, scroller, etc. The value is a
|
|
|
|
|
dictionary describing the color. The keys that can be
|
|
|
|
|
used for setting the system colors are described in the
|
|
|
|
|
documentation for NSColor.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term><em>System Fonts</em></term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
System Fonts may be set using the defaults system. System
|
|
|
|
|
fonts are standard fonts for drawing text in GUI
|
|
|
|
|
elements. They include NSBoldFont, for instance. The value
|
|
|
|
|
is the name of the font to use. There is also a
|
|
|
|
|
cooresponding size key (e.g. NSBoldFontSize) for specifying
|
|
|
|
|
the point size of the font. The keys that can be used for
|
|
|
|
|
setting the system fonts are described in the documentation
|
|
|
|
|
for NSFont.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
</deflist>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
<section>
|
2002-04-02 03:41:40 +00:00
|
|
|
<heading>Backend Defaults</heading>
|
2001-11-28 19:20:10 +00:00
|
|
|
<p>
|
2002-04-03 16:59:43 +00:00
|
|
|
Below is a list of defaults used to control the x11-based
|
2001-11-28 19:20:10 +00:00
|
|
|
backend. These defaults generally control system specific
|
|
|
|
|
display and user interaction options which may not be available
|
|
|
|
|
on all systems.
|
|
|
|
|
</p>
|
|
|
|
|
<deflist>
|
|
|
|
|
<term>NSDefaultVisual</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
An integer that specifies the X-Windows visual class to use
|
|
|
|
|
in the application. For instance one could display the
|
|
|
|
|
application using the PsuedoColor visual class by setting
|
|
|
|
|
the value to the id of this class. The default is the
|
|
|
|
|
X-Windows default visual class.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>NSColorsPerChannel</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
An integer which limits the maximum number of colors to
|
|
|
|
|
display, per channel. For a psuedo-color display, this would
|
|
|
|
|
limit the total number of colors that the application could
|
|
|
|
|
use (normally 256). For a true-color display, this would
|
|
|
|
|
limit the range of red, green, and blue values that could be used.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2002-04-02 03:41:40 +00:00
|
|
|
<term>GSAppOwnsMiniwindow</term>
|
2001-11-28 19:20:10 +00:00
|
|
|
<desc>
|
|
|
|
|
<p>
|
2002-04-02 03:41:40 +00:00
|
|
|
A boolean value which defaults to <code>YES</code>. Some window
|
|
|
|
|
managers control the miniaturized versions of windows themselves.
|
|
|
|
|
Set this default to <code>NO</code> to let the window manager
|
|
|
|
|
have it's way, otherwise, GNUstep will create a miniwindow.
|
2001-11-28 19:20:10 +00:00
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>GSFontAntiAlias</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value which defaults to <code>NO</code>. If set to
|
|
|
|
|
<code>YES</code> and the X-Windows system has the XFT
|
|
|
|
|
extension, then the application will use anti-aliased fonts
|
|
|
|
|
as provided by the X-Windows system.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-12-07 23:03:39 +00:00
|
|
|
<term>GSFontMask</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A string value which defaults to <code>"*"</code>. It defines
|
|
|
|
|
the pattern used to get the installed fonts from the
|
|
|
|
|
X-Server. A value of <code>"*-iso8859-1"</code> would only
|
|
|
|
|
include fonts available with ISO Western encoding. This
|
|
|
|
|
feature might be helpfull if the font_cacher program is having
|
|
|
|
|
problem with the X-Server.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-11-28 19:20:10 +00:00
|
|
|
<term>GraphicCompositing</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
2001-12-11 04:31:08 +00:00
|
|
|
A boolean value which defaults to <code>YES</code>. If set to
|
2001-11-28 19:20:10 +00:00
|
|
|
<code>YES</code>, then the application uses various tricks
|
|
|
|
|
to get alpha colors to work when compositing images. This
|
|
|
|
|
may slow down drawing of images, but it is generally
|
|
|
|
|
recommended anyway, particularly on fast systems.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-12-07 22:52:42 +00:00
|
|
|
<term>Keyboard Modifiers</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
The OPENstep specification requires 3 main different
|
|
|
|
|
keyboard modifiers: <code>CONTROL</code>,
|
|
|
|
|
<code>COMMAND</code> and <code>ALTERNATE</code>. Some systems
|
|
|
|
|
may not have these set up correctly. You can changed the defaults
|
|
|
|
|
with the default keys.
|
|
|
|
|
</p>
|
|
|
|
|
<list>
|
|
|
|
|
<item>GSFirstControlKey</item>
|
|
|
|
|
<item>GSSecondControlKey</item>
|
|
|
|
|
<item>GSFirstCommandKey</item>
|
|
|
|
|
<item>GSSecondCommandKey</item>
|
|
|
|
|
<item>GSFirstAlternateKey</item>
|
|
|
|
|
<item>GSSecondAlternateKey</item>
|
|
|
|
|
</list>
|
|
|
|
|
<p>
|
|
|
|
|
Default values are respectively:
|
|
|
|
|
</p>
|
|
|
|
|
<list>
|
|
|
|
|
<item>Control_L</item>
|
|
|
|
|
<item>Control_R</item>
|
|
|
|
|
<item>Alt_L</item>
|
|
|
|
|
<item>NoSymbol</item>
|
|
|
|
|
<item>Alt_R</item>
|
|
|
|
|
<item>NoSymbol</item>
|
|
|
|
|
</list>
|
|
|
|
|
<p>
|
|
|
|
|
This is described more completely in the GUI documentation.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>UseWindowMakerIcons</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value which defaults to <code>YES</code>. If set to
|
|
|
|
|
<code>YES</code> then icon windows are controlled by the
|
|
|
|
|
window manager, otherwise they are controlled by the GNUstep
|
|
|
|
|
application.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
|
|
|
|
<term>XGPS-Shm</term>
|
|
|
|
|
<desc>
|
|
|
|
|
<p>
|
|
|
|
|
A boolean value which defaults to <code>YES</code> (as long as shared
|
|
|
|
|
memory is available). If set to <code>NO</code>, shared memory is not
|
|
|
|
|
used for various display specific operations.
|
|
|
|
|
</p>
|
|
|
|
|
</desc>
|
2001-11-28 19:20:10 +00:00
|
|
|
</deflist>
|
|
|
|
|
</section>
|
|
|
|
|
</chapter>
|
|
|
|
|
</body>
|
|
|
|
|
</gsdoc>
|
2001-12-07 22:52:42 +00:00
|
|
|
|
|
|
|
|
|
