Opening Files for Add

To add new files to a Perforce depot, first run open for add, then run submit. You can open files to be added in the current path, or in a subdirectory of the current path, by choosing Run->Open files for add... in the control panel of the Path Browser page.

The open for add command doesn't create new files -- -- it just puts 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 runnning open for add.)

The files you have 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.

Run->Open for add... takes you to a page where you list the files you want to add and select options to control how they will be added. After completing the form on the page, click "Open for Add" to open the files.

• Files: In this field, list the files you want to add, one file per line. If the files are in the current path, enter the filenames only, with no pathname. If the files are in subdirectories of the current path, enter them with pathnames relative to the current path. Do not use wildcard characters in the filenames or pathnames.

  This version of P4Web requires you to enter filenames in a text field instead of dragging and dropping files or folders. If you have several files to add, you can use these shortcuts to save yourself some typing:

  • On Windows: open a command prompt window and cd to the client workspace path where your new files live. Run dir/s/b and cut and paste the resulting output to the "Files" field in your browser page.

  • On Unix: in a command shell, cd to the client workspace path where your new files live. Run find . -type f and cut and paste the resulting output to the "Files" field in your browser page.

  A file list you cut and paste this way may contain files that already have been added to the depot, and/or files you don't want to add. Files that already exist in the depot don't have to be removed from the list; Perforce simply won't open them. If the list contains non-Perforce files you don't want to add to the depot, you can remove them from the list before clicking the "Open for Add" button, or you can revert them after opening them.

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