Merge pull request #3720 from b4n/encodings-ui-improvements
[geany-mirror.git] / scintilla / README
blobfcdc4065326a0f7a96693fd01e50477286064dca
1 README for building of Scintilla, Lexilla, and SciTE
3 Scintilla and Lexilla can be built by themselves.
4 To build SciTE, Scintilla and Lexilla should first be built.
6 See lexilla/README for information on building Lexilla.
8 *** GTK+/Linux version ***
10 You must first have GTK+ 2.24 or later and GCC (7.1 or better) installed.
11 Clang may be used by adding CLANG=1 to the make command line.
12 Other C++ compilers may work but may require tweaking the make file.
13 Either GTK+ 2.x or 3.x may be used with 2.x the default and 3.x
14 chosen with the make argument GTK3=1.
16 To build Scintilla, use the makefile located in the scintilla/gtk directory
17         cd scintilla/gtk
18         make
19         cd ../..
21 To build and install SciTE, use the makefile located in the scite/gtk directory
22         cd scite/gtk
23         make
24         sudo make install
26 This installs SciTE into $prefix/bin. The value of $prefix is determined from
27 the location of Gnome if it is installed. This is usually /usr if installed
28 with Linux or /usr/local if built from source. If Gnome is not installed
29 /usr/bin is used as the prefix. The prefix can be overridden on the command
30 line like "make prefix=/opt" but the same value should be used for both make
31 and make install as this location is compiled into the executable. The global
32 properties file is installed at $prefix/share/scite/SciTEGlobal.properties.
33 The language specific properties files are also installed into this directory.
35 To remove SciTE
36         sudo make uninstall
38 To clean the object files which may be needed to change $prefix
39         make clean
41 The current make file supports static and dynamic linking between SciTE, Scintilla, and Lexilla.
44 *** Windows version ***
46 A C++ 17 compiler is required.
47 Visual Studio 2019 is the development system used for most development
48 although Mingw-w64 9.2 is also supported.
50 To build Scintilla, make in the scintilla/win32 directory
51                 cd scintilla\win32
52 GCC:            mingw32-make
53 Visual C++:     nmake -f scintilla.mak
54                 cd ..\..
56 To build SciTE, use the makefiles located in the scite/win32 directory
57                 cd scite\win32
58 GCC:            mingw32-make
59 Visual C++:     nmake -f scite.mak
61 An executable SciTE will now be in scite/bin.
63 *** GTK+/Windows version ***
65 Mingw-w64 is known to work. Other compilers will probably not work.
67 Only Scintilla will build with GTK+ on Windows. SciTE will not work.
69 Make builds both a static library version of Scintilla with lexers (scintilla.a) and
70 a shared library without lexers (libscintilla.so or or libscintilla.dll).
72 To build Scintilla, make in the scintilla/gtk directory
73         cd scintilla\gtk
74         mingw32-make
76 *** macOS Cocoa version ***
78 Xcode 9.2 or later may be used to build Scintilla on macOS.
80 There is no open source version of SciTE for macOS but there is a commercial
81 version available through the App Store.
83 To build Scintilla, run xcodebuild in the scintilla/cocoa/ScintillaFramework or 
84 scintilla/cocoa/Scintilla directory
86         cd cocoa/Scintilla
88         xcodebuild
90 *** Qt version ***
92 See the qt/README file to build Scintilla with Qt.