10.2. ComPact Configuration Files

compactrc. As mentioned in the introduction of this chapter, this file is the root of all initialization and configuration procedures of Elego ComPact. It is edited manually by every user. For a complete description of all possible entries see Section A.1 in Elego ComPact Manual Appendices. The compactrc file is never touched by any of the ComPact programs.

compact-env-rc. This is the override file generated by the ComPact GUI. It contains variable bindings from the current session environment of the ComPactHTTPd server process. It should not be edited manually (except perhaps for the removal of unwanted entries), and may savely be deleted if a working compactrc file exists. The compact-env-rc is less general than the compactrc file in that it may not contain mapping definitions used for conditional value bindings based on the runtime environment.

HTTPdActions. This resource defines all the actions performed by the ComPactHTTPd graphical user interface. It is described in Chapter 14. Some of the action definitions may refer to internal implementations, other to the resource file PkgBase.DefaultData.

PkgBase.DefaultData. This resource defines several kinds of packages distinguished by their directory structure, filenames, and current TPC definitions, and the operations (in form of external program calls) that may be applied to package of these kinds. Its syntax and semantics are explained in Section A.2 in Elego ComPact Manual Appendices.

pkgconf.cbcl. This is the resource that configures the backend of the ComPact build system. It contains definitions for kinds of package elements, derivation rules, and action definitions for certain kinds of derivation processes. It is discussed in the chapter about Target/Platform Configuration Management in the package manager user manual of the ComPact documentation. An example can be seen in Section A.3 in Elego ComPact Manual Appendices.

Viewing and changing configuration files. To view one of the current configuration resources of ComPact, click on the square selection box or the name of the configuration resource in the dir1 (5) frame. The file will be displayed in the combined dir2 (6), and dir3 (7) frames. To edit the selected file, use the Edit in the header command frame (4) or the small icon next to the selection box. If you want the changes you made to take effect without restarting the GUI, you must reinitialize the appropriate session of the ComPactHTTPd server, for example by using the ReInit in the header frame of the configuration page.