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. There are two ways to open files for add:

• To open multiple files in a path, select the directory on the Files tab and then select Open for add... from the pulldown menu.
• To open a single file, click on that file in the Files tab and then select Open for add... from the pulldown menu.

Selecting Open for add... first takes you to the page where you select files to add. There you can either enter a list of files you want to add, or have P4Web scan your workspace looking for files to add.

Once you have selected the files to add, click Continue. Next, on the "Open for Add" page, 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 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 when you selected which files to add. 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