Remove file documentation

These will not be used in the Sphinx documentation, and most were
self-explanatory and only there to make the Doxygen index look nice anyway.
Where there was actually useful information, it has been preserved as regular
comments.

20 files changed, 0 insertions, 97 deletions

diff --git a/src/implementation.c b/src/implementation.c
index 23bfbde..e842e13 100644
--- a/src/implementation.c
+++ b/src/implementation.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file implementation.c
-   @brief Platform-independent implementation.
-*/
-
 #include "implementation.h"
 
 #include "pugl/pugl.h"
diff --git a/src/implementation.h b/src/implementation.h
index 6d961a8..8c5398c 100644
--- a/src/implementation.h
+++ b/src/implementation.h
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file implementation.h
-   @brief Shared declarations for implementation.
-*/
-
 #ifndef PUGL_IMPLEMENTATION_H
 #define PUGL_IMPLEMENTATION_H
 
diff --git a/src/mac.h b/src/mac.h
index d31eb91..d17c74f 100644
--- a/src/mac.h
+++ b/src/mac.h
@@ -15,11 +15,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac.h
-   @brief Shared definitions for MacOS implementation.
-*/
-
 #ifndef PUGL_DETAIL_MAC_H
 #define PUGL_DETAIL_MAC_H
 
diff --git a/src/mac.m b/src/mac.m
index 6b8761f..bb4bf45 100644
--- a/src/mac.m
+++ b/src/mac.m
@@ -15,11 +15,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac.m
-   @brief MacOS implementation.
-*/
-
 #define GL_SILENCE_DEPRECATION 1
 
 #include "mac.h"
diff --git a/src/mac_cairo.m b/src/mac_cairo.m
index 1b5c667..9a46037 100644
--- a/src/mac_cairo.m
+++ b/src/mac_cairo.m
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac_cairo.m
-   @brief Cairo graphics backend for MacOS.
-*/
-
 #include "implementation.h"
 #include "mac.h"
 #include "stub.h"
diff --git a/src/mac_gl.m b/src/mac_gl.m
index 8a48578..b29221f 100644
--- a/src/mac_gl.m
+++ b/src/mac_gl.m
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac_gl.m
-   @brief OpenGL graphics backend for MacOS.
-*/
-
 #include "implementation.h"
 #include "mac.h"
 #include "stub.h"
diff --git a/src/mac_stub.m b/src/mac_stub.m
index 576734f..404d295 100644
--- a/src/mac_stub.m
+++ b/src/mac_stub.m
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac_stub.m
-   @brief Stub graphics backend for MacOS.
-*/
-
 #include "implementation.h"
 #include "mac.h"
 #include "stub.h"
diff --git a/src/mac_vulkan.m b/src/mac_vulkan.m
index 2d01fd4..c56346c 100644
--- a/src/mac_vulkan.m
+++ b/src/mac_vulkan.m
@@ -14,10 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file mac_vulkan.m Vulkan graphics backend for MacOS.
-*/
-
 #define VK_NO_PROTOTYPES 1
 
 #include "implementation.h"
diff --git a/src/stub.h b/src/stub.h
index acd3181..36d7364 100644
--- a/src/stub.h
+++ b/src/stub.h
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file stub.h
-   @brief Definition of generic stub backend functions.
-*/
-
 #ifndef PUGL_DETAIL_STUB_H
 #define PUGL_DETAIL_STUB_H
 
diff --git a/src/types.h b/src/types.h
index a7c029a..4e63d43 100644
--- a/src/types.h
+++ b/src/types.h
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file types.h
-   @brief Shared internal type definitions.
-*/
-
 #ifndef PUGL_DETAIL_TYPES_H
 #define PUGL_DETAIL_TYPES_H
 
diff --git a/src/win.c b/src/win.c
index 3189220..5cfd89a 100644
--- a/src/win.c
+++ b/src/win.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file win.c
-   @brief Windows implementation.
-*/
-
 #include "win.h"
 
 #include "implementation.h"
diff --git a/src/win.h b/src/win.h
index bd85cb1..bc1f763 100644
--- a/src/win.h
+++ b/src/win.h
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file win.h
-   @brief Shared definitions for Windows implementation.
-*/
-
 #ifndef PUGL_DETAIL_WIN_H
 #define PUGL_DETAIL_WIN_H
 
diff --git a/src/win_cairo.c b/src/win_cairo.c
index 5b6a738..bab8ea0 100644
--- a/src/win_cairo.c
+++ b/src/win_cairo.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file win_cairo.c
-   @brief Cairo graphics backend for Windows.
-*/
-
 #include "stub.h"
 #include "types.h"
 #include "win.h"
diff --git a/src/win_gl.c b/src/win_gl.c
index 662baef..fcf511b 100644
--- a/src/win_gl.c
+++ b/src/win_gl.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file win_gl.c
-   @brief OpenGL graphics backend for Windows.
-*/
-
 #include "stub.h"
 #include "types.h"
 #include "win.h"
diff --git a/src/win_vulkan.c b/src/win_vulkan.c
index 3d6934a..f862716 100644
--- a/src/win_vulkan.c
+++ b/src/win_vulkan.c
@@ -14,10 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file win_vulkan.c Vulkan graphics backend for Windows.
-*/
-
 #define VK_NO_PROTOTYPES 1
 
 #include "stub.h"
diff --git a/src/x11.c b/src/x11.c
index bf9331c..686e35c 100644
--- a/src/x11.c
+++ b/src/x11.c
@@ -16,11 +16,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file x11.c
-   @brief X11 implementation.
-*/
-
 #define _POSIX_C_SOURCE 199309L
 
 #include "x11.h"
diff --git a/src/x11.h b/src/x11.h
index 3705cd9..5749a19 100644
--- a/src/x11.h
+++ b/src/x11.h
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file x11.h
-   @brief Shared definitions for X11 implementation.
-*/
-
 #ifndef PUGL_DETAIL_X11_H
 #define PUGL_DETAIL_X11_H
 
diff --git a/src/x11_cairo.c b/src/x11_cairo.c
index abfabff..3147266 100644
--- a/src/x11_cairo.c
+++ b/src/x11_cairo.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file x11_cairo.c
-   @brief Cairo graphics backend for X11.
-*/
-
 #include "types.h"
 #include "x11.h"
 
diff --git a/src/x11_gl.c b/src/x11_gl.c
index 64061d1..50b37b8 100644
--- a/src/x11_gl.c
+++ b/src/x11_gl.c
@@ -14,11 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file x11_gl.c
-   @brief OpenGL graphics backend for X11.
-*/
-
 #include "stub.h"
 #include "types.h"
 #include "x11.h"
diff --git a/src/x11_vulkan.c b/src/x11_vulkan.c
index c7ae1b0..b32111c 100644
--- a/src/x11_vulkan.c
+++ b/src/x11_vulkan.c
@@ -14,10 +14,6 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
-/**
-   @file x11_vulkan.c Vulkan graphics backend for X11.
-*/
-
 #define VK_NO_PROTOTYPES 1
 
 #include "stub.h"