aboutsummaryrefslogtreecommitdiffstats
path: root/doc/summary.rst
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2023-05-23 12:04:24 -0400
committerDavid Robillard <d@drobilla.net>2023-05-23 12:55:48 -0400
commite493446eee14980e8747486300dabd02595b987a (patch)
treeed52997d4616542abe492a949568d4281280850f /doc/summary.rst
parent136a0204414f74af6d06649d0f1554234ca4eded (diff)
downloadpugl-e493446eee14980e8747486300dabd02595b987a.tar.gz
pugl-e493446eee14980e8747486300dabd02595b987a.tar.bz2
pugl-e493446eee14980e8747486300dabd02595b987a.zip
Improve introduction and deployment documentation
Diffstat (limited to 'doc/summary.rst')
-rw-r--r--doc/summary.rst21
1 files changed, 10 insertions, 11 deletions
diff --git a/doc/summary.rst b/doc/summary.rst
index e9cdc62..4f08c46 100644
--- a/doc/summary.rst
+++ b/doc/summary.rst
@@ -1,17 +1,16 @@
-Pugl is a library for writing portable and embeddable GUIs.
-Pugl is not a toolkit or framework,
-but a minimal portability layer that sets up a drawing context and delivers events.
+Pugl is a minimal portability layer for embeddable GUIs.
+It provides a drawing context and event-based main loop API,
+which can be used to create graphical applications or embedded views.
-Pugl is particularly suitable for use in plugins or other loadable modules.
-It has no implicit context or mutable static data,
-so it may be statically linked and used multiple times in the same process.
-
-Pugl has a modular design with a core library and separate graphics backends.
-The core library implements platform support and depends only on standard system libraries.
-MacOS, Windows, and X11 are currently supported as platforms.
+Pugl is particularly suitable for plugins,
+since it has no implicit context or mutable static data,
+and can be statically linked.
+The "core" library implements platform support,
+and depends only on standard system libraries.
+MacOS, Windows, and X11 are currently supported.
Graphics backends are built as separate libraries,
-so applications can depend only on the APIs that they use.
+so applications depend only on the APIs that they use.
Pugl includes graphics backends for Cairo_, OpenGL_, and Vulkan_.
Other graphics APIs can be used by implementing a custom backend.