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