Release Notes for P4WSAD The Perforce Plug-in for Eclipse and WebSphere Studio Version 2007.3 Introduction These notes include release-specific information about the Perforce Plug-in for Eclipse and WebSphere Studio (P4WSAD). For details about using P4WSAD, refer to the online help included in the Eclipse IDE and WebSphere Studio Application Developer - when you install P4WSAD, a "Perforce SCM" folder is added to the help table of contents. P4WSAD allows access to Perforce from within the Eclipse IDE as well as the IBM Rational Studio family of products. P4WSAD, the Perforce Plug-in for Eclipse and WebShere Studio, has met IBM specifications for validation as Ready for WebSphere Studio software. Requirements * It is highly recommended that any previous versions of the P4WSAD plugin be removed before installing the new version (see the uninstall instructions below) due to the agressive caching done by Eclipse. * P4WSAD, the Perforce Plug-in for Eclipse and Websphere Stuidio, version 2007.3 works with a Perforce server at Release 2002.2 or higher. * P4WSAD 2007.3 runs in: - Eclipse 3.2 and 3.3, Release Builds only; - IBM Rational Application Developer 7 (based on Eclipse 3.2). Note: The 2006.2 version of P4WSAD is still available for users of Eclipse 2.x and IDEs that are based on Eclipse 2.x via the Update Manager: Uncheck the "Show the latest version of a feature only" option in "Update Manager" / "Find and Install" to have it listed. Version 2006.2 of P4WSAD supports Perforce servers 2002.2 through 2007.2 and the following IDEs: - Eclipse 2.x (release builds starting with 2.1); - WebSphere Studio 2.1; - WebSphere Studio Application Developer 5.1 and up; - WebSphere Studio Site Developer 5.1 and up; - WebSphere Studio Homepage Builder 6; - IBM Rational Application Developer * P4WSAD 2007.3 works with Sun JRE 1.5. * System Requirements Memory: 12 MB minimum, 768 MB recommended Disk : 750 KB * Supported platforms P4WSAD is supported under: * Windows XP/2003/Vista * Linux (x86/GTK 2) Known to work by Perforce or Perforce customers, not tested nor certified by Perforce, not supported by Perforce Technical Support (Certification Level 2): * Solaris 8 (SPARC/Motif) * Linux (x86/Motif) * Mac OSX (Mac/Carbon) * AIX (PPC/Motif) * HP-UX (HP9000/Motif) * Windows 98/ME/2000 * P4WSAD issues "p4" commands, therefore, the p4 command line client must reside in a directory in your command path or the path to the p4 client can be defined in the preferences. For unicode enabled servers, the plugin requires a p4 client >= 2003.2. Documentation P4WSAD is documented in help files that are installed in the Eclipse's Help->Help Content. Installation To install P4WSAD, open the Software Updates / Update Manager in Eclipse or IBM Rational Application Developer and create a new site bookmark with the following URL: http://www.perforce.com/downloads/http/p4-wsad/install/ Specific Instructions: For Eclipse 3.x and IBM Rational Appllication Developer 6 & 7: 1. Choose Help > Software Updates > Find and Install The Install/Update Feature Updates form is displayed. 2. On the Feature Updates form, click the "Search for new features to install" radio button and then click "Next>". 3. On the Install Update sites to visit, click on the "New Remote Site..." button. Fill in the name (such as Perforce P4WSAD) and enter the following location in the "URL:" field: http://www.perforce.com/downloads/http/p4-wsad/install/ then click the "OK" button. The new site is displayed in the "Sites to include in search" pane. 4. In the "Sites to include in search" pane, check the newly created P4WSAD site and then click the "Next>" or "Finish" button. The "Search Results" page will be displayed. 5. On the Search Results page, check the P4WSAD plugin and then click "Next>". The Feature License page is displayed. Click on the license selection and then click "Next>". The Installation page is displayed. Click "Finish" to proceed to the installation of the plugin. For Eclipse 2.x and Websphere Studio Application Developer 5: 1. In WebSphere Studio Application Developer, choose Help > Software Updates > Update Manager The Install/Update perspective is displayed. 2. In the Feature Updates view, right-click Sites to Visit and choose New > Site Bookmark from the context menu. The New Site Bookmark dialog is displayed. 3. Enter the following location in the URL field and click Finish: http://www.perforce.com/downloads/http/p4-wsad/install/ The new node is displayed in the Feature Updates pane. 4. Expand the newly created P4WSAD node and its child node (P4WSAD - Perforce Team Provider 5. Click on "Install" or "Update". Installing from a zip file: 1. Unzip the P4WSAD install files into a local directory. 2. Choose Help > Software Updates > Find and Install... The Install/Update Feature Updates form is displayed. 3. On the Feature Updates form, click the "Search for new features to install" radio button and then click "Next>". 4. On the Install Update sites to visit, click on the "New Local Site..." button. Browse to the install directory of the uzipped plugin files and click "OK". On the "Edit Local Site" box, click "OK". The local installation site is displayed in the "Sites to include in search" pane. 5. In the "Sites to include in search" pane, check the newly created P4WSAD site and then click the "Finish" button. The "Search Results" page will be displayed. 6. On the Search Results page, check the P4WSAD plugin and then click "Next>". The Feature License page is displayed. Click on the license selection and then click "Next>". The Installation page is displayed. Click "Finish" to proceed to the installation of the plugin. Installation Note: Label Decorations Label Decorations are off by default. To turn them on go to Window->Preferences. Then, open "Workbench" or "General", "Apearance" and click on "Label Decorations". Click on "Perforce" so that it is checked and click "Apply". Then, open "Team" and open "Perforce". Click on "Label Decorations" and make sure the label decorations are set up then click "Apply". Uninstalling Eclipse 3.x and Rational Application Developer 7: 1. Disconnect all projects in the IDE from Perforce (Team->Unmanage) and close the Perforce Perspective and any other Perforce views that are open. 2. Go to Help->Software Updates->Manage Configuration. 3. Open the entry for the installation and look for an entry for the P4WSAD plugin. 4. Right click on the entry for the P4WSAD plugin and select "Uninstall". Click "OK" for the "Do you want to disable and uninstall this feature"? dialog. Click "Yes" to restart the IDE. 5. To uninstall other plugins that were replaced with the current one, click on the "Show Disabled Features" button. Look for P4WSAD entries and right click and select "Uninstall". 6. Shutdown the IDE. 7. Go to the ECLIPSE_HOME directory (Note: the ECLIPSE_HOME directory is usually the Eclipse software directory). 8. Do a recursive search for "perforce" and ensure there are none. If so, remove anything that is found. 9. Go into the IDE workspace (on the user's system where the IDE is used). Go into the ".metadata/.plugins" directory, do a recursive search for "perforce". Remove anything that is found. 10. Start Eclipse up again and the P4WSAD plugin will be gone. Known Limitations P4WSAD does not support: * P4CHARSET should not be set prior to using P4WSAD (use the "Charset" setting on the connection dialog) * P4CONFIG, P4DIFF or P4MERGE environment variables * Creating client workspaces, branches, labels or jobs * Editing client workspaces, branches, labels or jobs * Performing integrations * Refactoring between projects Notes Refactor->Rename and File->Rename in Eclipse and Rational / Websphere Studio: When you refactor files, P4WSAD displays the refactored files as open for add but in fact has renamed them by integrating them to the new names and deleting the old ones, as follows: p4 integrate -v oldfile newfile p4 add newfile p4 delete oldfile The plugin issues the "p4 integrate -v" command followed by the "p4 add" command, because the new file has been created by the IDE and therefore cannot be created by Perforce. This sequence of steps supports refactoring correctly and preserves the branching history of the original file and its new, refactored version. * -- requires new p4wsad plugin ** -- requires new p4d server program -------------------------------------------------------------------------------- New Functionality in 2007.3 #25580 * The plugin now identifies itself as "p4wsad" along with the version in "p4 monitor" and in the Perforce server log. #25231 * The plugin works with Eclipse 3 (starting with Eclipse 3.2). Bugs Fixed in 2007.3.661 #28631 * Under certain circumstances defining a new server in the "P4 Depots" view would not work. This has been fixed. Bugs Fixed in 2007.3.646 #28506 * Extraneous change -o calls done under certain circumstances were introduced as a side-effect of an earlier fix and could cause slowdowns. This has been fixed. #28278 * Revert Files menu item shows up on the top menu. This has been fixed. #28188 * Submitting a change to a file from another client leaves the plugin unable to open for edit the file. This has been fixed. #27918 * Manually inserted lines in .p4ignore were not being honored. This has been fixed. #27908 * Unable to open for edit after add on brand new workspace. This has been fixed. #27332 * #27219 * #24343 * Eclipse could hang on start up after a crash due to the plugin's activator. This has been fixed. Previous versions of the P4WSAD plugin must be completely removed first before installing the version of the plugin that contains this fix to ensure the fix is in place due to Eclipse's agressive caching (see the Uninstall instructions above). #27271 * When editing a file, the open for edit dialog would show up even though the file is already open and in a changelist. There was a similar problem when adding a new file. This has been fixed. #27224 * When connecting to a unicode enabled server, a valid charset is now required on the connection dialog box. A dropdown list of valid charsets has been added to the connection dialog box. #27184 * The plugin was generating a lot of "p4 have"s in the console window which could slow down the responsiveness. This has been fixed. #27176 * If the p4 command line was not available, a loop of repeating error messages were given. This has been fixed. #26653 * Check consistency could give the wrong results for a missing file. This has been fixed. #26547 * All files under derived folders were added unless they are also marked derived. This has been fixed. #26046 * P4WSAD was not creating a log file when the "Log all commands to persistent log file" option was selected. This has been fixed. #26037 * "Revert Files" showed up twice in the context menu of "P4 Pending Changelists". This has been fixed. #26073 * #25870 * A hang could occur if connecting to a unicode server and using an incorrect charset. It could also give a misleading error. This has been fixed and the Team->Share dialog will only accept valid charsets (see the Internationalization Notes for the list of valid charsets). #26038 * When retrieving all changelists (the "Retrieve all changelists from server" option in Team->Perforce Preferences was set) in the "P4 Submitted Changelists view, it could hang. This has been fixed. #25916 * The plugin would issue an fstat for files outside of the project directory. This has been fixed. #25432 * There were handler conflicts with Eclipse 3.3. This has been fixed. #25400 * In the P4 Depots view, the "Properties" context menu could become inactive. This has been fixed. #25035 * For non-Java projects, if the P4 Pending Changelists view was not open, a null pointer exception could happen when connecting the project to a Perforce server. This has been fixed. #24749 * Label decorations were not displayed in the submit dialog box. This has been fixed. #24107 * #24185 * Plugin could crash on startup after Eclipse was not shutdown properly. This has been fixed. #24092 * When diffing two files and all changes were copied from right to left and then saved, the file was read-only. This has been fixed. #23648 * Sometimes, deleting a file in Eclipse would open it for edit in Perforce. This has been fixed. #22249 * A warning is now given if .p4ignore not writable. #19905 * Can not edit read-only files when a project is "offline". A dialog has been added to allow editing of the file when the project is "offline". #19743 * Key bindings were not working. This has been fixed. #18608 * A subsequent submit could still show a previously submitted file. This has been fixed. New Functionality in 2006.2 #23988 * The plugin works with IBM Rational Application Developer 7. #23177 * In the "P4 Pending Changeslists" view, the default is now off for the "Show Other Clients Changelists" option. This will help performance by preventing the accidental clicking of that view selection. To turn it on, select the menu and check the option. #22903 * The plugin now works with the 2006.2 Perforce server. #20553 * An option to persistently log all Perforce commands has been added to Window->Preferences, Team->Perforce. The commands will be written to the /.metadata/.log file. This is helpful for debugging purposes. #15247 * #18183 * A "Filter by Client" option has been added to the P4 Depots view. To turn this option on, go to the menu (the triangle in the upper right corner of the view) and check the option. Bugs Fixed in 2006.2 P4WSAD Release 2006.2.4136 #23780 * Plugin would not use the default editor when in a Perforce view. This has been fixed. P4WAD Release 2006.2.4134 #23832 * The "Filter by Client Workspace" setting in the P4 Depots view did not work with 2002.x to 2003.x servers. This has been fixed. #23427 * Updated the wording to "Filter by Client Workspace" in the P4 Depots view. #23188 * In certain cases, importing a project may result in a hidden exception and afterwards, the Perforce decorators may not work correctly. This has been fixed. #22536 * A copy / paste incorrectly opened the target file for delete. This has been fixed so that a copy / paste overlays and opens the target file for edit. #22394 * #20371 * Adding a new file did not mark it for add even though the "Open for add" option in the "When adding a new file" preference was selected. This has been fixed. #22381 * #20119 * Refactoring could produce exception errors. These have been fixed. #22048 * A file could not be opened for edit if Perforce label decorations had not been enabled and Perforce views are not opened. This has been fixed. #21906 * Label decorations disappeared for nested projects. This has been fixed. #21806 * Label decorations would stop working for a project that was closed and then opened. This has been fixed. #19963 * Refactoring no longer opened files for add automatically. This has been fixed. #19901 * The Problems view of Eclipse may still show the problem "Local addition not under Perforce control" for the files of a directory which had been added to the .p4ignore file. This has been fixed. #19675 * The label decoration for a project may display the wrong domain name (such as perforce.com instead of public.perforce.com). This has been fixed. New Functionality / Fixes in 2005.2 P4WSAD Release 2005.2.3644 (08/25/2006) #21978 * Added back the ability to set P4CHARSET on the connection dialog for use with a unicode enabled Perforce server (since the 2006.1, the Perforce server now checks for valid utf8 data in files). This will allow P4CHARSET to be set on a per project basis. If no charset is specified by the user, utf8 will be used as the default when connecting to a unicode server. #21909 * Fixed exception for "Rebuild All" in Eclipse 2.0 (WSAD 5.0) #21785 * Fixed support for high ascii characters. #21575 * For certain projects, the connection dialog would not work. Clicking "Finish" would do nothing (though "Cancel" worked). This has been fixed. #21493 * Fixed the issue where refactor results in "can't add filenames with wildcards" error. P4WSAD Release 2005.2.3606 (06/30/2006) #21112 * Fixed problem where renaming a project in IBM Rational Software Architect 6 would cause an exception. #21024 * The plugin works with the Eclipse 3.2 release. #21001 * Fixed problem where label decorations would disappear after a project was closed and then reopened. #20814 * Switching a project from an "OFFLINE" to "ONLINE" state and then selecting "Pending Changelists" would cause an exception. This has been fixed. #20242 * Fixed problem where automatic edit caused an exception if no server had been defined (or it had been removed). P4WSAD Release 2005.2.3573 (02/03/2006) #19850 * The "Disconnect" dialog will now pop up for a project that is connected to a Perforce server that goes down while using the project. #19721 * When an invalid client workspace name is entered in the connection dialog, an error message box is popped up but hitting OK loops back to the error box. This has been fixed and hitting OK will return control to the connection dialog box. #19405 * "Disconnect" no longer disconnects all projects. Only the effected project is disconnected. #19400 * The "Cancel" button on the password dialog doesn't work. This button has been removed and a "Work Offline" button added to the password dialog box. #19392 * Error when directory contains @#% special characters. This has been fixed. #19306 * Properties dialog does not show settings for server clicked. This has been fixed. #19294 * There is now an "Offline" label decorator for any project that is currently working offline. P4WSAD Release 2005.2.3562 (12/08/2005) #19293 * Added a 'Work Online' option to the Team menu. Now this option can be used to attempt to reconnect a project to a Perforce server instead of restarting Eclipse. #18991 * Any failure to connect with the "Team->Share" connection dialog box will now return control to the connection dialog box without doing anything. #18917 * In the "Depots" view, once connectivity was not working, the ability to remove or even add new servers was gone. This has been fixed. #18835 * On Windows, the part of the plugin used to run "p4" commands without popping up a DOS box has been renamed to "p4winexec.exe" (from "win32exec.exe") to avoid a name collision with a known virus. #18332 * Added a preference choice for automatically adding new files, create a marker or neither. #18199 * There was a situation where a conflict with the plugin could crash the J2EE package explorer view. This has been fixed. #17709 * Added a decorator selection for "Indicators for files not synced to head" in the "Team->Perforce->Label Decorations" preference. #17611 * The default changelist description is no longer hardcoded. This will make it compatible with an "out" trigger. #17492 * Submit of a single file was not working. This has been fixed. #17362 * The plugin works with the Eclipse 3.1 release. #17348 * #16869 * If two projects shared a file or used the same share area as a linked resource, the label decorations only showed up in one of the projects. This has been fixed. #17324 * #15563 * The plugin now supports unicode enabled server (defaults to UTF-8). #17291 * Added support for filepaths that contain @#%* characters in compliance with the 2004.2 p4 change. #17018 * Requests for decorator settings for workspace root in IBM Websphere Application Developer 5.1.2 caused plugin to crash. This has been fixed. #16994 * #15035 * Directories can now be added to the .p4ignore file. All files under the specified directory will be excluded from Perforce control. #16739 * Upon submit, the plugin will now prompt to save any changed files. #16595 * #15361 * #15071 * Added a "Check Consistency" option to the Team menu. This function will check the workspace for files not under Perforce control, files that are changed but not open for edit and files that are missing but not open for delete. This will aid when reconnecting after working offline. #16594 * Double clicking on a file that is in a closed project will now pop up a dialog giving the user the option to open the relevant project. #16593 * For Refactor->Move, the plugin will no longer add files that were not under Perforce control. #16540 * For directory browsing, the "*" wildcard was not quoted which caused a slowdown as it was expanded by the OS. This has been fixed. #16277 * #15029 * A changelist select dialog is now provided when a file is automatically open for delete, edit or rename when both "Show changelist selection dialog when opening files for add, edit and delete" and "Enable support for Workbench edit, delete, rename and refactoring operations" Team preferences are enabled. #16117 * p4 delete of class files - derived files were not being properly detected. This has been fixed. #15713 * In the Submit dialog box, the job description is now displayed after the job number for any jobs added to the changelist. #15701 * #15700 * The decorator has been redesigned to speed up performance (memory use is less intensive). #15633 * Diff windows are no longer modal. This will allow users to display more than one diff at a time. #15636 * Added ability to define the path to the "p4" client in the Peforce Team preferences. #15635 * Fixed "Display branching history" option in Revision History view. #15610 * Added a decorator selection for "Indicators for files open in other workspaces" in the "Team->Perforce->Label Decorations" preference. #15474 * Added a selection in Team preferences for retrieving a user defined number or all jobs from the server. An option to "Show more..." is also now available in the jobs view. #15431 * Job filters are now cleared with a "Clear" button (which was renamed from "Delete" to avoid confusion). #15374 * Added support for working offline from the Perforce server. A dialog box with the options of "Work Offline", "Edit Settings", and "Retry" will now pop up if the plugin can not connect to the Perforce server. #15264 * When deleting a file that is open for edit, the edit will now be reverted first before being open for delete. #15195 * Added support for key bindings. #15194 * Added an "Open for Edit Using" option on the context menu in the Pending Changelists view. #15158 * Added a "Move to another changelist..." option on the context menu in the Pending Changelists view. #14521 * A "Sync to Head (Preview only)" selection has been added to the Team menu. #12766 * #12431 * Added a "Submitted Changelists" view. Dragging a directory from a project into this view will show only submitted changelists for that project directory. #12759 * Added a "Decorate files/folders contained in .p4ignore" option on the "Team->Perforce->Label Decorations" preference. New Functionality / Fixes in 2004.2 P4WSAD Release 2004.2.3122 (01/21/05) #16391 * Plugin was no longer compatible with Eclipse 2.0.x or the IBM Websphere Applications that were based on Eclipse 2.0.x. This has been fixed. #15700 * Performanance improvement for label decorations. Operations like "Team>>Refresh" will be much faster, especially for large projects containing thousands of files. P4WSAD Release 2004.2.2485 (10/25/2004) #15683 * Fixed case issue with plugin on Windows. #15480 * Deselecting a file change on the submit form will no longer submit that file change. P4WSAD Release 2004.2.2398 (09/03/2004) #15423 * Added "Delete" button to jobs view so that user can delete filters. #15190 * Added new preference option under Window>>Preferences>>Team>>Perforce called "Open project files for delete when deleting a project". This controls whether or not P4WSAD should open all the project files for delete when a project is deleted from the Workbench. #15193 * Added "Submit" menu option to Pending Changelists files context menu. This allows the user to easily submit a subset of the changelist files Added "Select All" and "Deselect All" buttons to Change Specification dialog. #15158 * Added "Move to another Changelist" menu option to Pending Changelists files context menu. #15158 * Added "Revision History" menu option to Pending Changelists files context menu. #15030 * Fixed bug where Revision History pane would not refresh. P4WSAD Release 2004.2.2368 (08/27/2004) #14997 * The plugin now supports the 2004.2 security features. #14442 * Diff against depot no longer availble for a directory so the user does not have to walk through exccessive dialog boxes. This option still exists with the "Compare With" Eclipse option. #15225 * If at any time P4WSAD cannot connect to the server then a dialog box will pop up asking the user if they want to change the server connection settings. #13291 * P4WSAD no longer requires that the password be saved (SIR# 13291). P4WSAD Release 2004.2.2326 (08/05/2004) #15178 * Fixes an intermittent crash on "open for edit" or "open for delete". #15204 * Small fix in decorator when file is newly added and type is unknown. #15205 * Made the change spec files list bigger. #15206 * P4 Console fonts are now set from Workspace->Fonts preferences. #15161 * Fix for reporting an error with no active window. #15202 * Now use filelog -l to get long descriptions for revision history view. #14839 * Fixed issue of not being able to delete a shared project that has a wrong client associated with it. #14533 * Fixes issue where certain entries in the .project can keep the project from connecting to Perforce with no error message. P4WSAD Release 2004.2.2225 (07/16/2004) #14130 * The plugin works with the Eclipse 3.0 release. #12471 * Added a "Recover Deleted File" menu item on the context menu in the P4 Depots view. # 12868 * Deleting an entire project and underlying directories now puts all the files for delete in the default changelist. #13571 * Deleted files are no longer displayed when "Show deleted files" is not checked in the P4 Depots view. #14178 * Erroneous "info" tasks no longer appear when using "import as project" or renaming a file. #12483 * Identical diffs now display a dialog instead of an empty diff. #12663 * #14402 * Menu options are now correlated to the status of the file, with the non-applicable options grayed out. #12675 * Syncing a project or directory now also syncs any newly added files. #12763 * The plugin now supports the "Compare with" and "Replace with" menu items. #13292 * Incorrect passwords no longer create entries in the "recent connections" drop down box. #13570 * In the "P4 Depots" view, a file can now be opened in the default editor by double-clicking it, provided it is in a project. #13572 * A refresh in the "P4 Depots" view no longer collapses the tree. #13573 * A "lock" option has been added to the Team menu (Bug #13573). #14138 * Filespecs on p4 commands are grouped as much as possible to improve performance. #14244 * An error message is now returned when importing a project in the P4 Depots view if there is no .project file available. #14339 * #14364 * Supports the standard Eclipse comparison extensions. #14244 * The "Import as Project" no longer returns a "File(s) not on client" message. #14845 * Supports linked resources. However, the linked resources must be mapped in the Perforce client's view. Also, delete, move, rename, and refactor of linked resources are not supported, in accordance with the Eclipse documentation. #14401 * The Perforce Perspective now includes a Jobs View that shows Perforce jobs. The jobs can be filtered. The submit form also allows jobs to be attached to the changelist submission. New Functionality / Fixes in 2003.2 P4WSAD Release 2003.2.1802 (02/24/2004) #12470 * New P4 Depot View that enables browsing multiple Perforce servers, as well as providing the ability to import specific depot folders as projects. #11894 * Connection settings must now explicitly be entered. #11574 * Refactoring is now fully supported. #11883 * #11884 * Perforce Menu selections, dialogs and icons have been updated. #13028 * A Revert All option has been added to the context menu for a pending changelist to allow all files in the changelist to be reverted at once. #11480 * Open for Add or Edit is now allowed for an entire Project. #11894 * An error dialog is now shown for any failed Perforce server connections. #13031 * Other users' pending changelists would become unexpandable when expanding the current user's changelists. #13289 * Lock icon does not show in pending changes page on file marked for add. #13290 * An error dialog is now shown for an incorrect password. #13293 * Newlines no longer mangled in multi-line changelist descriptions.