# HG changeset patch # User alpar # Date 1152874274 0 # Node ID 582c8c28aa01587bd81af5b89f2861db716233f3 # Parent a683f63b54e23c2a61b3f5451eb9374aec1ed448 Some updates and restructuring diff -r a683f63b54e2 -r 582c8c28aa01 INSTALL --- a/INSTALL Fri Jul 14 10:50:05 2006 +0000 +++ b/INSTALL Fri Jul 14 10:51:14 2006 +0000 @@ -40,65 +40,78 @@ Configure Flags =============== - You can pass the following flags to configure in step 1 (see ./configure ---help for more): + You can pass the following flags to configure in step 1 +(see ./configure --help for more): - --with-glpk[=PREFIX] +CXX=comp - Enable GLPK support (default). You should specify the prefix too if you -installed GLPK to some non-standard location (e.g. your home directory). If it -is not found, GLPK support will be disabled. + Change the C++ compiler to 'comp'. - --with-glpk-includedir=DIR +CXXFLAGS='flags' - The directory where the GLPK header files are located. This is only useful -when the GLPK headers and libraries are not under the same prefix (which is -unlikely). + Pass the 'flags' to the compiler. For example + CXXFLAGS='-O3 -march=pentium-m' + turns on generation of aggressively optimized + Pentium-M specific code. - --with-glpk-libdir=DIR +--enable-demo - The directory where the GLPK libraries are located. This is only useful -when the GLPK headers and libraries are not under the same prefix (which is -unlikely). + Build the demo programs too. - --without-glpk +--disable-demo + + Do not build the demo programs (default). + +--enable-benchmark + + Build the benchmark programs too. + +--disable-benchmark + + Do not build the benchmark programs (default). + +--with-glpk[=PREFIX] + + Enable GLPK support (default). You should specify the prefix too if + you installed GLPK to some non-standard location (e.g. your home + directory). If it is not found, GLPK support will be disabled. + +--with-glpk-includedir=DIR + + The directory where the GLPK header files are located. This is only + useful when the GLPK headers and libraries are not under the same + prefix (which is unlikely). + +--with-glpk-libdir=DIR + + The directory where the GLPK libraries are located. This is only + useful when the GLPK headers and libraries are not under the same + prefix (which is unlikely). + +--without-glpk Disable GLPK support. - --with-cplex[=PREFIX] +--with-cplex[=PREFIX] - Enable CPLEX support (default). You should specify the prefix too if you -installed CPLEX to some non-standard location (e.g. /opt/ilog/cplex75). If it -is not found, CPLEX support will be disabled. + Enable CPLEX support (default). You should specify the prefix too + if you installed CPLEX to some non-standard location + (e.g. /opt/ilog/cplex75). If it is not found, CPLEX support will be + disabled. - --with-cplex-includedir=DIR +--with-cplex-includedir=DIR - The directory where the CPLEX header files are located. This is only useful -when the CPLEX headers and libraries are not under the same prefix (e.g. -/usr/local/cplex/cplex75/include). + The directory where the CPLEX header files are located. This is + only useful when the CPLEX headers and libraries are not under the + same prefix (e.g. /usr/local/cplex/cplex75/include). - --with-cplex-libdir=DIR +--with-cplex-libdir=DIR - The directory where the CPLEX libraries are located. This is only useful -when the CPLEX headers and libraries are not under the same prefix (e.g. -/usr/local/cplex/cplex75/lib/i86_linux2_glibc2.2_gcc3.0/static_pic_mt). + The directory where the CPLEX libraries are located. This is only + useful when the CPLEX headers and libraries are not under the same + prefix (e.g. + /usr/local/cplex/cplex75/lib/i86_linux2_glibc2.2_gcc3.0/static_pic_mt). - --without-cplex +--without-cplex Disable CPLEX support. - - --enable-demo - - Build the demo programs too. - - --disable-demo - - Do not build the demo programs (default). - - --enable-benchmark - - Build the benchmark programs too. - - --disable-benchmark - - Do not build the benchmark programs (default). diff -r a683f63b54e2 -r 582c8c28aa01 README --- a/README Fri Jul 14 10:50:05 2006 +0000 +++ b/README Fri Jul 14 10:51:14 2006 +0000 @@ -1,36 +1,60 @@ -LEMON +------------------------------------------------------------------ +LEMON - a Library of Efficient Models and Optimization in Networks +------------------------------------------------------------------ -Library of Efficient Models and Optimization in Networks +LEMON is the abbreviation of Library of Efficient Models and +Optimization in Networks. It is an open source library written in +C++. It provides a set of easy-to-use implementation of common data +structures and algorithms in the area of optimization and helps +implementing new ones. It is an especially suitable tool to solve the +design and optimization problems of telecommunications networks. To +achieve wide usability, a fundamental design requirement is the +genericity of interface of data structures and algorithms. Lemon is +intended to become an open source library in order to involve people +all around the world in its development. -LEMON is the abbreviation of Library of Efficient Models -and Optimization in Networks. It is an open source -library written in C++. It provides a set of easy-to-use -implementation of common data structures and algorithms -in the area of optimization and helps implementing new -ones. It is an especially suitable tool to solve the -design and optimization problems of telecommunications -networks. To achieve wide usability, a fundamental design -requirement is the genericity of interface of data -structures and algorithms. Lemon is intended to become an -open source library in order to involve people all around -the world in its development. +-------- +Contents +-------- -The subdirectories 'autopackage', 'build-aux' and 'm4' are -needed by installation. In subdirectory 'benchmark' -programs can be found that observe the performance of LEMON. -Subdirectory 'demo' contains some demonstration programs to -make you easier to getting familiar with LEMON. Documentation -of LEMON can be found in subdirectory 'doc'. Source code of -LEMON is in subdirectory 'lemon'. Some useful scripts related -to the usage of LEMON can be found in subdirectory 'scripts'. -In subdirectory 'test' you can find some programs, proofing -you the correctness of some implementations. +COPYING, LICENSE -See file COPYING for copying, distribution and modification -conditions and terms. + Copying, distribution and modification conditions and terms. -For general building and installation instructions, see the -file INSTALL. +INSTALL -Version number of the package is the highest one written in -file NEWS. + For general building and installation instructions, see the file + +lemon/ + + Source code of LEMON itself. + +doc/ + + Documentation of LEMON. The staring page is doc/html/index/html. + The documentation will be installed into the directory + + /usr/local/share/doc/lemon/html + + or -- if you use different prefix -- into + + ${prefix}/share/doc/lemon/html + + (see also INSTALL). + +demo/ + + Some demonstration programs to make you easier to getting familiar + with LEMON. Use --enable-demo configure option to also compile these + codes (see also INSTALL). + +test/ + + Contains programs to check the integrity and correctness of + LEMON. The command 'make check' performs these tests. + +benchmark/ + + Contains programs measuring the performance of LEMON. Use + --enable-benchmark configure option to also compile these codes (see + also INSTALL).