QStyle docs: Use since enum attribute

Use the explicit [since ...] instead of plain text to mark
when new enums were introduced.

Pick-to: 6.3
Change-Id: I13655931c91a509fa64cd545b49c517e975d4cc7
Reviewed-by: Marc Mutz <marc.mutz@qt.io>

1 files changed, 16 insertions, 30 deletions

diff --git a/src/widgets/styles/qstyle.cpp b/src/widgets/styles/qstyle.cpp
index 04c110a662..59932c80d1 100644
--- a/src/widgets/styles/qstyle.cpp
+++ b/src/widgets/styles/qstyle.cpp
@@ -1504,24 +1504,19 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,
 
     \value PM_SubMenuOverlap The horizontal overlap between a submenu and its parent.
 
-    \value PM_TreeViewIndentation The indentation of items in a tree view.
-           This enum value has been introduced in Qt 5.4.
+    \value [since 5.4] PM_TreeViewIndentation The indentation of items in a tree view.
 
     \value PM_HeaderDefaultSectionSizeHorizontal The default size of sections
            in a horizontal header. This enum value has been introduced in Qt 5.5.
     \value PM_HeaderDefaultSectionSizeVertical The default size of sections
            in a vertical header. This enum value has been introduced in Qt 5.5.
 
-    \value PM_TitleBarButtonIconSize The size of button icons on a title bar.
-           This enum value has been introduced in Qt 5.8.
-    \value PM_TitleBarButtonSize The size of buttons on a title bar.
-           This enum value has been introduced in Qt 5.8.
+    \value [since 5.8] PM_TitleBarButtonIconSize The size of button icons on a title bar.
+    \value [since 5.8] PM_TitleBarButtonSize The size of buttons on a title bar.
 
-    \value PM_LineEditIconSize The default size for icons in a line edit.
-           This enum value has been introduced in Qt 6.2.
+    \value [since 6.2] PM_LineEditIconSize The default size for icons in a line edit.
 
-    \value PM_LineEditIconMargin The margin around icons in a line edit.
-           This enum value has been introduced in Qt 6.3.
+    \value [since 6.3] PM_LineEditIconMargin The margin around icons in a line edit.
 
     \value PM_CustomBase Base value for custom pixel metrics.  Custom
     values must be greater than this value.
@@ -1853,9 +1848,8 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,
     spinbox mouse clicks.
     \value SH_SpinBox_ClickAutoRepeatThreshold  Auto-repeat threshold for
     spinbox mouse clicks.
-    \value SH_SpinBox_SelectOnStep  Whether changing the value using
-    the buttons or up/down keys automatically selects the text. This enum
-    value has been introduced in Qt 6.3.
+    \value [since 6.3] SH_SpinBox_SelectOnStep  Whether changing the value using
+    the buttons or up/down keys automatically selects the text.
 
     \value SH_ToolTipLabel_Opacity  An integer indicating the opacity for
     the tip label, 0 is completely transparent, 255 is completely
@@ -2117,23 +2111,15 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,
     \value SP_MediaSeekBackward Icon indicating that media should seek backward.
     \value SP_MediaVolume Icon indicating a volume control.
     \value SP_MediaVolumeMuted Icon indicating a muted volume control.
-    \value SP_LineEditClearButton Icon for a standard clear button in a QLineEdit. This enum value was added in Qt 5.2.
-    \value SP_DialogYesToAllButton Icon for a standard YesToAll button in a QDialogButtonBox.
-        This enum value was added in Qt 5.14.
-    \value SP_DialogNoToAllButton Icon for a standard NoToAll button in a QDialogButtonBox.
-        This enum value was added in Qt 5.14.
-    \value SP_DialogSaveAllButton Icon for a standard SaveAll button in a QDialogButtonBox.
-       This enum value was added in Qt 5.14.
-    \value SP_DialogAbortButton Icon for a standard Abort button in a QDialogButtonBox.
-       This enum value was added in Qt 5.14.
-    \value SP_DialogRetryButton Icon for a standard Retry button in a QDialogButtonBox.
-       This enum value was added in Qt 5.14.
-    \value SP_DialogIgnoreButton Icon for a standard Ignore button in a QDialogButtonBox.
-       This enum value was added in Qt 5.14.
-    \value SP_RestoreDefaultsButton Icon for a standard RestoreDefaults button in a QDialogButtonBox.
-       This enum value was added in Qt 5.14.
-    \value SP_TabCloseButton Icon for the close button in the tab of a QTabBar.
-       This enum value was added in Qt 6.3.
+    \value [since 5.2] SP_LineEditClearButton Icon for a standard clear button in a QLineEdit.
+    \value [since 5.14] SP_DialogYesToAllButton Icon for a standard YesToAll button in a QDialogButtonBox.
+    \value [since 5.14] SP_DialogNoToAllButton Icon for a standard NoToAll button in a QDialogButtonBox.
+    \value [since 5.14] SP_DialogSaveAllButton Icon for a standard SaveAll button in a QDialogButtonBox.
+    \value [since 5.14] SP_DialogAbortButton Icon for a standard Abort button in a QDialogButtonBox.
+    \value [since 5.14] SP_DialogRetryButton Icon for a standard Retry button in a QDialogButtonBox.
+    \value [since 5.14] SP_DialogIgnoreButton Icon for a standard Ignore button in a QDialogButtonBox.
+    \value [since 5.14] SP_RestoreDefaultsButton Icon for a standard RestoreDefaults button in a QDialogButtonBox.
+    \value [since 6.3] SP_TabCloseButton Icon for the close button in the tab of a QTabBar.
     \value SP_CustomBase  Base value for custom standard pixmaps;
     custom values must be greater than this value.