From ef193ccaed3af6bf520157b776768e00c4d985fc Mon Sep 17 00:00:00 2001
From: Volker Hilsheimer <volker.hilsheimer@qt.io>
Date: Sun, 21 Feb 2021 00:11:55 +0100
Subject: [PATCH] Complete documentation for QStyleOptionHeaderV2

Document the isSectionDragTarget variable, and add \inmodule command.
Put code and documentation together.

Amends 4c6579eacded086ad014b0fd2432095362c1d131.

Change-Id: Id8837ca75cd6af13c8dc4c028b304b279e507ade
Reviewed-by: Christian Ehrlicher <ch.ehrlicher@gmx.de>
(cherry picked from commit 7f1dc4bb750f412482a55e4f52e29751d2b4120d)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 src/widgets/styles/qstyleoption.cpp | 55 +++++++++++++++++------------
 1 file changed, 33 insertions(+), 22 deletions(-)

diff --git a/src/widgets/styles/qstyleoption.cpp b/src/widgets/styles/qstyleoption.cpp
index 33071b07246..3e6a2b4beea 100644
--- a/src/widgets/styles/qstyleoption.cpp
+++ b/src/widgets/styles/qstyleoption.cpp
@@ -752,28 +752,6 @@ QStyleOptionHeader::QStyleOptionHeader(int version)
 {
 }
 
-/*!
-    \class QStyleOptionHeaderV2
-    \brief The QStyleOptionHeaderV2 class is used to describe the
-    parameters for drawing a header.
-*/
-
-/*!
-    Constructs a QStyleOptionHeaderV2, initializing the members
-    variables to their default values.
-*/
-QStyleOptionHeaderV2::QStyleOptionHeaderV2()
-    : QStyleOptionHeaderV2(QStyleOptionHeader::Version)
-{
-}
-
-/*!
-    \internal
-*/
-QStyleOptionHeaderV2::QStyleOptionHeaderV2(int version)
-: QStyleOptionHeader(version), textElideMode(Qt::ElideNone), isSectionDragTarget(false), unused(0)
-{}
-
 /*!
     \variable QStyleOptionHeader::orientation
     \brief the header's orientation (horizontal or vertical)
@@ -913,6 +891,30 @@ QStyleOptionHeaderV2::QStyleOptionHeaderV2(int version)
     \sa sortIndicator
 */
 
+/*!
+    \class QStyleOptionHeaderV2
+    \brief The QStyleOptionHeaderV2 class is used to describe the
+    parameters for drawing a header.
+
+    \inmodule QtWidgets
+*/
+
+/*!
+    Constructs a QStyleOptionHeaderV2, initializing the members
+    variables to their default values.
+*/
+QStyleOptionHeaderV2::QStyleOptionHeaderV2()
+    : QStyleOptionHeaderV2(QStyleOptionHeader::Version)
+{
+}
+
+/*!
+    \internal
+*/
+QStyleOptionHeaderV2::QStyleOptionHeaderV2(int version)
+: QStyleOptionHeader(version), textElideMode(Qt::ElideNone), isSectionDragTarget(false), unused(0)
+{}
+
 /*!
     \variable QStyleOptionHeaderV2::textElideMode
     \brief where ellipsis should be added for text that is too long to fit
@@ -923,6 +925,15 @@ QStyleOptionHeaderV2::QStyleOptionHeaderV2(int version)
     \sa Qt::TextElideMode
 */
 
+/*!
+    \variable QStyleOptionHeaderV2::isSectionDragTarget
+
+    \brief whether the section is the location at which a dragged section
+    will be inserted
+
+    \sa QHeaderView::setSectionsMovable
+*/
+
 /*!
     \class QStyleOptionButton
     \brief The QStyleOptionButton class is used to describe the