SYNTAX

ObsoleteProjectorFile filename1 [filename2]… [-p] [-project projectName]
[-u user]

DESCRIPTION

The ObsoleteProjectorFile command causes a file within a project to become inactive. This means the following:

• Once the file has been inactivated, you cannot check it out for modification or to create additional revisions.

• Existing revisions can be checked out as read-only files by using the -obsolete option of the CheckOut command.

WARNING
Versions of MPW before version 3.3 do not recognize obsoleted files. Users of a version of the MPW Shell that does not recognize obsoleted files will be able to modify and check in a new revision of an obsoleted file. To the user of the MPW Shell version 3.3 or later the file is still obsolete, but a new revision will have mysteriously appeared. •

INPUT

None

OUTPUT

None

STATUS

ObsoleteProjectorFile can return the following status codes:

PARAMETERS

filename1 [filename2]…

Specifies one or more files to obsolete.

OPTIONS

-p

Writes progress information to standard output.

-u user

Identifies the name of the current user. You must use this option if the MPW Shell variable {User} is not set or is a null string. Using this option allows you to override the variable's current definition.

-project projectName

Obsoletes files of the specified project. This overrides the default in which Projector automatically obsoletes files out of the current project.

EXAMPLES

The following command line obsoletes the latest revision of MySources.c from the currently mounted project:

ObsoleteProjectorFile MySources.c

The following command line obsoletes the latest revision of file.c from the Project∫SubProject∫Sources project.

ObsoleteProjectorFile file.c -project Project∫SubProject∫Sources

Setting the current user name with the Set command allows you to execute Projector commands without specifying the user name with the -u option. However, if you want to set the user name and obsolete a file on the same command line, you can use the -u option as shown in this example.

ObsoleteProjectorFile MySources.c -u MSC

SEE ALSO

CheckOut -obsolete

DeleteRevisions

NameRevisions

ProjectInfo

RenameProjectorFile

UnObsoleteProjectorFile