Script 'mail_helper' called by obssrc
Hello community,

here is the log from the commit of package kf6-kitemmodels for openSUSE:Factory 
checked in at 2026-10-11 15:15:37
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/kf6-kitemmodels (Old)
 and      /work/SRC/openSUSE:Factory/.kf6-kitemmodels.new.3698736 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Package is "kf6-kitemmodels"

Sun Oct 11 15:15:37 2026 rev:32 rq:1383940 version:6.31.0

Changes:
--------
--- /work/SRC/openSUSE:Factory/kf6-kitemmodels/kf6-kitemmodels.changes  
2026-09-11 18:02:30.109773058 +0200
+++ 
/work/SRC/openSUSE:Factory/.kf6-kitemmodels.new.3698736/kf6-kitemmodels.changes 
    2026-10-11 15:18:14.955063571 +0200
@@ -1,0 +2,14 @@
+Wed Oct  7 06:47:28 UTC 2026 - Christophe Marin <[email protected]>
+
+- Update to 6.31.0
+  * New feature release
+  * For more details please see:
+  * https://kde.org/announcements/frameworks/6/6.31.0
+- Changes since 6.30.0:
+  * Update dependency version to 6.31.0
+  * Add more missing doc for QML interfaces
+  * ksortfilterproxymodel: Improve documentation
+  * Use ECMInstalledLibraryCheck
+  * Update version to 6.31.0
+
+-------------------------------------------------------------------

Old:
----
  kitemmodels-6.30.0.tar.xz
  kitemmodels-6.30.0.tar.xz.sig

New:
----
  kitemmodels-6.31.0.tar.xz
  kitemmodels-6.31.0.tar.xz.sig

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Other differences:
------------------
++++++ kf6-kitemmodels.spec ++++++
--- /var/tmp/diff_new_pack.k5RNiq/_old  2026-10-11 15:18:15.674093581 +0200
+++ /var/tmp/diff_new_pack.k5RNiq/_new  2026-10-11 15:18:15.677093706 +0200
@@ -19,12 +19,12 @@
 %define qt6_version 6.9.0
 
 %define rname kitemmodels
-# Full KF6 version (e.g. 6.30.0)
+# Full KF6 version (e.g. 6.31.0)
 %{!?_kf6_version: %global _kf6_version %{version}}
 %bcond_with python
 %bcond_without released
 Name:           kf6-kitemmodels
-Version:        6.30.0
+Version:        6.31.0
 Release:        0
 Summary:        Set of item models extending the Qt model-view framework
 License:        LGPL-2.1-or-later


++++++ kitemmodels-6.30.0.tar.xz -> kitemmodels-6.31.0.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/.kde-ci.yml 
new/kitemmodels-6.31.0/.kde-ci.yml
--- old/kitemmodels-6.30.0/.kde-ci.yml  2026-09-04 13:39:39.000000000 +0200
+++ new/kitemmodels-6.31.0/.kde-ci.yml  2026-10-02 15:20:29.000000000 +0200
@@ -7,3 +7,4 @@
  test-before-installing: True
  require-passing-tests-on: ['Linux', 'FreeBSD', 'Windows']
  enable-lsan: True
+ run-installed-library-check-on: ['@all']
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/CMakeLists.txt 
new/kitemmodels-6.31.0/CMakeLists.txt
--- old/kitemmodels-6.30.0/CMakeLists.txt       2026-09-04 13:39:39.000000000 
+0200
+++ new/kitemmodels-6.31.0/CMakeLists.txt       2026-10-02 15:20:29.000000000 
+0200
@@ -1,10 +1,10 @@
-cmake_minimum_required(VERSION 3.29)
+cmake_minimum_required(VERSION 3.30)
 
-set(KF_VERSION "6.30.0") # handled by release scripts
+set(KF_VERSION "6.31.0") # handled by release scripts
 project(KItemModels VERSION ${KF_VERSION})
 
 include(FeatureSummary)
