forked from genometools/genometools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
134 lines (88 loc) · 4.23 KB
/
INSTALL
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
Building GenomeTools
--------------------
Invoke GNU make, e.g.:
$ make [argument ...]
to build GenomeTools. You need at least version 3.80 of GNU make, you can check
which version you have by invoking
$ make --version
On *BSD GNU make is often called ``gmake''.
Possible arguments:
- 64bit=no to compile a 32-bit version
- 32bit=yes to compile a 32-bit version
- opt=no to disable optimization
- assert=no to disable assertions
- amalgamation=yes to compile as an amalgamation
- cairo=no to disable AnnotationSketch, dropping Cairo/Pango deps
- errorcheck=no to disable the handling of compiler warnings as errors
- universal=yes to build a universal binary
Example call to build GenomeTools without assertions on a system where GNU make
is called ``gmake'':
$ gmake assert=no
Please remember to always run `make cleanup' before rebuilding with changed make
parameters!
Building GenomeTools without the sketch tool:
---------------------------------------------
The AnnotationSketch engine requires the Cairo and Pango headers and libraries
to be installed in order to build GenomeTools. Please consult your operating
system's package manager for more information on how to install these. For
example, on Debian the packages ``libcairo2-dev'' and ``libpango1.0-dev'' must
be installed.
If Cairo and/or Pango headers are not installed on the system, and
AnnotationSketch support is not required, GenomeTools can be built without
graphics support by invoking make as above with the argument `cairo=no'.
Building GenomeTools on Mac OS X (>= 10.6):
-------------------------------------------
Make sure the command line developer tools are installed:
$ xcode-select --install
With these installed, you are ready to build GenomeTools without
AnnotationSketch support (cairo=no). To build GenomeTools with AnnotationSketch,
you can use Homebrew (http://brew.sh) to install the necessary dependencies
required for building:
$ brew install caskroom/cask/brew-cask
$ brew cask install xquartz
$ brew install cairo
$ brew install pango
To start the build process, invoke make as stated above.
Building GenomeTools as a Universal Binary (on Mac OS X < v10.6):
-----------------------------------------------------------------
Invoke make as above with the argument universal=yes.
Note that on later Mac OS X systems (those with an Intel CPU) the universal=yes
option is not required. Also, do not use it on Mac OS X 10.6 (Snow Leopard) or
later as PowerPC support has since been discontinued. Thus trying to build a
universal binary may lead to problems.
Building GenomeTools on Windows (using Cygwin):
-----------------------------------------------
Building GenomeTools with gcc on Windows occasionally results in a warning
regarding the '-fPIC' parameter. This can be ignored without problems. To ignore
this warning, please append the errorcheck=no option to your make call. All
other options given in this file can still be used.
Testing GenomeTools (optional)
------------------------------
Call
$ make test
to make sure your GenomeTools build went fine. This step requires an installed
Ruby 1.8 interpreter (see http://www.ruby-lang.org/en/ for informations on
Ruby).
Please note that all make options given during the compilation must be repeated
in the `make test' invocation. For example, if you compiled GenomeTools with
the '64bit=no cairo=no' options, the correct installation command would be:
# make 64bit=no cairo=no test
Installing GenomeTools
----------------------
To install the ``gt'' binary and the ``libgenometools'' library
(plus header files) on your system invoke
$ make install
Per default the files are installed under /usr/local. You can change this with
the prefix argument. For example, to install under /usr, invoke
# make prefix=/usr install
Please note that all make options given during the compilation must be
given in the `make install' invocation again. For example, if you compiled
GenomeTools with the '64bit=no cairo=no' options, the correct installation
command would be:
# make prefix=/usr 64bit=no cairo=no install
Omitting these options is likely to lead to problems during installation.
Final note
-----------
Please look at http://genometools.org for updates and report bugs if you
encounter any.
Enjoy!