Perforce 2002.2 Command Reference
<< Previous Chapter
About This Manual
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 admin

p4 add


Synopsis

Open file(s) in a client workspace for addition to the depot.

Syntax

p4 [g-opts] add [-c changelist#] [-t type] file...

Description

p4 add opens files within the client workspace for addition to the depot. The specified file(s) are linked to a changelist; the files are not actually added to the depot until the changelist is sent to the server with p4 submit.

The added files must be contained in the user's current client view. These files need not exist within the client workspace at the time of p4 add. They must, however, be in the client workspace when p4 submit is run, or submission fails. p4 add does not create the files; they must be created by the user.

The new files must either not already exist in the depot, or can exist in the depot but be deleted at the head revision. Files may be deleted and re-added arbitrarily.

By default, the specified files are linked to the default changelist. Use -c to specify a different changelist.

When adding files, Perforce first examines the typemap table (p4 typemap) to see if the system administrator has defined a file type for the file(s) being added. If a match is found, the file's type is set as defined in the typemap table. If a match is not found, Perforce examines the first 1024 bytes of the file to determine whether it is text or binary, and the files are stored in the depot accordingly. Text file revisions are stored in reverse delta format; binary file revisions are stored as full files.

The -t filetype flag specifies the file type explicitly, overriding any settings in the typemap table and Perforce's default file detection mechanism.

Options

-c changelist

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

-t filetype

Adds the file as the specified filetype.

Please see the File Types chapter for a list of Perforce file types.

g-opts

See the Global Options section.

Usage Notes

Can File Arguments Use
Revision Specifier?

Can File Arguments Use
Revision Range?

Minimal Access Level Required

No

No

open

Examples

p4 add -c 13 *

Opens all the files within the user's current directory for add, and links these files to changelist 13.

p4 add README ~/src/*.c

Opens all *.c files in the user's ~/src directory for add; also opens the README file in the user's current working directory for add. These files are linked to the default changelist.

p4 add -t binary file.pdf

Assigns a specific file type to a new file, overriding any settings in the typemap table

Related Commands

To open a file for edit

p4 edit

To open a file for deletion

p4 delete

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 pending changelist

p4 reopen

To change an open file's file type

p4 reopen -t filetype


Perforce 2002.2 Command Reference
<< Previous Chapter
About This Manual
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 admin
Please send comments and questions about this manual to [email protected].
Copyright 1999-2003 Perforce Software. All rights reserved.
Last updated: 02/25/03