Chapter 5: Using Source Control

Viewing the status of source-controlled objects

After a PocketBuilder workspace is assigned to a source control project through a connection profile, icons in the PocketBuilder System Tree indicate the source control status of all objects in the workspace. In the Library painter, the same icons also indicate the status of objects if the workspace to which they belong is the current workspace for PocketBuilder.

Source control icons

The icons and their meanings are described in Table 5-3 and Table 5-4.

**Table 5-3: Source control status icons in PocketBuilder**
Icon	Source control status of object displaying icon
	The object resides only locally and is not under source control.
	The object is under source control and is not checked out by anyone. The object on the local machine is in sync with the object on the server unless the icon for indeterminate status also appears next to the same object.
	The object is checked out by the current user.
	The object is checked out by another user.
	The current status of an object under source control has not been determined. You are likely to see this icon only if the Perform Diff On Status Update check box is not selected and if diffs are not performed for your source control system based on version number. This icon can appear only in conjunction with the icon for a registered object (green dot icon) or for an object checked out by another user (red x icon). If multiple checkouts are enabled, it can also appear with a red check mark above it.
	The object on the local machine is registered to source control but is out of sync with the object on the server. This icon can also appear with the icon for an object checked out by another user. The Perform Diff On Status Update check box must be selected for this icon to display.

Compound icons with a red check mark can display only if you add a PK.INI setting to permit multiple user checkouts. These icons are described in the following table:

**Table 5-4: Source control status icons with multiple checkouts enabled**
Icon	Source control status of object displaying icon
	The object is under source control and is checked out nonexclusively by another user. PocketBuilder allows a concurrent checkout by the current user.
	The object is checked out by both the current user and another user.
	The object is checked out nonexclusively by another user and the version in the current user’s local path is out of sync.

For more information on allowing multiple user checkouts, see “Checking objects out from source control”.

Pop-up menus

Pop-up menus for each object in the workspace change dynamically to reflect the source control status of the object. For example, if the object is included in a source-controlled workspace but has not been registered to source control, the Add To Source Control menu item is visible and enabled in the object’s pop-up menu. However, other source control menu items such as Check In and Show Differences are not visible until the object is added to source control.

Library painter Entry menu

Additional status functionality is available from the Entry menu of the Library painter. Depending on the source control system you are using, you can see the owner of an object and the name of the user who has the object checked out. For most source control systems, you can see the list of revisions, including any branch revisions, as well as version labels for each revision.

Library painter selections When a painter is open, menu commands apply to the current object or objects in the painter, not the current object in the System Tree. This can get confusing with the Library painter in particular, since Library painter views list objects only (much like the System Tree), and do not provide a more detailed visual interface for viewing current selections, as other painters do.

To view the status of source-controlled objects

In a Library painter view, select the object (or objects) whose status you want to determine.
Select Entry>Source Control>Source Control Manager Properties.

A dialog box from your source control system displays. Typically it indicates if the selected file is checked in, or the name of the user who has the file checked out. It should also display the version number of the selected object.

Displaying the version number in the Library painter You can display the version number of all files registered in source control directly in the Library painter. You add a Version Number column to the Library painter List view by making sure the SCC Version Number option is selected in the Options dialog box for the Library painter.

For more information, see “Displaying libraries and objects”.

View this book as PDF