Download StarTeam® - Borland Technical Publications

W r ap p in g t h e A p pl ic a t i on A r o u nd V S S
label from the earlier revision. A VSS revision label can have the same name as a VSS
project label, but no application revision label can have the same name as an
application view label. Therefore, the application will not create a revision label if a
project label with the same name exists. The comment for a VSS revision label
becomes the description for a StarTeam revision label.
In VSS, you can create a new version of a file with no changes in file contents by
selecting the file and using File > Label to add a label. In this situation, the application
generates a new version of the file to match the version in VSS. If desired, you can
delete one of the file versions in VSS by adding the label a second time, which makes
a gap in the VSS history. During the wrap the application recognizes the gap but
cannot obtain any data, so it generates a revision one second after the most recent
content revision. The application uses the revision comment in the file history to
indicate that the revision is a “fake.”
Pinned files
If a file is pinned in VSS prior to the wrap, the StarTeam item configuration for the file
will show that it is pinned. Because VSS does not supply the time at which the pin
operation occurred, the application uses a time immediately after the pinned revision
was checked in. If a user rolls back a view to a configuration time that is after the time
at which the application pinned the revision, the item will remain pinned.
Pinned files in both StarTeam and VSS are read only and therefore cannot be
modified.
To wrap an application project around a VSS project so that the projects are
interoperable:
1 Do one of the following:
■
Click the New Project icon.
■
Select Project > New from the menu bar.
■
Drag the srcsafe.ini file from Network Neighborhood or Explorer and drop it on an
empty portion of the application window to create the project.
2 Do one of the following:
■
From the server list, select the server configuration that will store the project.
■
Click Add Server to add access to another server configuration and follow the
steps in “Adding Access to a Server Configuration” on page 74. Then select the
server configuration.
3 If you are not currently logged onto the server configuration, you will be asked to do
so. After you log on, the New Project Wizard dialog appears.
If you are already logged onto the server or are running the application Toolbar, but
wish to log on as a different user, you can do so. On the New Project Wizard dialog,
click the Log On As button and enter an alternate user name and password in the
Log On dialog. To reset your default credentials for the server, select the “Save as
default credentials for this server” check box . When you are done, click OK.
4 From the New Project Wizard dialog, click Next. The New Project Wizard: Project
Name dialog appears.
a Enter the name of the new project in the Project Name text box.
b Enter a description of the project.
c If VSS security is disabled, go to step 5. If it is not disabled, go to step 4d.
d Click Foreign Archives.The Select Foreign Archive dialog appears.
1 Select the Create Project From check box.
2 Select the Visual SourceSafe option button.
222 S t a rT ea m A dm in is t r a t o r ’s G u id e