Changes between Version 1 and Version 2 of InstallTraleSLD


Ignore:
Timestamp:
Nov 10, 2010, 12:37:42 AM (8 years ago)
Author:
ke
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallTraleSLD

    v1 v2  
    171171}}}
    172172
    173 TO BE CONTINUED
     173== Obtaining TRALE ==
     174
     175Current versions of [http://www.ale.cs.toronto.edu/docs/ TRALE] contain Kahina as well as the Prolog code to connect [http://www.ale.cs.toronto.edu/docs/man/ale_trale_man/ale_trale_man-node70.html TRALE's source-level debugger] to Kahina. If you have access to TRALE's Subversion repository, you can obtain the latest version from there. Otherwise, ask for an archive and unpack it.
     176
     177== Using TRALE with the distributed version of Kahina ==
     178
     179Assuming a Unix-like environment (counting Cygwin on Windows), you start TRALE by running the {{{trale}}} script found in the {{{trale}}} directory of the TRALE distribution. Before running it, make sure that the environment variable {{{TRALE_HOME}}} is not set or set to the path {{{trale}}} directory that contains the up-to-date version you wish to use. To use TRALE's source-level debugger with Kahina, you need to run {{{trale}}} with the option {{{-d}}}, like this:
     180
     181{{{
     182trale -d
     183}}}
     184
     185== Using TRALE with a development version of Kahina ==
     186
     187To always use the latest and greatest version of Kahina and use new features as soon as they are added, you need a [http://subversion.tigris.org/ Subversion] client and [http://ant.apache.org Ant] installed. Use the following command to obtain a development version of Kahina:
     188
     189{{{
     190svn checkout http://kahina.org/svn/kahina/trunk kahina
     191cd kahina
     192ant
     193}}}
     194
     195This will create a directory called {{{kahina}}} in the current directory, containing the Kahina sources, and compile them.
     196
     197Every time you want to update Kahina to the latest version, run the following from the {{{kahina}}} directory.
     198
     199{{{
     200svn update
     201ant
     202}}}
     203
     204To tell TRALE to use the development version, start it with the environment variable {{{KAHINA_TRUNK}}} set to point to the {{{kahina}}} directory, e.g. like this:
     205
     206{{{
     207export KAHINA_TRUNK=/home/ke/workspace/kahina
     208trale -d
     209}}}
     210
     211If you always want to work with the development version, you can include the first line in your shell's startup script. To use the version distributed with TRALE again, just unset {{{KAHINA_TRUNK}}}, like this:
     212
     213{{{
     214unset KAHINA_TRUNK
     215}}}
     216
     217== First steps ==
     218
     219After starting TRALE using {{{trale -d}}}, you can try if it works by using the predicates {{{dcompile_gram/1}}} to compile a TRALE grammar and {{{drec/1}}} to parse a sentence, or (experimentally) {{{dquery/1}}} to resolve a query in the ALE programming language. Each of these commands should bring up the Kahina GUI (you can read more about their function and usage [http://ale.cs.toronto.edu/docs/man/ale_trale_man/ale_trale_man-node70.html in the TRALE documentation]. Alternatively, you can just ask the following query:
     220
     221{{{
     222dgo.
     223}}}
     224
     225This will start the GUI but make the Prolog prompt inaccessible, in return giving you the possibility to starting compilation processes and parsing via the '''Parse''' menu in the GUI. Closing the GUI will return you to the Prolog prompt. You can do this at any time while debugging, resulting in the abortion of the compilation/parsing/query resulution process.