Script 'mail_helper' called by obssrc
Hello community,
here is the log from the commit of package kf6-kdbusaddons for
openSUSE:Leap:16.0 checked in at 2025-08-07 19:22:06
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Leap:16.0/kf6-kdbusaddons (Old)
and /work/SRC/openSUSE:Leap:16.0/.kf6-kdbusaddons.new.1085 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "kf6-kdbusaddons"
Thu Aug 7 19:22:06 2025 rev:4 rq:1292762 version:6.16.0
Changes:
--------
--- /work/SRC/openSUSE:Leap:16.0/kf6-kdbusaddons/kf6-kdbusaddons.changes
2025-04-23 10:11:33.619521167 +0200
+++
/work/SRC/openSUSE:Leap:16.0/.kf6-kdbusaddons.new.1085/kf6-kdbusaddons.changes
2025-08-07 19:26:43.290570971 +0200
@@ -1,0 +2,38 @@
+Mon Jul 7 07:24:37 UTC 2025 - Christophe Marin <christo...@krop.fr>
+
+- Update to 6.16.0
+ * New feature release
+ * For more details please see:
+ * https://kde.org/announcements/frameworks/6/6.16.0
+- Changes since 6.15.0:
+ * Update dependency version to 6.16.0
+ * Update version to 6.16.0
+
+-------------------------------------------------------------------
+Mon Jun 9 20:29:35 UTC 2025 - Christophe Marin <christo...@krop.fr>
+
+- Update to 6.15.0
+ * New feature release
+ * For more details please see:
+ * https://kde.org/announcements/frameworks/6/6.15.0
+- Changes since 6.14.0:
+ * Update dependency version to 6.15.0
+ * Add tags file to documentation
+ * Add missing qhp project
+ * Add landing page for QDoc
+ * Port API documentation to QDoc syntax
+ * Update version to 6.15.0
+- Replace _kf6_bugfix_version usage
+
+-------------------------------------------------------------------
+Sun May 4 19:05:19 UTC 2025 - Christophe Marin <christo...@krop.fr>
+
+- Update to 6.14.0
+ * New feature release
+ * For more details please see:
+ * https://kde.org/announcements/frameworks/6/6.14.0
+- Changes since 6.13.0:
+ * Update dependency version to 6.14.0
+ * Update version to 6.14.0
+
+-------------------------------------------------------------------
Old:
----
kdbusaddons-6.13.0.tar.xz
kdbusaddons-6.13.0.tar.xz.sig
New:
----
kdbusaddons-6.16.0.tar.xz
kdbusaddons-6.16.0.tar.xz.sig
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ kf6-kdbusaddons.spec ++++++
--- /var/tmp/diff_new_pack.yZWXHP/_old 2025-08-07 19:26:43.566582456 +0200
+++ /var/tmp/diff_new_pack.yZWXHP/_new 2025-08-07 19:26:43.570582623 +0200
@@ -16,16 +16,14 @@
#
-%define qt6_version 6.7.0
+%define qt6_version 6.8.0
%define rname kdbusaddons
-# Full KF6 version (e.g. 6.13.0)
+# Full KF6 version (e.g. 6.16.0)
%{!?_kf6_version: %global _kf6_version %{version}}
-# Last major and minor KF6 version (e.g. 6.0)
-%{!?_kf6_bugfix_version: %define _kf6_bugfix_version %(echo %{_kf6_version} |
awk -F. '{print $1"."$2}')}
%bcond_without released
Name: kf6-kdbusaddons
-Version: 6.13.0
+Version: 6.16.0
Release: 0
Summary: Convenience classes for QtDBus
License: LGPL-2.1-or-later
@@ -35,9 +33,8 @@
Source1: %{rname}-%{version}.tar.xz.sig
Source2: frameworks.keyring
%endif
-BuildRequires: doxygen
BuildRequires: fdupes
-BuildRequires: kf6-extra-cmake-modules >= %{_kf6_bugfix_version}
+BuildRequires: kf6-extra-cmake-modules >= %{_kf6_version}
BuildRequires: qt6-gui-private-devel >= %{qt6_version}
BuildRequires: cmake(Qt6DBus) >= %{qt6_version}
BuildRequires: cmake(Qt6Gui) >= %{qt6_version}
@@ -80,7 +77,7 @@
%autosetup -p1 -n %{rname}-%{version}
%build
-%cmake_kf6 -DBUILD_QCH:BOOL=TRUE
+%cmake_kf6
%kf6_build
@@ -106,7 +103,6 @@
%{_kf6_bindir}/kquitapp6
%files devel
-%doc %{_kf6_qchdir}/KF6DBusAddons.*
%{_kf6_includedir}/KDBusAddons/
%{_kf6_cmakedir}/KF6DBusAddons/
%{_kf6_libdir}/libKF6DBusAddons.so
++++++ kdbusaddons-6.13.0.tar.xz -> kdbusaddons-6.16.0.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/CMakeLists.txt
new/kdbusaddons-6.16.0/CMakeLists.txt
--- old/kdbusaddons-6.13.0/CMakeLists.txt 2025-04-04 16:00:04.000000000
+0200
+++ new/kdbusaddons-6.16.0/CMakeLists.txt 2025-07-04 17:11:37.000000000
+0200
@@ -1,10 +1,10 @@
cmake_minimum_required(VERSION 3.16)
-set(KF_VERSION "6.13.0") # handled by release scripts
+set(KF_VERSION "6.16.0") # handled by release scripts
project(KDBusAddons VERSION ${KF_VERSION})
include(FeatureSummary)
-find_package(ECM 6.13.0 NO_MODULE)
+find_package(ECM 6.16.0 NO_MODULE)
set_package_properties(ECM PROPERTIES TYPE REQUIRED DESCRIPTION "Extra CMake
Modules." URL "https://commits.kde.org/extra-cmake-modules";)
feature_summary(WHAT REQUIRED_PACKAGES_NOT_FOUND
FATAL_ON_MISSING_REQUIRED_PACKAGES)
@@ -18,7 +18,7 @@
include(ECMQtDeclareLoggingCategory)
include(ECMDeprecationSettings)
-set(REQUIRED_QT_VERSION 6.6.0)
+set(REQUIRED_QT_VERSION 6.7.0)
find_package(Qt6DBus ${REQUIRED_QT_VERSION} REQUIRED NO_MODULE)
find_package(Qt6Gui ${REQUIRED_QT_VERSION} CONFIG) # qtx11extras_p.h
@@ -32,7 +32,7 @@
include(ECMGenerateHeaders)
include(ECMGenerateExportHeader)
include(ECMMarkNonGuiExecutable)
-include(ECMAddQch)
+include(ECMGenerateQDoc)
include(ECMPoQmTools)
@@ -56,9 +56,6 @@
set(EXCLUDE_DEPRECATED_BEFORE_AND_AT 0 CACHE STRING "Control the range of
deprecated API excluded from the build [default=0].")
-option(BUILD_QCH "Build API documentation in QCH format (for e.g. Qt
Assistant, Qt Creator & KDevelop)" OFF)
-add_feature_info(QCH ${BUILD_QCH} "API documentation in QCH format (for e.g.
Qt Assistant, Qt Creator & KDevelop)")
-
ecm_set_disabled_deprecation_versions(
QT 6.9.0
)
@@ -74,16 +71,6 @@
# create a Config.cmake and a ConfigVersion.cmake file and install them
set(CMAKECONFIG_INSTALL_DIR "${KDE_INSTALL_CMAKEPACKAGEDIR}/KF6DBusAddons")
-if (BUILD_QCH)
- ecm_install_qch_export(
- TARGETS KF6DBusAddons_QCH
- FILE KF6DBusAddonsQchTargets.cmake
- DESTINATION "${CMAKECONFIG_INSTALL_DIR}"
- COMPONENT Devel
- )
- set(PACKAGE_INCLUDE_QCHTARGETS
"include(\"\${CMAKE_CURRENT_LIST_DIR}/KF6DBusAddonsQchTargets.cmake\")")
-endif()
-
configure_package_config_file("${CMAKE_CURRENT_SOURCE_DIR}/KF6DBusAddonsConfig.cmake.in"
"${CMAKE_CURRENT_BINARY_DIR}/KF6DBusAddonsConfig.cmake"
INSTALL_DESTINATION ${CMAKECONFIG_INSTALL_DIR}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/KF6DBusAddonsConfig.cmake.in
new/kdbusaddons-6.16.0/KF6DBusAddonsConfig.cmake.in
--- old/kdbusaddons-6.13.0/KF6DBusAddonsConfig.cmake.in 2025-04-04
16:00:04.000000000 +0200
+++ new/kdbusaddons-6.16.0/KF6DBusAddonsConfig.cmake.in 2025-07-04
17:11:37.000000000 +0200
@@ -12,5 +12,4 @@
endif()
include("${CMAKE_CURRENT_LIST_DIR}/KF6DBusAddonsTargets.cmake")
-@PACKAGE_INCLUDE_QCHTARGETS@
include("${CMAKE_CURRENT_LIST_DIR}/KF6DBusAddonsMacros.cmake")
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/poqm/es/kdbusaddons6_qt.po
new/kdbusaddons-6.16.0/poqm/es/kdbusaddons6_qt.po
--- old/kdbusaddons-6.13.0/poqm/es/kdbusaddons6_qt.po 2025-04-04
16:00:04.000000000 +0200
+++ new/kdbusaddons-6.16.0/poqm/es/kdbusaddons6_qt.po 2025-07-04
17:11:37.000000000 +0200
@@ -1,8 +1,13 @@
-# Eloy Cuadra <ecua...@eloihr.net>, 2014.
+# Spanish translations for kdbusaddons6_qt.po package.
+# Copyright (C) 2014-2025 This file is copyright:
+# This file is distributed under the same license as the kdbusaddons package.
+#
+# SPDX-FileCopyrightText: 2014, 2025 Eloy Cuadra <ecua...@eloihr.net>
msgid ""
msgstr ""
-"Project-Id-Version: \n"
-"PO-Revision-Date: 2014-03-29 17:46+0100\n"
+"Project-Id-Version: kdbusaddons6_qt\n"
+"Report-Msgid-Bugs-To: https://bugs.kde.org\n";
+"PO-Revision-Date: 2025-05-12 13:44+0100\n"
"Last-Translator: Eloy Cuadra <ecua...@eloihr.net>\n"
"Language-Team: Spanish <kde-l10n...@kde.org>\n"
"Language: es\n"
@@ -11,7 +16,7 @@
"Content-Transfer-Encoding: 8bit\n"
"X-Qt-Contexts: true\n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
-"X-Generator: Lokalize 1.5\n"
+"X-Generator: Lokalize 25.04.1\n"
#: tools/kquitapp/kquitapp.cpp:19
msgctxt "main|"
@@ -28,7 +33,7 @@
#: tools/kquitapp/kquitapp.cpp:24
msgctxt "main|"
msgid "Path in the D-Bus interface to use"
-msgstr "Ruta a usar en la interfaz de D-Bus"
+msgstr "Ruta que se va a usar en la interfaz de D-Bus"
#: tools/kquitapp/kquitapp.cpp:27
msgctxt "main|"
@@ -50,7 +55,6 @@
"\n"
" %2 : %3"
msgstr ""
-"Ha ocurrido un fallo al salir de la aplicación %1. El error generado ha "
-"sido:\n"
+"No se ha podido salir de la aplicación %1. El error generado ha sido:\n"
"\n"
" %2 : %3"
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/CMakeLists.txt
new/kdbusaddons-6.16.0/src/CMakeLists.txt
--- old/kdbusaddons-6.13.0/src/CMakeLists.txt 2025-04-04 16:00:04.000000000
+0200
+++ new/kdbusaddons-6.16.0/src/CMakeLists.txt 2025-07-04 17:11:37.000000000
+0200
@@ -3,6 +3,8 @@
add_library(KF6DBusAddons)
add_library(KF6::DBusAddons ALIAS KF6DBusAddons)
+ecm_generate_qdoc(KF6DBusAddons kdbusaddons.qdocconf)
+
set_target_properties(KF6DBusAddons PROPERTIES
VERSION ${KDBUSADDONS_VERSION}
SOVERSION ${KDBUSADDONS_SOVERSION}
@@ -91,28 +93,3 @@
FILE kdbusaddons.categories
DESTINATION ${KDE_INSTALL_LOGGINGCATEGORIESDIR}
)
-
-if(BUILD_QCH)
- ecm_add_qch(
- KF6DBusAddons_QCH
- NAME KDBusAddons
- BASE_NAME KF6DBusAddons
- VERSION ${KF_VERSION}
- ORG_DOMAIN org.kde
- SOURCES # using only public headers, to cover only public API
- ${KDBusAddons_HEADERS}
- MD_MAINPAGE "${CMAKE_SOURCE_DIR}/README.md"
- LINK_QCHS
- Qt6DBus_QCH
- Qt6Core_QCH
- INCLUDE_DIRS
- ${CMAKE_CURRENT_BINARY_DIR}
- BLANK_MACROS
- KDBUSADDONS_EXPORT
- KDBUSADDONS_DEPRECATED
- TAGFILE_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
- QCH_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
- COMPONENT Devel
- )
-endif()
-
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kdbusaddons-index.qdoc
new/kdbusaddons-6.16.0/src/kdbusaddons-index.qdoc
--- old/kdbusaddons-6.13.0/src/kdbusaddons-index.qdoc 1970-01-01
01:00:00.000000000 +0100
+++ new/kdbusaddons-6.16.0/src/kdbusaddons-index.qdoc 2025-07-04
17:11:37.000000000 +0200
@@ -0,0 +1,20 @@
+/*!
+ \page kdbusaddons-index.html
+ \title KDBusAddons
+
+ KDBusAddons provides convenience classes on top of QtDBus, as well as an
API to create KDED modules.
+
+ \section1 Using the Module
+
+ \include {module-use.qdocinc} {using the c++ api}
+
+ \section2 Building with CMake
+
+ \include {module-use.qdocinc} {building with cmake} {KF6} {DBusAddons}
{KF6::DBusAddons}
+
+ \section1 API Reference
+
+ \list
+ \li \l{KDBusAddons C++ Classes}
+ \endlist
+*/
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kdbusaddons.qdoc
new/kdbusaddons-6.16.0/src/kdbusaddons.qdoc
--- old/kdbusaddons-6.13.0/src/kdbusaddons.qdoc 1970-01-01 01:00:00.000000000
+0100
+++ new/kdbusaddons-6.16.0/src/kdbusaddons.qdoc 2025-07-04 17:11:37.000000000
+0200
@@ -0,0 +1,9 @@
+/*!
+ \module KDBusAddons
+ \title KDBusAddons C++ Classes
+ \ingroup modules
+ \cmakepackage KF6
+ \cmakecomponent DBusAddons
+
+ \brief KDBusAddons provides convenience classes on top of QtDBus, as well
as an API to create KDED modules.
+*/
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kdbusaddons.qdocconf
new/kdbusaddons-6.16.0/src/kdbusaddons.qdocconf
--- old/kdbusaddons-6.13.0/src/kdbusaddons.qdocconf 1970-01-01
01:00:00.000000000 +0100
+++ new/kdbusaddons-6.16.0/src/kdbusaddons.qdocconf 2025-07-04
17:11:37.000000000 +0200
@@ -0,0 +1,31 @@
+include($KDE_DOCS/global/qt-module-defaults.qdocconf)
+
+project = KDBusAddons
+description = KDBusAddons provides convenience classes on top of QtDBus, as
well as an API to create KDED modules.
+
+documentationinheaders = true
+
+headerdirs += .
+sourcedirs += .
+
+outputformats = HTML
+
+navigation.landingpage = "KDBusAddons"
+
+depends += qtcore qtgui qttools
+
+qhp.projects = KDBusAddons
+
+qhp.KDBusAddons.file = kdbusaddons.qhp
+qhp.KDBusAddons.namespace = org.kde.kdbusaddons.$QT_VERSION_TAG
+qhp.KDBusAddons.virtualFolder = kdbusaddons
+qhp.KDBusAddons.indexTitle = KDBusAddons
+qhp.KDBusAddons.indexRoot =
+
+qhp.KDBusAddons.subprojects = classes
+qhp.KDBusAddons.subprojects.classes.title = C++ Classes
+qhp.KDBusAddons.subprojects.classes.indexTitle = KDBusAddons C++ Classes
+qhp.KDBusAddons.subprojects.classes.selectors = class fake:headerfile
+qhp.KDBusAddons.subprojects.classes.sortPages = true
+
+tagfile = kdbusaddons.tags
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kdbusservice.h
new/kdbusaddons-6.16.0/src/kdbusservice.h
--- old/kdbusaddons-6.13.0/src/kdbusservice.h 2025-04-04 16:00:04.000000000
+0200
+++ new/kdbusaddons-6.16.0/src/kdbusservice.h 2025-07-04 17:11:37.000000000
+0200
@@ -18,43 +18,42 @@
class KDBusServicePrivate;
-/**
- * @class KDBusService kdbusservice.h <KDBusService>
- *
- * KDBusService takes care of registering the current process with D-Bus.
+/*!
+ * \class KDBusService
+ * \inmodule KDBusAddons
+ * \brief KDBusService takes care of registering the current process with
D-Bus.
*
* This registers the application at a predictable location on D-Bus, registers
* the QCoreApplication (or subclass) object at /MainApplication, and
* assists in implementing the application side of D-Bus activation from
- * the <a
- *
href="http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html";>Desktop
- * Entry Specification</a>.
+ * the \l
{http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html}
+ * {Desktop Entry Specification}.
*
* An application can either work in Multiple mode or Unique mode.
*
* In Multiple mode, the application can be launched many times. The service
* name in the D-Bus registration will contain the PID to distinguish the
- * various instances; for example: <tt>org.kde.konqueror-12345</tt>.
+ * various instances; for example: \e org.kde.konqueror-12345.
*
* In Unique mode, only one instance of this application can ever run.
* The first instance of the application registers with D-Bus without the PID,
* and any attempt to run the application again will cause the
* activateRequested() signal to be emitted in the already-running instance;
the
* duplicate instance will then quit. The exit value can be set by the already
- * running instance with setExitValue(), the default value is @c 0.
+ * running instance with setExitValue(), the default value is \c 0.
*
* Unique-mode applications should usually delay parsing command-line arguments
* until after creating a KDBusService object; that way they know they are the
* original instance of the application.
*
- * Applications that set the D-Bus activation entry (DBusActivatable=true) in
+ * Applications that set the D-Bus activation entry (\c DBusActivatable=true)
in
* their desktop files will use Unique mode and connect to the signals emitted
* by this class.
* Note that the D-Bus interface is exported for Multiple-mode applications as
* well, so it also makes sense for such applications to connect to the signals
* emitted by this class.
*
- * @note In order to avoid a race, the application should export its objects to
+ * \note In order to avoid a race, the application should export its objects to
* D-Bus before allowing the event loop to run (for example, by calling
* QCoreApplication::exec()). Otherwise, the application will appear on the
bus
* before its objects are accessible via D-Bus, which could be a problem for
@@ -63,89 +62,77 @@
*
* Example usage:
*
- * @code
- QApplication app(argc, argv);
- app.setApplicationName("kuiserver");
- app.setOrganizationDomain("kde.org");
- // Create your D-Bus objects here
- // ...
- KDBusService service(KDBusService::Unique);
- // If this point is reached, this is the only running instance
- // i.e. org.kde.kuiserver has been registered
- return app.exec();
- * @endcode
+ * \code
+ * QApplication app(argc, argv);
+ * app.setApplicationName("kuiserver");
+ * app.setOrganizationDomain("kde.org");
+ * // Create your D-Bus objects here
+ * // ...
+ * KDBusService service(KDBusService::Unique);
+ * // If this point is reached, this is the only running instance
+ * // i.e. org.kde.kuiserver has been registered
+ * return app.exec();
+ * \endcode
*
- * @since 5.0
+ * \since 5.0
*/
class KDBUSADDONS_EXPORT KDBusService : public QObject
{
Q_OBJECT
public:
- /**
+ /*!
+ * \enum KDBusService::StartupOption
* Options to control the behaviour of KDBusService
- * @see StartupOptions
+ * \value Unique
+ * Indicates that only one instance of this application should ever exist.
+ * Cannot be combined with \c Multiple.
+ * \value Multiple
+ * Indicates that multiple instances of the application may exist.
+ * Cannot be combined with \c Unique. This is the default.
+ * \value NoExitOnFailure
+ * Indicates that the application should not exit if it failed to
+ * register with D-Bus.
+ * If not set, KDBusService will quit the application if it failed to
+ * register the service with D-Bus or a \c Unique instance can not be
+ * activated. A \c Multiple instance will exit with error code \c 1.
+ * The exit value of a \c Unique instance can be set from the running
+ * instance with setExitValue(), the default value is \c 0.
+ * \value [since 5.65] Replace
+ * Indicates that if there's already a unique service running,
+ * to be quit and replaced with our own.
+ * If exported, it will try first quitting the service calling
+ * \c org.qtproject.Qt.QCoreApplication.quit,
+ * which is exported by KDBusService by default.
*/
enum StartupOption {
- /**
- * Indicates that only one instance of this application should ever
exist.
- *
- * Cannot be combined with @c Multiple.
- */
Unique = 1,
- /**
- * Indicates that multiple instances of the application may exist.
- *
- * Cannot be combined with @c Unique. This is the default.
- */
Multiple = 2,
- /** Indicates that the application should not exit if it failed to
- * register with D-Bus.
- *
- * If not set, KDBusService will quit the application if it failed to
- * register the service with D-Bus or a @c Unique instance can not be
- * activated. A @c Multiple instance will exit with error code @c 1.
- * The exit value of a @c Unique instance can be set from the running
- * instance with setExitValue(), the default value is @c 0.
- */
NoExitOnFailure = 4,
- /**
- * Indicates that if there's already a unique service running, to be
quit and replaced
- * with our own.
- *
- * If exported, it will try first quitting the service calling @c
org.qtproject.Qt.QCoreApplication.quit,
- * which is exported by KDBusService by default.
- *
- * @since 5.65
- */
Replace = 8
};
Q_ENUM(StartupOption)
-
- /**
- * Stores a combination of #StartupOption values.
- */
Q_DECLARE_FLAGS(StartupOptions, StartupOption)
Q_FLAG(StartupOptions)
- /**
+ /*!
* Tries to register the current process to D-Bus at an address based on
the
- * application name and organization domain.
+ * application name and organization domain under the given \a parent.
*
* The D-Bus service name is the reversed organization domain, followed by
- * the application name. If @p options includes the @c Multiple flag, the
- * application PID will be appended. For example,
- * @code
+ * the application name. If \a options includes the \c Multiple flag, the
+ * application PID will be appended. For example:
+ * \code
* app.setApplicationName("kuiserver");
* app.setOrganizationDomain("kde.org");
- * @endcode
- * will make KDBusService register as @c org.kde.kuiserver in @c Unique
- * mode, and @c org.kde.kuiserver-1234 (if the process has PID @c 1234) in
- * @c Multiple mode.
+ * \endcode
+ * The above will make KDBusService register as \c org.kde.kuiserver in \c
Unique
+ * mode, and \c org.kde.kuiserver-1234 (if the process has PID \c 1234) in
+ * \c Multiple mode.
*/
explicit KDBusService(StartupOptions options = Multiple, QObject *parent =
nullptr);
- /**
+ /*!
* Destroys this object (but does not unregister the application).
*
* Deleting this object before unregister() could confuse
@@ -154,7 +141,7 @@
*/
~KDBusService() override;
- /**
+ /*!
* Returns true if the D-Bus registration succeeded.
*
* Note that this is only useful when specifying the option
NoExitOnFailure.
@@ -163,14 +150,14 @@
*/
bool isRegistered() const;
- /**
+ /*!
* Returns the name of the D-Bus service registered by this class.
* Mostly useful when using the option Multiple.
- * @since 5.33
+ * \since 5.33
*/
QString serviceName() const;
- /**
+ /*!
* Returns the error message from the D-Bus registration if it failed.
*
* Note that this is only useful when specifying the option
NoExitOnFailure.
@@ -178,10 +165,10 @@
*/
QString errorMessage() const;
- /**
+ /*!
* Sets the exit value to be used for a duplicate instance.
*
- * If this is a @c Unique application, a slot connected to
+ * If this is a \c Unique application, a slot connected to
* activateRequested() can use this to specify a non-zero exit value for
the
* duplicate instance. This would typically be done if invalid
command-line
* arguments are passed.
@@ -189,15 +176,15 @@
* Note that this will only work if the signal-slot connection type is
* Qt::DirectConnection.
*
- * @param value The exit value for the duplicate instance.
+ * \a value The exit value for the duplicate instance.
*/
void setExitValue(int value);
Q_SIGNALS:
- /**
+ /*!
* Signals that the application is to be activated.
*
- * If this is a @c Unique application, when KDBusService is constructed in
+ * If this is a \c Unique application, when KDBusService is constructed in
* subsequent instances of the application (ie: when the executable is run
* when an instance is already running), it will cause this signal to be
* emitted in the already-running instance (with the arguments passed to
the
@@ -205,22 +192,25 @@
*
* If this application's desktop file indicates that it supports D-Bus
* activation (DBusActivatable=true), a command launcher may also call the
Activate()
- * D-Bus method to trigger this signal. In this case, @p args will be
empty.
+ * D-Bus method to trigger this signal. In this case, \a arguments will be
empty.
*
* In single-window applications, the connected signal should typically
* raise the window.
*
- * @param arguments The arguments the executable was called with,
starting with the executable file name.
- * See QCoreApplication::arguments().
- * This can also be empty.
+ * \a arguments The arguments the executable was called with,
+ * starting with the executable file name.
+ * See QCoreApplication::arguments(). This can be empty.
+ *
+ * \a workingDirectory The directory from which the executable is called.
+ * This can be empty.
*
* A typical implementation of the signal handler would be:
- * @code
- * if (!arguments.isEmpty()) {
- * commandLineParser->parse(arguments); // same QCommandLineParser
instance as the one used in main()
- * handleCmdLine(workingDirectory); // shared method with main(),
which uses commandLineParser to handle options and positional arguments
- * }
- * @endcode
+ * \code
+ * if (!arguments.isEmpty()) {
+ * commandLineParser->parse(arguments); // same QCommandLineParser
instance as the one used in main()
+ * handleCmdLine(workingDirectory); // shared method with main(),
which uses commandLineParser to handle options and positional arguments
+ * }
+ * \endcode
*
* For GUI applications, the handler also needs to deal with any
platform-specific startup ids
* and make sure the mainwindow is shown as well as request its activation
from the window manager.
@@ -228,24 +218,24 @@
* from QX11Info::nextStartupId(), if there is one.
* For Wayland, KDBusService provides the token for the XDG Activation
protocol in the
* "XDG_ACTIVATION_TOKEN" environment variable and unsets it again after
the signal, if there is one.
- * The util method @c KWindowSystem::updateStartupId(QWindow *window)
(since KF 5.91) takes care of that.
+ * The util method \c KWindowSystem::updateStartupId(QWindow *window)
(since KF 5.91) takes care of that.
* A typical implementation in the signal handler would be:
- * @code
- * mainWindow->show();
- * KWindowSystem::updateStartupId(mainWindow->windowHandle());
- * mainWindow->raise();
- * KWindowSystem::activateWindow(mainWindow->windowHandle());
- * @endcode
+ * \code
+ * mainWindow->show();
+ * KWindowSystem::updateStartupId(mainWindow->windowHandle());
+ * mainWindow->raise();
+ * KWindowSystem::activateWindow(mainWindow->windowHandle());
+ * \endcode
*
- * If you're using the builtin handling of @c --help and @c --version in
QCommandLineParser,
+ * If you're using the builtin handling of \c --help and \c --version in
QCommandLineParser,
* you should call parser.process(arguments) before creating the
KDBusService instance,
* since parse() doesn't handle those (and exiting the already-running
instance would be wrong anyway).
*
- * @see setExitValue()
+ * \sa setExitValue()
*/
void activateRequested(const QStringList &arguments, const QString
&workingDirectory);
- /**
+ /*!
* Signals that one or more files should be opened in the application.
*
* This signal is emitted to request handling of the respective method of
the D-Bus activation.
@@ -254,12 +244,13 @@
* See documentation of activateRequested(const QStringList &arguments,
const QString &)
* for details.
*
- * @param uris The URLs of the files to open.
+ * \a uris The URLs of the files to open.
*/
void openRequested(const QList<QUrl> &uris);
- /**
- * Signals that an application action should be triggered.
+ /*!
+ * Signals that an application action \a actionName should be triggered
+ * with the given \a parameter.
*
* This signal is emitted to request handling of the respective method of
the D-Bus activation.
* For GUI applications, the signal handler also needs to deal with any
platform-specific startup ids
@@ -272,7 +263,7 @@
void activateActionRequested(const QString &actionName, const QVariant
¶meter);
public Q_SLOTS:
- /**
+ /*!
* Manually unregister the given serviceName from D-Bus.
*/
void unregister();
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kdedmodule.h
new/kdbusaddons-6.16.0/src/kdedmodule.h
--- old/kdbusaddons-6.13.0/src/kdedmodule.h 2025-04-04 16:00:04.000000000
+0200
+++ new/kdbusaddons-6.16.0/src/kdedmodule.h 2025-07-04 17:11:37.000000000
+0200
@@ -20,18 +20,16 @@
class QDBusObjectPath;
class QDBusMessage;
-/**
- * \class KDEDModule kdedmodule.h <KDEDModule>
- *
- * The base class for KDED modules.
+/*!
+ * \class KDEDModule
+ * \inmodule KDBusAddons
+ * \brief The base class for KDED modules.
*
* KDED modules are constructed as shared libraries that are loaded on-demand
* into the kded daemon at runtime.
*
* See https://invent.kde.org/frameworks/kded/-/blob/master/docs/HOWTO
* for documentation about writing kded modules.
- *
- * @author Waldo Bastian <bast...@kde.org>
*/
class KDBUSADDONS_EXPORT KDEDModule : public QObject
{
@@ -41,45 +39,48 @@
friend class Kded;
public:
- /**
- * Constructor
+ /*!
+ * \brief Creates a new kded module with the given \a parent.
*/
explicit KDEDModule(QObject *parent = nullptr);
~KDEDModule() override;
- /**
- * Sets the name of the module, and uses it to register the module to
D-Bus.
+ /*!
+ * Sets the \a name of the module, and uses it to register the module to
D-Bus.
*
* For modules loaded as plugins by a daemon, this is called automatically
* by the daemon after loading the module. Module authors should NOT call
this.
*/
void setModuleName(const QString &name);
+ /*!
+ * The name of the module used to register to D-Bus.
+ */
QString moduleName() const;
- /**
- * Returns the module being called by this D-Bus message.
+ /*!
+ * Returns the module being called by this D-Bus \a message.
+ *
* Useful for autoloading modules in kded and similar daemons.
- * @since 5.7
+ * \since 5.7
*/
static QString moduleForMessage(const QDBusMessage &message);
Q_SIGNALS:
- /**
- * Emitted when a mainwindow registers itself.
+ /*!
+ * Emitted when a mainwindow with the specified \a windowId registers
itself.
*/
void windowRegistered(qlonglong windowId);
- /**
- * Emitted when a mainwindow unregisters itself.
+ /*!
+ * Emitted when a mainwindow with the specified \a windowId unregisters
itself.
*/
void windowUnregistered(qlonglong windowId);
- /**
- * Emitted after the module is registered successfully with D-Bus
- *
- * @since 4.2
+ /*!
+ * Emitted after the module is registered successfully with D-Bus under
the specified D-Bus object \a path.
+ * \since 4.2
*/
void moduleRegistered(const QDBusObjectPath &path);
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kdbusaddons-6.13.0/src/kupdatelaunchenvironmentjob.h
new/kdbusaddons-6.16.0/src/kupdatelaunchenvironmentjob.h
--- old/kdbusaddons-6.13.0/src/kupdatelaunchenvironmentjob.h 2025-04-04
16:00:04.000000000 +0200
+++ new/kdbusaddons-6.16.0/src/kupdatelaunchenvironmentjob.h 2025-07-04
17:11:37.000000000 +0200
@@ -17,37 +17,54 @@
class QString;
class KUpdateLaunchEnvironmentJobPrivate;
-/**
- * @class KUpdateLaunchEnvironmentJob updatelaunchenvironmentjob.h
<KUpdateLaunchEnvironmentJob>
- *
- * Job for updating the launch environment.
+/*!
+ * \class KUpdateLaunchEnvironmentJob
+ * \inmodule KDBusAddons
+ * \brief Job for updating the launch environment.
*
* This job adds or updates an environment variable in process environment
that will be used
- * when a process is launched:
- * This includes:
- * - DBus activation
- * - Systemd units
- * - Plasma-session
+ * when a process is launched. This includes:
+ *
+ * \list
+ * \li DBus activation
+ * \li Systemd units
+ * \li Plasma-session
+ * \endlist
*
* Environment variables are sanitized before uploading.
*
- * This object deletes itself after completion, similar to KJobs
+ * This object deletes itself after completion, similar to KJobs.
+ *
+ * Example usage:
+ *
+ * \code
+ * QProcessEnvironment newEnv;
+ * newEnv.insert("VARIABLE"_s, "value"_s);
+ * auto job = new KUpdateLaunchEnvironmentJob(newEnv);
+ * QObject::connect(job, &KUpdateLaunchEnvironmentJob::finished, &SomeClass,
&SomeClass::someSlot);
+ * \endcode
*
* Porting from KF5 to KF6:
*
* The class UpdateLaunchEnvironmentJob was renamed to
KUpdateLaunchEnvironmentJob.
*
- * @since 6.0
+ * \since 6.0
*/
class KDBUSADDONS_EXPORT KUpdateLaunchEnvironmentJob : public QObject
{
Q_OBJECT
public:
+ /*!
+ * Creates a new job for the given launch \a environment.
+ */
explicit KUpdateLaunchEnvironmentJob(const QProcessEnvironment
&environment);
~KUpdateLaunchEnvironmentJob() override;
Q_SIGNALS:
+ /*!
+ * Emitted when the job is finished, before the object is automatically
deleted.
+ */
void finished();
private:
