| 1 | 1 |
Installation Instructions |
| 2 | 2 |
========================= |
| 3 | 3 |
|
| 4 | 4 |
Since you are reading this I assume you already obtained one of the release |
| 5 | 5 |
tarballs and successfully extracted it. The latest version of LEMON is |
| 6 | 6 |
available at our web page (http://lemon.cs.elte.hu/). |
| 7 | 7 |
|
| 8 |
LEMON provides two different build environments, one is based on "autotool", |
|
| 9 |
while the other is based on "cmake". This file contains instructions only for |
|
| 10 |
the former one, which is the recommended build environment on Linux, Mac OSX |
|
| 11 |
and other unices or if you use Cygwin on Windows. For cmake installation |
|
| 12 |
instructions visit http://lemon.cs.elte.hu. |
|
| 13 |
|
|
| 8 | 14 |
In order to install LEMON from the extracted source tarball you have to |
| 9 | 15 |
issue the following commands: |
| 10 | 16 |
|
| 11 | 17 |
1. `cd lemon-x.y.z' |
| 12 | 18 |
|
| 13 | 19 |
This command changes to the directory which was created when you |
| 14 | 20 |
extracted the sources. The x.y.z part is a version number. |
| 15 | 21 |
|
| 16 | 22 |
2. `./configure' |
| 17 | 23 |
|
| 18 | 24 |
This command runs the configure shell script, which does some checks and |
| 19 | 25 |
creates the makefiles. |
| 20 | 26 |
|
| 21 | 27 |
3. `make' |
| 22 | 28 |
|
| 23 | 29 |
This command compiles the non-template part of LEMON into libemon.a |
| 24 | 30 |
file. It also compiles the programs in the tools and demo subdirectories |
| 25 | 31 |
when enabled. |
| 26 | 32 |
|
| 27 | 33 |
4. `make check' |
| 28 | 34 |
|
| 29 | 35 |
This step is optional, but recommended. It runs the test programs that |
| 30 | 36 |
we developed for LEMON to check whether the library works properly on |
| 31 | 37 |
your platform. |
| 32 | 38 |
|
| 33 | 39 |
5. `make install' |
| 34 | 40 |
|
| 35 | 41 |
This command installs LEMON under /usr/local (you will need root |
| 36 | 42 |
privileges to be able to do that). If you want to install it to some |
| 37 | 43 |
other location, then pass the --prefix=DIRECTORY flag to configure in |
| 38 | 44 |
step 2. For example: `./configure --prefix=/home/username/lemon'. |
| 39 | 45 |
|
| 40 | 46 |
6. `make install-html' |
| 41 | 47 |
|
| 42 | 48 |
This command installs the documentation under share/doc/lemon/docs. The |
| 43 | 49 |
generated documentation is included in the tarball. If you want to |
| 44 | 50 |
generate it yourself, then run `make html'. Note that for this you need |
| 45 | 51 |
to have the following programs installed: Doxygen, Graphviz, Ghostscript, |
| 46 | 52 |
Latex. |
| 47 | 53 |
|
| 48 | 54 |
|
| 49 | 55 |
Configure Options and Variables |
| 50 | 56 |
=============================== |
| 51 | 57 |
|
| 52 | 58 |
In step 2 you can customize the actions of configure by setting variables |
| 53 | 59 |
and passing options to it. This can be done like this: |
| 54 | 60 |
`./configure [OPTION]... [VARIABLE=VALUE]...' |
| 55 | 61 |
|
| 56 | 62 |
Below you will find some useful variables and options (see `./configure --help' |
| 57 | 63 |
for more): |
| 58 | 64 |
|
| 59 | 65 |
CXX='comp' |
| 60 | 66 |
|
| 61 | 67 |
Change the C++ compiler to 'comp'. |
| 62 | 68 |
|
| 63 | 69 |
CXXFLAGS='flags' |
| 64 | 70 |
|
| 65 | 71 |
Pass the 'flags' to the compiler. For example CXXFLAGS='-O3 -march=pentium-m' |
| 66 | 72 |
turns on generation of aggressively optimized Pentium-M specific code. |
| 67 | 73 |
|
| 68 | 74 |
--prefix=PREFIX |
| 69 | 75 |
|
| 70 | 76 |
Set the installation prefix to PREFIX. By default it is /usr/local. |
| 71 | 77 |
|
| 72 | 78 |
--enable-demo |
| 73 | 79 |
|
| 74 | 80 |
Build the examples in the demo subdirectory. |
| 75 | 81 |
|
| 76 | 82 |
--disable-demo |
| 77 | 83 |
|
| 78 | 84 |
Do not build the examples in the demo subdirectory (default). |
| 79 | 85 |
|
| 80 | 86 |
--enable-tools |
| 81 | 87 |
|
| 82 | 88 |
Build the programs in the tools subdirectory (default). |
| 83 | 89 |
|
| 84 | 90 |
--disable-tools |
| 85 | 91 |
|
| 86 | 92 |
Do not build the programs in the tools subdirectory. |
| 87 | 93 |
|
| 88 | 94 |
--with-glpk[=PREFIX] |
| 89 | 95 |
|
| 90 | 96 |
Enable GLPK support (default). You should specify the prefix too if |
| 91 | 97 |
you installed GLPK to some non-standard location (e.g. your home |
| 92 | 98 |
directory). If it is not found, GLPK support will be disabled. |
| 93 | 99 |
|
| 94 | 100 |
--with-glpk-includedir=DIR |
| 95 | 101 |
|
| 96 | 102 |
The directory where the GLPK header files are located. This is only |
| 97 | 103 |
useful when the GLPK headers and libraries are not under the same |
| 98 | 104 |
prefix (which is unlikely). |
| 99 | 105 |
|
| 100 | 106 |
--with-glpk-libdir=DIR |
| 101 | 107 |
|
| 102 | 108 |
The directory where the GLPK libraries are located. This is only |
| 103 | 109 |
useful when the GLPK headers and libraries are not under the same |
0 comments (0 inline)