From 9abb36f32cbb0b626ccee17203a765a68c56cd41 Mon Sep 17 00:00:00 2001 From: fedor Date: Wed, 28 Nov 2001 19:20:10 +0000 Subject: [PATCH] Summary of user defaults git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@11568 72102866-910b-0410-8b05-ffd578937521 --- ChangeLog | 8 + Documentation/gsdoc/DefaultsSummary.gsdoc | 197 +++++++++++++++++++ Documentation/gsdoc/DefaultsSummary.html | 225 ++++++++++++++++++++++ Documentation/gsdoc/Gui.gsdoc | 1 + Documentation/gsdoc/Gui.html | 1 + Source/GSServicesManager.m | 4 +- 6 files changed, 433 insertions(+), 3 deletions(-) create mode 100644 Documentation/gsdoc/DefaultsSummary.gsdoc create mode 100644 Documentation/gsdoc/DefaultsSummary.html diff --git a/ChangeLog b/ChangeLog index adaabb8c5..c83b084bb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2001-11-28 Adam Fedor + + * Source/GSServicesManager.m (-rebuildServices): Use userLanguages + method rather than getting NSLanguages default. + + * Documentation/gsdoc/DefaultsSummary.gsdoc: New file. + * Documentation/gsdoc/Gui.gsdoc: Include it. + 2001-11-27 Adam Fedor * Source/NSClipView.m: Treat _documentView as a convienience diff --git a/Documentation/gsdoc/DefaultsSummary.gsdoc b/Documentation/gsdoc/DefaultsSummary.gsdoc new file mode 100644 index 000000000..ec6a746de --- /dev/null +++ b/Documentation/gsdoc/DefaultsSummary.gsdoc @@ -0,0 +1,197 @@ + + + + + User Defaults Summary for GNUstep Libraries + + + + + $Revision$ + $Date$ + + + + Defaults Summary +

+ This document contains a summary of available user default + values that one can set to control the operation of the GNUstep + libraries. +

+
+ GUI Library Defaults +

+ Below is a list of defaults used to control the gnustep-gui library. +

+ + GSBackend + +

+ A string containing the name of the backend bundle to use + for display specific GUI handling. The default is + "libgnustep-xgps.bundle". Currently the only other choice is + "libgnustep-xdps.bundle". +

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

+ + GSSavePanelShowProgress + +

+ A boolean value, NO 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 + is meant to make things friendlier for slow computers. Not + well tested. +

+ + GSLogWorkspaceTimeout + +

+ A boolean value that defaults to NO. 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. +

+ + NSInterfaceStyleDefault + +

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

+ + NSMenuInterfaceStyle + +

+ An interface style specific to menu operation. If not set + the NSInterfaceStyleDefault value is used. +

+ + NSCommandKeys + +

+ 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". +

+ + NSHost + +

+ Used by NSPasteboard to find the host on which the + pasteboard server is running. +

+ + NSMeasurementUnit + +

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

+ + System Colors + +

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

+ + System Fonts + +

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

+ + + +
+
+ XGPS Backend Defaults +

+ Below is a list of defaults used to control the gnustep-xgps + backend. These defaults generally control system specific + display and user interaction options which may not be available + on all systems. +

+ + NSDefaultVisual + +

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

+ + NSColorsPerChannel + +

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

+ + XGPS-Shm + +

+ A boolean value which defaults to YES (as long as shared + memory is available). If set to NO, shared memory is not + used for various display specific operations. +

+ + GSFontAntiAlias + +

+ A boolean value which defaults to NO. If set to + YES and the X-Windows system has the XFT + extension, then the application will use anti-aliased fonts + as provided by the X-Windows system. +

+ + GraphicCompositing + +

+ A boolean value which defaults to NO. If set to + YES, 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. +

+ + +
+ + + diff --git a/Documentation/gsdoc/DefaultsSummary.html b/Documentation/gsdoc/DefaultsSummary.html new file mode 100644 index 000000000..914bc769d --- /dev/null +++ b/Documentation/gsdoc/DefaultsSummary.html @@ -0,0 +1,225 @@ + + User Defaults Summary for GNUstep Libraries + + +

