INSTALL.cmake 3.22 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
#-------------------------------------------------------------
#  building CLHEP with cmake
#-------------------------------------------------------------

At this time, the cmake build system only supports building 
CLHEP as a complete package, starting from the top level directory.

This package requires cmake 2.6 or later.

#-------------------------------------------------------------
#  installing from a source code tar ball
#-------------------------------------------------------------

Unwind the source code tar ball in some relevant directory.
Determine where the files will be installed.
Create a build directory that is NOT in the source code directory tree.
Make sure cmake is in your path.

cd <build_directory>

cmake -DCMAKE_INSTALL_PREFIX=<install_dir> <source_code_dir>
   (Note that files will be installed under /usr/local if you do not 
    specify a prefix.)
make
   (Build temporary copies of libraries and executables.)
make test
   (Run the tests.)
make install
   (Copy libraries, headers, executables, etc. to relevant 
    subdirectories under <install_dir>.)

#-------------------------------------------------------------
#  cmake options
#-------------------------------------------------------------

-DCMAKE_INSTALL_PREFIX=/install/path
-DCMAKE_BUILD_TYPE=Debug|Release|RelWithDebInfo|MinSizeRel
38
-DCLHEP_BUILD_DOCS=ON
Lynn Garren's avatar
Lynn Garren committed
39
40
41

-DCMAKE_C_COMPILER=...
-DCMAKE_CXX_COMPILER=...
Lynn Garren's avatar
Lynn Garren committed
42
43
-DCMAKE_CXX_FLAGS="list_of_flags"

44
45
-DLIB_SUFFIX=64 (installs the libraries in a lib64 subdirectory)

Lynn Garren's avatar
Lynn Garren committed
46
47
48
IMPORTANT:
If you include -DCLHEP_BUILD_DOCS=ON, do not use "make -jN"

49
50
51
52
53
#-------------------------------------------------------------
# building documents
#-------------------------------------------------------------

Documents are not built or installed automatically.  
54
If you wish to build and install the documents, 
55
add -DCLHEP_BUILD_DOCS=ON to your cmake command.   
56
Documents will then be built during the normal build.
57
58
59
You will need to have latex in your path.

#-------------------------------------------------------------
Lynn Garren's avatar
Lynn Garren committed
60
# building from svn
61
62
#-------------------------------------------------------------

Lynn Garren's avatar
Lynn Garren committed
63
64
65
66
67
68
69
70
To work with a tagged branch:
svn co svn+ssh://svn.cern.ch/reps/clhep/tags/CLHEP_2_1_2_2

To work with the head:
svn co svn+ssh://svn.cern.ch/reps/clhep/trunk CLHEP 

You may also download directly from the online browser
http://svnweb.cern.ch/world/wsvn/clhep/
71
72
73

Now continue with directions as if you unpacked a source code tarball.

Lynn Garren's avatar
Lynn Garren committed
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

#-------------------------------------------------------------
# building cmake
#-------------------------------------------------------------

cmake 2.6 or later is readily available for Linux,
although you may need to install it

download the cmake tar file from http://www.cmake.org/cmake/resources/software.html
You may find a usable binary distribution there.  
If not, get the source code and proceed as below (for either MacOSX or Linux).

Unwind the source code tarball.  This directory is <cmake_source_dir>.
Identify a separate build directory and a separate install directory: 
<cmake_build_dir> and <cmake_install_dir>.

cd <cmake_build_dir>
<cmake_source_dir>/bootstrap --prefix=<cmake_install_dir>
make
make install

Add <cmake_install_dir>/bin to your path.

97
#-------------------------------------------------------------