aboutsummaryrefslogtreecommitdiffstats
path: root/doc/summary.rst
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2022-05-28 23:11:51 -0400
committerDavid Robillard <d@drobilla.net>2022-05-28 23:14:05 -0400
commit4dd1eac7c46f7be257ce10cb2ce6b79939650938 (patch)
tree608f9ff2b4622b0f237d959ed112f390545c49b1 /doc/summary.rst
parent574bf1e11d73059ec5e6099e6806d919e1ac22b0 (diff)
downloadpugl-4dd1eac7c46f7be257ce10cb2ce6b79939650938.tar.gz
pugl-4dd1eac7c46f7be257ce10cb2ce6b79939650938.tar.bz2
pugl-4dd1eac7c46f7be257ce10cb2ce6b79939650938.zip
Update documentation
Diffstat (limited to 'doc/summary.rst')
-rw-r--r--doc/summary.rst16
1 files changed, 7 insertions, 9 deletions
diff --git a/doc/summary.rst b/doc/summary.rst
index f05515f..e9cdc62 100644
--- a/doc/summary.rst
+++ b/doc/summary.rst
@@ -1,21 +1,19 @@
-Pugl is an API for writing portable and embeddable GUIs.
+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.
-Compared to other libraries,
Pugl is particularly suitable for use in plugins or other loadable modules.
-There is no implicit context or static data in the library,
+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 that separates the core library from graphics backends.
-The core library is graphics agnostic,
-it implements platform support and depends only on standard system libraries.
+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.
-Graphics backends are separate so that applications only depend on the API that they use.
+Graphics backends are built as separate libraries,
+so applications can depend only on the APIs that they use.
Pugl includes graphics backends for Cairo_, OpenGL_, and Vulkan_.
-It is also possible to use some other graphics API by implementing a custom backend,
-or simply accessing the native platform handle for a window.
+Other graphics APIs can be used by implementing a custom backend.
.. _Cairo: https://www.cairographics.org/
.. _OpenGL: https://www.opengl.org/