> <\body> package with > To run the configuration of a package (say ), the tool >|http://www.cmake.org/> should be installed in order to produce the Makefiles for the construction step. If the packages depends on external libraries or tools, they will be checked during the configuration step. The installation instructions of each package describe what should be installed.\ A package (say ) can be configured in a directory as follows. The directory of the sources of is called hereafter pkg_dir\>>; it can be for instance > if this package is one of the packages of : <\shell-code> cd path_to_build\> cmake pkg_dir\> \ make Before starting, here some > on the configuration steps with : it uses a cache file to store the values of the configuration variables. Thus if you need to > the configuration step from scratch, you have to clean this file: <\shell-code> rm CMakeCache.txt; cmake pkg_dir\> A convenient and safe way is to do it systematically and to use the following alias: <\shell-code> alias CMake='rm -f CMakeCache.txt; cmake' That is what we will do in the following. If on the contrary, you want to keep or > the configuration variables, you can use interface and have access to the stored value of these configuration variables and change them:\ <\shell-code> ccmake . By default, each package provides a library of the same name. The option which controls the construction of libraries is . The default value is . If it is turned , then the other options will also be turned . \ Here is how it can be turned :\ <\shell-code> CMake pkg_dir\> -DLIBS=OFF The option which controls the test is . To build these tests, you have to assign . The default value is . \ Here is how it can be set:\ <\shell-code> CMake pkg_dir\> -DTEST=ON make test This will create in the executable tests in . The option which controls the construction of the applications from the folder is . The default value is . Here is how it can be turned off:\ <\shell-code> CMake pkg_dir\> -DAPP=OFF make If the application executables are built, they are put in the folder . The option which controls the construction of a module for the , is . To construct the glue, you have to assign , if it is not done by default. In this case, the dependency with other packages might be checked, depending on the list defined in the file . Here is how you can set it:\ <\shell-code> CMake pkg_dir\> -DGLUE=ON make This will create a module in the folder . The option which controls the construction of modules for available in the folder is . To construct these modules, you have to assign . In this case, the dependency with other packages might be checked, depending on the list defined in the file . Here is how you can set it:\ <\shell-code> CMake pkg_dir\> -DAXEL=ON make This will create plugins which will put in the folder of the application . To construct the documentation, you need also to have >|http://www.texmacs.org/> and >|http://www.doxygen.org> installed. The variable which control the generation of the documentation is . You can use the commands: <\shell-code> CMake pkg_dir\> -DDOC=ON make This will create a folder which contain the html documentation.\ When the package contains subpackages, if the option for a subpackage say is , then all the other subpackages on which depends are turned . If the option for the subpackage is , then all the other subpackages which depend on are turned . If the mode is turned , there is no default subpackage selection. In this case, to use a subpackage, the corresponding option has to be turned explicitely: \ \ <\shell-code> CMake pkg_dir\> -DDEV=ON -DNUMERIX=ON\ Some of the packages on which the libraries depend may be external to the distribution. To know which are the external packages, see the file . These external packages are usually installed globally in the environment but in some cases it is necessary to configure and compile them directly. Such \ external libraries \ will be downloaded, configured and built if the option passed to is : <\shell-code> CMake -DEXTERNAL=ON ../pkg\ The corresponding libraries and headers will be installed in the folder , where is used. In the case of \ , it depends on two external libraries: |http://gmplib.org/> for integer and rational numbers, |http://www.mpfr.org/> for floating point numbers. If they are not installed globally, theey will be downloaeded and built if the option is turned . Once is run, the command can be used: <\shell-code> make\ To see more details on the command that are run to build files, one can use the option : <\shell-code> make VERBOSE=1 To see the available targets of the command, use <\shell-code> make help To specify the place where you install the package, use : <\code> <\shell-code> CMake pkg_dir\> -DCMAKE_INSTALL_PREFIX=$HOME/local make && make install If the variable is not specified, the package will be installed with the prefix (if you don't have the permission to write in this directory, you can use ). To see the other available targets, you can use:\ <\shell-code> make help . If you don't have this file, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.> <\initial> <\collection>