Syntax

	revertChanges($changes)

Description

Reverts the given changes (tl.changelog:ChangeSet) inside the caller's active transaction. The order of the entries in the given list is irrelevant: the function sorts them internally by revision in descending order and reverts the youngest change first.

The function does not open or commit a transaction itself. The surrounding script is responsible for commit and rollback handling.

The returned list contains the problems (resource keys) that were raised during the revert. An empty list means every revert ran without conflict.

Parameter

Name Type Description Mandatory Default
changes List of tl.changelog:ChangeSet The changes to be undone. May also be a single ChangeSet. yes

Return value

Type: List of resource keys

List of problems raised during the revert; empty when all reverts ran cleanly.

Examples

Example 1

	revertChanges($project.changeLog())

Restores a project and all its sub-objects to the state they had before the first recorded change in the log. The surrounding script must commit the transaction afterwards.