aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorGravatar mitchell <70453897+orbitalquark@users.noreply.github.com>2022-03-02 01:27:28 -0500
committerGravatar mitchell <70453897+orbitalquark@users.noreply.github.com>2022-03-02 01:27:28 -0500
commit40d2ffbf47803a224a3f26356aa49df013b5a91c (patch)
tree2fd196fe4b05c5d3bc39cab4278408c932b40d89
parent96daa96857ce9d3778265f46d4c75ea3ce3d9b24 (diff)
Updated documentation on preferred use of GTK 3.
Also updated download and install sizes.
-rw-r--r--README.md8
-rw-r--r--docs/faq.md16
-rw-r--r--docs/manual.md30
3 files changed, 24 insertions, 30 deletions
diff --git a/README.md b/README.md
index f8105fba..094aca12 100644
--- a/README.md
+++ b/README.md
@@ -32,9 +32,9 @@ that runs in a desktop environment, and a terminal version that runs within a te
In its bid for minimalism, Textadept depends on very little to run. On Windows and macOS,
it has no external dependencies. On Linux and BSD, the GUI version depends only on [GTK][]
-(a cross-platform GUI toolkit) version 2.24 or later (circa early 2011), and the terminal
-version depends only on a wide-character implementation of curses like [ncurses][](w). Lua and
-any other third-party dependencies are compiled into the application itself.
+(a cross-platform GUI toolkit), and the terminal version depends only on a wide-character
+implementation of curses like [ncurses][](w). Lua and any other third-party dependencies are
+compiled into the application itself.
[GTK]: https://gtk.org
[ncurses]: https://invisible-island.net/ncurses/ncurses.html
@@ -83,7 +83,7 @@ General Requirements:
* [GNU C compiler][] (*gcc*) 7.1+ (circa mid-2017)
* [GNU Make][] (*make*)
-* [GTK][] 2.24+ development libraries for the GUI version
+* [GTK][] 3 development libraries for the GUI version (GTK 2.24 is also supported)
* [ncurses][](w) development libraries (wide character support) for the terminal version
* [mingw-w64][] 5.0+ with GCC 7.1+ when cross-compiling for Windows.
* [OSX cross toolchain][] with [Clang][] 4.0+ when cross-compiling for macOS.
diff --git a/docs/faq.md b/docs/faq.md
index 445fc413..4b8c210f 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,16 +1,14 @@
## FAQ
**Q:**
-If Textadept is so minimalist, why are the downloads around 10MB in size and the unzipped
-folders 10s of MBs in size? Why is the Git repository more than 50MB in size?
+If Textadept is so minimalist, why are the downloads around 20MB in size and the unzipped
+folders more than double that? Why is the Git repository more than 50MB in size?
**A:**
-Each download contains 2 executables: a GUI version and a terminal version. Furthermore,
-the Windows and macOS packages bundle in GTK runtimes, accounting for some 3/4 of the total
-application size. (GTK is the cross-platform GUI toolkit Textadept uses.) Then, starting in
-version 10, in order to be able to run on older Linux systems whose libstdc++ does not support
-newer C++ symbols, the Linux executables statically link in a newer version of libstdc++. Finally,
-nightly builds are compiled with debug symbols enabled in order to aid debugging of various issues.
+Each download contains 2 executables: a GUI version and a terminal version. Furthermore, the
+Windows and macOS packages bundle in GTK runtimes, accounting for ~80% of the total application
+size. (GTK is the cross-platform GUI toolkit Textadept uses.) Finally, nightly builds are
+compiled with debug symbols enabled in order to aid debugging of various issues.
The Git repository is an export of an underlying Mercurial repository and is not compressed or
optimized for size. After the initial clone, you can run `git gc --aggressive` to reduce its
@@ -169,7 +167,7 @@ On my Windows HiDPI display, Textadept's fonts look fuzzy or blurred. How can I
like other HiDPI-aware applications?
**A:**
-GTK 2.0, the cross-platform GUI toolkit Textadept uses, is not HiDPI aware, so you need to
+GTK, the cross-platform GUI toolkit Textadept uses, is not HiDPI aware, so you need to
instruct Windows to take over font rendering. Right-click on the Textadept executable and
select "Properties". Click on the "Compatibility" tab and then the "Change high DPI settings"
button. Check the "Override high DPI scaling" checkbox towards the bottom of the pop-up
diff --git a/docs/manual.md b/docs/manual.md
index e439bf6f..346955b8 100644
--- a/docs/manual.md
+++ b/docs/manual.md
@@ -156,12 +156,11 @@ connected to events.
In its bid for minimalism, Textadept depends on very little to run. On Windows and macOS,
it has no external dependencies. On Linux and BSD, the GUI version depends only on [GTK][]
-(a cross-platform GUI toolkit) version 2.24 or later (circa early 2011), and the terminal
-version depends only on a wide-character implementation of curses like [ncurses][](w). Most
-Linux and BSD systems either already have these dependencies installed, or they are readily
-available from a package manager.
+(a cross-platform GUI toolkit), and the terminal version depends only on a wide-character
+implementation of curses like [ncurses][](w). Most Linux and BSD systems either already have
+these dependencies installed, or they are readily available from a package manager.
-Windows XP and Mac OSX 10.10 (Yosemite) are the minimum required operating systems. Linux and
+Windows 7 and Mac OSX 10.10 (Yosemite) are the minimum required operating systems. Linux and
BSD have no defined minimum.
[GTK]: https://gtk.org
@@ -181,9 +180,9 @@ The following table lists Textadept's approximate download and installation size
Platform | Download Size | Installed Size
-|-|-
-Linux | 4 MB | 11 MB
-macOS | 11 MB | 35 MB (12 MB without bundled GTK Runtime)
-Windows | 16 MB |41 MB (23 MB without bundled GTK Runtime)
+Linux | 4 MB | 8 MB
+Windows | 21 MB | 57 MB (11 MB without bundled GTK Runtime)
+macOS | 20 MB | 65 MB (9 MB without bundled GTK Runtime)
**Note:** each platform package contains two executables, one for the GUI version of Textadept,
and one for the terminal version.
@@ -1334,13 +1333,10 @@ your changes.
[`reset()`]: api.html#reset
The widgets in the GUI version of Textadept cannot be themed using Lua theme files. Instead,
-you must use [GTK Resource Files][], which are part of the GUI toolkit Textadept uses. The
-exception to this is find & replace entry font, which can be changed.
+you must use [GTK CSS][], which is part of the GUI toolkit Textadept uses. The exception to
+this is find & replace entry font, which can be changed.
-**Note:** Textadept's pre-built binaries are built for and linked against GTK 2,
-not GTK 3.
-
-[GTK Resource Files]: https://developer.gnome.org/gtk3/stable/gtk3-Resource-Files.html
+[GTK CSS]: https://docs.gtk.org/gtk3/css-overview.html
---
### Scripting
@@ -1446,13 +1442,13 @@ Linux requirements:
* [GNU C compiler][] (*gcc*) 7.1+ (circa mid-2017)
* [GNU Make][] (*make*)
-* [GTK][] 2.24+ development libraries for the GUI version
+* [GTK][] 3 development libraries for the GUI version (GTK 2.24 is also supported)
* [ncurses][](w) development libraries (wide character support) for the terminal version
* _**OR**_
* [Docker][]
**Note:** on Ubuntu for example, these dependencies would be provided by the `build-essential`,
-`libgtk2.0-dev`, `libncurses5-dev`, `libncursesw5-dev`, and `docker.io` packages.
+`libgtk-3-dev` (or `libgtk2.0-dev`), `libncurses-dev`, and `docker.io` packages.
BSD requirements:
@@ -1460,7 +1456,7 @@ BSD requirements:
* [GNU Make][] (*gmake*)
* [pkg-config][]
* [libiconv][]
-* [GTK][] 2.24+ development libraries for the GUI version
+* [GTK][] 3 development libraries for the GUI version (GTK 2.24 is also supported)
* [ncurses][](w) development libraries (wide character support) for the terminal version
Windows cross-compiling requirements: