From 216bf7b704e52f506bf2515a21ded94f6173be1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antti=20M=C3=A4=C3=A4tt=C3=A4?= <antti.maatta@qt.io>
Date: Tue, 14 Feb 2023 08:57:36 +0200
Subject: [PATCH] Update qtrace_p.h comments
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

-Update supported types
-Add how to autogenerate metadata.

Change-Id: I1a88ff137760f7d348b841275cc00a2c63771927
Reviewed-by: Hatem ElKharashy <hatem.elkharashy@qt.io>
Reviewed-by: Tomi Korpipää <tomi.korpipaa@qt.io>
(cherry picked from commit e4562157a14dfa07a56c364203c159cada330269)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 src/corelib/global/qtrace_p.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/corelib/global/qtrace_p.h b/src/corelib/global/qtrace_p.h
index 4b96916c97f..f4e39ffe2bf 100644
--- a/src/corelib/global/qtrace_p.h
+++ b/src/corelib/global/qtrace_p.h
@@ -75,6 +75,9 @@
  *      - QByteArray
  *      - QUrl
  *      - QRect
+ *      - QRectF
+ *      - QSize
+ *      - QSizeF
  *
  * Dynamic arrays are supported using the syntax illustrated by
  * qcoreapplication_baz above.
@@ -218,6 +221,11 @@ QT_BEGIN_NAMESPACE
  *                        ...
  *                       "} QImage::Format;" \
  *                       );
+ *
+ *       If the content of enum is empty or contains keyword AUTO, then the tracepointgen tool
+ *       tries to find the enumeration from header files.
+ *
+ *       Q_TRACE_METADATA(qtcore, "ENUM { AUTO, RANGE User ... MaxUser } QEvent::Type;");
  */
 #define Q_TRACE_INSTRUMENT(provider)
 #define Q_TRACE_PARAM_REPLACE(in, out)