Svelte/HOWTOINSTALLSOURCE-GITBASH.txt

   1 HOWTO DOWNLOAD ECLIPSE THIN SLICER SOURCE CODE USING GIT BASH
   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 Make a new directory to hold your cloned git repositories. Within git
  22 bash, cd to this directory and type the following commands:
  23
  24 git clone git://repo.or.cz/wala.git
  25 git clone git://repo.or.cz/walaincubator.git
  26 git clone git://repo.or.cz/eclipsethinslicer.git
  27
  28 This will create three directories (wala, walaincubator, and
  29 eclipsethinslicer) with the WALA and slicer source. However, wala and
  30 walaincubator are by default on the "master" branch, which contains
  31 direct code from WALA SVN trunk. To use the slicer, you will have to
  32 switch branches to use the slicer-specific WALA versions.
  33
  34 3. Create/switch branches
  35 In the wala directory, run the following commands:
  36
  37 git branch --track v1.1.2 origin/v1.1.2-jdt
  38 git checkout v1.1.2-jdt
  39
  40 This is a version of WALA, branched off from v1.1.2, with a JDT WALA
  41 backend. You can repeat this to make more local branches for v1.1.2,
  42 v1.1.2-LOCALBUGFIXES (WALA v1.1.2 with additional bugfixes), if you wish
  43 to look at / work with these versions, but v1.1.2-jdt is the branch that
  44 the slicer currently uses.
  45
  46 In the walaincubator directory, run the following commands:
  47
  48 git branch --track v1.1.2 origin/v1.1.2
  49 git checkout v1.1.2
  50
  51 This is the version of walaincubator closest to WALA v1.1.2, and is
  52 currently required by the slicer. The "git branch" command makes a local
  53 branch to follow "track" the remote branch, and the second command
  54 checks out this local branch to the local working directory .
  55
  56 You do not have to do this with the eclipsethinslicer repository, as the
  57 default branch (master) is what you want.
  58
  59 4. As described the WALA Getting Started Guide
  60 (http://wala.sourceforge.net/wiki/index.php/UserGuide:Getting_Started),
  61 install the following in the wala repository directory:
  62 * in com.ibm.wala.cast.java/lib:
  63 polyglot.jar
  64 java_cup.jar
  65
  66 * in com.ibm.wala.cast.js/lib:
  67 js.jar
  68 xalan.jar
  69
  70 5. Launch Eclipse and create a new fresh workspace. Go to File -> Import.
  71 Under General, choose "Existing Projects into Workspace". Find the
  72 directory that contains you used git to download the Eclipse Thin Slicer
  73 into -- i.e. the directory which contains "Svelte" and choose this, and
  74 then import the Svelte project. Repeat for "wala" and "walaincubator".
  75 From "wala", you need everything but com.ibm.wala.j2ee. From
  76 "walaincubator", you just need com.ibm.wala.eclipse and
  77 com.ibm.wala.eclipse.tests
  78
  79 6. Debug or run the projects using the "wala.eclipse" launcher. In the new
  80 workspace you should be ready to use the slicer. Try opening a java file,
  81 selecting some text, and hitting the "CI" button.