/
INSTALL.txt
92 lines (59 loc) · 2.3 KB
/
INSTALL.txt
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
COMPILING Oblige
================
Dependencies
------------
1. C++ compiler (GNU's G++) and associated tools
packages: g++ binutils
2. GNU make
package: make
3. FLTK 1.3
website: http://www.fltk.org/
package: libfltk1.3-dev
You may also need: libxft-dev
libxinerama-dev
libjpeg-dev
libpng-dev
4. zlib
website: http://www.zlib.net/
package: zlib1g-dev
5. XDG Utils
(only needed for Linux, to install the desktop and icon files)
package: xdg-utils
Linux Compilation
-----------------
Assuming all those dependencies are met, then the following shell
command will build the Oblige binary. (The '>' is just the prompt)
> make
Windows Compilation
-------------------
I personally compile the Win32 binaries on Linux using what's
called a "Cross Compiler". That means I don't need to reboot
out of Linux in order to create the Win32 packages.
Sorry, but if you want to compile the Win32 binary under
Windows itself then you are on your own.
Assuming you have a working cross-compiler, like the "mingw32"
package in Debian or Ubuntu Linux, then the following command
will build the EXE:
> make -f Makefile.xming
INSTALLING Oblige
=================
For a system-wide Linux installation you should run "make install"
as root (the superuser) after building, which installs the binary
program plus all the script and data files. It also uses the XDG
tools to install a desktop file and icon, allowing Oblige to appear
in your system's applications menu -- though if this step fails,
Oblige will still work when invoked from the command line.
MISCELLANEOUS NOTES
===================
To build FLTK with the WIN32 cross-compiler:
(a) read README.CMake.txt and copy the cross-compiling snippet
in there to a file: Toolchain-mingw32.cmake
(b) edit Toolchain-mingw32.cmake and set the proper paths for
the cross-compiling tools (for me: i586-mingw32msvc)
(c) mkdir mingw ; cd mingw
(d) cmake -DCMAKE_TOOLCHAIN_FILE=../Toolchain-mingw32.cmake \
CMAKE_BUILD_TYPE=Release -DOPTION_USE_GL=OFF -DOPTION_USE_THREADS=OFF
(e) make
Note that the build fails when it gets to some stuff which require
FLUID to process some .fl files. That doesn't matter since the
needed libraries (in mingw/lib) have been built by then.