summaryrefslogtreecommitdiffstats
path: root/libraries/libadwaita/README
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/libadwaita/README')
-rw-r--r--libraries/libadwaita/README29
1 files changed, 29 insertions, 0 deletions
diff --git a/libraries/libadwaita/README b/libraries/libadwaita/README
new file mode 100644
index 0000000000..4ea2fa7ae1
--- /dev/null
+++ b/libraries/libadwaita/README
@@ -0,0 +1,29 @@
+Libadwaita is a GTK4 library implementing the GNOME HIG, complementing
+GTK. Libadwaita is the successor of libhandy, but for GTK4.
+
+Among other things, libadwaita provides a set of widgets built on top of
+GTK4 as well as the "Adwaita" theme, a coloring API, and a mechanism to
+make apps linked against it fit in with a system-wide dark mode
+preference.
+
+NOTE:
+This version of libadwaita for Slackware 15.0 has been patched to
+support GTK 4.4. libadwaita upstream advertises its minimum version as
+4.5, although it does not use any C API that is not provided by version
+4.4. However, according to the libadwaita git logs, it libadwaita relies
+on some fixes from GTK 4.5+ to work 100% correctly. I have found
+libadwaita to work perfectly reasonably with GTK 4.4. Adding one patch
+to suppress a CSS runtime warning, the only issue I have run into is
+that some fonts may render as larger than the developers have intended,
+and window widths and heights are slightly larger as well.
+
+If you wish to use libadwaita as fully intended by the developers, you
+can build a local copy of GTK 4 >= 4.5 on your system.
+
+Build options:
+
+BUILDTYPE => customize build type by setting to a value recognized by
+meson; eg, BUILDTYPE=debug (defaults to 'release').
+
+GTK_DOC => set to 'true' to build API documentation; requires
+`gi-docgen` (defaults to 'false').