| 1 |
These instructions are for UNIX-like systems (including Linux, Cygwin |
| 2 |
and MSys) only. If Microsoft Developer Studio projects are |
| 3 |
maintained for this package, you can find instructions at |
| 4 |
|
| 5 |
https://projects.coin-or.org/MSVisualStudio |
| 6 |
|
| 7 |
********************************************************************** |
| 8 |
*** DOWNLOAD *** |
| 9 |
********************************************************************** |
| 10 |
|
| 11 |
You can obtain the source code for the Vol package in two ways: |
| 12 |
|
| 13 |
1. Obtain the source directly from the COIN-OR subversion repository |
| 14 |
(recommended). For this you needs the program 'svn' installed on |
| 15 |
your machine, and output of "svn --version" must contain |
| 16 |
"handles 'https' scheme". |
| 17 |
|
| 18 |
Assuming that you want to download the 'trunk' (where the |
| 19 |
development happens) version of the code into a subdirectory |
| 20 |
named "Vol", you type |
| 21 |
|
| 22 |
svn co https://projects.coin-or.org/svn/Vol/trunk Vol |
| 23 |
|
| 24 |
To download stable/1.1 you'd type: |
| 25 |
|
| 26 |
svn co https://projects.coin-or.org/svn/Vol/stable/1.1 Vol |
| 27 |
|
| 28 |
etc. |
| 29 |
|
| 30 |
2. Download the tarball from http://www.coin-or.org/download/source/Vol |
| 31 |
and extract it. For example, for the release 1.1.0 you type |
| 32 |
|
| 33 |
gunzip CoinUtils-1.1.0.tgz |
| 34 |
tar xvf CoinUtils-1.1.0.tar |
| 35 |
|
| 36 |
More detailed download instructions can be found at |
| 37 |
|
| 38 |
https://projects.coin-or.org/BuildTools/wiki/user-download |
| 39 |
|
| 40 |
********************************************************************** |
| 41 |
*** CONFIGURATION *** |
| 42 |
********************************************************************** |
| 43 |
|
| 44 |
Go into the directory that you just downloaded or extracted (e.g., |
| 45 |
Vol or Vol-1.1.0). Then create a build directory and configure the |
| 46 |
package by typing |
| 47 |
|
| 48 |
mkdir build |
| 49 |
cd build |
| 50 |
../configure |
| 51 |
|
| 52 |
Note that you might have to specify additional options, in case you |
| 53 |
don't want to use the default choices that configure makes (e.g., |
| 54 |
compilers). Please visit |
| 55 |
|
| 56 |
https://projects.coin-or.org/BuildTools/wiki/user-configure |
| 57 |
|
| 58 |
and the Vol Trac page |
| 59 |
|
| 60 |
https://projects.coin-or.org/Vol |
| 61 |
|
| 62 |
for more information. |
| 63 |
|
| 64 |
If everything went fine, you will see at the end of the output |
| 65 |
|
| 66 |
"Main configuration of Vol successful" |
| 67 |
|
| 68 |
********************************************************************** |
| 69 |
*** COMPILATION AND INSTALLATION *** |
| 70 |
********************************************************************** |
| 71 |
|
| 72 |
In the directory where you ran the configure script: |
| 73 |
|
| 74 |
1. Compile the code by typing |
| 75 |
|
| 76 |
make |
| 77 |
|
| 78 |
2. To test if the code works, you can type |
| 79 |
|
| 80 |
make test |
| 81 |
|
| 82 |
3. To install the code, you type |
| 83 |
|
| 84 |
make install |
| 85 |
|
| 86 |
After this, you will find the executables, libraries and header |
| 87 |
files in the "bin", "lib" and "include" subdirectory, respectively. |
| 88 |
|
| 89 |
More information on the compilation and installation can be found at |
| 90 |
|
| 91 |
https://projects.coin-or.org/BuildTools/wiki/user-compile |
| 92 |
|
| 93 |
********************************************************************** |
| 94 |
*** USING THE LIBRARIES *** |
| 95 |
********************************************************************** |
| 96 |
|
| 97 |
Now you can link your own code with the installed libraries. You can |
| 98 |
find examples in the |
| 99 |
|
| 100 |
Vol/examples/ |
| 101 |
|
| 102 |
subdirectory, see also the information at |
| 103 |
|
| 104 |
https://projects.coin-or.org/BuildTools/wiki/user-examples |