The File List

The File List displays the files contained in the selected folder. In VSS mode (auto-commits on), the File List reflects the status of the files on the server since changes have been automatically committed. In CVS Mode, (auto-commits off), the file list may reflect certain pending changes not yet committed to the repository, such as renames, moves and deletes. In CVS mode, shares, pins, adds, and branches, will not appear in the File List until they are committed to the server. Note that in VSS mode with auto-commits off, the file list may also reflect pending changes not yet committed to the repository.

The File List must be refreshed periodically to retrieve any changes which may have been made on the server by other users. This can be set to automatically refresh in the General Options. The Refresh command (found on the Toolbar and View menu) refreshes both the File List and the Folder Tree.

One or multiple files can be selected. Right-click on a selected file to bring up the File List Context Menu for that file. Double-click on the selected file to bring up View or Edit File dialog box. In the General Options, there is a setting to control whether a double-click’s default behavior will view or edit the file.

The File List supports multiple column sorting. Clicking a column without a key will create a single column sort based on the contents of that column. If a new sort is created, it is in ascending order. If the column is already sorted, the sort is reversed. For example, an ascending column will be sorted descending and vice versa. The sorted column is indicated by an arrow. An up arrow indicates the file list is sorted in ascending order. Conversely, a down arrow indicates the list is sorted in descending order. Click a different column to sort the list by that column.

If you depress the SHIFT key while clicking a column, that column will be last on the list of columns to sort by. If no other columns are currently sorted, the clicked column will be new "primary" sorted column.

If any column (even if it is in an existing sort) is clicked without using SHIFT, the sorted columnas are all cleared that that column is now the primary sort in acending order.

The default columns for the File List are File, Checkouts, Local Version, Remote Version and Status. Other columns are available in the Options dialog, File List Columns pane.

File

The File column lists the names of the file in the selected folder. It also includes an icon for the file to indicate the state of the file. The appearance of the icon indicates the status of the file.

  • When the file is not checked out and has not been pinned or shared, the icon is a single "page."

  • When the file is checked out by a single user, regardless of who it is, the icon includes a red check mark.

  • When the file is checked out by more than one user, the icon includes two red check marks.

  • When the file is pinned, the icon includes a red push pin.

  • When the file is shared, the icon includes a blue double-headed arrow.

  • When the file is both shared and checked out, the icon includes a blue double arrow and one or two red check marks depending if it is checked out by one or multiple users.

  • When a non-version-controlled file exists in your working folder, the icon a light gray outline of a file (note this type of file will only show up if the “show non-version-controlled files ghosted in file list” option is turned on). See Ghost Folders and Files for more information.

Check Outs

The Check Outs column includes the name of any user(s) who has the file checked out. The term (Exclusive) appears next to the name if the file has an exclusive lock.

Local Version

The Local Version refers to the version number of the file in the working directory.

Remote Version

The Remote Version refers to the latest version number of the file in the repository.

Status

The Status is a one-word description of the state of the working copy of the file. Following is an explanation of the possible status of a file.

Status

Explanation

(blank)

The working copy has not been edited. The working copy matches the version in the repository.

Edited

The working copy has been checked out and modified. The remote version has not changed.

Renegade

The working copy has been modified but is not currently checked out. This status only exists for mergeable files when you require a check out before a check in (see Check In Options).

Needs Merge

The working copy is checked out and edited. The remote version has also been edited. You must use the Show Merge command before this file can be checked in.

Merged

The working copy has been edited. The remote version has been edited and the file has been merged. You can use the Show Merge command to examine what was done or to revert back to Needs Merge status.

Old

The server copy of the file is newer than the working copy. The working copy has not been edited.

Missing

The working copy does not exist.

Unknown

The working copy exists but Vault Standard cannot determine its status.

More Recent

The working copy has not been edited and is a version of the file which is more recent than the current version on the server.