aboutsummaryrefslogtreecommitdiff
path: root/3rdparty/glfw/source/docs/main.dox
diff options
context:
space:
mode:
authorhnOsmium0001 <[email protected]>2022-04-03 18:36:23 -0700
committerhnOsmium0001 <[email protected]>2022-04-03 18:36:23 -0700
commitebd42760caaec8330a3c028f31adc7bc0b339d16 (patch)
treea1a01147b78f10f467b757ecee7056d09d594230 /3rdparty/glfw/source/docs/main.dox
Initial commit
Diffstat (limited to '3rdparty/glfw/source/docs/main.dox')
-rw-r--r--3rdparty/glfw/source/docs/main.dox46
1 files changed, 46 insertions, 0 deletions
diff --git a/3rdparty/glfw/source/docs/main.dox b/3rdparty/glfw/source/docs/main.dox
new file mode 100644
index 0000000..995c2f5
--- /dev/null
+++ b/3rdparty/glfw/source/docs/main.dox
@@ -0,0 +1,46 @@
+/*!
+
+@mainpage notitle
+
+@section main_intro Introduction
+
+GLFW is a free, Open Source, multi-platform library for OpenGL, OpenGL ES and
+Vulkan application development. It provides a simple, platform-independent API
+for creating windows, contexts and surfaces, reading input, handling events, etc.
+
+@ref news_34 list new features, caveats and deprecations.
+
+@ref quick_guide is a guide for users new to GLFW. It takes you through how to
+write a small but complete program.
+
+There are guides for each section of the API:
+
+ - @ref intro_guide – initialization, error handling and high-level design
+ - @ref window_guide – creating and working with windows and framebuffers
+ - @ref context_guide – working with OpenGL and OpenGL ES contexts
+ - @ref vulkan_guide - working with Vulkan objects and extensions
+ - @ref monitor_guide – enumerating and working with monitors and video modes
+ - @ref input_guide – receiving events, polling and processing input
+
+Once you have written a program, see @ref compile_guide and @ref build_guide.
+
+The [reference documentation](modules.html) provides more detailed information
+about specific functions.
+
+@ref moving_guide explains what has changed and how to update existing code to
+use the new API.
+
+There is a section on @ref guarantees_limitations for pointer lifetimes,
+reentrancy, thread safety, event order and backward and forward compatibility.
+
+The [FAQ](https://www.glfw.org/faq.html) answers many common questions about the
+design, implementation and use of GLFW.
+
+Finally, @ref compat_guide explains what APIs, standards and protocols GLFW uses
+and what happens when they are not present on a given machine.
+
+This documentation was generated with Doxygen. The sources for it are available
+in both the [source distribution](https://www.glfw.org/download.html) and
+[GitHub repository](https://github.com/glfw/glfw).
+
+*/