Class: UserPreferences

• Inheritance
• Description
• Class protocol
  • accessing
  • accessing - defaults
  • accessing defaultPrefs
  • initialization
  • saving
• Instance protocol
  • accessing
  • accessing-locale
  • accessing-misc
  • accessing-misc-communication
  • accessing-pref'd tools
  • accessing-prefs-UI
  • accessing-prefs-browser
  • accessing-prefs-browser-colors
  • accessing-prefs-browser-syntaxColoring
  • accessing-prefs-changes & history
  • accessing-prefs-code
  • accessing-prefs-code generator
  • accessing-prefs-code view
  • accessing-prefs-defaultPackages
  • accessing-prefs-editor
  • accessing-prefs-external tools
  • accessing-prefs-files and directories
  • accessing-prefs-localization
  • accessing-prefs-startup
  • accessing-prefs-times
  • accessing-prefs-tools
  • accessing-prefs-tools-building
  • accessing-scm
  • default settings-syntax colors
  • default values
  • misc
  • obsolete
  • saving

Inheritance:

   Object
   |
   +--Collection
      |
      +--Set
         |
         +--Dictionary
            |
            +--IdentityDictionary
               |
               +--UserPreferences

Package:

stx:libbasic

Category:

System-Support

Version:

rev: 1.511 date: 2019/07/19 07:11:53

user: cg

file: UserPreferences.st directory: libbasic

module: stx stc-classLibrary: libbasic

Description:

A Dictionary for user preference values.
For non-existing keys, either a defaultValue (false),
or the value from a defaultDictionary is returned.

This will eventually keep track of ALL user preferences.
For now, not all preferences are found here -
(some of them are currently spread over the system - especially, in Class-Variables)
- but this will change over time.

If more prefs are added, think about adding a corresponding UI to the SystemSettingsDialog too.

Notice, that ST/X is intended to be multi-user capable, supporting multiple users on multiple screens.
This is effectively used by (at least) 2 ST/X customers we are aware of (for multi-screen applications).
So do not break it, by putting user-specific stuff into class variables.

Usage:
    UserPreferences current at:#foo
or
    UserPreferences current at:#foo put:something

Class protocol:

 current

CurrentPreferences := nil

 default

DefaultPreferences := nil.

 reset

resets the CurrentPreferences to its default values

 setCurrent: preferencesInstance

sets the CurrentPreferences to preferencesInstance

 syntaxColorKeys

returns the keys of syntax color items

usage example(s):

self syntaxColorKeys

 syntaxColorNames

returns the syntax colors for the settings in the launcher

 syntaxColorNamesAndKeys

returns the names and keys of syntax color items

 defaultUserSettingsFile

 defaultWorkspaceDirectory

 defaultSettingsFilename

 fileBrowserClass

the class to be used for file browsing
(used to be the simple FileBrowser, but is now the FileBrowserV2)

usage example(s):

UserPreferences fileBrowserClass

 systemBrowserClass

UserPreferences systemBrowserClass

 versionDiffViewerClass

UserPreferences versionDiffViewerClass

 initializeDefaultsIn: preferences

Smalltalk isStandAloneApp

 readSettingsFile

read the settings from standard places,
If a --preferences command line argument was given, read it from there

 saveSettings: userPrefs in: fileNameOrString

save settings to a settings-file.

Instance protocol:

 at: key

(comment from inherited method)
return the element indexed by aKey - report an error if none found

 at: key ifAbsent: exceptionValue

Look to DefaultPreferences first...

 at: key put: value

