diff --git a/docs/Doxyfile b/docs/Doxyfile
index 4c1078a0c55..df647b71d9d 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -910,8 +910,7 @@ WARN_IF_UNDOC_ENUM_VAL = NO
 # Possible values are: NO, YES, FAIL_ON_WARNINGS and FAIL_ON_WARNINGS_PRINT.
 # The default value is: NO.
 
-WARN_AS_ERROR          = NO
-# todo - ideally this will eventually become FAIL_ON_WARNINGS
+WARN_AS_ERROR = FAIL_ON_WARNINGS
 
 # The WARN_FORMAT tag determines the format of the warning messages that doxygen
 # can produce. The string should contain the $file, $line, and $text tags, which
@@ -2457,7 +2456,7 @@ INCLUDE_FILE_PATTERNS  =
 # recursively expanded use the := operator instead of the = operator.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
 
-PREDEFINED             =
+PREDEFINED = DOXYGEN
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
 # tag can be used to specify a list of macro names that should be expanded. The
diff --git a/src/platform/linux/graphics.cpp b/src/platform/linux/graphics.cpp
index 2cd81dd451e..b085ef0664b 100644
--- a/src/platform/linux/graphics.cpp
+++ b/src/platform/linux/graphics.cpp
@@ -339,6 +339,9 @@ namespace egl {
     return eglGetError() != EGL_SUCCESS;
   }
 
+  /**
+   * @memberof egl::display_t
+   */
   display_t
   make_display(std::variant<gbm::gbm_t::pointer, wl_display *, _XDisplay *> native_display) {
     constexpr auto EGL_PLATFORM_GBM_MESA = 0x31D7;
diff --git a/src/platform/linux/wayland.h b/src/platform/linux/wayland.h
index b1fd38b4350..cff16019252 100644
--- a/src/platform/linux/wayland.h
+++ b/src/platform/linux/wayland.h
@@ -17,7 +17,7 @@
  * The classes defined in this macro block should only be used by
  * cpp files whose compilation depends on SUNSHINE_BUILD_WAYLAND
  */
-#ifdef SUNSHINE_BUILD_WAYLAND
+#if defined(SUNSHINE_BUILD_WAYLAND) || defined(DOXYGEN)
 
 namespace wl {
   using display_internal_t = util::safe_ptr<wl_display, wl_display_disconnect>;
diff --git a/src/platform/windows/display_ram.cpp b/src/platform/windows/display_ram.cpp
index 0a8e1a8b8f6..8a5f7706e3d 100644
--- a/src/platform/windows/display_ram.cpp
+++ b/src/platform/windows/display_ram.cpp
@@ -370,6 +370,9 @@ namespace platf::dxgi {
     return 0;
   }
 
+  /**
+   * @memberof platf::dxgi::display_ram_t
+   */
   int
   display_ram_t::dummy_img(platf::img_t *img) {
     if (complete_img(img, true)) {
diff --git a/src/platform/windows/display_vram.cpp b/src/platform/windows/display_vram.cpp
index ae0e6407347..be144c9844f 100644
--- a/src/platform/windows/display_vram.cpp
+++ b/src/platform/windows/display_vram.cpp
@@ -1583,6 +1583,9 @@ namespace platf::dxgi {
   }
 
   // This cannot use ID3D11DeviceContext because it can be called concurrently by the encoding thread
+  /**
+   * @memberof platf::dxgi::display_vram_t
+   */
   int
   display_vram_t::dummy_img(platf::img_t *img_base) {
     return complete_img(img_base, true);