The VCS Pop-up menu () (Figure 16.5) appears in editor windows when a version control system is activated. The icon that represents the VCS Pop-up menu indicates the current permission setting for the file. For more information on permission settings, see "VCS States".

When using a version control system, each file in a project can have a different permission setting. A file's permission setting can be viewed in the Project window's Checkout Status Column (Figure 16.6) and as part of the file's editor window's VCS Pop-up menu (Figure 16.6). See Table 16.3 for a description of each state indicator.

If the icon is		Then
	Checked out	You can edit the file and add your changes to the revision control database.
	Checked in	You cannot edit the file, and it is part of the revision control database.
	Writable	You can edit the file, but you cannot add your changes to the revision control database because the file was not properly checked-out for modification.
	Unlocked	The file can be edited, and it is not checked into a revision control database.
	Locked	You cannot edit the file, and it is not part of the revision control database. You may not have the access privileges needed to access the file, or someone may have locked the file.

Depending on the state of the VCS Pop-Up menu when you click on it, certain operations may be performed on the file you are editing. These supported operations are described in Table 16.4.

You choose an item from the VCS Pop-up menu to execute a VCS operation. If the menu item contains an ellipsis character "", a dialog box of advanced options for the operation appears, enabling you to customize the operation before executing it.

Press the Option key before choosing a menu command to access any advanced VCS options. If an ellipsis character "" appears next to a menu command, advanced VCS options are available for that operation.

For more information on these operations, refer to the documentation that came with your revision control system.

Command	Description
Unlock	Change the lock on the file (if possible) so that the file is writable.
Add	Add the file to the revision control database.
Get	Retrieve a fresh copy of the file from the revision control database.
Checkout	Check the file out from the revision control database for modifications.
Undo Checkout	Discard any changes made to the file, and tell the revision control database to cancel the checkout of the file.
Checkin	Tell the revision control database to accept the file with the changes that have been made to it.
Make Writable	Make the file writable for experimentation, though it will not be able to be checked into the revision control database.