key isSymbol ifFalse:[

usage example(s):

self at:key asSymbol put:value.

 beModified

this is not needed for settings applications,
which notice any modifications themself.
However, if someone else modifies the settings (programmatically),
the change should be remembered, so that the user can be warned at session end

 beUnmodified

done when saved

 isModified

this is set, if someone modifies the settings programmatically,
so that the user can be warned at session end

 dateInputFormat

return a format used when tools read a date from the user

 dateInputFormat: aFormatString

return a format used when tools read a date from the user

usage example(s):

UserPreferences current dateInputFormat:'%d %m %y' -- european UserPreferences current dateInputFormat:'%m %d %y' -- us

 decimalPointCharacter

toDo: migrate from ClassVar in Number;
use this for new applications

 decimalPointCharacter: aCharacter

 thousandsSeparatorCharacter

toDo: migrate from ClassVar elsewhere;
use this for new applications

 thousandsSeparatorCharacter: aCharacter

 selectorNamespacesEnabled

Return true, if selector namespaces support is enabled
for this system. Note, that this method may return true
even if selector namespaces are not supported by this system.

This is rather user setting. To ask whether the selector namespaces
support should be used, use:

UserPreferences current selectorNamespacesSupportedAndEnabled

usage example(s):

UserPreferences current selectorNamespacesEnabled UserPreferences current selectorNamespacesSupportedAndEnabled UserPreferences current selectorNamespacesEnabled: true. UserPreferences current selectorNamespacesEnabled: false.

 selectorNamespacesEnabled: aBoolean

Enables/disables selector namespaces support for this system.
Please note that even if selector namespaces are enabled here,
they may not be supported by the system/VM.

This is rather user setting. To ask whether the selector namespaces
are supported use

ConfigurableFeatures includesFeature:#SelectorNamespaces

usage example(s):

UserPreferences current selectorNamespacesEnabled UserPreferences current selectorNamespacesSupportedAndEnabled UserPreferences current selectorNamespacesEnabled: true. UserPreferences current selectorNamespacesEnabled: false.

 selectorNamespacesSupportedAndEnabled

Return true, if selector namespaces are both enabled
and supported by this system/VM, false otherwise

usage example(s):

UserPreferences current selectorNamespacesEnabled UserPreferences current selectorNamespacesSupportedAndEnabled UserPreferences current selectorNamespacesEnabled: true. UserPreferences current selectorNamespacesEnabled: false.

 dotNetBridgeRunsInIDE

a debugging flag: if true, the dotNetBridge is assumed to be
already running and the bridge-exe will not be started by st/x

 dotNetBridgeRunsInIDE: aBoolean

a debugging flag: if true, the dotNetBridge is assumed to be
already running and the bridge-exe will not be started by st/x

 dotNetBridgeVerbose

UserPreferences current dotNetBridgeVerbose

 dotNetBridgeVerbose: aBoolean

 javaBridgeRunsInIDE

a debugging flag: if true, the javaBridge is assumed to be
already running and the bridge-exe will not be started by st/x

 javaBridgeRunsInIDE: aBoolean

a debugging flag: if true, the javaBridge is assumed to be
already running and the bridge-exe will not be started by st/x

 logExecutedOSCommands

UserPreferences current logExecutedOSCommands

 logExecutedOSCommands: aBoolean

 logHTTPRequests

 logHTTPRequests: aBoolean

UserPreferences current logHTTPRequests
UserPreferences current logHTTPRequests:true
UserPreferences current logHTTPRequests:false

 logNetCommunications

 logNetCommunications: aBoolean

use Smalltalk at: to avoid prerequisite package dependency

usage example(s):

UserPreferences current logNetCommunications UserPreferences current logNetCommunications:true UserPreferences current logNetCommunications:false

 logSOAPRequests

 logSOAPRequests: aBoolean

UserPreferences current logSOAPRequests
UserPreferences current logSOAPRequests:true
UserPreferences current logSOAPRequests:false

 logSSLCommunications

UserPreferences current logSSLCommunications

 logSSLCommunications: aBoolean

UserPreferences current logSSLCommunications
UserPreferences current logSSLCommunications:true
UserPreferences current logSSLCommunications:false

 smallteamViaXMPPEnabled

 smallteamViaXMPPEnabled: aBoolean

 smallteamXMPPPassword

 smallteamXMPPPassword: aPasswordString

 smallteamXMPPServer

 smallteamXMPPServer: aHostname

UserPreferences current smallteamXMPPUser:'exept.de'.

 smallteamXMPPUser

 smallteamXMPPUser: aUsernameString

UserPreferences current smallteamXMPPUser:'cg'.

 smtpServerName

 smtpServerName: aHostnameString

UserPreferences current smtpServerName
UserPreferences current smtpServerName:'mailhost'

 soapErrorDebugging

open a debugger on error, or report it as a soap-error

 soapErrorDebugging: aBoolean

open a debugger on error, or report it as a soap-error

usage example(s):

UserPreferences current soapErrorDebugging:true

 soapLoggingLevel

 soapLoggingLevel: anIntegerBetween0_and_3

 socksProxyHost

 socksProxyHost: aString

 socksProxyPort

 socksProxyPort: aNumber

 useBuiltinJVM

an experimental flag if the builtin JVM should be used for
JAVA instead of an external jvm.
Notice that the builtin jvm does not support >= v8 java

 useBuiltinJVM: aBoolean

an experimental flag if the builtin JVM should be used for
JAVA instead of an external jvm.
Notice that the builtin jvm does not support >= v8 java

 changeSetBrowserClass

Original code

usage example(s):

self current changeSetBrowserClass

 changeSetBrowserClass: aClass

UserPreferences current changeSetBrowserClass
UserPreferences current changeSetBrowserClass: Tools::ChangeSetBrowser2.
UserPreferences current changeSetBrowserClass: ChangeSetBrowser.

 changesBrowserClass

the browser to be used for the changeFile

 changesBrowserClass: aClass

UserPreferences current changesBrowserClass
UserPreferences current changesBrowserClass: Tools::ChangeSetBrowser2.
UserPreferences current changesBrowserClass: ChangeSetBrowser.

 changesBrowserClassName
( an extension from the stx:libtool package )

Backward comparibility

 externalDiffCommandTemplate

the external command to use for diff

usage example(s):

UserPreferences current externalDiffCommandTemplate

 externalDiffCommandTemplate: aString

the external command to use for diff.
The default is 'diff %1 %2' on msdos and 'diff -b %1 %2' on unix

 fileBrowserClass
( an extension from the stx:libtool package )

the class to be used for file browsing
(used to be the simple FileBrowser, but is now the FileBrowserV2)

 fileBrowserClass: aClass
( an extension from the stx:libtool package )

UserPreferences current fileBrowserClass
UserPreferences current fileBrowserClass: FileBrowser.
UserPreferences current fileBrowserClass: FileBrowserV2.

 fileBrowserClassName
( an extension from the stx:libtool package )

Backward comparibility

 inspectorClassSetting

 showTipOfTheDayAtStartup

 showTipOfTheDayAtStartup: aBoolean

 systemBrowserClass

 testRunnerClass

 useInspector2

using brand new or old inspector

usage example(s):

UserPreferences current useInspector2

 useInspector2: aBoolean

using very new or old inspector

 useNativeFileDialog

 useNativeFileDialog: aBoolean

 useNewChangeSetBrowser

using old or jan's changeSetBrowser for package diffs

 useNewChangeSetBrowser: aBoolean

using old or jan's changeSetBrowser for package diffs

 useNewChangesBrowser

using new or old change browser for the changes file

 useNewChangesBrowser: aBoolean

using new or old changeBrowser for the changes file

 useNewFileBrowser

using new or old version diff viewer

 useNewFileBrowser: aBoolean

using new or old file browser

 useNewFileDialog

using new or old file dialog

usage example(s):

UserPreferences current useNewFileDialog:false UserPreferences current useNewFileDialog:true

 useNewFileDialog: aBoolean

using new or old file dialog

usage example(s):

UserPreferences current useNewFileDialog:true

 useNewInspector

using new or old inspector

usage example(s):

UserPreferences current useNewInspector

 useNewInspector: aBoolean

using new or old inspector

 useNewSettingsApplication

using one application for the settings

 useNewSettingsApplication: aBoolean

using one application for the settings

usage example(s):

UserPreferences current useNewSettingsApplication:true

 useNewSystemBrowser

using new or old system browser

 useNewSystemBrowser: aBoolean

using new or old systemBrowser

usage example(s):

UserPreferences current useNewSystemBrowser:true

 useNewVersionDiffBrowser

using new or old version diff viewer

 useNewVersionDiffBrowser: aBoolean

using new or old versionDiffBrowser

 useProcessMonitorV2

using ProcessMonitorV2 application for display Processes

 useProcessMonitorV2: aBoolean

using ProcessMonitorV2 application for display Processes

usage example(s):

UserPreferences current useProcessMonitorV2:true

 useSmalltalkDocumentViewer

using the smalltalk-DocumentViewer (as opposed to the native systems Browser)
to display documentation

usage example(s):

UserPreferences current useSmalltalkDocumentViewer UserPreferences current useSmalltalkDocumentViewer:false

 useSmalltalkDocumentViewer: aBoolean

using the smalltalk-DocumentViewer (as opposed to the native systems Browser)
to display documentation

 useTestRunner2

using new or old test runner

 useTestRunner2: aBoolean

using new or old test runner

usage example(s):

UserPreferences current useTestRunner2:true

 useXTermViewIfAvailable

switch between xtermView (xembed) and vt100 (st/x emulation)
if possible on that architecture.

usage example(s):

UserPreferences current useXTermViewIfAvailable

 useXTermViewIfAvailable: aBoolean

switch between xtermView (xembed) and vt100 (st/x emulation)
if possible on that architecture.

 versionDiffViewerClass

 allowMouseWheelZoom

return the flag which controls if text can be magnified via the ALT-wheel-action

usage example(s):

UserPreferences current allowMouseWheelZoom

 allowMouseWheelZoom: aBooleanOrNil

set/clear the flag which controls if text can be magnified via the ALT-wheel-action

usage example(s):

UserPreferences current allowMouseWheelZoom:true UserPreferences current allowMouseWheelZoom:false UserPreferences current allowMouseWheelZoom

 avoidConfirmationsForExperiencedUsers

some confirmers ara annoying, if you are an experienced st/x user

usage example(s):

UserPreferences current avoidConfirmationsForExperiencedUsers UserPreferences current avoidConfirmationsForExperiencedUsers:true

 avoidConfirmationsForExperiencedUsers: aBooleanOrNil

some confirmers ara annoying, if you are an experienced st/x user.
Set/clear the flag which controls this

usage example(s):

UserPreferences current avoidConfirmationsForExperiencedUsers:true

 avoidSlowDrawingOperationsUnderWindows

 beepEnabled

return the flag which controls the beeper.
This affects any beeping

usage example(s):

UserPreferences current beepEnabled

 beepEnabled: aBoolean

set/clear the flag which controls the beeper.
This affects any beeping

usage example(s):

UserPreferences current beepEnabled:false

 beepForErrorDialog

return the flag which controls beeping for error dialogs
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForErrorDialog

 beepForErrorDialog: aBoolean

set/clear the flag which controls beeping for error dialogs.
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForErrorDialog:true

 beepForInfoDialog

return the flag which controls beeping for info dialogs.
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForInfoDialog

 beepForInfoDialog: aBoolean

set/clear the flag which controls beeping for info dialogs.
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForInfoDialog:true

 beepForWarningDialog

return the flag which controls beeping for warning dialogs.
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForWarningDialog

 beepForWarningDialog: aBoolean

set/clear the flag which controls beeping for warning dialogs.
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepForWarningDialog:true

 beepInEditor

return the flag which controls the beeper in editors.
This affects beeping in response to a bad user operation (not system failure beeps).
(unless completely disabled via beepEnabled)

usage example(s):

UserPreferences current beepInEditor

 beepInEditor: aBoolean

set/clear the flag which controls the beeper in editors.
This affects beeping in response to a bad user operation (not system failure beeps).
(unless completely disabled via beepEnabled)

 busyBackgroundColorInDoits

if non nil, that color is shown as background in editors while
performing a doit (i.e. in addition to showing a busy cursor).
If nil is returned, the color remains unchanged.

 busyBackgroundColorInDoits: aColorOrNil

if non nil, that color is shown as background in editors while
performing a doit (i.e. in addition to showing a busy cursor).
If nil is returned, the color remains unchanged.

 button2WithAltKey

if true, an ALT-left click is translated to a right click
Useful with 1-button mice

usage example(s):

UserPreferences current button2WithAltKey

 button2WithAltKey: aBoolean

if true, an ALT-left click is translated to a right click
Useful with 1-button mice

usage example(s):

UserPreferences current button2WithAltKey UserPreferences current button2WithAltKey:true UserPreferences current button2WithAltKey:false

 closePopUpMenuChainOnEscape

if true, the whole chain of popUpMenus is closed when escape is pressed.
if false (the default), only the last popup-view is closed.
The first corresponds to X-behavior, the later is how windows does it - sigh.

usage example(s):

UserPreferences current closePopUpMenuChainOnEscape:false UserPreferences current closePopUpMenuChainOnEscape:true

 closePopUpMenuChainOnEscape: aBoolean

if true, the whole chain of popUpMenus is closed when escape is pressed.
if false (the default), only the last popup-view is closed.
The first corresponds to X-behavior, the later is how windows does it - sigh.

usage example(s):

UserPreferences current closePopUpMenuChainOnEscape:true UserPreferences current closePopUpMenuChainOnEscape:false

 delayedMenuShowAndHide

the Windows behavior of showing submenus of a menu slightly delayed,
to allow for short-time leaving of the mouse pointer.
(bug #D1480943)

 delayedMenuShowAndHide: aBoolean

the Windows behavior of showing submenus of a menu slightly delayed,
to allow for short-time leaving of the mouse pointer.
(bug #D1480943)

 eclipseStyleMenus

if true, return menus organized like in eclipse;
if false (the default) return them as usual

 eclipseStyleMenus: aBoolean

if true, return menus organized like in eclipse;
if false (the default) return them as usual

usage example(s):

UserPreferences current eclipseStyleMenus:true

 enableVMWareDrawingBugWorkaround

return the flag which enables a workaround for a redraw bug when running X/Linux in the VMWare virtual machine

usage example(s):

UserPreferences current enableVMWareDrawingBugWorkaround

 enableVMWareDrawingBugWorkaround: aBoolean

change the flag which enables a workaround for a redraw bug when running X/Linux in the VMWare virtual machine

usage example(s):

UserPreferences current enableVMWareDrawingBugWorkaround UserPreferences current enableVMWareDrawingBugWorkaround:true UserPreferences current enableVMWareDrawingBugWorkaround:false

 enforcedPositionOfOKButtonInDialogs

this can be used to override any setting from the viewStyle,
and force it to true. This is a customer request and useful if either
the stylesheet is in error, or the user is using expecco on both windows
and unix machines and wants to have the same feeling.
Return: #left to force at left, #right to force to the right,
nil to use whatever the stylesheet uses

usage example(s):

UserPreferences current enforcedPositionOfOKButtonInDialogs UserPreferences current enforcedPositionOfOKButtonInDialogs:#left UserPreferences current enforcedPositionOfOKButtonInDialogs:nil

 enforcedPositionOfOKButtonInDialogs: aSymbolOrNil

this can be used to override any setting from the viewStyle,
and force it to true. This is a customer request and useful if either
the stylesheet is in error, or the user is using expecco on both windows
and unix machines and wants to have the same feeling.
Return: #left to force at left, #right to force to the right,
nil to use whatever the stylesheet uses

 expandSelectionOnMouseMoveWithButtonPressed

expand the selection in a selectionInListView if the mouse is pressed while moving over
more lines. Default is not FALSE !

usage example(s):

UserPreferences current expandSelectionOnMouseMoveWithButtonPressed

 expandSelectionOnMouseMoveWithButtonPressed: aBoolean

expand the selection in a selectionInListView if the mouse is pressed while moving over
more lines. Default is not FALSE !

 flyByHelpActive

(FlyByHelp notNil and:[FlyByHelp isActive])

 flyByHelpActive: aBoolean

 focusFollowsMouse

return the flag which controls if the keyboard focus should
follow the mouse (as in X) - as opposed to click mode (as in MS-win).
This only affects certain widgets (EditFields, EditTextViews and SelectionInListViews).
The returned value has 3 states: true/false and nil, which means: as defined in styleSheet.

usage example(s):

UserPreferences current focusFollowsMouse

 focusFollowsMouse: aBooleanOrNil

set/clear the flag which controls if the keyboard focus should
follow the mouse (as in X) - as opposed to click mode (as in MS-win).
This only affects certain widgets (EditFields, EditTextViews and SelectionInListViews).
Allowed are: true/false and nil, which means: as defined in styleSheet.

usage example(s):

UserPreferences current focusFollowsMouse:true UserPreferences current focusFollowsMouse:false UserPreferences current focusFollowsMouse

 fontPreferences

experimental

usage example(s):

UserPreferences current fontPreferences UserPreferences current fontPreferences:nil

 fontPreferences: aDictionary

experimental; aDictionary maps symbolic keys (such as #Button) to fonts

usage example(s):

UserPreferences current fontPreferences UserPreferences current fontPreferences:nil

 fontPreferencesChanged

tells view classes about changed font preferences

usage example(s):

UserPreferences current fontPreferencesChanged

 forceWindowsIntoMonitorBounds

if true, windows are forced to be placed into a monitor's bounds completely;
if false, they may be placed as to cross a boundary. This only affects initial placement,
not window movement.

 forceWindowsIntoMonitorBounds: aBoolean

if true, windows are forced to be placed into a monitor's bounds completely;
if false, they may be placed as to cross a boundary. This only affects initial placement,
not window movement.

usage example(s):

UserPreferences current forceWindowsIntoMonitorBounds:false UserPreferences current forceWindowsIntoMonitorBounds:true

 menuPanelTakesFocusOnClick

if true, the menu panel takes the focus and allows further control via
cursor and tab keys.

usage example(s):

UserPreferences current menuPanelTakesFocusOnClick UserPreferences current menuPanelTakesFocusOnClick:false UserPreferences current menuPanelTakesFocusOnClick:true

 menuPanelTakesFocusOnClick: aBooleanOrNil

if true, the menu panel takes the focus and allows further control via
cursor and tab keys.
Used to be on, but now we changed the default as it turned out to be counter productive

usage example(s):

UserPreferences current menuPanelTakesFocusOnClick:true UserPreferences current menuPanelTakesFocusOnClick:false UserPreferences current menuPanelTakesFocusOnClick

 metaIsMouseWheelZoom

return the flag which controls if meta+mouseWheel shall invoke the zoom.
(or else, the horizontal scroll)

usage example(s):

UserPreferences current metaIsMouseWheelZoom

 metaIsMouseWheelZoom: aBoolean

set/clear the flag which controls if meta+mouseWheel shall invoke the zoom.
(or else, the horizontal scroll)

usage example(s):

UserPreferences current metaIsMouseWheelZoom UserPreferences current metaIsMouseWheelZoom:true UserPreferences current metaIsMouseWheelZoom:false

 motionDistanceToStartDrag

the motion distance (in pixel) to start drag (as opposed to adding to the selection)

 mouseWheelDirectionReversed

if set, mouse wheel motions are upside-down.
I got very confused with macOSX10.9, behavind different from 10.6,
so I added this option

usage example(s):

UserPreferences current mouseWheelDirectionReversed UserPreferences current mouseWheelDirectionReversed:true UserPreferences current mouseWheelDirectionReversed:false

 mouseWheelDirectionReversed: aBoolean

if set, mouse wheel motions are upside-down.
I got very confused with macOSX10.9, behavind different from 10.6,
so I added this option

usage example(s):

UserPreferences current mouseWheelDirectionReversed UserPreferences current mouseWheelDirectionReversed:true UserPreferences current mouseWheelDirectionReversed:false

 mouseWheelFocusFollowsMouse

return the flag which controls if the mouseWheel focus should
follow the mouse (as in X) - as opposed to click mode (as in MS-win)

usage example(s):

UserPreferences current mouseWheelFocusFollowsMouse

 mouseWheelScale

if set, mouse wheel motions are scaled by this number

usage example(s):

UserPreferences current mouseWheelScale UserPreferences current mouseWheelScale:0.5 UserPreferences current mouseWheelScale:1

 mouseWheelScale: aNumber

if set, mouse wheel motions are scaled by this number

usage example(s):

UserPreferences current mouseWheelScale UserPreferences current mouseWheelScale:0.25 UserPreferences current mouseWheelScale:0.5 UserPreferences current mouseWheelScale:1 WindowSensor mouseWheelScale

 nativeDialogs

 nativeDialogs: aBoolean

 nativeFileDialogs

all developer please help testing the native file dialog

 nativeFileDialogs: aBoolean

 nativeWidgets

 nativeWidgets: aBoolean

enable/disable native widgets on the current display

 onlyShowTooltipsForActiveWindow

on a mac (and maybe on others), it is preferable to turn this on

usage example(s):

UserPreferences current onlyShowTooltipsForActiveWindow UserPreferences current onlyShowTooltipsForActiveWindow:false

 onlyShowTooltipsForActiveWindow: aBooleanOrNil

on a mac (and maybe on others), it is preferable to turn this on

 opaqueTableColumnResizing

return the flag which controls if table column resizing should be done
animated (opaque)

usage example(s):

UserPreferences current opaqueTableColumnResizing

 opaqueTableColumnResizing: aBoolean

change the flag which controls if table column resizing should be done
animated (opaque)

usage example(s):

UserPreferences current opaqueTableColumnResizing:true

 opaqueVariablePanelResizing

return the flag which controls if variable panel resizing should be done
animated (opaque)

usage example(s):

UserPreferences current opaqueVariablePanelResizing

 opaqueVariablePanelResizing: aBoolean

change the flag which controls if variable panel resizing should be done
animated (opaque)

usage example(s):

UserPreferences current opaqueVariablePanelResizing:true

 searchDialogIsModal

true if the search dialog (in textViews) shall be modal (the default)

usage example(s):

UserPreferences current searchDialogIsModal

 searchDialogIsModal: aBooleanOrNil

true if the search dialog (in textViews) shall be modal (the default)

usage example(s):

UserPreferences current searchDialogIsModal:true UserPreferences current searchDialogIsModal:false UserPreferences current searchDialogIsModal

 selectOnRightClick

the Windows behavior of selecting on a right-click

 selectOnRightClick: aBoolean

the Windows behavior of selecting on a right-click

usage example(s):

UserPreferences current selectOnRightClick:true. UserPreferences current selectOnRightClick:false.

 shiftMouseWheelScrollsHorizontally

if true (the default), a shift-mouse-wheel does horizontal scrolling

usage example(s):

UserPreferences current shiftMouseWheelScrollsHorizontally

 shiftMouseWheelScrollsHorizontally: aBoolean

if true (the default), a shift-mouse-wheel does horizontal scrolling

 shouldRememberLastExtent

 shouldRememberLastExtent: aBoolean

UserPreferences current shouldRememberLastExtent.
UserPreferences current shouldRememberLastExtent:true.
UserPreferences current shouldRememberLastExtent:false.

 showDottedLinesInTree

 showDottedLinesInTree: aBoolean

UserPreferences current showDottedLinesInTree:true.
UserPreferences current showDottedLinesInTree:false.

 showRightButtonMenuOnRelease

the Windows behavior of showing the right-button menu on a release.

 showRightButtonMenuOnRelease: aBoolean

the Windows behavior of showing the right-button menu on a release.

usage example(s):

UserPreferences current showRightButtonMenuOnRelease:true. UserPreferences current showRightButtonMenuOnRelease:false.

 startTextDragWithControl

if true, textDrag is only started when the CTRL-key is down

usage example(s):

UserPreferences current startTextDragWithControl

 startTextDragWithControl: aBooleanOrNil

if true, textDrag is only started when the CTRL-key is down

usage example(s):

UserPreferences current startTextDragWithControl:true UserPreferences current startTextDragWithControl:false UserPreferences current startTextDragWithControl

 toolTipAutoHideDelay

return the time in seconds, tooltips are shown. 0 means: show forever

usage example(s):

UserPreferences current toolTipAutoHideDelay

 toolTipAutoHideDelay: aTimeDuration

set the time, tooltips are shown. 0 means: don't hide

usage example(s):

UserPreferences current toolTipAutoHideDelay:10 seconds UserPreferences current toolTipAutoHideDelay:0

 toolTipShapeStyle

return a symbol, or nil. If nil, the value from the stylesheet is used.

usage example(s):

UserPreferences current toolTipShapeStyle UserPreferences current toolTipShapeStyle:#cartoon UserPreferences current toolTipShapeStyle:nil

 toolTipShapeStyle: aSymbolOrNil

A symbol, or nil. If nil, the value from the stylesheet is used.

usage example(s):

UserPreferences current toolTipShapeStyle UserPreferences current toolTipShapeStyle:#cartoon UserPreferences current toolTipShapeStyle:nil

 useColorsForColorBlindness

return the flag which controls some color combinations
to compensate for color deficiencies, such as red-green blindness.
For example, red-green is replaced by red-blue

usage example(s):

UserPreferences current useColorsForColorBlindness UserPreferences current useColorsForColorBlindness:true UserPreferences current useColorsForColorBlindness:false

 useColorsForColorBlindness: aBoolean

change the flag which controls some color combinations
to compensate for color deficiencies, such as red-green blindness.
For example, red-green is replaced by red-blue

usage example(s):

UserPreferences current useColorsForColorBlindness UserPreferences current useColorsForColorBlindness:true UserPreferences current useColorsForColorBlindness:false

 useXFontsOnly

experimental:
a flag to suppress any use of Xft Fonts on X window displays

usage example(s):

UserPreferences current useXFontsOnly

 useXFontsOnly: aBoolean

experimental:
a flag to suppress any use of Xft Fonts on X window displays

usage example(s):

UserPreferences current useXFontsOnly UserPreferences current useXFontsOnly:true UserPreferences current useXFontsOnly:false UserPreferences current useXftFontsOnly:true UserPreferences current useXftFontsOnly:false

 useXftFontsOnly

experimental:
return the flag which controls if ONLY Xft fonts should be used.
If changed, this should be done very early during startup, before any other fonts
are already acquired (i.e. before any views are opened)

usage example(s):

UserPreferences current useXftFontsOnly

 useXftFontsOnly: aBooleanOrNil

experimental:
set/clear the flag which controls if ONLY Xft fonts should be used.
If changed, this should be done very early during startup, before any other fonts
are already acquired (i.e. before any views are opened)

usage example(s):

UserPreferences current useXftFontsOnly:true UserPreferences current useXftFontsOnly:false UserPreferences current useXftFontsOnly

 viewStyle

UserPreferences current viewStyle
UserPreferences current viewStyle:(ViewStyle adwaita)

 viewStyle: aStyleSymbol

UserPreferences current viewStyle
UserPreferences current viewStyle:(ViewStyle adwaita)

 waitCursorVisibleTime

answer the time (in ms), how long a wait cursor should be visible at least

 workAroundRenderingBugOnVista

a temporary kludge for the vista-cleartype character redraw bug

 acceptCancelBarOrder

the original order was accept-cancel-compare.
However, we found that the danger of pressing cancel by accident
was too high, so we changed the default.
If you want to go back, return #acceptCancelCompare here

usage example(s):

UserPreferences current acceptCancelBarOrder UserPreferences current acceptCancelBarOrder: #acceptCompareCancel UserPreferences current acceptCancelBarOrder: #acceptCancelCompare

 acceptCancelBarOrder: aSymbol

the original order was accept-cancel-compare.
However, we found that the danger of pressing cancel by accident
was too high, so we changed the default.
If you want to go back, return #acceptCancelCompare here

usage example(s):

UserPreferences current acceptCancelBarOrder UserPreferences current acceptCancelBarOrder: #acceptCompareCancel UserPreferences current acceptCancelBarOrder: #acceptCancelCompare

 alwaysOpenNewTabWhenCtrlClick
( an extension from the stx:libtool package )

UserPreferences current alwaysOpenNewTabWhenCtrlClick

 alwaysOpenNewTabWhenCtrlClick: aBoolean
( an extension from the stx:libtool package )

 autoFormatting

return the flag which controls automatic formatting of code (in some browsers)
Notice, the regular browser does not (yet) do automatic formating.

usage example(s):

UserPreferences current autoFormatting

 autoFormatting: aBoolean

turn on/off automatic formatting of code (in some browsers);
Notice, the regular browser does not (yet) do automatic formating.

usage example(s):

UserPreferences current autoFormatting:true UserPreferences current autoFormatting:false

 autoIndentInCodeView

return the flag which controls automatic cursor control in editors which
show code(autoIndent)

usage example(s):

UserPreferences current autoIndentInCodeView

 autoIndentInCodeView: aBoolean

flag which controls automatic cursor control in editors which
show code(autoIndent)

usage example(s):

UserPreferences current autoIndentInCodeView:true UserPreferences current autoIndentInCodeView:false

 confirmCheckinOfPrivateClasses

If set, a confirmation dialog is shown when attempting to checkin a private class.

usage example(s):

UserPreferences current confirmCheckinOfPrivateClasses UserPreferences current confirmCheckinOfPrivateClasses:true UserPreferences current confirmCheckinOfPrivateClasses:false

 confirmCheckinOfPrivateClasses: aBoolean

If set, a confirmation dialog is shown when attempting to checkin a private class.

usage example(s):

UserPreferences current confirmCheckinOfPrivateClasses UserPreferences current confirmCheckinOfPrivateClasses:true UserPreferences current confirmCheckinOfPrivateClasses:false

 confirmRefactorings
( an extension from the stx:libtool package )

If set, each refactoring must be confirmed before accepted.
A programmer may select which changes to apply and which not
and/or alter the change.

See RefactoryChange>>shouldBeConfirmed

usage example(s):

UserPreferences current confirmRefactorings UserPreferences current confirmRefactorings:true UserPreferences current confirmRefactorings:false

 confirmRefactorings: aBoolean
( an extension from the stx:libtool package )

If set, each refactoring must be confirmed before accepted.
A programmer may select which changes to apply and which not
and/or alter the change.

See RefactoryChange>>shouldBeConfirmed

usage example(s):

UserPreferences current confirmRefactorings UserPreferences current confirmRefactorings:true UserPreferences current confirmRefactorings:false

 enforceCodeStyle

return the flag which controls enforcing a certain code style (in some browsers)

usage example(s):

UserPreferences current enforceCodeStyle UserPreferences current enforceCodeStyle:true UserPreferences current enforceCodeStyle:false

 enforceComment

return the flag which controls enforcing a comment in accepted methods

usage example(s):

UserPreferences current enforceComment UserPreferences current enforceComment:true UserPreferences current enforceComment:false

 enforceComment: aBoolean

set/clear the flag which controls enforcing a comment in accepted methods

usage example(s):

UserPreferences current enforceComment:true UserPreferences current enforceComment:false

 immediateCheckClassVersionAgainstRepository

if true, a class' revision is checked to be up-to-date, when selected (and shown in the lower package info).

usage example(s):

UserPreferences current immediateCheckClassVersionAgainstRepository UserPreferences current immediateCheckClassVersionAgainstRepository:true

 immediateCheckClassVersionAgainstRepository: aBoolean

if true, a class' revision is checked to be up-to-date, when selected (and shown in the lower package info).

usage example(s):

UserPreferences current immediateCheckClassVersionAgainstRepository UserPreferences current immediateCheckClassVersionAgainstRepository:true

 runLintChecksInBackground

controls the browser's lint-check behavior;
background operation (Jan's pref) makes it difficult to stop and debug...)

usage example(s):

UserPreferences current runLintChecksInBackground UserPreferences current runLintChecksInBackground:true UserPreferences current runLintChecksInBackground:false

 runLintChecksInBackground: aBoolean

controls the browser's lint-check behavior;
background operation (Jan's pref) makes it difficult to stop and debug...)

usage example(s):

UserPreferences current runLintChecksInBackground:true UserPreferences current runLintChecksInBackground:false

 showAcceptCancelBarInBrowser

this is a little confusing: the codeview2 has its own accept/cancel bar
which can be turned on separately.
The codeview2 will suppress the regular accept/cancel bar, if it uses its own.

usage example(s):

UserPreferences current showAcceptCancelBarInBrowser UserPreferences current showAcceptCancelBarInBrowser:true UserPreferences current showAcceptCancelBarInBrowser:false

 showAcceptCancelBarInBrowser: aBoolean

this is a little confusing: the codeview2 has its own accept/cancel bar
which can be turned on separately.
The codeview2 will suppress the regular accept/cancel bar, if it uses its own.

usage example(s):

UserPreferences current showAcceptCancelBarInBrowser:true UserPreferences current showAcceptCancelBarInBrowser:false

 showBookmarkBar
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showBookmarkBar UserPreferences current showBookmarkBar:true UserPreferences current showBookmarkBar:false

 showBookmarkBar: aBoolean
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showBookmarkBar UserPreferences current showBookmarkBar:true UserPreferences current showBookmarkBar:false

 showEmbeddedTestRunnerInBrowser
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showEmbeddedTestRunnerInBrowser UserPreferences current showEmbeddedTestRunnerInBrowser:true UserPreferences current showEmbeddedTestRunnerInBrowser:false

 showEmbeddedTestRunnerInBrowser: aBoolean
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showEmbeddedTestRunnerInBrowser:true UserPreferences current showEmbeddedTestRunnerInBrowser:false

 showGlobalHistory
( an extension from the stx:libtool package )

Whether to show global history in the browser

usage example(s):

UserPreferences current showGlobalHistory UserPreferences current showGlobalHistory:true UserPreferences current showGlobalHistory:false

 showGlobalHistory: aBoolean
( an extension from the stx:libtool package )

Whether to show global history in the browser

usage example(s):

UserPreferences current showGlobalHistory UserPreferences current showGlobalHistory:true UserPreferences current showGlobalHistory:false

 showLocalHistory
( an extension from the stx:libtool package )

Whether to show local (per tab) history in the browser

usage example(s):

UserPreferences current showLocalHistory UserPreferences current showLocalHistory:true UserPreferences current showLocalHistory:false

 showLocalHistory: aBoolean
( an extension from the stx:libtool package )

Whether to show local (per tab) history in the browser

usage example(s):

UserPreferences current showLocalHistory UserPreferences current showLocalHistory:true UserPreferences current showLocalHistory:false

 showMarqueeInfo

If set, show multiline infos in the info area as a scrolling marquee text

usage example(s):

UserPreferences current showMarqueeInfo UserPreferences current showMarqueeInfo:true UserPreferences current showMarqueeInfo:false

 showMarqueeInfo: aBoolean

If set, show multiline infos in the info area as a scrolling marquee text

usage example(s):

UserPreferences current showMarqueeInfo UserPreferences current showMarqueeInfo:true UserPreferences current showMarqueeInfo:false

 showMethodTemplate
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showMethodTemplate UserPreferences current showMethodTemplate:true UserPreferences current showMethodTemplate:false

 showMethodTemplate: aBoolean
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current showMethodTemplate:true UserPreferences current showMethodTemplate:false

 sortAndIndentClassesByInheritance
( an extension from the stx:libtool package )

UserPreferences current sortAndIndentClassesByInheritance
UserPreferences current sortAndIndentClassesByInheritance:true
UserPreferences current sortAndIndentClassesByInheritance:false

 sortAndIndentClassesByInheritance: aBoolean
( an extension from the stx:libtool package )

UserPreferences current sortAndIndentClassesByInheritance
UserPreferences current sortAndIndentClassesByInheritance:true
UserPreferences current sortAndIndentClassesByInheritance:false

 sourceCodeManagementMenuLayout
( an extension from the stx:libtool package )

Defines the layout of source code management menus in
NewSystemBrowser. Can be one of:
#old - old style as of 2011-10-06
#compact - only one Repository menu, SCM specific menus underneath
#inline - Repository and then SCM specific menus inlined

usage example(s):

UserPreferences current sourceCodeManagementMenuLayout UserPreferences current sourceCodeManagementMenuLayout: #inline UserPreferences current sourceCodeManagementMenuLayout: #compact UserPreferences current sourceCodeManagementMenuLayout: #old

 sourceCodeManagementMenuLayout: aSymbol
( an extension from the stx:libtool package )

Defines the layout of source code management menus in
NewSystemBrowser. Can be one of:
#old - old style as of 2011-10-06
#compact - only one Repository menu, SCM specific menus underneath
#inline - Repository and then SCM specific menus inlined

usage example(s):

UserPreferences current sourceCodeManagementMenuLayout UserPreferences current sourceCodeManagementMenuLayout: #inline UserPreferences current sourceCodeManagementMenuLayout: #compact UserPreferences current sourceCodeManagementMenuLayout: #old

 syntaxColoring

return the flag which controls syntax coloring (in the browsers)

usage example(s):

UserPreferences current syntaxColoring

 syntaxColoring: aBoolean

turn on/off syntaxColoring (in the browsers).

usage example(s):

UserPreferences current syntaxColoring:true UserPreferences current syntaxColoring:false

 useInPlaceSearchInBrowserLists
( an extension from the stx:libtool package )

UserPreferences current useInPlaceSearchInBrowserLists
UserPreferences current useInPlaceSearchInBrowserLists:true
UserPreferences current useInPlaceSearchInBrowserLists:false

 useInPlaceSearchInBrowserLists: aBoolean
( an extension from the stx:libtool package )

UserPreferences current useInPlaceSearchInBrowserLists
UserPreferences current useInPlaceSearchInBrowserLists:true
UserPreferences current useInPlaceSearchInBrowserLists:false

 useSearchBarInBrowser

true, if the search-entry fields are initially shown in the browser itself
(like in firefox). False if a dialog is to be opened.

usage example(s):

UserPreferences current useSearchBarInBrowser UserPreferences current useSearchBarInBrowser:true UserPreferences current useSearchBarInBrowser:false

 useSearchBarInBrowser: aBoolean

true, if the search-entry fields are initially shown in the browser itself
(like in firefox). False if a dialog is to be opened.

usage example(s):

UserPreferences current useSearchBarInBrowser:true UserPreferences current useSearchBarInBrowser:false

 webBrowserLikeLayout
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current webBrowserLikeLayout UserPreferences current webBrowserLikeLayout:true UserPreferences current webBrowserLikeLayout:false

 webBrowserLikeLayout: aBoolean
( an extension from the stx:libtool package )

experimental.

usage example(s):

UserPreferences current webBrowserLikeLayout UserPreferences current webBrowserLikeLayout:true UserPreferences current webBrowserLikeLayout:false

 colorForInstrumentedFullyCoveredCode

the color for code in the browser which is instrumented
and where all branches have been executed (also code, which has been executed)

usage example(s):

self at:#colorForInstrumentedFullyCoveredCode put:clr.

 colorForInstrumentedFullyCoveredCode: aColor

the color for code in the browser which is instrumented
and where all branches have been executed (also code, which has been executed)

usage example(s):

UserPreferences current colorForInstrumentedFullyCoveredCode:(Color green slightlyDarkened). UserPreferences current colorForInstrumentedFullyCoveredCode:nil.

 colorForInstrumentedNeverCalledCode

the color for code in the browser which is instrumented but has never been called

usage example(s):

self at:#colorForInstrumentedNeverCalledCode put:clr.

usage example(s):

UserPreferences current at:#colorForInstrumentedNeverCalledCode put:(Color red slightlyDarkened).

 colorForInstrumentedNeverCalledCode: aColor

the color for code in the browser which is instrumented but has never been called

usage example(s):

UserPreferences current colorForInstrumentedNeverCalledCode:(Color red slightlyDarkened). UserPreferences current colorForInstrumentedNeverCalledCode:nil.

 colorForInstrumentedPartiallyCoveredCode

color for code in the browser which is instrumented and where some branches have been
executed

usage example(s):

self at:#colorForInstrumentedPartiallyCoveredCode put:clr.

usage example(s):

UserPreferences current at:#colorForInstrumentedPartiallyCoveredCode put:(Color orange slightlyLightened).

 colorForInstrumentedPartiallyCoveredCode: aColor

color for code in the browser which is instrumented and where some branches have been
executed

usage example(s):

UserPreferences current colorForInstrumentedPartiallyCoveredCode:(Color orange slightlyLightened). UserPreferences current colorForInstrumentedPartiallyCoveredCode:nil.

 colorForPseudoProtocolsInMethodListInBrowser

eventually, make this also a settings value (for people with weak gray-visibility)

 emphasisForChangedCode

the emphasis for changed code (in changeSet) in the browser

usage example(s):

self allInstancesDo:[:pref |pref at:#emphasisForChangedCode put:nil]. UserPreferences current emphasisForChangedCode. UserPreferences current at:#emphasisForChangedCode put:nil.

 emphasisForChangedCodeInSmallTeam

the emphasis for changed code (in a remote changeSet) in the browser.
You need the SmallTeam extension to be present for this to work.

usage example(s):

self allInstancesDo:[:pref |pref at:#emphasisForChangedCodeInSmallTeam put:nil]. UserPreferences current emphasisForChangedCodeInSmallTeam. UserPreferences current at:#emphasisForChangedCodeInSmallTeam put:nil.

 emphasisForDifferentPackage

emp := Array with:#bold with:emp.

usage example(s):

self allInstancesDo:[:pref |pref at:#emphasisForDifferentPackage put:nil].

 emphasisForInstrumentedFullyCoveredCode

the emphasis for code in the browser which is instrumented and where all branches have been
executed

usage example(s):

UserPreferences current at:#emphasisForInstrumentedFullyCoveredCode put:(Array with:#bold with:(#color->Color green slightlyDarkened)).

 emphasisForInstrumentedNeverCalledCode

the emphasis for code in the browser which is instrumented but has never been called

usage example(s):

UserPreferences current at:#emphasisForInstrumentedNeverCalledCode put:(Array with:#bold with:(#color->Color red slightlyDarkened)).

 emphasisForInstrumentedPartiallyCoveredCode

the emphasis for code in the browser which is instrumented and where some branches have been
executed

usage example(s):

UserPreferences current at:#emphasisForInstrumentedPartiallyCoveredCode put:(Array with:#bold with:(#color->Color orange slightlyLightened)).

 emphasisForModifiedBuffer

self allInstancesDo:[:pref |pref at:#emphasisForModifiedBuffer put:nil].

 emphasisForNamespacedCode

the emphasis for changed code (in changeSet) in the browser

usage example(s):

self allInstancesDo:[:pref |pref at:#emphasisForNamespacedCode put:nil]. UserPreferences current emphasisForNamespacedCode. UserPreferences current at:#emphasisForNamespacedCode put:nil.

 emphasisForObsoleteCode

self allInstancesDo:[:pref |pref at:#emphasisForObsoleteCode put:nil].

 emphasisForReadVariable

 emphasisForWrittenVariable

 annotationColor

the color used for annotations/resource specs;
If syntaxColoring is turned on.

 annotationEmphasis

the emphasis used for annotations/resource specs;
If syntaxColoring is turned on.

 argumentIdentifierColor

the color used for argument identifiers;
If syntaxColoring is turned on.

 argumentIdentifierEmphasis

the emphasis used for argument identifiers;
If syntaxColoring is turned on.

 badIdentifierColor

the color used for illegal identifiers;
If syntaxColoring is turned on.

 badIdentifierEmphasis

the emphasis used for illegal identifiers;
If syntaxColoring is turned on.

 booleanConstantColor

the color used for boolean constants;
If syntaxColoring is turned on.

 booleanConstantEmphasis

the emphasis used for boolean constants;
If syntaxColoring is turned on.

 bracketColor

the color used for brackets;
If syntaxColoring is turned on.

usage example(s):

self current at:#bracketColor put:Color red. self current at:#bracketEmphasis put:#bold self current bracketColor self current bracketEmphasis

 bracketEmphasis

the emphasis used for brackets;
If syntaxColoring is turned on.

usage example(s):

self current at:#bracketEmphasis put:#bold self current bracketEmphasis

 classVariableIdentifierColor

the color used for classVar/classInstVar identifiers
If syntaxColoring is turned on.

 classVariableIdentifierEmphasis

the color used for classVar/classInstVar identifiers
If syntaxColoring is turned on.

 collectionEnumerationSelectorColor

the color used for some selected collection enumeration
selectors (such as collect:, select: etc.);
If syntaxColoring is turned on.
If left nil, the normal selector color is used.

 collectionEnumerationSelectorEmphasis

the color used for some selected collection enumeration
selectors (such as collect:, select: etc.);
If syntaxColoring is turned on.
If left nil, the normal selector emphasis is used.

 colorWithKey: key default: defaultColor

 commentColor

the color used for comments;
If syntaxColoring is turned on.

 commentEmphasis

the emphasis used for comments;
If syntaxColoring is turned on.

 commentEmphasisAndColor

 commentFont

the font used for comments; nil if no special font has been defined.
If syntaxColoring is turned on.

 commentFont: aFont

the font used for comments; nil if no special font has been defined.
If syntaxColoring is turned on.

usage example(s):

UserPreferences current commentFont:(XftFontDescription family: 'Comic Sans' size: 12) UserPreferences current commentFont

 constantColor

the color used for constants;
If syntaxColoring is turned on.

 constantEmphasis

the emphasis used for constants;
If syntaxColoring is turned on.

 controlFlowSelectorColor

the color used for some selected controlFlow selectors (such as if, while etc.);
If syntaxColoring is turned on.

 controlFlowSelectorEmphasis

the emphasis used for some selected controlFlow selectors (such as if, while etc.);
If syntaxColoring is turned on.

 debugSelectorColor

the color used for some selected debug
selectors (such as halt etc.);
If syntaxColoring is turned on.
If left nil, the normal selector color is used.

 debugSelectorEmphasis

the color used for some selected debug
selectors (such as halt etc.);
If syntaxColoring is turned on.
If left nil, the normal selector emphasis is used.

 defaultSyntaxColor

the color used for anything else;
If syntaxColoring is turned on.

 defaultSyntaxEmphasis

the emphasis used for anything else;
If syntaxColoring is turned on.

 emphasis: e andColor: c

 emphasizeParenthesisLevel

UserPreferences current emphasizeParenthesisLevel
UserPreferences current emphasizeParenthesisLevel:true
UserPreferences current emphasizeParenthesisLevel:false

 emphasizeParenthesisLevel: aBoolean

UserPreferences current emphasizeParenthesisLevel
UserPreferences current emphasizeParenthesisLevel:true
UserPreferences current emphasizeParenthesisLevel:false

 errorColor

the color used for illegal identifiers;
If syntaxColoring is turned on.

 errorRaisingSelectorColor

the color used for some selected error raising
selectors (such as raise etc.);
If syntaxColoring is turned on.
If left nil, the normal selector color is used.

 errorRaisingSelectorEmphasis

the color used for some selected error raising
selectors (such as raise etc.);
If syntaxColoring is turned on.
If left nil, the normal selector emphasis is used.

 fullSelectorCheck

with fullSelector check, selectors are searched immediately for
being implemented in the system. This may not be useful on slow machines

 fullSelectorCheck: aBoolean

with fullSelector check, selectors are searched immediately for
being implemented in the system. This may not be useful on slow machines

 globalClassIdentifierColor

the color used for global identifiers which are known to be classes;
If syntaxColoring is turned on.

 globalClassIdentifierEmphasis

the emphasis used for global variable identifiers which are known to be classes;
If syntaxColoring is turned on.

 globalIdentifierColor

the color used for global identifiers;
If syntaxColoring is turned on.

usage example(s):

self current globalIdentifierColor

 globalIdentifierEmphasis

the emphasis used for global variable identifiers;
If syntaxColoring is turned on.

 hereColor

the color used for the here pseudoVariable;
If syntaxColoring is turned on.

 hereEmphasis

the emphasis used for the hre special variable;
If syntaxColoring is turned on.

 identifierColor

the color used for other identifiers;
If syntaxColoring is turned on.

usage example(s):

UserPreferences current at:#identifierColor put:Color green darkened darkened. UserPreferences current at:#identifierColor put:Color black.

 identifierEmphasis

the emphasis used for other identifiers;
If syntaxColoring is turned on.

 instVarIdentifierColor

the color used for instance variable identifiers;
If syntaxColoring is turned on.

usage example(s):

UserPreferences current at:#instVarIdentifierColor put:Color green darkened. UserPreferences current at:#instVarIdentifierColor put:Color black. UserPreferences current instVarIdentifierColor

 instVarIdentifierEmphasis

the emphais used for instance variable identifiers;
If syntaxColoring is turned on.

 jsKeywordColor

 jsKeywordEmphasis

 localIdentifierColor

the color used for local variable identifiers;
If syntaxColoring is turned on.

usage example(s):

UserPreferences current at:#localIdentifierColor put:Color green darkened. UserPreferences current at:#localIdentifierColor put:Color black.

 localIdentifierEmphasis

the emphais used for local variable identifiers;
If syntaxColoring is turned on.

 methodSelectorColor

the color used for a methods selector pattern;
If syntaxColoring is turned on.

 methodSelectorEmphasis

the emphasis used for a methods selector pattern;
If syntaxColoring is turned on.

 numberConstantColor

the color used for number constants;
If syntaxColoring is turned on.

 numberConstantEmphasis

the emphasis used for number constants;
If syntaxColoring is turned on.

 poolVariableIdentifierColor

the color used for pool variable identifiers
If syntaxColoring is turned on.

 poolVariableIdentifierEmphasis

the color used for pool variable identifiers
If syntaxColoring is turned on.

 returnColor

the color used for the return expression;
If syntaxColoring is turned on.

 returnEmphasis

the emphasis used for returns;
If syntaxColoring is turned on.

 selectorColor

the color used for message selectors;
If syntaxColoring is turned on.

 selectorEmphasis

the emphasis used for message selectors;
If syntaxColoring is turned on.

 selfColor

the color used for the self pseudoVariable;
If syntaxColoring is turned on.

 selfEmphasis

the emphasis used for the self pseudoVariable;
If syntaxColoring is turned on.

 sideEffectAssignmentBackgroundColor

the bg-color used for assignments with side effect (i.e. to instvars, globals, classvars or pool vars).
If nil is returned, the variable's color is used

 sideEffectAssignmentColor

the color used for assignments with side effect (i.e. to instvars, globals, classvars or pool vars).
If nil is returned, the variable's color is used

 stringColor

the color used for string constants;
If syntaxColoring is turned on.

 stringEmphasis

the emphasis used for string constants;
If syntaxColoring is turned on.

 stringEmphasisAndColor

 superColor

the color used for the super pseudoVariable;
If syntaxColoring is turned on.

 superEmphasis

the emphasis used for the super pseudoVariable;
If syntaxColoring is turned on.

 symbolColor

the color used for symbol constants;
If syntaxColoring is turned on.

 symbolEmphasis

the emphasis used for symbol constants;
If syntaxColoring is turned on.

 thisContextColor

the color used for the thisContext pseudoVariable;
If syntaxColoring is turned on.

 thisContextEmphasis

the emphasis used for the thisContext pseudoVariable;
If syntaxColoring is turned on.

 unimplementedSelectorColor

the color used for bad message selectors;
If syntaxColoring is turned on.

 unimplementedSelectorEmphasis

the emphasis used for bad message selectors;
If syntaxColoring is turned on.

 unknownIdentifierColor

the color used for unknown identifiers;
If syntaxColoring is turned on.

usage example(s):

self current at:#unknownIdentifierColor put:Color red. self current at:#unknownIdentifierEmphasis put:#bold self current unknownIdentifierColor self current unknownIdentifierEmphasis

 unknownIdentifierEmphasis

the emphasis used for unknown identifiers;
If syntaxColoring is turned on.

 xmlAttributeColor

the emphasis used for xml-attributes;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlAttributeColor put:Color black self current xmlAttributeColor

 xmlAttributeEmphasis

the emphasis used for xml-attributes;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlAttributeEmphasis put:#normal self current at:#xmlAttributeEmphasis put:#bold self current xmlAttributeEmphasis

 xmlCDataColor

the emphasis used for xml-CData;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlCDataColor put:Color black self current xmlCDataColor

 xmlCDataEmphasis

the emphasis used for xml-CData;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlCDataEmphasis put:#normal self current xmlCDataEmphasis

 xmlTagColor

the emphasis used for xml-tags;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlTagColor put:Color black self current xmlTagColor

 xmlTagEmphasis

the emphasis used for xml-tags;
If syntaxColoring is turned on.

usage example(s):

self current at:#xmlTagEmphasis put:#normal self current xmlTagEmphasis

 historyManagerAllowEditOfHistory
( an extension from the stx:libbasic3 package )

useful if you have 'beginner students', to prevent them from changing the history

 historyManagerAllowEditOfHistory: aBoolean

useful if you have 'beginner students', to prevent them from changing the history

usage example(s):

self default historyManagerAllowEditOfHistory:true. self default historyManagerAllowEditOfHistory:false.

 historyManagerEnabled

automatically add history line comments to accepted methods

 historyManagerEnabled: aBoolean

automatically add history line comments to accepted methods

usage example(s):

UserPreferences current historyManagerEnabled UserPreferences current historyManagerEnabled:true UserPreferences current historyManagerEnabled:false

 historyManagerModificationLimit
( an extension from the stx:libbasic3 package )

the time-delta within which the history manager does not treat a change as a new one

 historyManagerModificationLimit: sec
( an extension from the stx:libbasic3 package )

the time-delta within which the history manager does not treat a change as a new one

 historyManagerSignature
( an extension from the stx:libbasic3 package )

the signature added by the history manager

 historyManagerSignature: aString
( an extension from the stx:libbasic3 package )

the signature added by the history manager

 historyManagerSignatures
( an extension from the stx:libbasic3 package )

the signatures added by the history manager

usage example(s):

UserPreferences current historyManagerSignatures

 historyManagerSignatures: aDictionary
( an extension from the stx:libbasic3 package )

the signatures added by the history manager

 categoryForMenuActionsMethods

 haltInObsoleteMethod

sometimes, these are annoying...

usage example(s):

UserPreferences current haltInObsoleteMethod UserPreferences current haltInObsoleteMethod:true UserPreferences current haltInObsoleteMethod:false

 ignorePublicPrivateCategories

used when loading dolphin code (which defines multiple categories per method);
if on, categories like public and private are ignored (if the method already has a category).
Turn this on, to get reasonable categories when loading dolphin code

usage example(s):

UserPreferences current ignorePublicPrivateCategories

 ignorePublicPrivateCategories: aBoolean

used when loading dolphin code (which defines multiple categories per method);
if on, categories like public and private are ignored (if the method already has a category).
Turn this on, to get reasonable categories when loading dolphin code

 keepMethodSourceCode

when fetching the source from a file/cvs, should the source be kept in the image ?
If on, the image will grow over time by about 10-20 Mb.
(will stay that high, even if switched off afterwards)

usage example(s):

UserPreferences current keepMethodSourceCode

 keepMethodSourceCode: aBoolean

when fetching the source from a file/cvs, should the source be kept in the image ?
If on, the image will grow over time by about 10-20 Mb.
(will stay that high, even if switched off afterwards)

usage example(s):

UserPreferences current keepMethodSourceCode UserPreferences current keepMethodSourceCode:true

 numberOfLinesForLongMethod

how many lines for a method's source to be considered as 'long'

usage example(s):

UserPreferences current numberOfLinesForLongMethod

 generateComments

return true; comments shall be generated (by the codeGenerator tool)

usage example(s):

UserPreferences current generateComments UserPreferences current generateComments:false UserPreferences current generateComments:true

 generateComments: aBoolean

true if comments shall be generated (by the codeGenerator tool)

usage example(s):

UserPreferences current generateComments UserPreferences current generateComments:false

 generateCommentsForAspectMethods

return true; comments shall be generated (by the codeGenerator tool)

usage example(s):

UserPreferences current generateCommentsForAspectMethods

 generateCommentsForAspectMethods: aBoolean

true if comments shall be generated (by the codeGenerator tool)

usage example(s):

UserPreferences current generateCommentsForAspectMethods:false

 generateCommentsForGetters

return true if comments for simple getters are to be generated (by the codeGenerator tool).
The default is now false, as these look stupid in the browser and were only generated
for the HTMLDocumentGenerator, which is not able to generate these comments on the fly.

usage example(s):

UserPreferences current generateCommentsForGetters

 generateCommentsForGetters: aBoolean

true if comments for simple getters are to be generated (by the codeGenerator tool).
The default is now false, as these look stupid in the browser and were only generated
for the HTMLDocumentGenerator, which is not able to generate these comments on the fly.

 generateCommentsForSetters

return true if comments for simple setters are to be generated (by the codeGenerator tool).
The default is now false, as these look stupid in the browser and were only generated
for the HTMLDocumentGenerator, which is not able to generate these comments on the fly.

usage example(s):

UserPreferences current generateCommentsForSetters

 generateCommentsForSetters: aBoolean

true if comments for simple setters are to be generated (by the codeGenerator tool).
The default is now false, as these look stupid in the browser and were only generated
for the HTMLDocumentGenerator, which is not able to generate these comments on the fly.

 assignmentBackgroundColorForNavigationService

 codeView2AutoPrettyPrint

UserPreferences current codeView2AutoPrettyPrint
UserPreferences current codeView2AutoPrettyPrint:true
UserPreferences current codeView2AutoPrettyPrint:false

 codeView2AutoPrettyPrint: aBoolean

UserPreferences current codeView2AutoPrettyPrint
UserPreferences current codeView2AutoPrettyPrint:true
UserPreferences current codeView2AutoPrettyPrint:false

 codeView2QuickSendersAndImplementorsOnControl

if true, CTRL-click opens the quick senders/implementors menu;
if false, you have to press ALT

usage example(s):

UserPreferences current codeView2QuickSendersAndImplementorsOnControl UserPreferences current codeView2QuickSendersAndImplementorsOnControl:true UserPreferences current codeView2QuickSendersAndImplementorsOnControl:false

 codeView2QuickSendersAndImplementorsOnControl: aBoolean

if true, CTRL-click opens the quick senders/implementors menu;
if false, you have to press ALT

usage example(s):

UserPreferences current codeView2QuickSendersAndImplementorsOnControl UserPreferences current codeView2QuickSendersAndImplementorsOnControl:true UserPreferences current codeView2QuickSendersAndImplementorsOnControl:false

 codeView2ShowAcceptCancel
( an extension from the stx:libtool package )

this is a little confusing: the codeview2 has its own accept/cancel bar
(why reinvent the wheel?).
So if this is enabled, the outer accept/cancel bar will be suppressed,
if this is on

usage example(s):

UserPreferences current codeView2ShowAcceptCancel UserPreferences current codeView2ShowAcceptCancel:true UserPreferences current codeView2ShowAcceptCancel:false

 codeView2ShowAcceptCancel: aBoolean
( an extension from the stx:libtool package )

this is a little confusing: the codeview2 has its own accept/cancel bar
(why reinvent the wheel?).
So if this is enabled, the outer accept/cancel bar will be suppressed,
if this is on

usage example(s):

UserPreferences current codeView2ShowAcceptCancel UserPreferences current codeView2ShowAcceptCancel:true UserPreferences current codeView2ShowAcceptCancel:false

 selectorBackgroundColorForNavigationService

16rADD9FF

 useCodeView2In: appSymbol
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

usage example(s):

UserPreferences current useCodeView2In: #Browser UserPreferences current useCodeView2InBrowser:true UserPreferences current useCodeView2InBrowser:false UserPreferences current useCodeView2InTools:true UserPreferences current useCodeView2InTools:false

 useCodeView2InBrowser
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useCodeView2InBrowser: aBoolean
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useCodeView2InDebugger
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useCodeView2InDebugger: aBoolean
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useCodeView2InTools
( an extension from the stx:libtool package )

false

usage example(s):

UserPreferences current useCodeView2InTools UserPreferences current useCodeView2InTools:true UserPreferences current useCodeView2InTools:false

 useCodeView2InTools: aBoolean
( an extension from the stx:libtool package )

UserPreferences current useCodeView2InBrowser:true
UserPreferences current useCodeView2InBrowser:false

 useCodeView2InWorkspace
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useCodeView2InWorkspace: aBoolean
( an extension from the stx:libtool package )

no longer used - will vanish.
Now the use of the codeView2 is globally enabled/disabled by useCodeView2InTools

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 variableBackgroundColorForNavigationService

(Color rgbValue:16rEFD7A7)

 addPreloadedPackage: packageName

add this to the set of preloaded packages.
This will be automatically loaded whenever the system starts

usage example(s):

UserPreferences current preloadedPackages UserPreferences current addPreloadedPackage:'stx:goodies/smallsense' UserPreferences current removePreloadedPackage:'stx:goodies/smallsense'

 preloadedPackages

the set of preloaded packages.
These will be automatically loaded whenever the system starts

usage example(s):

UserPreferences current addPreloadedPackage:'stx:goodies/smallsense' UserPreferences current removePreloadedPackage:'stx:goodies/smallsense' UserPreferences current preloadedPackages

 preloadedPackages: setOfPreloadedPackages

define the set of preloaded packages.
This will be automatically loaded whenever the system starts

 removePreloadedPackage: packageName

remove this from the set of preloaded packages.
This will be no longer be automatically loaded whenever the system starts

usage example(s):

UserPreferences current preloadedPackages UserPreferences current addPreloadedPackage:'stx:goodies/smallsense' UserPreferences current removePreloadedPackage:'stx:goodies/smallsense'

 appendAbbreviationsToCompletionSuggestions

show abbreviations in completion

usage example(s):

UserPreferences current appendAbbreviationsToCompletionSuggestions UserPreferences current appendAbbreviationsToCompletionSuggestions:true UserPreferences current appendAbbreviationsToCompletionSuggestions:false

 appendAbbreviationsToCompletionSuggestions: aBoolean

show abbreviations in completion

usage example(s):

UserPreferences current appendAbbreviationsToCompletionSuggestions UserPreferences current appendAbbreviationsToCompletionSuggestions:true UserPreferences current appendAbbreviationsToCompletionSuggestions:false

 codeCompletionOnControlKey

show completion with CTRL-key - experimental

usage example(s):

UserPreferences current codeCompletionOnControlKey UserPreferences current codeCompletionOnControlKey:true UserPreferences current codeCompletionOnControlKey:false

 codeCompletionOnControlKey: aBoolean

show completion with CTRL key - experimental

usage example(s):

UserPreferences current codeCompletionOnControlKey UserPreferences current codeCompletionOnControlKey:true UserPreferences current codeCompletionOnControlKey:false

 codeCompletionOnTabKey

show completion with TAB-key - experimental

usage example(s):

UserPreferences current codeCompletionOnTabKey UserPreferences current codeCompletionOnTabKey:true UserPreferences current codeCompletionOnTabKey:false

 codeCompletionOnTabKey: aBoolean

show completion with TAB-key - experimental

usage example(s):

UserPreferences current codeCompletionOnTabKey UserPreferences current codeCompletionOnTabKey:true UserPreferences current codeCompletionOnTabKey:false

 codeCompletionViewKeyboardNavigationNeedsModifier

if you find it annoying, that cursor up/down is intercepted by a floating
completion view, set this to true. Then cursor up/down are only passed to the completion
view if a shift- or control modifier is pressed.
The default is false for backward compatibility

usage example(s):

UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier:true UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier:false

 codeCompletionViewKeyboardNavigationNeedsModifier: aBoolean

if you find it annoying, that cursor up/down is intercepted by a floating
completion view, set this to true. Then cursor up/down are only passed to the completion
view if a shift- or control modifier is pressed.
The default is false for backward compatibility

usage example(s):

UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier:true UserPreferences current codeCompletionViewKeyboardNavigationNeedsModifier:false

 deleteSetsClipboardText

if true, a delete also updates the clipboard with the deleted text

usage example(s):

UserPreferences current deleteSetsClipboardText

 deleteSetsClipboardText: aBooleanOrNil

if true, a delete also updates the clipboard with the deleted text

usage example(s):

UserPreferences current deleteSetsClipboardTextdeleteSetsClipboardText:true UserPreferences current deleteSetsClipboardText:false UserPreferences current deleteSetsClipboardText

 enforcedDropModeForFiles

when dropping a file, paste the #name, the #contents or ask ?
(default is nil, for ask)

usage example(s):

UserPreferences current enforcedDropModeForFiles

 enforcedDropModeForFiles: aSymbolOrNil

when dropping a file, paste the #name, the #contents or ask ?
(default is nil, for ask)

usage example(s):

UserPreferences current enforcedDropModeForFiles:#contents UserPreferences current enforcedDropModeForFiles:#name

 extendedWordSelectMode

when double clicking, include underscore, dollar and at-character as word-characters ?
(default is on)

usage example(s):

UserPreferences current extendedWordSelectMode

 extendedWordSelectMode: aBoolean

when double clicking, include underscore, dollar and at-character as word-characters ?
(default is on)

usage example(s):

UserPreferences current extendedWordSelectMode:true UserPreferences current extendedWordSelectMode:false

 generateBackupFileWhenSaving

if true, the editor will write a backup file
before saving. The default is true

 generateBackupFileWhenSaving: aBoolean

if true, the editor will write a backup file
before saving. The default is true

 immediateCodeCompletion

show completion, as you type - experimental

usage example(s):

UserPreferences current immediateCodeCompletion UserPreferences current immediateCodeCompletion:true UserPreferences current immediateCodeCompletion:false

 immediateCodeCompletion: aBoolean

show completion, as you type - experimental

usage example(s):

UserPreferences current immediateCodeCompletion UserPreferences current immediateCodeCompletion:true UserPreferences current immediateCodeCompletion:false

 numberOfRememberedUndoOperationsInEditor

the number of possible undo-operations.
Nil means: unlimited.
Notice: you may run out of memory, if editing a lot and the number of undos is not limited.

usage example(s):

UserPreferences current numberOfRememberedUndoOperationsInEditor

 numberOfRememberedUndoOperationsInEditor: aNumberOrNil

the number of possible undo-operations.
Nil means: unlimited.
Notice: you may run out of memory, if editing a lot and the number of undos is not limited.

usage example(s):

UserPreferences current numberOfRememberedUndoOperationsInEditor:20

 selectAllWhenClickingBeyondEnd

select mode, when clicking after the end of text,
as in st80 (or squeak), select all

usage example(s):

UserPreferences current selectAllWhenClickingBeyondEnd

 selectAllWhenClickingBeyondEnd: aBoolean

select mode, when clicking after the end of text,
as in st80 (or squeak), select all

usage example(s):

UserPreferences current selectAllWhenClickingBeyondEnd:true UserPreferences current selectAllWhenClickingBeyondEnd:false

 selectionExtensionMode

Returns selection extension mode. Mode is either

#traditional ... Shift-End always moves end of selection (iff it is on the same line)
Shift->Home always moves beggining of selection (iff it is on the same line)
That's how CG likes it.

#standard ... That's how vast majority text editors and text widgets behaves, therefore
this is how most users expects it to behave.


For historical reasons, #traditional is the default...

usage example(s):

UserPreferences current selectionExtensionMode UserPreferences current selectionExtensionMode:#traditional UserPreferences current selectionExtensionMode:#standard UserPreferences current selectionExtensionMode:nil UserPreferences current selectionExtensionMode

 selectionExtensionMode: aSymbol

Sets selection extension mode. Must be either:

#traditional ... Shift-End always moves end of selection (iff it is on the same line)
Shift->Home always moves beggining of selection (iff it is on the same line)
That's how CG likes it.

#standard ... That's how vast majority text editors and text widgets behaves, therefore
this is how most users expects it to behave.


For historical reasons, #traditional is the default...

usage example(s):

UserPreferences current selectionExtensionMode UserPreferences current selectionExtensionMode:#traditional UserPreferences current selectionExtensionMode:#standard UserPreferences current selectionExtensionMode:nil UserPreferences current selectionExtensionMode

 st80EditMode

editing as in st80 (do not allow cursor beyond endOfLine/endOftext).

usage example(s):

UserPreferences current st80EditMode UserPreferences current st80EditMode:true UserPreferences current st80EditMode UserPreferences current st80EditMode:false UserPreferences current st80EditMode

 st80EditMode: aBoolean

editing as in st80 (do not allow cursor beyond endOfLine/endOftext).

usage example(s):

UserPreferences current st80EditMode:true UserPreferences current st80EditMode:false

 st80SelectMode

select mode, when double clicking as in st80
(select to corresponding lparen/double-quote) ?

usage example(s):

UserPreferences current st80SelectMode

 st80SelectMode: aBoolean

select mode, when double clicking as in st80
(select to corresponding lparen/double-quote).

usage example(s):

UserPreferences current st80SelectMode:true UserPreferences current st80SelectMode:false

 trimBlankLines

if true, blank lines are trimmed to zero size in the editor

usage example(s):

UserPreferences current trimBlankLines UserPreferences current trimBlankLines:true UserPreferences current trimBlankLines UserPreferences current trimBlankLines:false UserPreferences current trimBlankLines

 trimBlankLines: aBoolean

if true, blank lines are trimmed to zero size in the editor

usage example(s):

UserPreferences current trimBlankLines UserPreferences current trimBlankLines:true UserPreferences current trimBlankLines UserPreferences current trimBlankLines:false UserPreferences current trimBlankLines

 whitespaceWordSelectMode

when double clicking, treat ANY non-whitespace as word-characters ?
(default is off)

usage example(s):

UserPreferences current whitespaceWordSelectMode

 whitespaceWordSelectMode: aBoolean

when double clicking, treat ANY non-whitespace as word-characters ?
(default is off)

usage example(s):

UserPreferences current whitespaceWordSelectMode:true UserPreferences current whitespaceWordSelectMode:false

 defaultFileOpenCommandFor: suffix

for the fileBrowser - remember which command to use as-per suffix

 defaultFileOpenCommandFor: suffix put: openCmd

for the fileBrowser - remember which command to use as-per suffix

 dllPath

ExpeccoPreferences current dllPath.
ExpeccoPreferences current dllPath:{ '/usr/local/lib' '/opt/local/lib' }

 dllPath: aCollectionOfFolderNames

UserPreferences current dllPath.
UserPreferences current dllPath:{ '/usr/local/lib' '/opt/local/lib' }

 osFileExplorerCommand

return an OS command template to open a finder/explorer or similar

 osFileExplorerCommand: aString

define an OS command template to open a finder/explorer or similar

usage example(s):

UserPreferences current osFileExplorerCommand osx: UserPreferences current osFileExplorerCommand:'open %1' linux: UserPreferences current osFileExplorerCommand:'nautilus %1' UserPreferences current osFileExplorerCommand:'dolphin %1'

 changeFileName

were to keep changes

 changeFileName: aFilename

were to keep changes

 usersModuleName

this will be taken as the user's module in the workspace and as a default for new projects

 usersModuleName: aString

 workspaceDirectory

this is the folder where snapshot images, the change file and any stc-compiled
object files are stored.
The idea is to keep that stuff together, so we can move it as a bunch.
These used to be in the bin-folder of st/x, but that would not work with readonly/shared
st/x installations.

 workspaceDirectory: aDirectoryOrNilForDefault

 language

intermediate migration code;

usage example(s):

For now, forward to Smalltalk, while all references to "Smalltalk-language"

usage example(s):

and "Smalltalk-languageTerritory" are replaced with "UserPreferences current"-messages

usage example(s):

UserPreferences current language

 language: aLanguageSymbol

intermediate migration code;

usage example(s):

UserPreferences current language UserPreferences current language:#en

 language: aLanguageSymbol territory: aTerritorySymbol

intermediate migration code;

usage example(s):

UserPreferences current language UserPreferences current language:#en territory:#us UserPreferences current language:#de territory:#de

 languageTerritory

intermediate migration code;

usage example(s):

and "Smalltalk-languageTerritory" are replaced with "UserPreferences current"-messages

usage example(s):

UserPreferences current languageTerritory

 languageTerritory: aLanguageSymbol

intermediate migration code;

usage example(s):

UserPreferences current languageTerritory UserPreferences current languageTerritory:#en

 unitForFileSize

may return either 1000 or 1024

 unitStringsForFileSize

Modified (format): / 17-11-2017 / 10:31:42 / cg

 useSystemLanguage

if true, the operating system's language is used (i.e. LANG environment variable),
when the system comes up. If false, the setting here is used.
The default is true.

usage example(s):

UserPreferences current useSystemLanguage UserPreferences current useSystemLanguage:false UserPreferences current useSystemLanguage:true

 useSystemLanguage: aBoolean

if true, the operating system's language is used (i.e. LANG environment variable),
when the system comes up. If false, the setting here is used.
The default is true.

usage example(s):

UserPreferences current useSystemLanguage UserPreferences current useSystemLanguage:false

 autoloadedPackages

list of package names, which are automatically loaded upon startup

 autoloadedPackages: aCollectionOfPackageNames

list of package names, which are automatically loaded upon startup

 timeToAutoExpandItemsWhenDraggingOver

in a hierarchical tree view

 twoDigitDateHandler

return a block which converts a two-digit date.
Possible algorithms:
- identity: treat as year 00..99
- add 1900: treat as 1900..1999
- around: treat as 1950..1999 if value is 50..99; 2000..2049 otherwise.

TODO: make this configurable, keep in dictionary and add to settings.

 allowSendMailFromDebugger

if true inserts a button in Debugger for open a GUI to send useful debugger infos per mail to a default
mail account

usage example(s):

UserPreferences current allowSendMailFromDebugger

 allowSendMailFromDebugger: aBoolean

if true inserts a button in Debugger for open a GUI to send useful debugger infos per mail to a default
mail account

usage example(s):

UserPreferences current allowSendMailFromDebugger:true UserPreferences current allowSendMailFromDebugger:false

 autoDefineWorkspaceVariables

return the flag which controls automatic definition of unknown variables
as workspace variables (in doIts)

usage example(s):

UserPreferences current autoDefineWorkspaceVariables

 autoDefineWorkspaceVariables: aBoolean

turn on/off automatic definition of unknown variables
as workspace variables (in doIts)

usage example(s):

UserPreferences current autoDefineWorkspaceVariables:true UserPreferences current autoDefineWorkspaceVariables:false

 autoRaiseDebugger

if true, the debugger raises itself automatically when entered.
The default is true

usage example(s):

UserPreferences current autoRaiseDebugger

 autoRaiseDebugger: aBoolean

if true, the debugger raises itself automatically when entered.
The default is true

usage example(s):

UserPreferences current autoRaiseDebugger UserPreferences current autoRaiseDebugger:false UserPreferences current autoRaiseDebugger:true

 autoRaiseOnFocusInDelay

if non-nil, an application window will raise automatically,
when it gets the focus (via the window manager) after that
number of milliseconds. If nil, autoRaise is disabled.
Especially useful with focusFollowsMouse under X11

usage example(s):

UserPreferences current autoRaiseOnFocusInDelay

 autoRaiseOnFocusInDelay: anIntegerOrNil

if non-nil, an application window will raise automatically,
when it gets the focus (via the window manager) after that
number of milliseconds. If nil, autoRaise is disabled.
Especially useful with focusFollowsMouse under X11

usage example(s):

UserPreferences current autoRaiseOnFocusInDelay UserPreferences current autoRaiseOnFocusInDelay:nil UserPreferences current autoRaiseOnFocusInDelay:750

 autoRaiseTranscript

if true, the transcript raises itself automatically when new messages appear.
The default is false

usage example(s):

UserPreferences current autoRaiseTranscript

 autoRaiseTranscript: aBoolean

if true, the transcript raises itself automatically when new messages appear.
The default is false

usage example(s):

UserPreferences current autoRaiseTranscript:true UserPreferences current autoRaiseTranscript:false UserPreferences current autoRaiseTranscript

 debuggerLogFile

if non nil, any entered debugger writes a backrace to that logfile.
This is useful to record all session-problems

usage example(s):

UserPreferences current debuggerLogFile UserPreferences current debuggerLogFile:'debug.log' UserPreferences current debuggerLogFile:nil

 debuggerLogFile: aFilename

if non nil, any entered debugger writes a backrace to that logfile.
This is useful to record all session-problems

usage example(s):

UserPreferences current debuggerLogFile UserPreferences current debuggerLogFile:'debug.log' UserPreferences current debuggerLogFile:nil

 editToolbarVisibleInWorkspace

return the flag which defaults the edit-toolbar-visibility in a workspace application

 editToolbarVisibleInWorkspace: aBooleanOrNil

set the flag which defaults the edit-toolbar-visibility in a workspace application

 functionKeySequences

return the collection of function-key macros.
That's a dictionary, which assigns code to F-keys

usage example(s):

UserPreferences current functionKeySequences

 hideSupportCodeInDebugger

UserPreferences current hideSupportCodeInDebugger

 hideSupportCodeInDebugger: aBooleanOrNil

 infoVisibleInWorkspace

return the flag which defaults the info-visibility in a workspace application

 infoVisibleInWorkspace: aBooleanOrNil

set the flag which defaults the info-visibility in a workspace application

 sendMessagesAlsoToTranscript

return the flag which controls if info/error messages are to be shown
on both Stderr AND the Transcript, or only on Stderr

usage example(s):

UserPreferences current sendMessagesAlsoToTranscript

 sendMessagesAlsoToTranscript: aBooleanOrNil

set/clear the flag which controls if info/error messages are to be shown
on both Stderr AND the Transcript, or only on Stderr

usage example(s):

UserPreferences current sendMessagesAlsoToTranscript:false. 'hello' infoPrintCR. UserPreferences current sendMessagesAlsoToTranscript:true. 'hello' infoPrintCR.

 sendMessagesOnlyToTranscript

return the flag which controls if info/error messages are to be shown
on Stderr (if true is returned, they are only shown on the Transcript)

usage example(s):

UserPreferences current sendMessagesOnlyToTranscript

 sendMessagesOnlyToTranscript: aBoolean

set the flag which controls if info/error messages are to be shown
on Stderr (if true is returned, they are only shown on the Transcript)

usage example(s):

UserPreferences current sendMessagesOnlyToTranscript:true. 'hello' errorPrintCR. UserPreferences current sendMessagesOnlyToTranscript:false. 'hello' errorPrintCR. UserPreferences current sendMessagesOnlyToTranscript

 showClockInLauncher

return the flag which controls if a clock is shown in the launcher

usage example(s):

UserPreferences current showClockInLauncher

 showClockInLauncher: aBooleanOrNil

set/clear the flag which controls if a clock is shown in the launcher

usage example(s):

UserPreferences current showClockInLauncher:false. NewLauncher open. UserPreferences current showClockInLauncher:true. NewLauncher open.

 showTypeIndicatorInInspector

UserPreferences current showTypeIndicatorInInspector

 showTypeIndicatorInInspector: aBooleanOrNil

UserPreferences current showTypeIndicatorInInspector:false.
NewLauncher inspect.

UserPreferences current showTypeIndicatorInInspector:true.
NewLauncher inspect.

 terminalInputIsUTF8

if true, a shell or unix command accepts utf8 encoded input and character input
should be encoded as such by the terminal emulator.

usage example(s):

UserPreferences current terminalInputIsUTF8

 terminalInputIsUTF8: aBoolean

if true, a shell or unix command accepts utf8 encoded input and character input
should be encoded as such by the terminal emulator.
This specifies a default setting for terminal views; individual instances can be
changed be calling a corresponding setup method on it.

usage example(s):

UserPreferences current terminalInputIsUTF8 UserPreferences current terminalInputIsUTF8:true UserPreferences current terminalInputIsUTF8:false

 terminalOutputIsUTF8

if true, the shell's output is utf8 encoded and should be decoded by
the terminal emulator.

usage example(s):

UserPreferences current terminalOutputIsUTF8

 terminalOutputIsUTF8: aBoolean

if true, the shell's output is utf8 encoded and should be decoded by
the terminal emulator.
This specifies a default setting for terminal views; individual instances can be
changed be calling a corresponding setup method on it.

usage example(s):

UserPreferences current terminalOutputIsUTF8 UserPreferences current terminalOutputIsUTF8:true UserPreferences current terminalOutputIsUTF8:false

 toolbarVisibleInWorkspace

return the flag which defaults the toolbar-visibility in a workspace application

 toolbarVisibleInWorkspace: aBooleanOrNil

set the flag which defaults the toolbar-visibility in a workspace application

 useJavaCompletionEngineSimple

switch to false, when the JavaCompletionEngine is

 useNewLayoutInDebugger

UserPreferences current useNewLayoutInDebugger

 useNewLayoutInDebugger: aBoolean

 useRefactoringSupport

return the flag which enables/disables use of refactoring package in browser.
If enabled, this enables all kinds of refactorings, better search and undo features.
There is usually no reason to disable these.

 useRefactoringSupport: aBooleanOrNil

enable/disable use of refactoring package in browser.
If enabled, this enables all kinds of refactorings, better search and undo features.
There is usually no reason to disable these.

usage example(s):

UserPreferences current useRefactoringSupport:false UserPreferences current useRefactoringSupport:true

 verboseBacktraceInDebugger

UserPreferences current verboseBacktraceInDebugger

 verboseBacktraceInDebugger: aBoolean

 autoUnloadAutoloadedClassesInProjectDefinition

UserPreferences current autoUnloadAutoloadedClassesInProjectDefinition

 autoUnloadAutoloadedClassesInProjectDefinition: aBoolean

UserPreferences current autoUnloadAutoloadedClassesInProjectDefinition
UserPreferences current autoUnloadAutoloadedClassesInProjectDefinition:false

 buildDirectory

UserPreferences current buildDirectory

 buildDirectory: aFilenameStringOrNil

UserPreferences current buildDirectory

 localBuild

deployment-build in a local directory (as opposed to making via the repository)

 localBuild: aBoolean

deployment-build in a local directory (as opposed to making via the repository)

 suppressProjectDefinitionWarnings

UserPreferences current suppressProjectDefinitionWarnings

 suppressProjectDefinitionWarnings: aBoolean

UserPreferences current suppressProjectDefinitionWarnings
UserPreferences current suppressProjectDefinitionWarnings:true

 usedCompilerForBuild

UserPreferences current usedCompilerForBuild

 usedCompilerForBuild: aString

UserPreferences current usedCompilerForBuild
UserPreferences current usedCompilerForBuild:'bcc'

 managerPerMatchingModuleDefinitions
( an extension from the stx:libbasic3 package )

UserPreferences current managerPerMatchingModuleDefinitions
UserPreferences current managerPerMatchingModuleDefinitions: #().

 managerPerMatchingModuleDefinitions: defs
( an extension from the stx:libbasic3 package )

 showBadRevisionStringDialogs

show a dialog when a bad revision string is encountered, or silently fix it

 showBadRevisionStringDialogs: aBoolean

show a dialog when a bad revision string is encountered, or silently fix it

 at: key putSyntaxColor: aColor

 listOfPredefinedSyntaxColoringSchemes

return a list of pre-defined syntax highlightning styles
(as shown in the Launchers 'source and debugger settings' dialog.

 resetSyntaxColors

resets the colors in the CurrentPreferences to their default values

 resetSyntaxColorsAllBlackExceptBadIDs

resets the colors in the CurrentPreferences to no-color mode,
except for bad identifiers, which are underwaved.

 resetSyntaxColorsBlueControlFlowSelectors

resets the colors in the CurrentPreferences to alternative default values
(with blue control flow selectors)

 resetSyntaxColorsBlueSelectorsGreenComments

resets the colors in the CurrentPreferences to alternative default values
(with blue selectors and green comments)

 resetSyntaxColorsBlueSelectorsGreyComments

resets the colors in the CurrentPreferences to alternative default values
(with blue selectors and grey comments)

 resetSyntaxColorsGreenComments

resets the colors in the CurrentPreferences to alternative default values
(with green comments)

 resetSyntaxColorsGreenCommentsBlueControlFlowSelectors

resets the colors in the CurrentPreferences to alternative default values
(with green comments, blue control flow)

 resetSyntaxColorsToSqueakStyle

resets the colors in the CurrentPreferences to alternative default values

 resetSyntaxColorsToSqueakStyle1

resets the colors in the CurrentPreferences to alternative default values
(with blue selectors and green comments)

 resetSyntaxColorsToSqueakStyle2

resets the colors in the CurrentPreferences to alternative default values
(with blue selectors and green comments)

 resetSyntaxColorsToVAgeStyle

resets the colors in the CurrentPreferences to alternative default values
(green comments, blue globals)

 resetSyntaxColorsToVCStyle

resets the colors in the CurrentPreferences to visual C default style
(green comments, blue keywords, redish string constants)

 resetSyntaxColorsToVW7Style

resets the colors in the CurrentPreferences to alternative default values
(with light blue comments, green variables)

 resetSyntaxColorsWithSideEffectHighlighting

resets the colors in the CurrentPreferences to their default values
plus side effect highlighting (assignments to instvars and globals are marked)

 defaultValue

the defaultValue for non-existing keys

 errorKeyNotFound: aKey

for any non-existing key, false is returned

 doesNotUnderstand: aMessage

this is needed, if a setting is loaded (via the settings.stx) at a time

 flyByHelpSettingChanged

 codeView2AutoIndent
( an extension from the stx:libtool package )

UserPreferences current codeView2AutoIndent
UserPreferences current codeView2AutoIndent:true
UserPreferences current codeView2AutoIndent:false

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 codeView2AutoIndent: aBoolean
( an extension from the stx:libtool package )

UserPreferences current codeView2AutoIndent
UserPreferences current codeView2AutoIndent:true
UserPreferences current codeView2AutoIndent:false

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useNewSettinsApplication

obsolete - will be removed in next release.
(this is kept for a while, as it may have found its way into some
saved user preference files)

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 useNewSettinsApplication: aBoolean

obsolete - will be removed in next release

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 saveIn: fileName

UserPreferences current saveIn:'test.settings'