From 9e07f4ce1834d8b8596f8f0813bd8dee5cbb584a Mon Sep 17 00:00:00 2001
From: Volker Hilsheimer <volker.hilsheimer@qt.io>
Date: Sun, 19 Jun 2022 12:23:47 +0200
Subject: [PATCH] Document QJniObject::construct

Added for 6.4. Not extremely useful as long as the macros that allow
the declaration of new class and type strings also being documented.

Change-Id: I9ee466fdd0aaccec1e627ceb313b5a5c17e3f3fa
Reviewed-by: BogDan Vatra <bogdan@kdab.com>
(cherry picked from commit 145bfe6054f8f7fcc32d0442e8845aa59af2fc1a)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 src/corelib/kernel/qjniobject.cpp | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/corelib/kernel/qjniobject.cpp b/src/corelib/kernel/qjniobject.cpp
index 8f21835a1fd..1b1432e4e34 100644
--- a/src/corelib/kernel/qjniobject.cpp
+++ b/src/corelib/kernel/qjniobject.cpp
@@ -761,6 +761,21 @@ QJniObject::QJniObject(jobject object)
     env->DeleteLocalRef(cls);
 }
 
+/*!
+    \fn template<typename Class, typename ...Args> static inline QJniObject construct(Args &&...args)
+    \since 6.4
+
+    Constructs an instance of the Java class that is the equivalent of \c Class and
+    returns a QJniObject containing the JNI object. The arguments in \a args are
+    passed to the Java constructor.
+
+    \code
+    QJniObject javaString = QJniObject::construct<jstring>();
+    \endcode
+
+    This function is only available if all \a args are known \l {JNI Types}.
+*/
+
 /*!
     \brief Get a JNI object from a jobject variant and do the necessary
     exception clearing and delete the local reference before returning.