From e50ef7e319634093489d886b009757d6e0fb40ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tor=20Arne=20Vestb=C3=B8?= <tor.arne.vestbo@qt.io>
Date: Mon, 7 Feb 2022 11:47:22 +0100
Subject: Add warning about native interface APIs to platform headers

Those platform specific classes are not covered by our
binary/source compatibility guarantee between minor releases.

Change-Id: I2a69c7ea07feea62fdf9899839e47fc540f89c12
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
(cherry picked from commit 1f93ff529b2463316417bc227645a1f3899759ff)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 src/gui/kernel/qguiapplication_platform.h   | 9 +++++++++
 src/gui/kernel/qoffscreensurface_platform.h | 9 +++++++++
 src/gui/kernel/qopenglcontext_platform.h    | 9 +++++++++
 3 files changed, 27 insertions(+)

(limited to 'src/gui/kernel')

diff --git a/src/gui/kernel/qguiapplication_platform.h b/src/gui/kernel/qguiapplication_platform.h
index 66cdf10814..c64790c771 100644
--- a/src/gui/kernel/qguiapplication_platform.h
+++ b/src/gui/kernel/qguiapplication_platform.h
@@ -40,6 +40,15 @@
 #ifndef QGUIAPPLICATION_PLATFORM_H
 #define QGUIAPPLICATION_PLATFORM_H
 
+//
+//  W A R N I N G
+//  -------------
+//
+// This file is part of the native interface APIs. Usage of
+// this API may make your code source and binary incompatible
+// with future versions of Qt.
+//
+
 #include <QtGui/qtguiglobal.h>
 
 #include <QtCore/qnativeinterface.h>
diff --git a/src/gui/kernel/qoffscreensurface_platform.h b/src/gui/kernel/qoffscreensurface_platform.h
index b6d77491d5..3a628a3c8d 100644
--- a/src/gui/kernel/qoffscreensurface_platform.h
+++ b/src/gui/kernel/qoffscreensurface_platform.h
@@ -40,6 +40,15 @@
 #ifndef QOFFSCREENSURFACE_PLATFORM_H
 #define QOFFSCREENSURFACE_PLATFORM_H
 
+//
+//  W A R N I N G
+//  -------------
+//
+// This file is part of the native interface APIs. Usage of
+// this API may make your code source and binary incompatible
+// with future versions of Qt.
+//
+
 #include <QtGui/qtguiglobal.h>
 #include <QtGui/qoffscreensurface.h>
 #include <QtCore/qnativeinterface.h>
diff --git a/src/gui/kernel/qopenglcontext_platform.h b/src/gui/kernel/qopenglcontext_platform.h
index efe219c055..b69752c233 100644
--- a/src/gui/kernel/qopenglcontext_platform.h
+++ b/src/gui/kernel/qopenglcontext_platform.h
@@ -40,6 +40,15 @@
 #ifndef QOPENGLCONTEXT_PLATFORM_H
 #define QOPENGLCONTEXT_PLATFORM_H
 
+//
+//  W A R N I N G
+//  -------------
+//
+// This file is part of the native interface APIs. Usage of
+// this API may make your code source and binary incompatible
+// with future versions of Qt.
+//
+
 #ifndef QT_NO_OPENGL
 
 #include <QtGui/qtguiglobal.h>
-- 
cgit v1.2.3