Revision

A revision refers to a specific state of a version control history; basically it is a version of the source code. When changes occur, they are usually identified by a number or letter code, termed "revision".

When displaying changes included in a finished or queued build, TeamCity also displays the corresponding revision. This section explains how the VCS revisions are chosen by TeamCity for a build.

TeamCity will use the current repository revision when a new VCS root is configured for a project or a build configuration, or when the configured VCS root settings have been modified.

After that TeamCity does not monitor the whole repository but only collects changes for the scope of the repository specified in TeamCity: the configured VCS root settings with checkout rules. The revision of the sources corresponding to the latest detected change affecting your build will be displayed as the VCS root revision on the Changes page accessible via the link on the Projects page or on the Changes tab of the build results.

If the settings of a VCS Root get modified since the last detected change, the revision in TeamCity will be different from the last change in the newly configured VCS root. TeamCity does not have any information on the previous change in this new root, so it starts to monitor changes with the new settings and sets the build revision to the first discovered change. Until the change is discovered, there is no way to get any revision other than the current revision of the repository. Therefore, while TeamCity builds the correct revision of the sources, the revision for the first build after a VCS root change will not be equal to the last change under the specified path.

See also:

Concepts: Change, Build Configuration
User's Guide: Investigating and Muting Build Failures