When you choose Run->Integrate... on the Path Browser page, you can use the resulting Integrate page to set up an integration to or from all the files in the current path. In most cases, you only need to be concerned with these fields on the Integrate page:
Current path:
This is initialized for you. It is a writable field to give you more flexibility, but you don't have to change it. If you do change it, make sure the pathname you enter ends with a slash ("/").Direction to integrate changes:
Select the direction in which you want integrate:
- To files in current path is the default. Files in the current path will be the integration targets -- that is, they are the ones that will be opened for integrate. Changes in the donor files will be integrated to files in the current path.
- From files in current path means the files in the current path will be the integration donors and will not themselves be opened for integrate. Changes to files in the current path will be integrated to the target files.
Use corresponding path:
Enter a pathname here. Make sure the pathname ends with a slash ("/"). This tells Perforce what pathname to use when looking for corresponding donor or target files, depending on the integration direction you chose.
The "Integrate" button runs the integrate command and opens files for integrate according to the options you chose.
You can use the "Preview Integration" button to see which files would be opened. This is a particularly good idea when you are using integrate to branch new files -- it lets you confirm that you are creating files in the correct path. To actually run the integrate command after previewing it, click your browser's "Back" button to return to the Integrate Options page, then click "Integrate".
An alternative to specifying corresponding paths each time you integrate is to use a branch view. A branch view is a predefined, stored mapping of corresponding paths.
Use branch view:
If there is a branch view that you want to use for this integration, click this radio button and enter the name of the branch view. When you choose this option, any "corresponding path" you entered above will be ignored.
- Integrate files in current path
This option (the default) restricts the integration to the files in the current path, using the branch view. Whether the files in the current path are the donors or the targets is controlled by the "direction to integrate" option, above.- Integrate all files in branch view
If you chose this option, the current path is ignored, and all the files in the branch view are considered for integration. You must choose whether to integrate in the forward or reverse direction of the branch view:
- forward -- the files on the right-hand side of the branch view mapping are the targets and will be opened for integrate. The files on the left-hand side of the branch view mapping are the donors. (This is the default.)
- reverse -- the files on the left-hand side of the branch view mapping are the targets and will be opened for integrate. The files on the right-hand side of the branch view mapping are the donors.
The remaining advanced options are the same regardless of how you arrived at the Integrate page.