-find_package(ECM 6.30.0 NO_MODULE)
+find_package(ECM 6.31.0 NO_MODULE)
 set_package_properties(ECM PROPERTIES
     TYPE REQUIRED
     DESCRIPTION "Extra CMake Modules."
@@ -27,8 +27,9 @@
 include(ECMDeprecationSettings)
 include(CMakePackageConfigHelpers)
 include(ECMGenerateQDoc)
+include(ECMInstalledLibraryCheck)
 
-set(REQUIRED_QT_VERSION 6.9.0)
+set(REQUIRED_QT_VERSION 6.10.0)
 find_package(Qt6Core ${REQUIRED_QT_VERSION} REQUIRED NO_MODULE)
 find_package(Qt6Qml ${REQUIRED_QT_VERSION} NO_MODULE)
 
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/src/core/CMakeLists.txt 
new/kitemmodels-6.31.0/src/core/CMakeLists.txt
--- old/kitemmodels-6.30.0/src/core/CMakeLists.txt      2026-09-04 
13:39:39.000000000 +0200
+++ new/kitemmodels-6.31.0/src/core/CMakeLists.txt      2026-10-02 
15:20:29.000000000 +0200
@@ -58,7 +58,7 @@
 
 target_link_libraries(KF6ItemModels PUBLIC Qt6::Core)
 
-ecm_generate_headers(KItemModels_HEADERS
+ecm_generate_headers(KItemModels_CamelCase_HEADERS
     HEADER_NAMES
         KBreadcrumbSelectionModel
         KCheckableProxyModel
@@ -78,8 +78,22 @@
 install(FILES
     ${CMAKE_CURRENT_BINARY_DIR}/kitemmodels_export.h
     ${KItemModels_HEADERS}
+    ${KItemModels_CamelCase_HEADERS}
     DESTINATION ${KDE_INSTALL_INCLUDEDIR_KF}/KItemModels
     COMPONENT Devel
 )
 
 ecm_generate_qdoc(KF6ItemModels kitemmodels.qdocconf)
+
+ecm_add_installed_library_check(KF6ItemModels
+    PACKAGE_NAME "KF6ItemModels"
+    PACKAGE_TARGET_NAMESPACE "KF6::"
+)
+
+ecm_installed_library_check_include_strings(KF6ItemModels
+    HEADERS ${KItemModels_CamelCase_HEADERS}
+)
+
+ecm_installed_library_check_version_preprocessor_macros(KF6ItemModels
+    PREFIX KITEMMODELS
+)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/src/core/knumbermodel.h 
new/kitemmodels-6.31.0/src/core/knumbermodel.h
--- old/kitemmodels-6.30.0/src/core/knumbermodel.h      2026-09-04 
13:39:39.000000000 +0200
+++ new/kitemmodels-6.31.0/src/core/knumbermodel.h      2026-10-02 
15:20:29.000000000 +0200
@@ -37,7 +37,7 @@
      *
      * The minimum value for the model
      *
-     * The default value is \c 1.0.
+     * The default value is \c 0.0.
      */
     Q_PROPERTY(qreal minimumValue READ minimumValue WRITE setMinimumValue 
NOTIFY minimumValueChanged)
     /*!
@@ -45,7 +45,7 @@
      *
      * The maximum value for the model
      *
-     * The default value is \c 1.0.
+     * The default value is \c 0.0.
      *
      * \note  If \c maximumValue is a multiple of \c stepSize added to \c 
minimumValue
      * it will be included. Otherwise it will not be reached.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' 
old/kitemmodels-6.30.0/src/qml/kdescendantsproxymodel_qml.h 
new/kitemmodels-6.31.0/src/qml/kdescendantsproxymodel_qml.h
--- old/kitemmodels-6.30.0/src/qml/kdescendantsproxymodel_qml.h 2026-09-04 
13:39:39.000000000 +0200
+++ new/kitemmodels-6.31.0/src/qml/kdescendantsproxymodel_qml.h 2026-10-02 
15:20:29.000000000 +0200
@@ -18,7 +18,10 @@
  * \qmltype KDescendantsProxyModel
  * \inqmlmodule org.kde.kitemmodels
  * \nativetype KDescendantsProxyModel
- * \brief Proxy Model for restructuring a Tree into a list.
+ * \brief Flattens a tree model into a list.
+ *
+ * Set \l model to the source tree model. Each item in the flattened list can
+ * be expanded or collapsed using its row in this proxy model.
  */
 class KDescendantsProxyModelQml : public KDescendantsProxyModel
 {
@@ -31,24 +34,74 @@
 
     /*!
      * \qmlproperty var KDescendantsProxyModel::model
+     * The source tree model to flatten.
      * \since 5.62
      */
 
     /*!
+     * \qmlproperty var KDescendantsProxyModel::sourceModel
+     * The source tree model to flatten. This inherited property refers to the
+     * same model as \l model.
+     */
+
+    /*!
      * \qmlproperty bool KDescendantsProxyModel::displayAncestorData
+     * \default false
+     * Whether display data includes the item's ancestors.
      * \since 5.62
      */
 
     /*!
-     * \qmlmethod KDescendantsProxyModel::expandChildren(int row)
+     * \qmlproperty string KDescendantsProxyModel::ancestorSeparator
+     * \default " / "
+     * The separator between ancestor values when displayAncestorData is true.
+     * \since 5.62
+     */
+
+    /*!
+     * \qmlproperty bool KDescendantsProxyModel::expandsByDefault
+     * \default true
+     * Whether all items are expanded when the source model is loaded.
+     * \since 5.74
+     */
+
+    /*!
+     * \qmlmethod QModelIndex KDescendantsProxyModel::mapToSource(QModelIndex 
proxyIndex)
+     * Returns the source model index corresponding to \a proxyIndex.
+     *
+     * \sa mapFromSource()
+     */
+
+    /*!
+     * \qmlmethod QModelIndex 
KDescendantsProxyModel::mapFromSource(QModelIndex sourceIndex)
+     * Returns the proxy model index corresponding to \a sourceIndex.
+     *
+     * \sa mapToSource()
+     */
+
+    /*!
+     * \qmlmethod QItemSelection 
KDescendantsProxyModel::mapSelectionToSource(QItemSelection proxySelection)
+     * Returns the source model selection corresponding to \a proxySelection.
+     */
+
+    /*!
+     * \qmlmethod QItemSelection 
KDescendantsProxyModel::mapSelectionFromSource(QItemSelection sourceSelection)
+     * Returns the proxy model selection corresponding to \a sourceSelection.
+     */
+
+    /*!
+     * \qmlmethod void KDescendantsProxyModel::expandChildren(int row)
+     * Expands the children of the item at \a row in this proxy model.
      */
     Q_INVOKABLE void expandChildren(int row);
     /*!
-     * \qmlmethod KDescendantsProxyModel::collapseChildren(int row)
+     * \qmlmethod void KDescendantsProxyModel::collapseChildren(int row)
+     * Collapses the children of the item at \a row in this proxy model.
      */
     Q_INVOKABLE void collapseChildren(int row);
     /*!
-     * \qmlmethod KDescendantsProxyModel::toggleChildren(int row)
+     * \qmlmethod void KDescendantsProxyModel::toggleChildren(int row)
+     * Toggles the expansion of the item at \a row in this proxy model.
      */
     Q_INVOKABLE void toggleChildren(int row);
 };
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/src/qml/krolenames.h 
new/kitemmodels-6.31.0/src/qml/krolenames.h
--- old/kitemmodels-6.30.0/src/qml/krolenames.h 2026-09-04 13:39:39.000000000 
+0200
+++ new/kitemmodels-6.31.0/src/qml/krolenames.h 2026-10-02 15:20:29.000000000 
+0200
@@ -18,12 +18,13 @@
 /*!
  * \qmltype KRoleNames
  * \inqmlmodule org.kde.kitemmodels
- * \brief A mapper between roles and role names of an attachee model.
+ * \nativetype KRoleNames
+ * \brief Maps role numbers and names of the attached model.
  *
- * KRoleNames exposes runtime-invokable methods to map from roles to role names
+ * Attach KRoleNames to a model to map from roles to role names
  * and vice-versa. It can be used to retrieve data from a model in an 
imperative
- * fashion when enum with roles is not available at runtime (i.e. not exported
- * via Q_ENUM macro) but role names are known; or just to maintain consistency
+ * fashion when a role enum is not available in QML (for example, when it is 
not
+ * exported via Q_ENUM) but role names are known; or to maintain consistency
  * with view delegates (which use role names as properties).
  *
  * \since 6.0
@@ -40,11 +41,11 @@
     ~KRoleNames() override;
 
     /*!
-     * \qmlattachedmethod KRoleNames::roleName(int role)
+     * \qmlattachedmethod string KRoleNames::roleName(int role)
      *
      * Maps role number to role name.
      *
-     * Returns an empty string if role is not found in attachee model's
+     * Returns an empty string if \a role is not found in the attached model's
      * roleNames() hash map.
      *
      * \since 6.0
@@ -52,11 +53,11 @@
     Q_INVOKABLE QByteArray roleName(int role) const;
 
     /*!
-     * \qmlattachedmethod int KRoleNames::role(var roleName)
+     * \qmlattachedmethod int KRoleNames::role(string roleName)
      *
      * Maps role name to role number.
      *
-     * Returns -1 if role name is not found in attachee model's
+     * Returns -1 if \a roleName is not found in the attached model's
      * roleNames() hash map.
      *
      * \since 6.0
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/src/qml/ksortfilterproxymodel.h 
new/kitemmodels-6.31.0/src/qml/ksortfilterproxymodel.h
--- old/kitemmodels-6.30.0/src/qml/ksortfilterproxymodel.h      2026-09-04 
13:39:39.000000000 +0200
+++ new/kitemmodels-6.31.0/src/qml/ksortfilterproxymodel.h      2026-10-02 
15:20:29.000000000 +0200
@@ -20,7 +20,34 @@
 /*!
  * \qmltype KSortFilterProxyModel
  * \inqmlmodule org.kde.kitemmodels
- * \brief Filter and sort an existing QAbstractItemModel.
+ * \nativetype QSortFilterProxyModel
+ * \brief Filter and sort an existing \l QAbstractItemModel.
+ *
+ * For example, filter and sort a list by its name role:
+ *
+ * \qml
+ * import QtQuick
+ * import org.kde.kitemmodels
+ *
+ * ListView {
+ *     width: 200
+ *     height: 200
+ *     model: KSortFilterProxyModel {
+ *         sourceModel: ListModel {
+ *             ListElement { name: "Alice" }
+ *             ListElement { name: "Bob" }
+ *             ListElement { name: "Charlie" }
+ *         }
+ *         filterRoleName: "name"
+ *         filterString: "li"
+ *         filterCaseSensitivity: Qt.CaseInsensitive
+ *         sortRoleName: "name"
+ *         sortCaseSensitivity: Qt.CaseInsensitive
+ *         sortColumn: 0
+ *     }
+ *     delegate: Text { text: name }
+ * }
+ * \endqml
  *
  * \since 5.67
  */
@@ -31,8 +58,78 @@
     Q_INTERFACES(QQmlParserStatus)
 
     /*!
+     * \qmlproperty var KSortFilterProxyModel::sourceModel
+     * The model whose rows are filtered and sorted.
+     */
+
+    /*!
+     * \qmlproperty bool KSortFilterProxyModel::dynamicSortFilter
+     * \default true
+     * Whether the proxy updates its sorting and filtering when sourceModel
+     * changes.
+     */
+
+    /*!
+     * \qmlproperty int KSortFilterProxyModel::filterKeyColumn
+     * \default 0
+     * The source column used for filtering. A value of -1 checks all columns.
+     */
+
+    /*!
+     * \qmlproperty int KSortFilterProxyModel::filterRole
+     * \default Qt.DisplayRole
+     * The source role ID used for filtering. Setting this also updates
+     * filterRoleName.
+     */
+
+    /*!
+     * \qmlproperty var KSortFilterProxyModel::filterRegularExpression
+     * The regular expression used to filter source rows. Setting filterString
+     * replaces it with a fixed-string filter.
+     */
+
+    /*!
+     * \qmlproperty Qt::CaseSensitivity 
KSortFilterProxyModel::filterCaseSensitivity
+     * \default Qt.CaseSensitive
+     * The case sensitivity used when filtering strings.
+     */
+
+    /*!
+     * \qmlproperty int KSortFilterProxyModel::sortRole
+     * \default Qt.DisplayRole
+     * The source role ID used for sorting. Setting this also updates
+     * sortRoleName.
+     */
+
+    /*!
+     * \qmlproperty Qt::CaseSensitivity 
KSortFilterProxyModel::sortCaseSensitivity
+     * \default Qt.CaseSensitive
+     * The case sensitivity used when sorting strings.
+     */
+
+    /*!
+     * \qmlproperty bool KSortFilterProxyModel::isSortLocaleAware
+     * \default false
+     * Whether string sorting follows the current locale.
+     */
+
+    /*!
+     * \qmlproperty bool KSortFilterProxyModel::recursiveFilteringEnabled
+     * \default false
+     * Whether a parent remains visible when one of its descendants matches
+     * the filter.
+     */
+
+    /*!
+     * \qmlproperty bool KSortFilterProxyModel::autoAcceptChildRows
+     * \default false
+     * Whether all children of an accepted row remain visible, even if they
+     * do not match the filter themselves.
+     */
+
+    /*!
      * \qmlproperty string KSortFilterProxyModel::filterString
-     * The string for the filter, only rows with their filterRole matching 
filterString will be displayed
+     * A fixed string used to filter rows by filterRole. Only matching rows 
are displayed.
      */
     Q_PROPERTY(QString filterString READ filterString WRITE setFilterString 
NOTIFY filterStringChanged)
     /*!
@@ -42,16 +139,16 @@
      * The callback is passed the source row, and source parent for a given 
row as arguments
      *
      * The callable's return value is evaluated as boolean to determine
-     * whether the row is accepted (true) or filtered out (false). It 
overrides the default implementation
-     * that uses filterRegExp or filterString; while filterCallback is set 
those two properties are
-     * ignored. Attempts to write a non-callable to this property are silently 
ignored, but you can set
+     * whether the row is accepted (true) or filtered out (false). It 
overrides the default row filter,
+     * so filterString and filterRegularExpression have no effect while 
filterRowCallback is set.
+     * Attempts to write a non-callable to this property are silently ignored, 
but you can set
      * it to null.
      *
-     * \code
+     * \qml
      * filterRowCallback: function(source_row, source_parent) {
      *   return sourceModel.data(sourceModel.index(source_row, 0, 
source_parent), Qt.DisplayRole) == "...";
      * };
-     * \endcode
+     * \endqml
      */
     Q_PROPERTY(QJSValue filterRowCallback READ filterRowCallback WRITE 
setFilterRowCallback NOTIFY filterRowCallbackChanged)
 
@@ -61,23 +158,23 @@
      * A JavaScript callable that can be used to perform advanced filters on a 
given column.
      * The callback is passed the source column, and source parent for a given 
column as arguments.
      *
-     * \see filterRowCallback
+     * \sa filterRowCallback
      */
     Q_PROPERTY(QJSValue filterColumnCallback READ filterColumnCallback WRITE 
setFilterColumnCallback NOTIFY filterColumnCallbackChanged)
 
     /*!
      * \qmlproperty string KSortFilterProxyModel::filterRoleName
      *
-     * The role of the sourceModel on which the filter will be applied.
-     * This can either be the numerical role value or the role name as a 
string.
+     * The name of the source role used for filtering. Use filterRole to set a
+     * numerical role ID instead.
      */
     Q_PROPERTY(QString filterRoleName READ filterRoleName WRITE 
setFilterRoleName NOTIFY filterRoleNameChanged)
 
     /*!
      * \qmlproperty string KSortFilterProxyModel::sortRoleName
      *
-     * The role of the sourceModel that will be used for sorting. if empty the 
order will be left unaltered
-     * This can either be the numerical role value or the role name as a 
string.
+     * The name of the source role used for sorting. Use sortRole to set a
+     * numerical role ID instead. An empty name leaves rows unsorted.
      */
     Q_PROPERTY(QString sortRoleName READ sortRoleName WRITE setSortRoleName 
NOTIFY sortRoleNameChanged)
 
@@ -90,10 +187,10 @@
 
     /*!
      * \qmlproperty int KSortFilterProxyModel::sortColumn
+     * \default -1
      *
      * Specify which column should be used for sorting
-     * The default value is -1.
-     * If \a sortRole is set, the default value is 0.
+     * Setting sortRoleName sorts column 0 if no column has been selected.
      */
     Q_PROPERTY(int sortColumn READ sortColumn WRITE setSortColumn NOTIFY 
sortColumnChanged)
 
@@ -133,7 +230,57 @@
 
 public Q_SLOTS:
     /*!
-     * \qmlmethod KSortFilterProxyModel::invalidateFilter
+     * \qmlmethod QModelIndex KSortFilterProxyModel::mapToSource(QModelIndex 
proxyIndex)
+     * Returns the source model index corresponding to \a proxyIndex.
+     *
+     * \sa mapFromSource()
+     */
+
+    /*!
+     * \qmlmethod QModelIndex KSortFilterProxyModel::mapFromSource(QModelIndex 
sourceIndex)
+     * Returns the proxy model index corresponding to \a sourceIndex.
+     * A filtered-out item has no corresponding proxy index.
+     *
+     * \sa mapToSource()
+     */
+
+    /*!
+     * \qmlmethod QItemSelection 
KSortFilterProxyModel::mapSelectionToSource(QItemSelection proxySelection)
+     * Returns the source model selection corresponding to \a proxySelection.
+     */
+
+    /*!
+     * \qmlmethod QItemSelection 
KSortFilterProxyModel::mapSelectionFromSource(QItemSelection sourceSelection)
+     * Returns the proxy model selection corresponding to \a sourceSelection.
+     */
+
+    /*!
+     * \qmlmethod void 
KSortFilterProxyModel::setFilterRegularExpression(string pattern)
+     * Filters rows using the regular expression \a pattern.
+     */
+
+    /*!
+     * \qmlmethod void KSortFilterProxyModel::setFilterRegularExpression(var 
regularExpression)
+     * Filters rows using \a regularExpression.
+     */
+
+    /*!
+     * \qmlmethod void KSortFilterProxyModel::setFilterWildcard(string pattern)
+     * Filters rows using the wildcard \a pattern.
+     */
+
+    /*!
+     * \qmlmethod void KSortFilterProxyModel::setFilterFixedString(string 
pattern)
+     * Filters rows using the literal string \a pattern.
+     */
+
+    /*!
+     * \qmlmethod void KSortFilterProxyModel::invalidate()
+     * Reapplies sorting and filtering to the source model.
+     */
+
+    /*!
+     * \qmlmethod void KSortFilterProxyModel::invalidateFilter()
      * Invalidates the current filtering.
      *
      * This function should be called if you are implementing custom filtering 
through
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' 
'--exclude=.svnignore' old/kitemmodels-6.30.0/src/qml/types.h 
new/kitemmodels-6.31.0/src/qml/types.h
--- old/kitemmodels-6.30.0/src/qml/types.h      2026-09-04 13:39:39.000000000 
+0200
+++ new/kitemmodels-6.31.0/src/qml/types.h      2026-10-02 15:20:29.000000000 
+0200
@@ -11,14 +11,83 @@
 #include <KColumnHeadersModel>
 #include <KNumberModel>
 
+/*!
+ * \qmltype KColumnHeadersModel
+ * \inqmlmodule org.kde.kitemmodels
+ * \nativetype KColumnHeadersModel
+ * \brief Exposes a model's horizontal column headers as a list.
+ *
+ * Each row represents one column of sourceModel. Its roles return the
+ * corresponding horizontal header data from the source model. The additional
+ * \c sort role reports sortOrder for the row selected by sortColumn; it is
+ * empty for other rows. Setting these properties does not sort the source 
model.
+ *
+ * \since 5.66
+ */
 struct KColumnHeadersModelForeign {
     Q_GADGET
     QML_NAMED_ELEMENT(KColumnHeadersModel)
     QML_FOREIGN(KColumnHeadersModel)
 };
 
+/*!
+ * \qmlproperty var KColumnHeadersModel::sourceModel
+ * The model whose horizontal column headers are exposed as rows.
+ */
+
+/*!
+ * \qmlproperty int KColumnHeadersModel::sortColumn
+ * \default -1
+ * The column whose \c sort role reports sortOrder. A value of -1 leaves the
+ * \c sort role empty for every row.
+ */
+
+/*!
+ * \qmlproperty Qt::SortOrder KColumnHeadersModel::sortOrder
+ * \default Qt.AscendingOrder
+ * The order reported by the \c sort role for sortColumn.
+ */
+
+/*!
+ * \qmltype KNumberModel
+ * \inqmlmodule org.kde.kitemmodels
+ * \nativetype KNumberModel
+ * \brief Provides a list of numbers at a fixed interval.
+ *
+ * The \c display role contains a locale-formatted string, and the \c value
+ * role contains the number. The list starts at minimumValue and advances by
+ * stepSize toward maximumValue. The end value is included only when a step
+ * reaches it exactly.
+ *
+ * \since 5.65
+ */
 struct KNumberModelForeign {
     Q_GADGET
     QML_NAMED_ELEMENT(KNumberModel)
     QML_FOREIGN(KNumberModel)
 };
+
+/*!
+ * \qmlproperty real KNumberModel::minimumValue
+ * \default 0.0
+ * The first value in the model.
+ */
+
+/*!
+ * \qmlproperty real KNumberModel::maximumValue
+ * \default 0.0
+ * The upper bound for values in the model. The model includes this value only
+ * when it falls on a step from minimumValue.
+ */
+
+/*!
+ * \qmlproperty real KNumberModel::stepSize
+ * \default 1.0
+ * The interval between values.
+ */
+
+/*!
+ * \qmlproperty QLocale::NumberOptions KNumberModel::formattingOptions
+ * \default QLocale::DefaultNumberOptions
+ * The \l QLocale number formatting options used by the \c display role.
+ */

Reply via email to