Adding New Files to a Perforce Depot

To add new files to a Perforce depot, first you "open them for add", then you submit them.

The Path Browser's Run->Open files for add... command lets you open one or more files in the current path for add. On the File Browser page, you can use Run->Open for add... if the current file does not already exist in the depot.

Run->Open files for add... first takes you to the Selecting Files to Add page. There you can either enter a list of files you want to add, or have P4Web scan your workspace looking for files to add. Next, on the "Open for Add" page, you verify the files you selected and choose options for how they will be opened. (See below.) After choosing your options, click the open for add command button.

The open for add command doesn't create new files -- -- it just lists them in a pending changelist. You can create the new files before or after you run open for add. (However, you don't have to worry about filetype selection if you create them before running open for add.)

Files opened for add aren't sent to the depot until you submit your pending changelist. The files must be present in your workspace to be submitted. If you decide you don't want to submit the files after all, you can use the revert command to remove them from your pending changelist.

The "Open for Add" options

• Open using filetype: When you open files for add, your P4Web Helper looks for the files in your workspace. If they already exist, their default filetype will be determined from their content. If the files don't already exist in your workspace, they will be opened as "text" files by default. The "Open using filetype" option lets you choose a different filetype than the one P4Web would use. Check the box and enter the filetype. See Perforce Filetypes for a list of valid choices.

• Put open files in changelist: If your client workspace has more than one pending changelist, you can this option to select a changelist.

• Files: This list is generated from your input to the Selecting Files to Add form. The checked files will be opened for add. Uncheck any files you don't want included in the open for add operation.

Files can only be opened for add if:

• They do not already exist in the depot
• They are in your client view
• You have permission to open them