xref: /MusicPlayer2/scintilla/README (revision 8af74909132ed5e696cb05b6689ae4baf14c1c96)
1*8af74909SZhong YangREADME for building of Scintilla and SciTE
2*8af74909SZhong Yang
3*8af74909SZhong YangScintilla can be built by itself.
4*8af74909SZhong YangTo build SciTE, Scintilla must first be built.
5*8af74909SZhong Yang
6*8af74909SZhong YangLexers can be either compiled into Scintilla or built separately into a Lexilla
7*8af74909SZhong Yangshared library.
8*8af74909SZhong YangA separate Lexilla is the preferred option and will become the only supported
9*8af74909SZhong Yangdirection in Scintilla 5.0.
10*8af74909SZhong YangSee lexilla/src/README for information on building Lexilla.
11*8af74909SZhong Yang
12*8af74909SZhong Yang*** GTK+/Linux version ***
13*8af74909SZhong Yang
14*8af74909SZhong YangYou must first have GTK+ 2.24 or later and GCC (7.1 or better) installed.
15*8af74909SZhong YangClang may be used by adding CLANG=1 to the make command line.
16*8af74909SZhong YangOther C++ compilers may work but may require tweaking the make file.
17*8af74909SZhong YangEither GTK+ 2.x or 3.x may be used with 2.x the default and 3.x
18*8af74909SZhong Yangchosen with the make argument GTK3=1.
19*8af74909SZhong Yang
20*8af74909SZhong YangTo build Scintilla, use the makefile located in the scintilla/gtk directory
21*8af74909SZhong Yang	cd scintilla/gtk
22*8af74909SZhong Yang	make
23*8af74909SZhong Yang	cd ../..
24*8af74909SZhong Yang
25*8af74909SZhong YangTo build and install SciTE, use the makefile located in the scite/gtk directory
26*8af74909SZhong Yang	cd scite/gtk
27*8af74909SZhong Yang	make
28*8af74909SZhong Yang	sudo make install
29*8af74909SZhong Yang
30*8af74909SZhong YangThis installs SciTE into $prefix/bin. The value of $prefix is determined from
31*8af74909SZhong Yangthe location of Gnome if it is installed. This is usually /usr if installed
32*8af74909SZhong Yangwith Linux or /usr/local if built from source. If Gnome is not installed
33*8af74909SZhong Yang/usr/bin is used as the prefix. The prefix can be overridden on the command
34*8af74909SZhong Yangline like "make prefix=/opt" but the same value should be used for both make
35*8af74909SZhong Yangand make install as this location is compiled into the executable. The global
36*8af74909SZhong Yangproperties file is installed at $prefix/share/scite/SciTEGlobal.properties.
37*8af74909SZhong YangThe language specific properties files are also installed into this directory.
38*8af74909SZhong Yang
39*8af74909SZhong YangTo remove SciTE
40*8af74909SZhong Yang	sudo make uninstall
41*8af74909SZhong Yang
42*8af74909SZhong YangTo clean the object files which may be needed to change $prefix
43*8af74909SZhong Yang	make clean
44*8af74909SZhong Yang
45*8af74909SZhong YangThe current make file only supports static linking between SciTE and Scintilla.
46*8af74909SZhong Yang
47*8af74909SZhong Yang
48*8af74909SZhong Yang*** Windows version ***
49*8af74909SZhong Yang
50*8af74909SZhong YangA C++ 17 compiler is required.
51*8af74909SZhong YangVisual Studio 2017 is the development system used for most development
52*8af74909SZhong Yangalthough Mingw-w64 7.1 is also supported.
53*8af74909SZhong Yang
54*8af74909SZhong YangThere are versions of Scintilla with lexers (SciLexer.DLL) and without lexers
55*8af74909SZhong Yang(Scintilla.DLL). Make builds both versions.
56*8af74909SZhong Yang
57*8af74909SZhong YangTo build Scintilla, make in the scintilla/win32 directory
58*8af74909SZhong Yang		cd scintilla\win32
59*8af74909SZhong YangGCC:		mingw32-make
60*8af74909SZhong YangVisual C++:	nmake -f scintilla.mak
61*8af74909SZhong Yang		cd ..\..
62*8af74909SZhong Yang
63*8af74909SZhong YangTo build SciTE, use the makefiles located in the scite/win32 directory
64*8af74909SZhong Yang		cd scite\win32
65*8af74909SZhong YangGCC:		mingw32-make
66*8af74909SZhong YangVisual C++: 	nmake -f scite.mak
67*8af74909SZhong Yang
68*8af74909SZhong YangAn executable SciTE will now be in scite/bin.
69*8af74909SZhong Yang
70*8af74909SZhong Yang*** GTK+/Windows version ***
71*8af74909SZhong Yang
72*8af74909SZhong YangMingw-w64 is known to work. Other compilers will probably not work.
73*8af74909SZhong Yang
74*8af74909SZhong YangOnly Scintilla will build with GTK+ on Windows. SciTE will not work.
75*8af74909SZhong Yang
76*8af74909SZhong YangMake builds both a static library version of Scintilla with lexers (scintilla.a) and
77*8af74909SZhong Yanga shared library without lexers (libscintilla.so or or libscintilla.dll).
78*8af74909SZhong Yang
79*8af74909SZhong YangTo build Scintilla, make in the scintilla/gtk directory
80*8af74909SZhong Yang	cd scintilla\gtk
81*8af74909SZhong Yang	mingw32-make
82*8af74909SZhong Yang
83*8af74909SZhong Yang*** macOS Cocoa version ***
84*8af74909SZhong Yang
85*8af74909SZhong YangXcode 9.2 or later may be used to build Scintilla on macOS.
86*8af74909SZhong Yang
87*8af74909SZhong YangThere is no open source version of SciTE for macOS but there is a commercial
88*8af74909SZhong Yangversion available through the App Store.
89*8af74909SZhong Yang
90*8af74909SZhong YangThere are versions of Scintilla.framework with lexers (ScintillaFramework) and
91*8af74909SZhong Yangwithout lexers (Scintilla).
92*8af74909SZhong Yang
93*8af74909SZhong YangTo build Scintilla, run xcodebuild in the scintilla/cocoa/ScintillaFramework or
94*8af74909SZhong Yangscintilla/cocoa/Scintilla directory
95*8af74909SZhong Yang
96*8af74909SZhong Yang        cd cocoa/Scintilla
97*8af74909SZhong Yang		or
98*8af74909SZhong Yang        cd cocoa/ScintillaFramework
99*8af74909SZhong Yang
100*8af74909SZhong Yang	xcodebuild
101*8af74909SZhong Yang
102*8af74909SZhong Yang*** Qt version ***
103*8af74909SZhong Yang
104*8af74909SZhong YangSee the qt/README file to build Scintilla with Qt.
105