8.2. General Page Layout and Header Frame

The ComPact GUI project management page assembles all commands and actions associated with sets of software packages around a central view of the selected project, which is displayed in the dir1 (5), dir2 (6), dir3 (7) frames. The left dir frame lists all projects with the selected one at the top, the middle frame lists all packages of the project, and the right frame lists all packages that have been locally modified or are out-of-date.

You can select any of the packages displayed in the dir1/2/3 frames by clicking on the selection box, and deselect it by clicking again. Furthermore, there are three small special buttons located in the top right corner of the dir frames to add all files to the selection, invert the selection, and deselect all files, respectively. The two small buttons in the dir2 (6) frame above the selection group and dir3 (7) frame can be used to rescan all packages of the project and reload the server-internal project cache, and to flush all the cached version control information about the packages of the project, rescan all packages, reload the cache and update the display with actual information.

You may switch to package management for a certain package by simply clicking on its name, or you may open the package context in a new window by hitting the `?' button to the left of the package name. The latter is very convenient if you work on a project and often switch between project and package context.

A lot of commands from the header command frame (4) make use of the set of selected packages from the dir2/3 frames. The general rule is that if no packages are explicitly selected, then all packages are concerned.

Figure 8-4 shows the complete header command frame.

ReInit and rescan project cache initiates a rescan of all packages of the project. During the rescan, fingerprints for all packages are computed based on the name and modification times of all files of the package, and then compared to the last saved project checkpoint. If the new fingerprint is different, then several attributes of the project cache will be reset or recomputed. The version control attributes that denote the up-to-date or out-of-date state of the packages are not invalidated by this action.

ReInit clean-slate and rescan cache first flushes all probably out-of-date information from the project cache and then initiates a rescan of all packages of the projects as described above. This may take a considerable amount of time, as the repository must be checked for every package if somebody has committed updates since the last checkout to the local workspace.

Edit pops up an editor window containing the project description file of the project by default, but may also be used to edit any other file. You simply must change the pathname in the text input field.

Create can be used to create the file named in the input field. If the pathname is not absolute, it is relative to the project directory.

Delete can be used to remove files. If the pathname is not absolute, it is relative to the project directory.