aboutsummaryrefslogtreecommitdiffstats
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2023-09-23Format meson.build files with muonDavid Robillard2-16/+44
The less time wasted with manual code formatting, the better.
2023-05-27Use files() for headers in mesonDavid Robillard2-2/+2
2023-05-27Remove dead meson codeDavid Robillard2-10/+0
2023-05-27Separate pugl/glu.h from pugl/gl.hDavid Robillard2-1/+3
The GLU library is often shipped in a separate package, so it's possible to have a system with GL, but no GLU headers. Since use of GLU isn't universal (none of the examples use it), its inclusion can break builds that would otherwise work. So, move it to a separate wrapper header so this can be avoided.
2023-05-23Improve introduction and deployment documentationDavid Robillard3-23/+64
2023-01-20Replace duplicated dox_to_sphinx script with sphinxygen dependencyDavid Robillard5-9/+24
2023-01-14Allow applications to specify the Vulkan library pathDavid Robillard1-1/+1
I don't know if vendoring the Vulkan library is appropriate, but regardless, this allows applications to set the name to whatever they want, or specify an absolute path, just in case the standard value baked into Pugl isn't the right one in some situation.
2023-01-14Add general string hint interfaceDavid Robillard2-3/+3
This replaces the window title and class name APIs with a more general one that can be easily extended to other things, like icon names, more detailed application hints, and so on.
2023-01-08Fix Doxygen errorsDavid Robillard1-2/+4
2023-01-08Prepare OpenGL context flags for OpenGL ES supportDavid Robillard1-1/+3
2023-01-07Rename create/destroy events to realize/unrealizeDavid Robillard3-8/+8
As evidence that this was confusing, the documentation for these was an outright lie, and I've burned quite a bit of time in the past few days trying to rework things based around that flawed understanding. These names make it clear what these events actually are. If we need actual create/destroy events with a broader scope, they'll have to be added, but I suspect those aren't actually useful anyway.
2023-01-04Clean up licensing metadataDavid Robillard3-0/+9
2023-01-03Use globally unique names for documentation groupsDavid Robillard3-4/+4
This becomes important when the documentation is included in larger projects.
2023-01-02Reorganize documentationDavid Robillard1-3/+10
2022-11-24Add docs_cpp configuration option and disable it by defaultDavid Robillard1-1/+4
Doxygen is now giving parse errors in most places where @copydoc is used. Unfortunately, this setup for bindings with documentation is generally really flaky, and I probably need to figure something else out anyway.
2022-11-24Use 0BSD for trivial "public domain intent" thingsDavid Robillard8-8/+8
2022-10-07Clean up meson definitionsDavid Robillard7-32/+53
2022-07-07Fix documentation build as a subprojectDavid Robillard3-13/+9
2022-07-07Fix outdated reference in documentationDavid Robillard1-2/+2
2022-06-08Use consistent terminology for native viewsDavid Robillard1-2/+2
On MacOS in particular, views and windows are entirely different concepts, so confusing them... confuses things. This was the last holdover in the API that used the old "native window".
2022-05-28Update documentationDavid Robillard3-20/+22
2022-05-28Remove redundant program checksDavid Robillard2-4/+0
2022-05-23Add rich clipboard supportDavid Robillard3-1/+121
This implements a more powerful protocol for working with clipboards, which supports datatype negotiation, and fixes various issues by mapping more directly to how things work on X11.
2022-05-21Use consistent integer types for view positions and sizesDavid Robillard1-0/+1
Actual window sizes and positions fit easily in a 16-bit integer. So, we use that in "representation contexts" like events. This makes structures smaller, and allows the values to be converted to float, double, or integer without casting (since any int16_t or uint16_t value can fit in them without loss). Setter APIs use native integers for convenience, to avoid casting hassles when doing arithmetic. Ranges are checked at runtime.
2022-05-21Add a uniform API for setting size hintsDavid Robillard1-0/+1
This collapses many functions into one, which makes the API more easily extensible and reduces code size.
2021-12-17Adopt REUSE machine-readable licensing standardDavid Robillard8-0/+24
See https://reuse.software/ for details.
2021-05-25Rename event structs in a more readable styleDavid Robillard3-10/+10
Aside from reading more naturally, this avoids clashes with types that are not events, like PuglEventFlags. This is also more consistent with the C++ bindings, where "EventExpose" would be quite strange, for example. Apologies for the noise. Aliases to the old names will be preserved in the deprecated API like other things for a short while.
2021-05-24Fix documentation build as a subprojectDavid Robillard7-17/+34
2021-05-24Consistently refer to C++ as "cpp" and fix installationDavid Robillard3-4/+4
2021-01-10Show installation paths in configuration summaryDavid Robillard1-5/+0
2021-01-08Switch to MesonDavid Robillard13-109/+167
2021-01-06Simplify documentation structure and use LV2 themeDavid Robillard14-300/+73
2021-01-06Split overview into multiple documentsDavid Robillard14-968/+1062
2021-01-06Make Doxygen warnings errorsDavid Robillard2-2/+2
2021-01-06Remove old unused main pageDavid Robillard1-77/+0
2021-01-02Add PUGL_CONST_APIDavid Robillard2-2/+2
Just a convenience macro to make declarations a little more readable.
2020-11-26Generate documentation with SphinxDavid Robillard21-3542/+1517
2020-11-25Rename puglShowWindow and puglHideWindow to puglShow an puglHideDavid Robillard1-1/+1
These names were confusing because a view is not necessarily a window. Since there's no room for ambiguity here, simply drop the superfluous word.
2020-10-30Clean up installed man pagesDavid Robillard2-3/+3
2020-10-30Move C++ bindings to a separate directoryDavid Robillard1-0/+1
This seemed messy and potentially misleading for what is fundamentally a C++ library. It also makes it possible to set separate clang-tidy and clang-format settings for each to avoid "tainting" the C settings, though currently the headers use the same checks.
2020-10-26Add Vulkan backendsDavid Robillard1-1/+1
2020-10-24Remove unused Doxygen configuration keysDavid Robillard1-40/+0
These are relatively new and cause warnings on older systems.
2020-10-21Simplify documentation structureDavid Robillard1-17/+21
2020-10-21Simplify documentation styleDavid Robillard1-9/+2
2020-10-21Move includes to a separate directoryDavid Robillard1-1/+1
This is more conventional and directories named "include" are specially understood by some tooling like clang-tidy.
2020-05-16Fix file documentationDavid Robillard1-1/+1
2020-05-16Remove deprecated Doxygen configuration valuesDavid Robillard1-7/+1
2020-04-03Rewrite C++ bindingsDavid Robillard4-21/+77
2020-04-01Increase space above field documentation slightlyDavid Robillard1-1/+1
2020-04-01Replace puglShowWindow() with puglRealize()David Robillard1-1/+1