From fae51d4e0006e8b7be2d92b43223d98960a373e7 Mon Sep 17 00:00:00 2001
From: Luflosi <luflosi@luflosi.de>
Date: Thu, 21 Nov 2019 14:16:01 +0100
Subject: [PATCH] Cocoa: Add comments for Cocoa symbol macros

From upstream: https://github.com/glfw/glfw/commit/94cb0347abdc4e8ebf8dcf133894a764d395b84c.
---
 glfw/cocoa_platform.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/glfw/cocoa_platform.h b/glfw/cocoa_platform.h
index 0b399d02e..4af0a54ce 100644
--- a/glfw/cocoa_platform.h
+++ b/glfw/cocoa_platform.h
@@ -36,6 +36,9 @@ typedef void* id;
 typedef void* CVDisplayLinkRef;
 #endif
 
+// NOTE: Many Cocoa enum values have been renamed and we need to build across
+//       SDK versions where one is unavailable or the other deprecated
+//       We use the newer names in code and these macros to handle compatibility
 #if MAC_OS_X_VERSION_MAX_ALLOWED < 101200
  #define NSBitmapFormatAlphaNonpremultiplied NSAlphaNonpremultipliedBitmapFormat
  #define NSEventMaskAny NSAnyEventMask