setlX v2.2.3

“Computers make very fast, very accurate mistakes.”

Overview

This is the quick installation guide for setlX, an interpreter for the very high level programming-language SetlX (set language extended). Its official homepage is setlX.randoom.org.

Installing setlX on a Unix-like OS (Linux, MacOS X, etc.)

  1. Make sure that a Java runtime, which is compatible to Java version 1.6 (aka version 6) or higher, is installed and working.
    You can verify this by executing:

       java -version

    inside a terminal (-emulator).
  2. Download setlX_v2-2-3.binary_only.zip.
  3. Unzip the downloaded file into a directory of your choosing.
  4. Copy all ‘setlX*.jar’-files into some folder, which is accessible by all users, who should be able to execute setlX (e.g. ‘/usr/local/setlX/’).
    You may also copy it into the home directory of some user, when she is the only setlX-user on the system (e.g. ‘/home/<user>/programs/setlX/’).
  5. Open the ‘setlX’-script in your favorite editor (either ‘vi’ or ‘emacs’ of course).
  6. Change the contents of the ‘setlXJarDirectory’-variable to the path where you copied the jar-files, e.g.

       setlXJarDirectory="/usr/local/setlX/"

  7. (Optional)Change the ‘setlXlibraryPath’-variable to the path where setlX should look for library files, e.g.

       setlXlibraryPath="$home/setlXlibrary";

  8. Save and close the file.
  9. Copy the modified ‘setlX’-script into some folder, which is in the search path of all users which should be able to execute setlX (e.g. ‘/usr/local/bin’).
    When only used by one user, you may copy it into the ‘bin’ directory in her home instead (e.g. ‘/home/<user>/bin’).
  10. Make the script executable, e.g.

       chmod +x /usr/local/bin/setlX

Installing setlX on Android

Get it on Google Play

If you can not use the Android Market, or do not want to, you can download the apk directly from setlX.randoom.org.

Installing setlX on Microsoft Windows

  1. Make sure that a Java runtime, which is compatible to Java version 1.6 (aka version 6) or higher, is installed and working.
    You can verify this by executing:

       java -version

    inside a terminal (-emulator).
  2. Download setlX_v2-2-3.binary_only.zip.
  3. Unzip the downloaded file into a directory of your choosing.
  4. Copy all ‘setlX*.jar’-files and the ‘setlX.cmd’ file into some folder, which is accessible by all users, who should be able to execute setlX (e.g. ‘C:\Progam Files\setlX\’).
  5. Open the copied ‘setlX.cmd’-script in your favorite editor.
  6. Change the contents of the ‘setlXJarDirectory’-variable to the path where you copied the jar-files, e.g.

       set setlXJarDirectory=C:\Progam Files\setlX\setlX.jar

  7. (Optional)Change the ‘SETLX_LIBRARY_PATH’-variable and set it to the path where setlX should look for library files, e.g.

       set SETLX_LIBRARY_PATH=C:\Progam Files\setlX\library

  8. Save and close the file.
  9. Add the folder where you placed the files into to the search-path (requires Administrator privileges):
    1. Press [Win]+[Pause] key combination to open system preferences.
    2. On Windows Vista or newer:
      Click on ‘Advanced system settings’ on the left pane, which opens a new window.

      On Windows XP or older:
      Click the ‘Advanced’ tab in the current window.
    3. Click on ‘Environment Variables’ on the bottom, which opens another window.
    4. Select the ‘Path’ variable in the ‘System variables’ section and click on ‘Edit...’, which opens jet another window.
    5. Do not alter the existing content of the ‘Variable value’ field, but add a semicolon (‘;’), followed by the full path to the folder where you installed setlX, to its very end. Using the previous example path, the new value should look like:

         <previous value>;C:\Progam Files\setlX

    6. Accept all changes by clicking ‘OK’ in all windows you opened before.
    7. End you current session and login into Windows again.

Getting started with setlX

  1. Now you can start the interpreter by executing:

       setlX

    inside a terminal (-emulator).
  2. The interpreter will launch and present you with a prompt, where you may start typing SetlX code.
    One example code-fragment would be:

       for (l in [83,101,116,108,88]) {print(char(l));}

  3. After you are done, you can leave the interpreter by typing:

       exit;

    into the interpreters prompt.
  4. A in depth tutorial explaining all major features of SetlX can be downloaded here.

Executing Files

To execute a file, start the interpreter with the path to the SetlX source file as an argument:

   setlX <path>/<name>.stlx

Bulding setlX from source

If you need or want to inspect the source code of setlX or rebuild the interpreter from scratch, you can download its source:
setlX_v2-2-3.devel.zip

Please read the included ‘manual.pdf’ for further instructions.