1 files changed, 64 insertions, 0 deletions
diff --git a/src/corelib/global/qtdeprecationmarkers.qdoc b/src/corelib/global/qtdeprecationmarkers.qdoc
new file mode 100644
index 0000000000..2dd572533e
--- /dev/null
+++ b/src/corelib/global/qtdeprecationmarkers.qdoc
@@ -0,0 +1,64 @@
+// Copyright (C) 2022 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+/*!
+    \headerfile <QtDeprecationMarkers>
+    \inmodule QtCore
+    \title Qt Deprecation Macros
+
+    \brief The <QtDeprecationMarkers> header file contains deprecation helper macros.
+
+    The header file declares several macros for disabling deprecated Qt APIs
+    and enabling/disabling compiler warnings when they are used.
+*/
+
+/*!
+    \macro QT_DISABLE_DEPRECATED_BEFORE
+    \relates <QtDeprecationMarkers>
+    \deprecated [6.5] Use QT_DISABLE_DEPRECATED_UP_TO instead
+
+    \sa QT_DISABLE_DEPRECATED_UP_TO
+*/
+
+/*!
+    \macro QT_DISABLE_DEPRECATED_UP_TO
+    \relates <QtDeprecationMarkers>
+
+    This macro can be defined in the project file to disable functions
+    deprecated in a specified version of Qt or any earlier version. The default
+    version number is 5.0, meaning that functions deprecated in or before
+    Qt 5.0 will not be included.
+
+    For instance, when preparing to upgrade to Qt 6.3, after eliminating all
+    deprecation warnings, you can set \c{QT_DISABLE_DEPRECATED_UP_TO=0x060300}
+    to exclude from your builds the Qt APIs you no longer use. In your own
+    project's build configuration, this will ensure that anyone adding new calls
+    to the deprecated APIs will know about it right away. If you also build Qt
+    for yourself, including this define in your build configuration for Qt will
+    make your binaries smaller by leaving out even the implementation of the
+    deprecated APIs.
+
+    \sa QT_DEPRECATED_WARNINGS, QT_DISABLE_DEPRECATED_UP_TO
+*/
+
+/*!
+    \macro QT_DEPRECATED_WARNINGS
+    \relates <QtDeprecationMarkers>
+
+    Since Qt 5.13, this macro has no effect. In Qt 5.12 and before, if this macro
+    is defined, the compiler will generate warnings if any API declared as
+    deprecated by Qt is used.
+
+    \sa QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS
+*/
+
+/*!
+    \macro QT_NO_DEPRECATED_WARNINGS
+    \relates <QtDeprecationMarkers>
+    \since 5.13
+
+    This macro can be used to suppress deprecation warnings that would otherwise
+    be generated when using deprecated APIs.
+
+    \sa QT_DISABLE_DEPRECATED_UP_TO
+*/