SYNTAX

RenameProjectorFile oldName newName [-p] [-project project] [-u user]

DESCRIPTION

The RenameProjectorFile command has the following effects:

• The file's name is changed in the Projector database.

• The file's old name is deleted; you can use it as the name of a new file or to rename another existing Projector file.

• When you use the NameRevisions command to obtain the names of all files belonging to a named revision, the new name is included in the list of files.

INPUT

None

OUTPUT

None, unless you request progress and summary information (-p). In that case, a report is printed to standard output.

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

RenameProjectorFile can return the following status codes:

PARAMETERS

oldName

Specifies the current name of the Projector file.

newName

Specifies the desired name of the Projector file.

OPTIONS

-p

Writes progress information to standard output.

-project project

Renames the file or files of the specified project. This overrides the default in which Projector automatically renames files out of the current project.

-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.

EXAMPLES

The following command line renames the latest revision of MySources.c to WizzySources.c. Projector assumes the file is in the currently mounted project.

RenameProjectorFile MySources.c WizzySources.c

The next command line renames the latest revision of file.c in the Project∫SubProject∫Sources project:

RenameProjectorFile file.c StarFile.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 rename a file on the same command line, you can use the -user option as shown in this example.

RenameProjectorFile MySources.c YourSources.c -u Mark

SEE ALSO

DeleteRevisions

NameRevisions

ObsoleteProjectorFile

ProjectInfo

UnObsoleteProjectorFile