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: <cedric.bastoul@inria.fr>.
  23
  24
  25 #   **-------------------------------------------------------------------**
  26 #   **                          I. Example                               **
  27 #   **-------------------------------------------------------------------**/
  28
  29
  30 This example program creates a simple CLooG-like loop generation program in a
  31 few lines. The input problem has to be given on standard input. We can test it
  32 for instance by typing 'more FILE.cloog | ./example' (or example.exe under
  33 Cygwin).
  34
  35
  36 #   **-------------------------------------------------------------------**
  37 #   **                       II. cloog2loopgen                           **
  38 #   **-------------------------------------------------------------------**/
  39
  40 NO MORE EXISTS !
  41
  42 This example creates a program converting a CLooG input file to a LoopGen input
  43 file. This can be useful to compare the two tools (I do not support LoopGen,
  44 don't ask me if you find some bugs !). The usage of the created tool is:
  45 'cloog2loopgen input_file output_file'.
  46
  47
  48 #   **-------------------------------------------------------------------**
  49 #   **                       III. cloog2Omega                            **
  50 #   **-------------------------------------------------------------------**/
  51
  52
  53 NO MORE EXISTS !
  54
  55 This example creates a program converting a CLooG input file to an Omega
  56 CodeGen input file. This can be useful to compare the two tools (I do not
  57 support CodeGen, don't ask me if you find some bugs !). The usage of the
  58 created tool is: 'cloog2omega input_file output_file'.