Files can be pinned in SourceOffSite
just as in SourceSafe. A file that has been pinned is denoted with a pin
symbol. When you pin a file, you are locking in a particular version of the
file. In other words, no changes can be made to a file as long as it is pinned.
Thus, when a Get Latest operation is performed on a pinned file, the pinned
version is the version that will be retrieved, even if there is a more recent
version.
In order to be able to pin a file, Pin Support must be enabled in the Pin Support tab of the Server Manager.
If Pin Support is disabled in SourceOffSite and you are
working with pinned files in SourceSafe, this may present some inconsistent
behavior. For example, when you perform a Get Latest Version in SourceOffSite
on a file that has been pinned in SourceSafe, you may not get the same version
that you would have gotten in SourceSafe. This would depend upon the file
version the pin was applied to in SourceSafe.
If a file had six versions but was pinned at version three and you perform a
Get Latest Version, SourceSafe would bring up version three. However,
SourceOffSite with Pin Support disabled would get the most recent version,
which would be version six. Again, enabling Pin Support in the Server Manager
will prevent this behavior, resulting in the expected version of the file being
retrieved.
To pin a version of a file, you must look at the revision history of a file. First, select the file in the File List. Then, click Show History or choose the Show History command from either the Tools menu or by right-clicking. Select the version you want to pin from the History dialog and click Pin. You have now locked this particular version of the file. A pin symbol will be displayed to the left of that file version in the History dialog as well as to the left of that file in the File List, indicating the pinned status of the file.
Please note: While you are presented with the option to Edit a pinned file, just as in SourceSafe, you cannot perform this function. An "Operation Failed" error message will appear in the SourceOffSite Status Window.
When you pin a file, you typically are not planning to change the file, so that a particular version of the file becomes the version that is part of your project. No changes can be made to that file until someone unpins that file.
To unpin a file, select the file in the File List. Click Show History or choose the Show History command from either the Tools menu or by right-clicking. Select the pinned version from the History dialog and click Unpin. You have now unlocked this particular version of the file. The pin symbol will be removed from that file version in the History dialog and from the left of that file in the File List.
