Fix file documentation

16 files changed, 40 insertions, 24 deletions

diff --git a/pugl/detail/implementation.c b/pugl/detail/implementation.c
index ee9b242..57d6f37 100644
--- a/pugl/detail/implementation.c
+++ b/pugl/detail/implementation.c
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file implementation.c Platform-independent implementation.
+   @file implementation.c
+   @brief Platform-independent implementation.
 */
 
 #include "pugl/detail/implementation.h"
diff --git a/pugl/detail/implementation.h b/pugl/detail/implementation.h
index bcecd85..d56024a 100644
--- a/pugl/detail/implementation.h
+++ b/pugl/detail/implementation.h
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file implementation.h Shared declarations for implementation.
+   @file implementation.h
+   @brief Shared declarations for implementation.
 */
 
 #ifndef PUGL_DETAIL_IMPLEMENTATION_H
diff --git a/pugl/detail/mac.h b/pugl/detail/mac.h
index 2243337..f650577 100644
--- a/pugl/detail/mac.h
+++ b/pugl/detail/mac.h
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
   Copyright 2017 Hanspeter Portner <dev@open-music-kontrollers.ch>
 
   Permission to use, copy, modify, and/or distribute this software for any
@@ -16,7 +16,8 @@
 */
 
 /**
-   @file mac.h Shared definitions for MacOS implementation.
+   @file mac.h
+   @brief Shared definitions for MacOS implementation.
 */
 
 #include "pugl/pugl.h"
diff --git a/pugl/detail/mac.m b/pugl/detail/mac.m
index 0b26cb7..bf3ad65 100644
--- a/pugl/detail/mac.m
+++ b/pugl/detail/mac.m
@@ -16,7 +16,8 @@
 */
 
 /**
-   @file mac.m MacOS implementation.
+   @file mac.m
+   @brief MacOS implementation.
 */
 
 #define GL_SILENCE_DEPRECATION 1
diff --git a/pugl/detail/mac_cairo.m b/pugl/detail/mac_cairo.m
index ccce14e..2949586 100644
--- a/pugl/detail/mac_cairo.m
+++ b/pugl/detail/mac_cairo.m
@@ -1,5 +1,5 @@
 /*
-  Copyright 2019 David Robillard <http://drobilla.net>
+  Copyright 2019-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file mac_cairo.m Cairo graphics backend for MacOS.
+   @file mac_cairo.m
+   @brief Cairo graphics backend for MacOS.
 */
 
 #include "pugl/detail/implementation.h"
diff --git a/pugl/detail/mac_gl.m b/pugl/detail/mac_gl.m
index 3d55056..209d90c 100644
--- a/pugl/detail/mac_gl.m
+++ b/pugl/detail/mac_gl.m
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file mac_gl.m OpenGL graphics backend for MacOS.
+   @file mac_gl.m
+   @brief OpenGL graphics backend for MacOS.
 */
 
 #include "pugl/detail/implementation.h"
diff --git a/pugl/detail/mac_stub.m b/pugl/detail/mac_stub.m
index 71a54b8..aa2ac55 100644
--- a/pugl/detail/mac_stub.m
+++ b/pugl/detail/mac_stub.m
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file mac_stub.m Stub graphics backend for MacOS.
+   @file mac_stub.m
+   @brief Stub graphics backend for MacOS.
 */
 
 #include "pugl/detail/implementation.h"
diff --git a/pugl/detail/types.h b/pugl/detail/types.h
index eb450e1..5a4c84d 100644
--- a/pugl/detail/types.h
+++ b/pugl/detail/types.h
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file types.h Shared internal type definitions.
+   @file types.h
+   @brief Shared internal type definitions.
 */
 
 #ifndef PUGL_DETAIL_TYPES_H
diff --git a/pugl/detail/win.c b/pugl/detail/win.c
index cb9a69c..f73a432 100644
--- a/pugl/detail/win.c
+++ b/pugl/detail/win.c
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file win.c Windows implementation.
+   @file win.c
+   @brief Windows implementation.
 */
 
 #include "pugl/detail/win.h"
diff --git a/pugl/detail/win.h b/pugl/detail/win.h
index 241ea24..4cba95c 100644
--- a/pugl/detail/win.h
+++ b/pugl/detail/win.h
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file win.h Shared definitions for Windows implementation.
+   @file win.h
+   @brief Shared definitions for Windows implementation.
 */
 
 #include "pugl/detail/implementation.h"
diff --git a/pugl/detail/win_cairo.c b/pugl/detail/win_cairo.c
index a8b371f..d171129 100644
--- a/pugl/detail/win_cairo.c
+++ b/pugl/detail/win_cairo.c
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file win_cairo.c Cairo graphics backend for Windows.
+   @file win_cairo.c
+   @brief Cairo graphics backend for Windows.
 */
 
 #include "pugl/detail/types.h"
diff --git a/pugl/detail/win_gl.c b/pugl/detail/win_gl.c
index f5acfd6..9dfd129 100644
--- a/pugl/detail/win_gl.c
+++ b/pugl/detail/win_gl.c
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file win_gl.c OpenGL graphics backend for Windows.
+   @file win_gl.c
+   @brief OpenGL graphics backend for Windows.
 */
 
 #include "pugl/detail/types.h"
diff --git a/pugl/detail/x11.c b/pugl/detail/x11.c
index e3fb264..001540b 100644
--- a/pugl/detail/x11.c
+++ b/pugl/detail/x11.c
@@ -17,7 +17,8 @@
 */
 
 /**
-   @file x11.c X11 implementation.
+   @file x11.c
+   @brief X11 implementation.
 */
 
 #define _POSIX_C_SOURCE 199309L
diff --git a/pugl/detail/x11.h b/pugl/detail/x11.h
index 6b7a150..61149b9 100644
--- a/pugl/detail/x11.h
+++ b/pugl/detail/x11.h
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file x11.h Shared definitions for X11 implementation.
+   @file x11.h
+   @brief Shared definitions for X11 implementation.
 */
 
 #include "pugl/detail/types.h"
diff --git a/pugl/detail/x11_cairo.c b/pugl/detail/x11_cairo.c
index 0229d97..1661762 100644
--- a/pugl/detail/x11_cairo.c
+++ b/pugl/detail/x11_cairo.c
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file x11_cairo.c Cairo graphics backend for X11.
+   @file x11_cairo.c
+   @brief Cairo graphics backend for X11.
 */
 
 #include "pugl/detail/types.h"
diff --git a/pugl/detail/x11_gl.c b/pugl/detail/x11_gl.c
index 33a05df..7e3a69d 100644
--- a/pugl/detail/x11_gl.c
+++ b/pugl/detail/x11_gl.c
@@ -1,5 +1,5 @@
 /*
-  Copyright 2012-2019 David Robillard <http://drobilla.net>
+  Copyright 2012-2020 David Robillard <http://drobilla.net>
 
   Permission to use, copy, modify, and/or distribute this software for any
   purpose with or without fee is hereby granted, provided that the above
@@ -15,7 +15,8 @@
 */
 
 /**
-   @file x11_gl.c OpenGL graphics backend for X11.
+   @file x11_gl.c
+   @brief OpenGL graphics backend for X11.
 */
 
 #include "pugl/detail/types.h"