8.4. General Project Commands
There are three tasks you can perform with the general command menu: executing programs in the project directory, applying commands and project manager actions to some or all packages of the project, and edit the project description file. The first one is of interest as it may conveniently be used to commit the project description including all snapshots to the version control repository, which is the recommended method till the integration of a full-featured, database based project management into Elego ComPact.
Executing commands in the project directory . The first part of the general command page allows you to execute commands in the directory where your project description file PrjDesc resides. The Start button executes the command in the input files next to it, while the Edit button transfers the selection from the history list of executed commands, which also holds some default entries. It will be necessary to reload the frame in order for new executed commands to show up in this list. The default list contains the following commands:
-
ls -lR to list the contents of the project directory
-
pkgvm -tree to list the contents and version control state of the project directory
-
prjm -check to check the project description file and all packages of the project
-
pkgvm -up head to update the project directory from the repository
-
pkgvm -commit patch to commit fixes and corrections of the project to the repository
-
pkgvm -commit minor to commit small changes of the project to the repository
-
pkgvm -commit major to commit major changes of the project, like the addition or removal of packages, to the repository
-
pkgvm -mod to list all local modifications of the project directory
Applying commands to packages . You can apply commands or predefined actions to selected or all packages of a project. The project manager first determines the set of packages the action shall be applied to, then executes it with the root directory of the package as its initial working directory. The Edit and Apply buttons have the obvious meaning; the possible options are explained in the next paragraph.
Options for the application of commands to packages .
-
action | command Action means one of the symbolic action names of the project manager, which are defined for each kind of package in the resource PackageBase.DefaultData. Command is just any command you might type in at a shell prompt.
-
unordered | ordered This defines whether the action is applied in the topological sort order based on the dependencies of the packages.
-
keep going | stop on errors Normally, ComPact stops if any error is encountered during a program execution, but in rare cases it might be useful to continue the application.
-
selected | all Most of the commands of the project manager take one or more packages are arguments, and assume all packages if no package argument is present. You can select the packages you want as targets of the command invocation by clicking on the check box in the directory frames above.
-
modified | mod./dep. | outdated | outd./dep. | dependend The packages the project manager operates on can also be selected in a more implicit way. modified and outdated select the packages with the corresponding version control state, while mod./dep. and outd./dep. add the packages depending on these.
-
dependend is used to add all packages depending on one or more explicitly selected packages.
Editing the project description file . The Edit button at the bottom of the page allows you to edit the project description file (or any other file if you type in its pathname).