INSTALL
author Alpar Juttner <alpar@cs.elte.hu>
Sun, 13 Jul 2008 16:46:56 +0100
changeset 208 4317d277ba21
child 245 da1d220b176b
permissions -rw-r--r--
Better source unifier

- now it is called scripts/unify-sources.sh
- replaces each tab with 8 spaces
- remove trailing spaces (and tabs)
- warnings on long lines (i.e. on lines that are more than 80 characters)
- the standard file header now turns off the space-to-tab replacement in Emacs
alpar@5
     1
Installation Instructions
alpar@5
     2
=========================
alpar@5
     3
alpar@5
     4
   Since you are reading this I assume you already obtained one of the release
alpar@5
     5
tarballs and successfully extracted it. The latest version of LEMON is
alpar@5
     6
available at our webpage (http://lemon.cs.elte.hu/).
alpar@5
     7
alpar@5
     8
   In order to install LEMON from the extracted source tarball you have to
alpar@5
     9
issue the following commands:
alpar@5
    10
alpar@5
    11
  1. `cd lemon-x.y.z'
alpar@5
    12
alpar@5
    13
     This changes to the directory which was created when you extracted the
alpar@5
    14
     sources. The x.y.z part is a version number.
alpar@5
    15
alpar@5
    16
  2. `./configure'
alpar@5
    17
alpar@5
    18
     This runs the configure shell script, which does some checks and
alpar@5
    19
     configuration (creates makefiles etc).
alpar@5
    20
alpar@5
    21
  3. `make'
alpar@5
    22
alpar@5
    23
     This command compiles the non-template part of LEMON into libemon.a file.
alpar@5
    24
     It also compiles the benchmark and demo programs when enabled.
alpar@5
    25
alpar@5
    26
  4. `make check'
alpar@5
    27
alpar@5
    28
     This step is optional, but recommended. It runs the test programs that we
alpar@5
    29
     developed for LEMON to check whether the library works properly on your
alpar@5
    30
     platform.
alpar@5
    31
alpar@5
    32
  5. `make install'
alpar@5
    33
alpar@5
    34
     This command installs LEMON under /usr/local (you will need root
alpar@5
    35
     privileges to be able to do that). If you want to install it to some
alpar@5
    36
     other location, then pass the --prefix=DIRECTORY flag to configure in
alpar@5
    37
     step 1. For example: `./configure --prefix=/home/username/lemon'
alpar@5
    38
alpar@5
    39
alpar@5
    40
Configure Flags
alpar@5
    41
===============
alpar@5
    42
alpar@5
    43
   You can pass the following flags to configure in step 1
alpar@5
    44
(see ./configure --help for more):
alpar@5
    45
alpar@5
    46
CXX=comp
alpar@5
    47
alpar@5
    48
  Change the C++ compiler to 'comp'.
alpar@5
    49
alpar@5
    50
CXXFLAGS='flags'
alpar@5
    51
alpar@5
    52
  Pass the 'flags' to the compiler. For example
alpar@5
    53
  CXXFLAGS='-O3 -march=pentium-m'
alpar@5
    54
  turns  on generation of aggressively optimized
alpar@5
    55
  Pentium-M specific code.
alpar@5
    56
alpar@5
    57
--enable-demo
alpar@5
    58
alpar@5
    59
   Build the demo programs too.
alpar@5
    60
alpar@5
    61
--disable-demo
alpar@5
    62
alpar@5
    63
   Do not build the demo programs (default).
alpar@5
    64
alpar@5
    65
--enable-benchmark
alpar@5
    66
alpar@5
    67
   Build the benchmark programs too.
alpar@5
    68
alpar@5
    69
--disable-benchmark
alpar@5
    70
alpar@5
    71
   Do not build the benchmark programs (default).
alpar@5
    72
alpar@5
    73
--with-glpk[=PREFIX]
alpar@5
    74
alpar@5
    75
   Enable GLPK support (default). You should specify the prefix too if
alpar@5
    76
   you installed GLPK to some non-standard location (e.g. your home
alpar@5
    77
   directory). If it is not found, GLPK support will be disabled.
alpar@5
    78
alpar@5
    79
--with-glpk-includedir=DIR
alpar@5
    80
alpar@5
    81
   The directory where the GLPK header files are located. This is only
alpar@5
    82
   useful when the GLPK headers and libraries are not under the same
alpar@5
    83
   prefix (which is unlikely).
alpar@5
    84
alpar@5
    85
--with-glpk-libdir=DIR
alpar@5
    86
alpar@5
    87
   The directory where the GLPK libraries are located. This is only
alpar@5
    88
   useful when the GLPK headers and libraries are not under the same
alpar@5
    89
   prefix (which is unlikely).
alpar@5
    90
alpar@5
    91
--without-glpk
alpar@5
    92
alpar@5
    93
   Disable GLPK support.
alpar@5
    94
alpar@5
    95
--with-cplex[=PREFIX]
alpar@5
    96
alpar@5
    97
   Enable CPLEX support (default). You should specify the prefix too
alpar@5
    98
   if you installed CPLEX to some non-standard location
alpar@5
    99
   (e.g. /opt/ilog/cplex75). If it is not found, CPLEX support will be
alpar@5
   100
   disabled.
alpar@5
   101
alpar@5
   102
--with-cplex-includedir=DIR
alpar@5
   103
alpar@5
   104
   The directory where the CPLEX header files are located. This is
alpar@5
   105
   only useful when the CPLEX headers and libraries are not under the
alpar@5
   106
   same prefix (e.g.  /usr/local/cplex/cplex75/include).
alpar@5
   107
alpar@5
   108
--with-cplex-libdir=DIR
alpar@5
   109
alpar@5
   110
   The directory where the CPLEX libraries are located. This is only
alpar@5
   111
   useful when the CPLEX headers and libraries are not under the same
alpar@5
   112
   prefix (e.g.
alpar@5
   113
   /usr/local/cplex/cplex75/lib/i86_linux2_glibc2.2_gcc3.0/static_pic_mt).
alpar@5
   114
alpar@5
   115
--without-cplex
alpar@5
   116
alpar@5
   117
   Disable CPLEX support.