notepad-plus-plus/scintilla/README

105 lines
3.4 KiB
Plaintext
Raw Normal View History

README for building of Scintilla and SciTE
Scintilla can be built by itself.
To build SciTE, Scintilla must first be built.
Lexers can be either compiled into Scintilla or built separately into a Lexilla
shared library.
A separate Lexilla is the preferred option and will become the only supported
direction in Scintilla 5.0.
See lexilla/src/README for information on building Lexilla.
*** GTK+/Linux version ***
2019-05-04 18:14:48 +00:00
You must first have GTK+ 2.24 or later and GCC (7.1 or better) installed.
Clang may be used by adding CLANG=1 to the make command line.
Other C++ compilers may work but may require tweaking the make file.
2019-05-04 18:14:48 +00:00
Either GTK+ 2.x or 3.x may be used with 2.x the default and 3.x
chosen with the make argument GTK3=1.
To build Scintilla, use the makefile located in the scintilla/gtk directory
cd scintilla/gtk
make
cd ../..
To build and install SciTE, use the makefile located in the scite/gtk directory
cd scite/gtk
make
2019-05-04 18:14:48 +00:00
sudo make install
This installs SciTE into $prefix/bin. The value of $prefix is determined from
the location of Gnome if it is installed. This is usually /usr if installed
with Linux or /usr/local if built from source. If Gnome is not installed
/usr/bin is used as the prefix. The prefix can be overridden on the command
line like "make prefix=/opt" but the same value should be used for both make
and make install as this location is compiled into the executable. The global
properties file is installed at $prefix/share/scite/SciTEGlobal.properties.
The language specific properties files are also installed into this directory.
To remove SciTE
2019-05-04 18:14:48 +00:00
sudo make uninstall
To clean the object files which may be needed to change $prefix
make clean
The current make file only supports static linking between SciTE and Scintilla.
*** Windows version ***
2019-05-04 18:14:48 +00:00
A C++ 17 compiler is required.
Visual Studio 2017 is the development system used for most development
although Mingw-w64 7.1 is also supported.
There are versions of Scintilla with lexers (SciLexer.DLL) and without lexers
(Scintilla.DLL). Make builds both versions.
To build Scintilla, make in the scintilla/win32 directory
cd scintilla\win32
GCC: mingw32-make
2019-05-04 18:14:48 +00:00
Visual C++: nmake -f scintilla.mak
cd ..\..
To build SciTE, use the makefiles located in the scite/win32 directory
cd scite\win32
GCC: mingw32-make
2019-05-04 18:14:48 +00:00
Visual C++: nmake -f scite.mak
An executable SciTE will now be in scite/bin.
*** GTK+/Windows version ***
2019-05-04 18:14:48 +00:00
Mingw-w64 is known to work. Other compilers will probably not work.
Only Scintilla will build with GTK+ on Windows. SciTE will not work.
Make builds both a static library version of Scintilla with lexers (scintilla.a) and
a shared library without lexers (libscintilla.so or or libscintilla.dll).
To build Scintilla, make in the scintilla/gtk directory
cd scintilla\gtk
mingw32-make
2019-05-04 18:14:48 +00:00
*** macOS Cocoa version ***
Xcode 9.2 or later may be used to build Scintilla on macOS.
There is no open source version of SciTE for macOS but there is a commercial
version available through the App Store.
There are versions of Scintilla.framework with lexers (ScintillaFramework) and
without lexers (Scintilla).
To build Scintilla, run xcodebuild in the scintilla/cocoa/ScintillaFramework or
scintilla/cocoa/Scintilla directory
cd cocoa/Scintilla
or
2019-05-04 18:14:48 +00:00
cd cocoa/ScintillaFramework
2019-05-04 18:14:48 +00:00
xcodebuild
*** Qt version ***
See the qt/README file to build Scintilla with Qt.