summaryrefslogtreecommitdiff
path: root/README.txt
blob: cbdd2ff375208115bd7383175c7ce7a88d979cc9 (plain)
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
Using the CMake build system
============================

There are basically two options for how to run ToME once built.


Prerequisites
=============

You will need to have the following libraries installed
on your system somewhere where CMake can find them:

   - jansson
     See http://www.digip.org/jansson/


Option #1 : Run ToME from the build directory
=============================================

Simply run the commands below.

       $ cmake .
       $ make

You should now be able to run

       $ ./src/tome

to start ToME.

This is currently the recommended option.



Option #2: Run ToME from a system install location
==================================================

Run

        $ cmake -DSYSTEM_INSTALL:BOOL=true .
        $ make
        $ sudo make install

You can now run ToME from anywhere.

You can also use DESTDIR when installing to a different location
(useful with e.g. stow or when building distribution packages).


Compiling on Ubuntu
===================

If you're having trouble compiling on an Ubuntu install you are
probably missing the

    build-essential

package. You'll also need to install the

    libjansson-dev

package.

Each frontend requires the additional packages listed below:

   X11: libx11-dev
   SDL: libsdl-image1.2-dev, libsdl-ttf2.0-dev
   ncurses: libncurses5-dev


Compiling on OpenBSD
====================

As of February 2010, the OpenBSD package cmake-2.4.8p2 is too old for
building ToME. You may need to compile a newer version of CMake.

If you have X11, then a bug in CMake may cause a linker error when
linking the 'tome' executable. As a workaround, set the environment
variable LDFLAGS=-L/usr/X11R6/lib when running CMake. Example:

       $ env LDFLAGS=-L/usr/X11R6/lib cmake .
       $ make

The SDL frontend also requires these packages: sdl-image, sdl-ttf


Compiling on Windows using MinGW
================================

(See http://www.mingw.org/)

The source MUST be unpacked in a directory without spaces in the
name.

To compile on Windows using MinGW, use the commands

       $ cmake -G "MinGW Makefiles"
       $ mingw32-make