Perforce Command Reference:   [Index]  [Prev] [Next]


p4 delete

Synopsis

Opens file(s) in a client workspace for deletion from the depot

Syntax

p4 [g-opts] delete [-c changelist#] file...

Description

Opens file(s) in a client workspace for deletion from the depot. The files are immediately removed from the client workspace, but are not deleted from the depot until the corresponding changelist is sent to the server with p4 submit.

Although it will appear that a deleted file has been deleted from the depot, the file is never truly deleted, as older revisions of the same file are always accessible. Instead, a new head revision of the file is created; it marks the file as being deleted. If p4 sync is used to bring the head revision of this file into another workspace, the file will be deleted from that workspace.

A file that is open for deletion will not appear on the client's have list.

Options

g_opts See global options.

-c change#

Opens the files for delete within the specified changelist. If this flag is not provided, the files are linked to the default changelist.

Usage Notes

Can File Arg Use
Revision Specifier?

Can File Arg
Use Revision Range?

Minimal
Access Level Required

No No open

A file that has been deleted from the client workspace with p4 delete can be reinstated in the client workspace and removed from the pending changelist with p4 revert. This command must be given before the changelist is submitted.

p4 add determines whether a file is text or binary by examining the first 1024 bytes of the file to see if they are valid ASCII characters. If all of them are, the file is assumed to be text. If at least one byte is not ASCII, the file is considered to be binary.

Perforce does not prevent users from opening already-open files; its default scheme is to allow multiple users to open a file simultaneously, and then resolve file conflicts with p4 resolve. To prevent someone else from opening a file once you've opened it, use p4 lock. To determine whether or not another user already has a particular file opened, use p4 opened -a file.

Examples

p4 delete //depot/README

Opens the file called README in the depot's top level directory for deletion. The corresponding file within the client workspace is immediately deleted, but the file is not deleted from the depot until the default changelist is submitted.

p4 delete -c 40

Opens all files in the current client workspace for deletion. The files are immediately removed from the client workspace; they won't be deleted from the depot until changelist 40 is sent to the server with p4 submit.

Related Commands

To open a file for add

p4 add
To open a file for edit p4 edit
To copy all open files to the depot p4 submit
To read files from the depot into the client workspace p4 sync
To create or edit a new changelist p4 change

To list all opened files

p4 opened
To revert a file to its unopened state p4 revert
To move an open file to a different changelist p4 reopen



Perforce Command Reference:   [Index]  [Prev] [Next]


Copyright 1998 Perforce Software.
Contact us at [email protected]
Last updated: 06/14/98