Svelte/HOWTOINSTALLSOURCE.txt

   1 HOWTO DOWNLOAD ECLIPSE THIN SLICER SOURCE CODE
   2
   3 WINDOWS:
   4 1. Download and install git from
   5 http://code.google.com/p/msysgit/downloads/list
   6 (Git-1.5.5-preview20080413.exe is fine)
   7 Git is a powerful distributed version control system used to keep the slicer source code.
   8
   9 WARNING: If you download git-1.5.5 or later, the autocrlf option, which
  10 converts between Windows and UNIX newlines, will be on by default. This
  11 causes problems with the WALA and slicer repositories and it will look
  12 like you have modified files when you have not, which may result in
  13 merge errors. If you are using git-1.5.5 or later, open Git Bash and
  14 type the following command to disable the autocrlf option:
  15
  16 git config --global core.autocrlf false
  17
  18 You only have to do this once.
  19
  20 2. Get WALA, WALA incubator, and Eclipse Thin Slicer source code via git
  21 Open Git Gui, click "Clone Existing Repository". For URL, type:
  22 git://repo.or.cz/wala.git
  23 For directory, choose a new empty directory to hold the WALA source code.
  24 I reccommend having a directory such as "git" and then subdirectories for
  25 wala, walaincubator, and eclipsethinslicer.
  26
  27 Clone the repository, and then repeat the process for the following two
  28 repositories:
  29 git://repo.or.cz/walaincubator.git
  30 git://repo.or.cz/eclipsethinslicer.git
  31
  32 If you prefer, you can also accomplish this step with the command "git
  33 clone git://repo.or.cz/wala.git" etc. from the Git Bash command shell.
  34
  35 3. Create/switch branches (actually merge this step with download)
  36 In Git-GUI open with the "wala" repository, create a remote tracking
  37 branch by doing the following:
  38 a. go to Branch -> Create
  39 b. choose "Match Tracking Branch Name" under Branch Name
  40 c. choose v1.1.2-jdt and click Create.
  41 d. go to Branch -> Checkout and checkout the branch you created.
  42
  43 This is a version of WALA, branched off from v1.1.2, with a JDT WALA
  44 backend. You can repeat this to make more local branches for v1.1.2,
  45 v1.1.2-LOCALBUGFIXES (WALA v1.1.2 with additional bugfixes), if you wish
  46 to look at / work with these versions.
  47
  48 In Git-GUI open with the "walaincubator" repository, and create a remote
  49 tracking branch as above for branch v1.1.2. Then check it out too.
  50
  51 You do not have to do this with the slicer, the default branch (master) is
  52 what you want.
  53
  54 Remote tracking branches can also be created with the following command
  55 from the Git Bash command line:
  56 git-branch --track v1.1.2 origin/v1.1.2
  57
  58 4. As described the WALA Getting Started Guide
  59 (http://wala.sourceforge.net/wiki/index.php/UserGuide:Getting_Started),
  60 install the following in the wala repository directory:
  61 * in com.ibm.wala.cast.java/lib:
  62 polyglot.jar
  63 java_cup.jar
  64
  65 * in com.ibm.wala.cast.js/lib:
  66 js.jar
  67 xalan.jar
  68
  69 5. Launch Eclipse and create a new fresh workspace. Go to File -> Import.
  70 Under General, choose "Existing Projects into Workspace". Find the
  71 directory that contains you used git to download the Eclipse Thin Slicer
  72 into -- i.e. the directory which contains "Svelte" and choose this, and
  73 then import the Svelte project. Repeat for "wala" and "walaincubator".
  74 From "wala", you need everything but com.ibm.wala.j2ee. From
  75 "walaincubator", you just need com.ibm.wala.eclipse and
  76 com.ibm.wala.eclipse.tests
  77
  78 6. Debug or run the projects using the "wala.eclipse" launcher. In the new
  79 workspace you should be ready to use the slicer. Try opening a java file,
  80 selecting some text, and hitting the "CI" button.
  81