sokol_app.h macos: add a warning comment to _sapp_macos_frame()

1 files changed, 4 insertions, 0 deletions

diff --git a/sokol_app.h b/sokol_app.h
index 422fb18b..800cece1 100644
--- a/sokol_app.h
+++ b/sokol_app.h
@@ -4712,6 +4712,10 @@ _SOKOL_PRIVATE void _sapp_macos_set_icon(const sapp_icon_desc* icon_desc, int nu
 }
 
 _SOKOL_PRIVATE void _sapp_macos_frame(void) {
+    // NOTE: DO NOT call _sapp_macos_update_dimensions() function from with the
+    // frame callback when called from MTKView's drawRect function.
+    // This will trigger a chicken-egg situation that triggers a
+    // Metal validation layer error about different render target sizes.
     _sapp_timing_measure(&_sapp.timing);
     #if defined(_SAPP_ANY_GL)
     glGetIntegerv(GL_FRAMEBUFFER_BINDING, (GLint*)&_sapp.gl.framebuffer);