Tool Mentor: EPF Composer Support for CVS

Initial Setup

EPF provides out-of-box support for CVS (Code Versioning System) so no additional software extensions are needed. Use the following instructions to configure CVS integration with EPF:

   1. Use the Window menu at the top of the EPF window and select Preferences.... The "Preferences" configuration window will appear.
   2. Expand the tree menu for Team in the left-hand side of the Preferences window then expand the submenu for CVS.
   3. Click on Watch/Edit. The Watch/Edit check boxes should be set as follows:
         1. Settings for CVS Watch/Edit: Check Configure projects to use Watch/Edit on checkout.
         2. When read-only files are modified in an editor: Check Send a CVS edit notification to the server.
         3. Before a CVS edit notification is sent to the server: Check Always prompt.
         4. Update edited files: Check Prompt to update if out of date.
   4. Click OK.
   5. Switch perspective to CVS Repository Exploring. This perspective shows files on the CVS server.
   6. Right-click in the blank window area.
   7. Select the New repository location. The "Add a new CVS Repository" dialog box appears.
   8. Enter settings supplied by CVS system administrator. These settings should include the following:
          * Host
          * Repository path
          * User
          * Password
          * Connection type

Now the snapshot view can be populated.

   1. Switch to the CVS Repository Exploring perspective.
   2. Go to the HEAD or Branch nodes.
   3. Right-click and select Check out to check out the desired library.
   4. By default the library is checked out in the EPF workspace.

Editing a Method Element

   1. Make sure the Authoring perspective is being used. Elements can only be edited from within this perspective.
   2. Use the tree-browser to find library element you want to edit.
   3. Double click on the element name to bring its contents into Editor window.
   4. As soon as changes are made to an element a "*" will appear on the tab at the top of the Editor window next to teh name of the element.
   5. Use the File menu then select Save to save changes. The "*" symbol will disappear indicating the local filesystem has been updated with the version currently cached in memory.
   6. When prompted to send a CVS notification answer Yes.
   7. If the file is currently being edited by another user a dialog box will appear with the option to continue or not. Answer No or else the files will have to be merged later. Switch to the Resources perspective. In this perspective files that have been modified and need to be checked-in are marked with a ">" symbol.
      Right-click to bring up Team menu, then Commit.

Note: Users should either check-in all files or else don't check-in any of them.
Adding a Method Element

   1. Make sure the Authoring perspective is being used. New elements can only be added from within this perspective.
   2. Use tree browser to locate the area where the new element will be added.
   3. Right-click on the parent element. A submenu will appear.
   4. Select Add new plugin....
   5. Enter content for the new element in the Editor window. A "*" symbol will appear next to the name of the new element in the tab at the top of the Editor wndow. This indicates the version cached in memory is out-of-synch with the local filesystem.
   6. After entering content for the new element use File menu and select Save. The "*" symbol will disappear indicating that the copy in the local filesystem has been updated with the verison cached in memory.
   7. Switch to the Team Synchronizing perspective.
   8. The new element should be listed there along with any dependent files. The dependent files may include plugin.xmi. Make sure this file is also updated.
   9. Richt-click on the element to be added and select Commit....

Deleting a Method Element

   1. Make sure the Authoring perspective is being used. Elements can only be deleted from within this perspective.
   2. Locate the element you wish to delete in the tree browser.
   3. Right-click on the name of the element and select Delete from the submenu.
   4. Use the File menu at the top of the EPF window and select Save.
   5. Switch to Team Synchronizing perspective. 1 or more files will be listed there. Look for a special icon next to files marked for deletion.
   6. Right-click on the file to be deleted and select Commit.... The file should disappear from the list on the right.