Navigation:  Guided Tour > System Folder >

System Folder Icons

Previous pageReturn to chapter overviewNext page

The following descriptions are also available using Help/What's This?

Additional Tools Folder

Open this icon to navigate to the contents of the Additional Tools folder, which contains further Smalltalk development tools.

You may install your own tools in this folder (see SourcefBrowser>>initialize for an example).

Class Browser Tool

Opens a Class Hierarchy Browser which can be used to browse and edit the Smalltalk code present in your image.

The Class Browser organises the classes present in your image in a normal superclass/subclass tree structure. All the classes are shown, so this is a good way of viewing the entire contents of your image.

The Class Browser is implemented by the ClassBrowserShell class in the image.


Class Diagram Tool

Opens a Class Diagram onto the entire class hierarchy present in the image.

Double-clicking a class in the hierarchy will open a browser onto that class. The Class Browser and System Browser also contain Class Diagram plug-ins that display the local hierarchy diagram for the class currently being browsed.

Dolphin Live Update Tool

Opens the Live Update facility, which will contact the Object Arts website to check for available Dolphin Smalltalk updates.

Updates are generally downloaded to your computer in the form of secure Smalltalk patch files. Live Update will display the available patches so you can choose the ones you wish to install. Normally, we would recommend that you install all available patches and save your image following the update process.

Executable Browser Tool

Opens the Executable Browser, which can then be loaded with a deployed application's manifest to display the actual class contents of the application.

The Executable Browser is actually an instance of EnvironmentBrowserShell which can be loaded with an environment dictated by the XML log file produced during application deployment.

Flipper Inspector Tool

Opens an empty Inspector window. You can then use the Visual Object Finder tab to drag a cursor and locate any visible Dolphin object that you wish to inspect.

The Flipper Inspector is so called because it allows you to "flip" between two possible views of the object being inspected; the Published Aspects view and the Instance Variables view.

Idea Space Tool

Opens an empty Idea Space, which can be used to group several browsers, inspectors, workspaces etc within it.

Only Available in Dolphin Professional

The Idea Space offers a way of grouping together various Dolphin windows to make them more manageable and to alleviate screen clutter. If you are following a particular train of thought it is often useful to be able to hold all of the Dolphin windows you are working with inside an Idea Space.

Each of the contained windows occupies its own tabbed "card" within the Idea Space. This means you can easily manipulate the windows, and close them, as a single unit.

The Idea Space is implemented by the IdeaSpaceShell class in the image.

Package Browser Tool

Opens the Package Browser, which allows you to browse the contents of all of the Smalltalk packages currently loaded into your image.

The Package Browser presents a view of all the installed packages in the image. Packages are used as a means of modularizing your Smalltalk code and are a way of exporting sources from the image for distribution to others or for checking into some external Source Code Control System (SCCS).

You can use the Package Browser to install additional packages or remove ones that are currently loaded. You can also launch further browsers onto the package contents (classes, loose methods and view resources etc) by double-clicking them.

The Package Browser is implemented by the PackageBrowserShell class in the image.


Panic Tool

The Panic tool icon (fashioned after Edvard Munch's picture "The Scream") can be useful under some circumstances if you believe that your image may have acquired some zombies (unwanted hidden windows).

Opening the Panic icon will bring up a warning indicating that all Dolphin windows will be closed without offering any further prompt to save changes. Hence, you should always ensure that you have saved anything that you require before executing a Panic. A Panic forcibly closes all windows;  both development tools & your own.

Pool Dictionaries Tool

Opens an Inspector on the collection of PoolDictionaries (and PoolConstantsDictionaries) owned by the image.

These dictionaries are normally used to hold manifest constants such as those normally found in Windows.h. Using the Inspector you can browse and edit these constant definitions.

Process Monitor Tool

Opens the Process Monitor window which displays all of the running Smalltalk processes in the image.

The Smalltalk image is a naturally multi-processing environment. Dolphin processes are "green threads" that do not map to underlying operating system threads. A basic Dolphin image normally has five running processes.

Protocol Browser Tool

Opens the Protocol Browser which can be used to display and create method protocols.

Method protocols are the Smalltalk equivalent of Java interfaces. A protocol consists of a series of message selectors that must be implemented by a class if it is to conform to that protocol. In Smalltalk, protocols are advisory only and not enforced.


Sample Applications Folder

Open this icon to navigate to the contents of the Sample Applications folder, which is normally used to contain quick launch icons  for various sample applications held in the image.

You may install your own samples in this folder (see HelloWorld>>initialize for an example).

Source Tracking Tools Folder

Open this icon to navigate to the contents of the Source Tracking Tools folder, which contains icons for accessing the STS source repository.

The Source Tracking System (STS) is a method level repository for holding source changes made to the packages in your image.

System Browser Tool

Opens a System Browser which can be used to browse and edit the Smalltalk code present in your image.

The System Browser , unlike the Class Browser, organizes the classes present in your image into a structure based on the packages to which they belong.

Initially you choose one or more of the loaded packages that you wish to browse/modify and the System Browser will then show you the classes they contain. You can choose to view these classes either as a list or a hierarchy.

The System Browser is implemented by the SystemBrowserShell class in the image.


User Preferences Tool

Opens an Inspector on to a collection of objects that hold the customizable user preferences for the various areas of the development system.

You can drill down into each of these objects to browse and set your own preferences for the way you'd like the development tools to work.

In most cases, the objects are the classes of the various development tools themselves and the preferences are aspects of these classes (held in the class variables). e.g. see SystemBrowserShell class>>autoSelectPackages:.

View Browser Tool

Opens the View Browser, which displays the view resources associated with each class in the image.

The View Browser groups the available view resources into categories, each with its own icon. A specialised version of the View Browser is used inside the View Composer as the toolbox from which new views can be dragged.

Note that the name "View Browser" is new for X6. The actual class of the tool is ResourceBrowser. It was felt that the new name was more descriptive of the purpose of the tool.


View Composer Tool

Opens the View Composer, which allows the creation and editing of view resources.

The View Composer provides a graphical means of laying out views. Views are the visible UI elements of Dolphin, so the View Composer can be thought of  as its GUI builder.

Once created, views are saved down as class-side methods of the classes to which they belong. Generally, these methods are not human-readable and are only intended to be edited using the View Composer.

Dolphin uses a user interface framework known as MVP which allows a each UI component to have multiple views associated with it, if required.

The View Composer is implemented by the ViewComposer class in the image.


Workspace Tool

Opens a blank Workspace that you can use to experiment with the objects in your image.

A Workspace is a general place where snippets of Smalltalk code can be edited and executed. The ability to interactively communicate with the live objects in your image is one of the things that makes Smalltalk such a productive development environment.