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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
# Compiling
## Requirements
Unfortunately, the requirements for building Textadept are not quite as minimal
as running it.
### Linux and BSD
First, Linux and BSD systems will need the [GNU C compiler][] (*gcc*) and
[GNU Make][] (*make*). Both should be available for your distribution through a
package manager. For example, Ubuntu includes these tools in the
"build-essential" package.
Next, the GTK+ development libraries are necessary for compiling the GUI version
of Textadept. Your package manager should allow you to install them. For
Debian-based Linux distributions like Ubuntu, the package is typically called
"libgtk2.0-dev". Otherwise, compile and install GTK+ from the [GTK+ website][].
If you would like to compile the terminal version of Textadept, you will need
the development library for a curses implementation like ncurses. Similarly, one
should be available from your package manager. For Debian-based Linux
distributions like Ubuntu, the ncurses package is typically called
"libncurses5-dev". Otherwise, compile and install ncurses from the
[ncurses website][]. Note: you need to have the wide-character development
version of ncurses installed, which handles multibyte sequences. (Therefore,
Debian users will _also_ need "libncursesw5-dev".)
In addition, BSD users will need to have [libiconv][] installed.
[GTK+ website]: http://www.gtk.org/download/linux.html
[GNU C compiler]: http://gcc.gnu.org
[GNU Make]: http://www.gnu.org/software/make/
[ncurses website]: http://invisible-island.net/ncurses/#download_ncurses
[libiconv]: http://www.gnu.org/software/libiconv/
### Windows
Compiling Textadept on Windows is no longer supported. If you wish to do so
however, you need a C compiler that supports the C99 standard, the
[GTK+ for Windows bundle][] (2.24 is recommended), and [libiconv for Windows][]
(the "Developer files" and "Binaries" zip files).
The preferred way to compile for Windows is cross-compiling from Linux. To do
so, in addition to the GTK+ bundle mentioned above, you need [MinGW][] with the
Windows header files. They should be available from your package manager.
[GTK+ for Windows bundle]: http://www.gtk.org/download/win32.html
[libiconv for Windows]: http://gnuwin32.sourceforge.net/packages/libiconv.htm
[MinGW]: http://mingw.org
### Mac OSX
Compiling Textadept on Mac OSX is no longer supported. The preferred way is
cross-compiling from Linux. To do so, you will need my [GTK+ for OSX bundle][]
and the [Apple Cross-compiler][] binaries.
[GTK+ for OSX bundle]: download/gtkosx-2.24.9.zip
[Apple Cross-compiler]: https://launchpad.net/~flosoft/+archive/cross-apple
## Compiling
Make sure you downloaded the *textadept_x.x.src.zip*, regardless of what
platform you are on, and not a platform-specific binary package.
### Linux and BSD
For Linux and BSD systems, simply run `make` in the *src/* directory. The
*textadept* and *textadeptjit* executables are created in the root directory.
Make a symlink from them to */usr/bin/* or elsewhere in your `PATH`.
Similarly, `make curses` builds *textadept-curses* and *textadeptjit-curses*.
Note: you may have to run
make CFLAGS="-I/usr/local/include" \
CXXFLAGS="-I/usr/local/include -L/usr/local/lib"
if the prefix where any dependencies are installed is */usr/local/* and your
compiler flags do not include them by default.
#### Installing
Textadept is self-contained, meaning it does not need to be installed and can be
run from wherever it is located. However, if you want to install Textadept like
a normal Linux application, run the usual `make` and then `make install` or
`sudo make install` depending on your privilages. The default prefix is
*/usr/local* but you can change this by setting `DESTDIR` (e.g.
`make install DESTDIR=/prefix/to/install/to`).
Similarly, `make curses` and `make curses install` installs the curses version.
### Cross Compiling for Windows
When cross-compiling from within Linux, first unzip the GTK+ for Windows bundle
into a new *src/win32gtk/* directory. Also, unzip the libiconv zips into the
same directory. Then, depending on your MinGW installation, either run
`make win32`, modify the `CROSS` variable in the "win32" block of *src/Makefile*
and run `make win32`, or run `make CROSS=i486-mingw32- win32` to build
*../textadept.exe* and *../textadeptjit.exe*. Finally, copy the dll files from
*src/win32gtk/bin/* to the directory containing the Textadept executables.
Please note that a *lua51.dll* is produced for _only_ the *textadeptjit.exe*
because limitations on external Lua library loading do not allow statically
linking LuaJIT to Textadept.
### Cross Compiling for Mac OSX
When cross-compiling from within Linux, first unzip the GTK+ for OSX bundle into
a new *src/gtkosx/* directory. Then run `make osx` to build *../textadept.osx*
and *../textadeptjit.osx*. At this point it is recommended to build a new
*Textadept.app* from an existing one. Download the most recent app and replace
*Contents/MacOS/textadept.osx* and *Contents/MacOS/textadeptjit.osx* with your
own versions.
Similarly, `make osx-curses` builds *../textadept-curses.osx* and
*../textadeptjit-curses.osx*.
#### Compiling on OSX (Legacy)
[XCode][] is needed for Mac OSX as well as [jhbuild][] (for GTK+). After
building "meta-gtk-osx-bootstrap" and "meta-gtk-osx-core", you need to build
"meta-gtk-osx-themes". Note that the entire compiling process can easily take 30
minutes or more and ultimately consume nearly 1GB of disk space.
After using *jhbuild*, GTK+ is in *~/gtk/* so make a symlink from *~/gtk/inst*
to *src/gtkosx* in Textadept. Then open *src/Makefile* and uncomment the
"Darwin" block. Finally, run `make osx` to build *../textadept.osx* and
*../textadeptjit.osx*.
Note: to build a GTK+ for OSX bundle, the following needs to be run from the
*src/* directory before zipping up *gtkosx/include/* and *gtkosx/lib/*:
sed -i -e 's|libdir=/Users/username/gtk/inst/lib|libdir=${prefix}/lib|;' \
gtkosx/lib/pkgconfig/*.pc
where `username` is replaced with your username.
Compiling the terminal version is not so expensive. After uncommenting the
"Darwin" block mentioned above, simply run `make osx-curses` to build
*../textadept-curses.osx* and *../textadeptjit-curses.osx*. No additional
libraries are needed.
[XCode]: http://developer.apple.com/TOOLS/xcode/
[jhbuild]: http://sourceforge.net/apps/trac/gtk-osx/wiki/Build
### Notes on LuaJIT
[LuaJIT][] is a Just-In-Time Compiler for Lua and can boost the speed of Lua
programs. I have noticed that syntax highlighting can be up to 2 times faster
with LuaJIT than with vanilla Lua. This difference is largely unnoticable on
modern computers and usually only discernable when initially loading large
files. Other than syntax highlighting, LuaJIT offers no real benefit
performance-wise to justify it being Textadept's default runtime. LuaJIT's
[ffi library][], however, appears to be useful for interfacing with external,
non-Lua, libraries.
[LuaJIT]: http://luajit.org
[ffi library]: http://luajit.org/ext_ffi.html
### Notes on CDK
[CDK][] is a library of curses widgets. The terminal version of Textadept
includes a slightly modified, stripped down version of this library. The changes
made to CDK are as follows:
* The following source files were removed: *alphalist.c*, *calendar.c*,
*cdk_compat.{c,h}*, *cdk_test.h*, *dialog.c*, *{d,f}scale.{c,h}*,
*fslider.{c,h}*, *gen-{scale,slider}.{c,h}*, *get_index.c*, *get_string.c*,
*graph.c*, *histogram.c*, *marquee.c*, *matrix.c*, *popup_dialog.c*,
*radio.c*, *scale.{c,h}*, *selection.c*, *slider.{c,h}*, *swindow.c*,
*template.c*, *u{scale,slider}.{c,h}*, *view_{file,info}.c*, and *viewer.c*.
* *cdk.h* does not `#include` "matrix.h", "viewer.h", and any headers labeled
"Generated headers" due to their machine-dependence.
* *cdk_config.h* no longer defines `HAVE_SETLOCALE` since Textadept handles
locale settings and no longer defines `HAVE_NCURSES_H` and `NCURSES` since
Textadept supports multiple curses implementations, not just ncurses.
* The `deleteFileCB` routine in *fselect.c* has been deactivated.
[CDK]: http://invisible-island.net/cdk/
|