User Defaults Summary for GNUstep Libraries

+

Authors

+
+
Adam Fedor +
+
+

Version: $Revision$

+

Date: $Date$

+

Defaults Summary

+

+ + This document contains a summary of available user default + values that one can set to control the operation of the GNUstep + libraries. +

+

GUI Library Defaults

+

+ + Below is a list of defaults used to control the gnustep-gui library. +

+
+
GSBackend +
+

+ + A string containing the name of the backend bundle to use + for display specific GUI handling. The default is + "libgnustep-xgps.bundle". Currently the only other choice is + "libgnustep-xdps.bundle". +

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

+ + +
GSSavePanelShowProgress +
+

+ + A boolean value, NO 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 + is meant to make things friendlier for slow computers. Not + well tested. +

+ + +
GSLogWorkspaceTimeout +
+

+ + A boolean value that defaults to NO. 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. +

+ + +
NSInterfaceStyleDefault +
+

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

+ + +
NSMenuInterfaceStyle +
+

+ + An interface style specific to menu operation. See + NSInterfaceStyleDefault. +

+ + +
NSCommandKeys +
+

+ + 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". +

+ + +
NSHost +
+

+ + Used by NSPasteboard to find the host on which the + pasteboard server is running. +

+ + +
NSMeasurementUnit +
+

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

+ + +
System Colors +
+

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

+ + +
System Fonts +
+

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

+ + +
+

XGPS Backend Defaults

+

+ + Below is a list of defaults used to control the gnustep-xgps + backend. These defaults generally control system specific + display and user interaction options which may not be available + on all systems. +

+
+
NSDefaultVisual +
+

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

+ + +
NSColorsPerChannel +
+

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

+ + +
XGPS-Shm +
+

+ + A boolean value which defaults to YES (as long as shared + memory is available). If set to NO, shared memory is not + used for various display specific operations. +

+ + +
GSFontAntiAlias +
+

+ + A boolean value which defaults to NO. If set to + YES and the X-Windows system has the XFT + extension, then the application will use anti-aliased fonts + as provided by the X-Windows system. +

+ + +
GraphicCompositing +
+

+ + A boolean value which defaults to NO. If set to + YES, 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. +

+ + +
+ + + diff --git a/Documentation/gsdoc/Gui.gsdoc b/Documentation/gsdoc/Gui.gsdoc index 1d41fa6e6..504755937 100644 --- a/Documentation/gsdoc/Gui.gsdoc +++ b/Documentation/gsdoc/Gui.gsdoc @@ -131,6 +131,7 @@

DPSOperators + Available User Defaults diff --git a/Documentation/gsdoc/Gui.html b/Documentation/gsdoc/Gui.html index 942291a62..32034f834 100644 --- a/Documentation/gsdoc/Gui.html +++ b/Documentation/gsdoc/Gui.html @@ -132,6 +132,7 @@

diff --git a/Source/GSServicesManager.m b/Source/GSServicesManager.m index 489177608..0f6987803 100644 --- a/Source/GSServicesManager.m +++ b/Source/GSServicesManager.m @@ -625,7 +625,6 @@ static NSString *disabledName = @".GNUstepDisabled"; - (void) rebuildServices { NSDictionary *services; - NSUserDefaults *defs; NSMutableArray *newLang; NSMutableSet *alreadyFound; NSMutableDictionary *newServices; @@ -634,8 +633,7 @@ static NSString *disabledName = @".GNUstepDisabled"; if (allServices == nil) return; - defs = [NSUserDefaults standardUserDefaults]; - newLang = AUTORELEASE([[defs arrayForKey: @"Languages"] mutableCopy]); + newLang = AUTORELEASE([[NSUserDefaults userLanguages] mutableCopy]); if (newLang == nil) { newLang = [NSMutableArray arrayWithCapacity: 1];