8.7. Project Version Control Actions

Checking out all or some packages of a project . Checkout checks out packages of the project. If no packages are selected in the dir 2 (6) and dir3 (7) frames, all packages are checked out, which results in a consistent project state. You may either specify a certain snapshot or relase name by selecting one from the list of known names, or you may checkout the current development version of all packages by using the predefined name head. Snapshots and releases are simply states of the project that have been frozen before and labelled with a unique name. See also Section 8.8.

Committing some or all packages of a project . Commit is used to transfer local changes of several packages to the repository, creating a new development version for each package. This is especially handy if you have modified several packages and want to check them in together. The default setting is to commit only modified packages. The complete options for Commit are listed below.

Releasing some or all packages of a project . Release is used to transfer local changes of several packages to the repository and creating a new release of each package. This is simply a mapping of the release funcction of the package manager to several packages. The default setting is to release only modified packages. The complete options for Commit are listed below.

Common options for Commit and Release . Both Commit and Release take the following options:

• patch | minor | major selects if a new patch version, minor version, or major version is to be created after committing the changes to the repository.

• 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. If you use the commit or release commands, you are strongly encouraged to explicitly or implicitly select packages, since it is very unlikely that you want to create a new version of all packages of the project.

• 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.