26.5 Examining the system tree

When you first invoke the System Browser, the Tree view is the default view. You can also switch to it from another view by choosing the relevant tab above the main view. The Tree view is shown in Displaying loaded systems using the Tree view below.

Displaying loaded systems using the Tree view

The System Browser window has four areas, described below.

26.5.1 System area

The System area is used to enter and display in the name of the system.

You can browse a system by entering its name into the System: area. While doing this you can press Up, Down or click to complete a partially specified name. This allows you to select from a list of all system names which begin with the partial input you have entered. See 3.14 Completion for detailed instructions.

The members of the system are displayed in the tree area.

26.5.2 Tree area

The Tree area produces a tree of the current system, together with all its members. The generic facilities available to all tree views throughout the environment are available here; see 6 Manipulating Graphs for details.

Double-click on a filename to display the file in the editor.
Click on an unfilled circle alongside a system name to display its members.
Click on a filled circle alongside a system name to hide its members.
Select either a system name or a file name to display details in the Description area.

You can operate on systems and files via the context menu, which offers commands such as Concatenate... and Search Files... for systems, and Compile and Print... for files. The system commands are also available in the Works > Systems menu. If no items are selected, the commands apply to the current system, whose name is printed in the System area.

To traverse the system hierarchy, expand a system node in the tree. If the desired parent node is not in the tree, choose Works > Systems > Browse All Systems. The parent of all systems defined in the image at any time is called ALL-SYSTEMS.

To see the source code definition of a system, double-click its node in the tree or do Works > Systems > Find Source or click .

26.5.3 Description area

The Description area shows details about any system member selected in the Tree area. The following items of information are shown:

Module	The name of the selected member. This is either the filename (if the member is a file of source code) or the system name (if the member is a subsystem).
Pathname	The directory pathname of the selected member. This is the full pathname of the file, if the selected member is a file of source code, or the default directory of the system, if the selected member is a subsystem.
Flags	This lists any keyword flags which have been set for the selected member in the system definition, such as the `:source-only` flag.

To operate on any of the items displayed in this area, select them and choose a command from the Works > Description menu, which contains the standard actions described in 3.8 Performing operations on selected objects. By making multiple selections, you can operate on as many of the items as you like.

26.5.4 Performing operations on system members

A variety of operations can be performed on any number of nodes selected in the Tree area. If no system nodes are selected, or if you are in another view, the commands are performed on the current system, whose name is printed in the System area.

The Works > Systems menu gives you access to the standard actions described in 3.8 Performing operations on selected objects.

Works > Systems > Browse All Systems causes the System Browser to display the root node, whose children include all loaded systems.
Works > Systems > Browse Systems For Directory causes the System Browser to display all systems that have files in a given directory or one of its subdirectories.
Choose Works > Systems > Compile and Load, Works > Systems > Compile, or Works > Systems > Load to compile or load the selected systems.
Choose Works > Systems > Concatenate... to produce a single fasl file from a system. You will need to supply the name of the fasl file, when prompted.
Choose Works > Systems > Search Files... to search the files of the selected systems (and any subsystems) for a given regular expression. A dialog prompts for the regular expression, and then a Search Files tool is raised in System Search mode, displaying the results of the search. The Search Files tool is described in 16 The Search Files tool.
Choose Works > Systems > Hide Files, to remove system member files from the tree and display only systems. Choose Works > Systems > Show Files to reverse this effect.
Choose Works > Systems > Query Replace to search all the files in the selected members (and any subsystems) for a given string and replace it with another string. You are prompted for both strings and an option to save the modified files in the same way as described for the Search Files tool in 16.4 Modifying the matched lines.