About P4 for Eclipse

P4 for Eclipse, the Eclipse plugin for P4 Server (P4D), integrates the most important features of P4 Server into the Eclipse IDE interface. P4 for Eclipse enables you to check files in and out, collaborate on code reviews with P4 Code Review, and perform various other versioning tasks directly from Eclipse. P4 for Eclipse supports classic depots and stream depots on the P4 Server.

Basic concepts and terminology

P4 Server (P4D) is an enterprise version management tool that you can use to manage source files and other documents, such as multiple revisions of a manual, web pages, or operating system administration files. The files managed by P4 reside in a depot. To work on files, you open the files and edit them in your Eclipse workspace. When you’re done, you submit changed files to the depot using a changelist. The depot keeps track of all of the current and previous revisions of the files.

The definitions for these P4 terms are as follows:

• Perforce Server, also referred to as P4D, P4 Server, and P4 Server: the program that manages file revisions.
• Depot: the central repository where file revisions are stored and managed by P4 Server.
• Workspace: the area on your computer where you work with your copies of files and directories that are managed by P4 Server.
• Changelist: a group of files, with a description explaining how you have changed them (for example,"Fix bug #123"). Changelists are assigned numbers by the P4 Server so you can track them. Changelists enable you to group related files and submit To send a pending changelist from the client workspace to the depot. them together.
• P4 Code Review: a code review allows other developers to see your code and provide feedback to suggest ways to improve the code's structure, performance, maintainability, and interaction with other code. You can request a P4 Code Review of a changelist from Eclipse, the review is assigned a number by the P4 Server so you can track it.

Basic tasks

• Get Latest Revision of a file or set of files from the depot: copy the most recent revision of a file or set of files from the depot to your workspace.

P4 also uses the term "sync" to mean "retrieve a file." This usage is different from the Eclipse term "synchronize."

• Get Revision... of a file or set of files from the depot: copy a specific revision of a file or set of files from the depot to your workspace.
• Check out a file: enables you to change the file.
• Mark a file for add or delete: indicates that the file is added to or deleted from the depot when the changelist is submitted.
• Revert a file: discard any changes you have made to an open file. If you open a file for edit and make changes, then change your mind and revert the file, P4 Server reloads the last version you got from the depot and discards your changes.
• Submit a changelist: update the depot to reflect any changes you've made to files in the changelist. Submitting is an all-or-nothing operation: if there's a problem submitting one file in a changelist, none of the other files in the changelist are updated.
• New P4 Code Review for a changelist: request a P4 Code Review of a P4 pending changelist or a P4 submitted changelist.
• Update P4 Code Review for a changelist: update an existing P4 Code Review with a P4 pending changelist.

P4 file decorations

File decorations indicate status as follows.

	Marked for add
	Marked for delete
	Checked out by you
	Checked out by another user
	Locked
	Version in workspace is not latest version
	Workspace version is up to date
	Needs resolve (conflicting 1. A situation where two users open the same file for edit. One user submits the file, after which the other user cannot submit unless the file is resolved. 2. A resolve where the same line is changed when merging one file into another. changes have been made)

For more details about configuring P4 for Eclipse, see Setting Preferences.

This product includes software developed by the Eclipse Project.

P4 for Eclipse installation links

Below are installation links to the current and previous versions of P4 for Eclipse.

• Install 4.32

• Install 4.31

• Install 4.30

• Install 4.29