3.9 Project definition

A project is either:

• A. Defined in a 'project-file' (more later)
• B. A directory
• C. A fragment group

A project may contain subprojects. These are defined differently for the three project types:

• A. A project may have defined subprojects in the project-file.
• B. The sub-directories are considered subprojects.
• C. Two subprojects are defined: [domain] and [extent]. These subprojects contain the fragment forms in the dependency-graph of the fragment group. [domain] contains all those in the domain (that is excluding BODY fragments), and [extent] contains all those in the extent (that is including BODY fragments). These two subprojects have in turn defined subprojects, namely the fragment groups in the domain (resp. the extent), sorted out into the libraries they are part of (e.g. basiclib, process, etc.).

3.9.1 Standard Projects

Assuming that you have not used source browser applications before, the project-list (1) will display three projects at start-up: "Std. Libraries", "~/" and "./".

"Std. Libraries" is a predefined project (defined in a project-file located in ~beta/configuration/r4.0/ymer.pjt), containing all the libraries in the standard MBS system (basiclib, containers, etc.). An example of this file is:

project basiclib '~beta/basiclib ' project containers '~beta/containers' project guienv '~beta/guienv' project bifrost '~beta/bifrost' project process '~beta/process' project persistentstore '~beta/persistentstore' project oodb '~beta/oodb' project distribution '~beta/distribution' project sysutils '~beta/sysutils' project unixlib '~beta/unixlib' project Xt '~beta/Xt' project mps '~beta/mps' project objectserver '~beta/objectserver' project contrib '~beta/contrib' project demo '~beta/demo/r4.0'

"~/" is a directory project, referring to your home directory, and "./" is a directory project, referring to the current directory (i.e. the directory, where you invoked the source browser application from).

If you have invoked a source browser application with command line arguments, these will be shown in the projects list as well.

When a project/directory is selected in the project list pane, the group list pane will display all fragment files in that project. The source browser remembers the last selection in the group list pane and the group viewer, such that it will reestablish these selections next time you enters the same project or group.

When a group with one fragment form, it will automatically be selected.

3.9.2 Fold/unfold Projects

To see the subprojects/subdirectories of a project, double-click on the project (called unfold the project), then you will see the subprojects, properly indented, e.g.:

Std. Libraries

basiclib

containers

bifrost

...

...

Double-clicking again on the "Std. Libraries" will 'fold' the subprojects, only showing the "Std. Libraries" project, and not the subprojects.

3.9.3 Dependency Graph - Domain and Extent Projects

You can make a fragment group into a project by double-clicking on it in the group list pane. It will then appear in the project list pane as a fragment group project. Double-clicking on it in the project list pane will calculate the dependency graph, and show the [domain] and [extent] subprojects.