Next: The VCS Menu, Previous: The VCS Explorer, Up: Version Control System

### 12.2 The VCS Activities

The VCS Activities give the ability to group files to be committed together. The set of files can be committed atomically if supported by the version control system used.

The way to bring up the VCS Activities view is through the `VCS->Activities` menu.

The VCS Activities view contains the following columns:

Activity / File
  The name of the activity or files belonging to an activity. This column can be sorted by clicking on the header.
Status
  Shows the status of the file. This column can be sorted by clicking on the header. See The VCS Explorer for a full description.
Log
  This column indicates whether a revision log exists for this file.
Working rev.
  Indicates the version of the local file.
Head rev.
  Indicates the most recent version of the file in the repository.

The VCS Explorer supports multiple selections. To select a single line, simply left-click on it. To select a range of lines, select the first line in the range, then hold down the <Shift> key and select the last line in the range. To add or remove single columns from the selection, hold down the <Control> key and left-click on the columns that you want to select/unselect.

There are different contextual menu entries depending on the position on the screen. On an empty area we have a simple contextual menu:

Create new activity
  Create a new activity. The name can be edited by double clicking on it.

On an activity line the contextual menu is:

Group commit
  This is a selectable menu entry. It is activated only if the VCS supports atomic commit and absolute filenames. See The VCS node for full details.
Create new activity
  Create a new activity. The name can be edited by double clicking on it.
Re-open activity / Close activity
  If the activity is closed it is possible to re-open it and if it is opened it is possible to close it manually.
Delete activity
  Remove the activity.
Commit activity
  Commit the activity. If group commit is activated then the commit log content is generated using a template file fully configurable. See Files. If group commit is not activated then the log content for each activity file is the file log catenated with the activity log. After this operation the file's log are removed but the activity log is kept as documentation.
Query status
  Query the status for all the source files contained in the activity.
Update
  Update all the source files contained in the activity.
Compare against head revision
  Show a visual comparison between the local activity files and the most recent version of those files in the repository.
Build patch file
  Create a patch file (in text format) for the activity. The patch file contains a header (the activity log and file's logs) and the diff of each file. The header format is fully configurable using a template file. See Files.
Edit revision log
  Edit the current revision log for activity. This log is shared with all the activity files.
Remove revision log
  Remove the current revision log for activity. This menu is present only if the activity revision log exists.

On a file line the contextual menu contains:

Create new activity
  Create a new activity. The name can be edited by double clicking on it.
Remove from activity
  Remove the selected file from the activity and delete the activity log.
Edit revision log
  Edit the current revision log for the selected file.