1 files changed, 34 insertions, 0 deletions
diff --git a/sources/pyside6/doc/extras/QtCore.ClassInfo.rst b/sources/pyside6/doc/extras/QtCore.ClassInfo.rst
new file mode 100644
index 000000000..75445e1fc
--- /dev/null
+++ b/sources/pyside6/doc/extras/QtCore.ClassInfo.rst
@@ -0,0 +1,34 @@
+.. currentmodule:: PySide6.QtCore
+.. py:decorator:: ClassInfo
+
+This decorator is used to associate extra information to the class, which is available
+using ``QObject.metaObject()``. This information is used by the
+*Qt D-Bus* and *Qt Qml* modules.
+
+The extra information takes the form of a dictionary with key and value in a literal string.
+
+The recommended usage is to provide the key/value using python keyword syntax, where the
+keyword becomes the key, and the provided string becomes the value.
+
+If the key needs to contain special characters (spaces, commas, '::', start with a number, etc),
+it is also possible to pass a python dictionary with arbitrary strings for both the key and
+value and enabling special characters in the key.
+
+.. note:: This decorator is a implementation of the Q_CLASSINFO macro.
+
+
+Example
+-------
+
+.. code-block:: python
+
+    # Recommended syntax
+    @ClassInfo(Author='PySide Team', URL='http://www.pyside.org')
+    class MyObject(QObject):
+        ...
+
+
+    # Provided to support keys not supported by Python's keyword syntax
+    @ClassInfo({'Some key text $': 'This syntax supports special characters in keys'})
+    class MyObject(QObject):
+        ...