File: http://svn.ist-palcom.org/svn/palcom/doc/setup/Eclipse-SVN.txt

1. Eclipse SVN Plugin
---------------------

To use SVN from within Eclipse you have to manually install a plugin
for this.

The suggested plugin is found at

    http://subclipse.tigris.org/

To install it, inside Eclipse do this:

   a. Select Help->Software updates->Find and install
      (meaning: In menu "Help", select item "Software updates", and select
      submenu item "Find and install")

   b. Choose "Search for new features to install"

   c. Press "New Remote Site"

   d. Enter URL http://subclipse.tigris.org/update_1.2.x, press OK

   e. Make sure "Subclipse" is checked. Press "Finish"
      
   f. When "Select the features to install" appears, click the + and 
      select Subclipse. Press "Next".

   g. Accept the license and press "Finish". Eclipse will suggest
      restarting.


2. Eclipse SVN and Command line svn
-----------------------------------

Unlike the CVS plugin, there should not be any problems switching
between Eclipse and command line, since both use the HTTP protocol to
access the repository.

3. Checking out "palcom" and importing Eclipse Projects.
--------------------------------------------------------

The SVN file structure of the PalCom toolbox does not follow the
(flat) directory structure preferred by Eclipse projects.
For this reason, you need to perform a few extra steps to establish
the Eclipse projects contained within the SVN Repository.

We here describe some alternative ways to do this.

2.1.  Checking out "palcom" and importing

There are (at least) two ways to check out the full source tree.
These alternatives are described in 3.1.1 and 3.1.2.  After having
done one of these, you continue with the import described in 3.1.3,
after which you should check your settings as described in
Eclipse-build.txt.

3.1.1 Checking out "palcom" with command line

      You can start by checking out the full main trunk of "palcom"
      using command line svn as described in Palcom-SVN.txt.
      Then go directly to 3.1.3 below.

3.1.2 Checking out "palcom" from within Eclipse

      If you do not have (or do not wish to use) a command line
      svn, you can use Eclipse to check out "palcom".
      However, since Eclipse insists on everything being organized
      as projects, and due to a bug in Eclipse (on some platforms)
      this is somewhat cumbersome. Here we go:

      A. First change your workspace to something else:

         File->Switch Workspace...

         If you do not have an existing workspace you do want
         to "pollute", simply use the Browse button to select a new
         location for this (somewhat temporary) workspace.
         [This step is necessary due to a bug in Eclipse (3.1.2) on
         at least Windows and linux: Eclipse will complain about 
         "Overlapping workspaces" if you try to import projects as
         described in 3.1.3 in the same workspace] 

      B. Set up the SVN Repository location.

         Change Perspective to the SVN Repository Exploring
	 perspective (normally a button/menu in the upper right corner
	 of the Eclipse window, showing "Java", "Resource" or some
	 other current Perspective).
         Right click in the empty part the left pane "SVN Repository",
	 and select
           New->Repository Location...
         Specify the URL 
           http://svn.ist-palcom.org/svn/palcom/trunk
         The plugin will ask for your SVN username and password. If
         you are a registered PalCom developer, use your assigned
         username and password. Otherwise, enter username "anon" and
         password "anon" for read-only access (without commit rights).
      
      C. Now right-click on this new location in the left pane and choose
         "Checkout" from the menu. Name the project "palcom".
         If you switch to the Resource view, you will see a
         "project" called "palcom" in this temporary workspace.

      D. Finally switch your workspace back to the workspace you
         want to import the Eclipse project into, and go to section
         1.1.3, here you should of course the use the other
         "temporary" workspace location to import from.

      E. After importing the projects, you can actually delete the
         checkout in the "temporary" workspace (but choose NOT to
         delete contents on disk!), but we recommend keeping it for
         easy update of the full source tree from within Eclipse.

      Now continue with 3.1.3.

2.1.3 Importing Eclipse projects from a full "palcom" checkout

      You should first have checked out the full SVN tree using one
      of the methods described in 3.1.1 or 3.1.2.

      In Eclipse open 

      File->Import...->Existing Projects Into Workspace

      Using the Browse button you navigate to the "developer"
      directory in your "palcom" checkout. Then make sure the
      correct projects are found and checked on the list presented,
      and press Finish. It is safe to import all the listed
      projects. After the import, automatic builders will be
      triggered for some projects. When they have finished, some
      errors will remain. Please see Eclipse-build.txt for
      information about how to perform the final build step
      manually.