examples/README

   1 #
   2 #  /**-------------------------------------------------------------------**
   3 #   **                              CLooG                                **
   4 #   **-------------------------------------------------------------------**
   5 #   **                       Library use examples                        **
   6 #   **-------------------------------------------------------------------**
   7 #   **             First version of this file: july 15th 2003            **
   8 #   **-------------------------------------------------------------------**/
   9 #
  10
  11
  12 In this directory are presented various examples of how to use the CLooG
  13 library. For each case, you will need to edit the makefile file according to
  14 your system, in particular you will have to set where your CLooG library has
  15 been installed, and where are the CLooG header files. Don't forget to update
  16 your LD_LIBRARY_PATH environment variable to reach the CLooG library. If you
  17 performed the default installation of CLooG, the library is in /usr/local/lib
  18 thus you need to set LD_LIBRARY_PATH thanks to one of the following command:
  19 'setenv LD_LIBRARY_PATH /usr/local/lib' for tcsh-like shells, or
  20 'export LD_LIBRARY_PATH=/usr/local/lib' for bash-like shells.
  21
  22 For any problem: <cloog-development@googlegroups.com>.
  23
  24
  25 #   **-------------------------------------------------------------------**
  26 #   **                          I. example                               **
  27 #   **-------------------------------------------------------------------**/
  28
  29
  30 This directory includes two basic examples:
  31 - The first example program creates a simple CLooG-like loop generation
  32 program in a few lines. The input problem has to be given on standard input.
  33 Users can test it for instance by typing 'more FILE.cloog | ./example' (or
  34 example.exe under Cygwin) after compilation.
  35 - The second example shows how to build a CLooG input from isl sets,
  36 generate the scanning code AST and pretty-printing it to the standard
  37 output. Users can test it by typing './example-isl' (or example-isl.exe
  38 under Cygwin) after compilation.
  39
  40
  41 #   **-------------------------------------------------------------------**
  42 #   **                       II. cloog2loopgen                           **
  43 #   **-------------------------------------------------------------------**/
  44
  45 NO MORE EXISTS !
  46
  47 This example creates a program converting a CLooG input file to a LoopGen input
  48 file. This can be useful to compare the two tools (I do not support LoopGen,
  49 don't ask me if you find some bugs !). The usage of the created tool is:
  50 'cloog2loopgen input_file output_file'.
  51
  52
  53 #   **-------------------------------------------------------------------**
  54 #   **                       III. cloog2Omega                            **
  55 #   **-------------------------------------------------------------------**/
  56
  57
  58 NO MORE EXISTS !
  59
  60 This example creates a program converting a CLooG input file to an Omega
  61 CodeGen input file. This can be useful to compare the two tools (I do not
  62 support CodeGen, don't ask me if you find some bugs !). The usage of the
  63 created tool is: 'cloog2omega input_file output_file'.