SYNTAX

TransferCkid sourceFile destinationFile

DESCRIPTION

The TransferCkid script copies the Projector 'ckid' resource from a source file to a destination file. This copies all the information stored in the 'ckid' resource of the source file, including its filename, revision number, and project information.

This means that when you check the file back in, it will be checked into the project that the source file was checked out from. Further, if any of the information in the 'ckid' resource does not match the destination file (for instance, if the name of the destination file is not the same as that specified in the 'ckid' resource), an error occurs.

INPUT

None

OUTPUT

None

ALIAS RESOLUTION

This command does not resolve leaf aliases used as part of a pathname or filename. Finder alias files are not recognized by Projector.

STATUS

TransferCkid can return the following status codes:

PARAMETERS

sourceFile

Specifies the source file from which the 'ckid' resource is removed.

destinationFile

Specifies the destination file to which the 'ckid' resource is moved.

OPTIONS

None

EXAMPLES

When a file loses its 'ckid' resource, it is said to be orphaned from its project. This can occur under many circumstances, often accidentally. For example, if you save a Projector file using Save As instead of Save, the 'ckid' resource is not retained in the new copy of the file. This means that it is no longer recognized as belonging to its project and cannot be checked in again. To remedy this, you can use a TransferCkid command, such as

TransferCkid myFile differentDirectory:myFile

to transfer the 'ckid' resource from another copy of that file to the one that was orphaned. To avoid conflicting filenames, be sure that the two copies of this file are in different directories when you execute this command.

The TransferCkid command can also be used when you wish to give your copy of a file the identity of another revision. For instance, you may be working with an old revision of a file and wish to check it in as the latest revision. In this case, you must check out the latest revision of the file and transfer its 'ckid' resource to the old revision.

CheckOut Plato -m
TransferCkid Plato Philosophers:Plato

SEE ALSO

OrphanFiles