Script 'mail_helper' called by obssrc
Hello community,
here is the log from the commit of package kf6-kcolorscheme for
openSUSE:Factory checked in at 2025-06-18 15:55:00
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/kf6-kcolorscheme (Old)
and /work/SRC/openSUSE:Factory/.kf6-kcolorscheme.new.19631 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "kf6-kcolorscheme"
Wed Jun 18 15:55:00 2025 rev:16 rq:1285564 version:6.15.0
Changes:
--------
--- /work/SRC/openSUSE:Factory/kf6-kcolorscheme/kf6-kcolorscheme.changes
2025-05-12 16:46:22.686360385 +0200
+++
/work/SRC/openSUSE:Factory/.kf6-kcolorscheme.new.19631/kf6-kcolorscheme.changes
2025-06-18 15:58:59.307267806 +0200
@@ -1,0 +2,18 @@
+Mon Jun 9 20:29:33 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 projects
+ * Add landing page for QDoc
+ * It compiles fine without kf_6_13 deprecated methods
+ * Add license headers for documentation files
+ * Port API documentation to QDoc syntax
+ * Update version to 6.15.0
+- Replace _kf6_bugfix_version usage
+
+-------------------------------------------------------------------
Old:
----
kcolorscheme-6.14.0.tar.xz
kcolorscheme-6.14.0.tar.xz.sig
New:
----
kcolorscheme-6.15.0.tar.xz
kcolorscheme-6.15.0.tar.xz.sig
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ kf6-kcolorscheme.spec ++++++
--- /var/tmp/diff_new_pack.wWo4FD/_old 2025-06-18 15:58:59.779287324 +0200
+++ /var/tmp/diff_new_pack.wWo4FD/_new 2025-06-18 15:58:59.779287324 +0200
@@ -16,16 +16,14 @@
#
-%define qt6_version 6.7.0
+%define qt6_version 6.8.0
%define rname kcolorscheme
-# Full KF6 version (e.g. 6.14.0)
+# Full KF6 version (e.g. 6.15.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-kcolorscheme
-Version: 6.14.0
+Version: 6.15.0
Release: 0
Summary: Classes to read and interact with KColorScheme
License: LGPL-2.0-or-later
@@ -35,14 +33,13 @@
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(KF6Codecs) >= %{_kf6_bugfix_version}
-BuildRequires: cmake(KF6Config) >= %{_kf6_bugfix_version}
-BuildRequires: cmake(KF6GuiAddons) >= %{_kf6_bugfix_version}
-BuildRequires: cmake(KF6I18n) >= %{_kf6_bugfix_version}
+BuildRequires: cmake(KF6Codecs) >= %{_kf6_version}
+BuildRequires: cmake(KF6Config) >= %{_kf6_version}
+BuildRequires: cmake(KF6GuiAddons) >= %{_kf6_version}
+BuildRequires: cmake(KF6I18n) >= %{_kf6_version}
BuildRequires: cmake(Qt6Gui) >= %{qt6_version}
BuildRequires: cmake(Qt6ToolsTools) >= %{qt6_version}
@@ -59,8 +56,8 @@
%package devel
Summary: Classes to read and interact with KColorScheme: Build
Environment
Requires: libKF6ColorScheme6 = %{version}
-Requires: cmake(KF6GuiAddons) >= %{_kf6_bugfix_version}
-Requires: cmake(KF6I18n) >= %{_kf6_bugfix_version}
+Requires: cmake(KF6GuiAddons) >= %{_kf6_version}
+Requires: cmake(KF6I18n) >= %{_kf6_version}
Requires: cmake(Qt6Gui) >= %{qt6_version}
%description devel
@@ -72,7 +69,7 @@
%autosetup -p1 -n %{rname}-%{version}
%build
-%cmake_kf6 -DBUILD_QCH:BOOL=TRUE
+%cmake_kf6
%kf6_build
@@ -94,7 +91,6 @@
%{_kf6_libdir}/libKF6ColorScheme.so.*
%files devel
-%doc %{_kf6_qchdir}/KF6ColorScheme.*
%{_kf6_cmakedir}/KF6ColorScheme/
%{_kf6_includedir}/KColorScheme/
%{_kf6_libdir}/libKF6ColorScheme.so
++++++ kcolorscheme-6.14.0.tar.xz -> kcolorscheme-6.15.0.tar.xz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/CMakeLists.txt
new/kcolorscheme-6.15.0/CMakeLists.txt
--- old/kcolorscheme-6.14.0/CMakeLists.txt 2025-05-02 16:15:47.000000000
+0200
+++ new/kcolorscheme-6.15.0/CMakeLists.txt 2025-06-06 15:29:19.000000000
+0200
@@ -3,12 +3,12 @@
cmake_minimum_required(VERSION 3.16)
-set(KF_VERSION "6.14.0") # handled by release scripts
-set(KF_DEP_VERSION "6.14.0") # handled by release scripts
+set(KF_VERSION "6.15.0") # handled by release scripts
+set(KF_DEP_VERSION "6.15.0") # handled by release scripts
project(KColorScheme VERSION ${KF_VERSION})
include(FeatureSummary)
-find_package(ECM 6.14.0 NO_MODULE)
+find_package(ECM 6.15.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)
@@ -22,10 +22,10 @@
include(ECMGenerateExportHeader)
include(ECMSetupVersion)
include(ECMGenerateHeaders)
-include(ECMAddQch)
include(ECMQtDeclareLoggingCategory)
include(ECMDeprecationSettings)
include(CMakeDependentOption)
+include(ECMGenerateQDoc)
set(REQUIRED_QT_VERSION 6.7.0)
find_package(Qt6 ${REQUIRED_QT_VERSION} CONFIG REQUIRED Gui)
@@ -36,10 +36,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)")
-
-
set(kcolorscheme_version_header
"${CMAKE_CURRENT_BINARY_DIR}/src/kcolorscheme_version.h")
ecm_setup_version(PROJECT VARIABLE_PREFIX KCOLORSCHEME
VERSION_HEADER "${kcolorscheme_version_header}"
@@ -52,7 +48,7 @@
ecm_set_disabled_deprecation_versions(
QT 6.9.0
- KF 6.12.0
+ KF 6.13.0
)
add_definitions(-DTRANSLATION_DOMAIN=\"kcolorscheme6\")
@@ -66,16 +62,6 @@
# create a Config.cmake and a ConfigVersion.cmake file and install them
set(CMAKECONFIG_INSTALL_DIR "${KDE_INSTALL_CMAKEPACKAGEDIR}/KF6ColorScheme")
-if(BUILD_QCH)
- ecm_install_qch_export(
- TARGETS KF6ColorScheme_QCH
- FILE KF6ColorSchemeQchTargets.cmake
- DESTINATION "${CMAKECONFIG_INSTALL_DIR}"
- COMPONENT Devel
- )
- set(PACKAGE_INCLUDE_QCHTARGETS
"include(\"\${CMAKE_CURRENT_LIST_DIR}/KF6ColorSchemeQchTargets.cmake\")")
-endif()
-
include(CMakePackageConfigHelpers)
configure_package_config_file(
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/KF6ColorSchemeConfig.cmake.in
new/kcolorscheme-6.15.0/KF6ColorSchemeConfig.cmake.in
--- old/kcolorscheme-6.14.0/KF6ColorSchemeConfig.cmake.in 2025-05-02
16:15:47.000000000 +0200
+++ new/kcolorscheme-6.15.0/KF6ColorSchemeConfig.cmake.in 2025-06-06
15:29:19.000000000 +0200
@@ -14,4 +14,3 @@
include("${CMAKE_CURRENT_LIST_DIR}/KF6ColorSchemeTargets.cmake")
-@PACKAGE_INCLUDE_QCHTARGETS@
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/LICENSES/CC-BY-SA-4.0.txt
new/kcolorscheme-6.15.0/LICENSES/CC-BY-SA-4.0.txt
--- old/kcolorscheme-6.14.0/LICENSES/CC-BY-SA-4.0.txt 1970-01-01
01:00:00.000000000 +0100
+++ new/kcolorscheme-6.15.0/LICENSES/CC-BY-SA-4.0.txt 2025-06-06
15:29:19.000000000 +0200
@@ -0,0 +1,170 @@
+Creative Commons Attribution-ShareAlike 4.0 International
+
+ Creative Commons Corporation (“Creative Commons”) is not a law firm and does
not provide legal services or legal advice. Distribution of Creative Commons
public licenses does not create a lawyer-client or other relationship. Creative
Commons makes its licenses and related information available on an “as-is”
basis. Creative Commons gives no warranties regarding its licenses, any
material licensed under their terms and conditions, or any related information.
Creative Commons disclaims all liability for damages resulting from their use
to the fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
conditions that creators and other rights holders may use to share original
works of authorship and other material subject to copyright and certain other
rights specified in the public license below. The following considerations are
for informational purposes only, are not exhaustive, and do not form part of
our licenses.
+
+Considerations for licensors: Our public licenses are intended for use by
those authorized to give the public permission to use material in ways
otherwise restricted by copyright and certain other rights. Our licenses are
irrevocable. Licensors should read and understand the terms and conditions of
the license they choose before applying it. Licensors should also secure all
rights necessary before applying our licenses so that the public can reuse the
material as expected. Licensors should clearly mark any material not subject to
the license. This includes other CC-licensed material, or material used under
an exception or limitation to copyright. More considerations for licensors.
+
+Considerations for the public: By using one of our public licenses, a licensor
grants the public permission to use the licensed material under specified terms
and conditions. If the licensor’s permission is not necessary for any
reason–for example, because of any applicable exception or limitation to
copyright–then that use is not regulated by the license. Our licenses grant
only permissions under copyright and certain other rights that a licensor has
authority to grant. Use of the licensed material may still be restricted for
other reasons, including because others have copyright or other rights in the
material. A licensor may make special requests, such as asking that all changes
be marked or described.
+
+Although not required by our licenses, you are encouraged to respect those
requests where reasonable. More considerations for the public.
+
+Creative Commons Attribution-ShareAlike 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree to be
bound by the terms and conditions of this Creative Commons
Attribution-ShareAlike 4.0 International Public License ("Public License"). To
the extent this Public License may be interpreted as a contract, You are
granted the Licensed Rights in consideration of Your acceptance of these terms
and conditions, and the Licensor grants You such rights in consideration of
benefits the Licensor receives from making the Licensed Material available
under these terms and conditions.
+
+Section 1 – Definitions.
+
+ a. Adapted Material means material subject to Copyright and
Similar Rights that is derived from or based upon the Licensed Material and in
which the Licensed Material is translated, altered, arranged, transformed, or
otherwise modified in a manner requiring permission under the Copyright and
Similar Rights held by the Licensor. For purposes of this Public License, where
the Licensed Material is a musical work, performance, or sound recording,
Adapted Material is always produced where the Licensed Material is synched in
timed relation with a moving image.
+
+ b. Adapter's License means the license You apply to Your Copyright
and Similar Rights in Your contributions to Adapted Material in accordance with
the terms and conditions of this Public License.
+
+ c. BY-SA Compatible License means a license listed at
creativecommons.org/compatiblelicenses, approved by Creative Commons as
essentially the equivalent of this Public License.
+
+ d. Copyright and Similar Rights means copyright and/or similar
rights closely related to copyright including, without limitation, performance,
broadcast, sound recording, and Sui Generis Database Rights, without regard to
how the rights are labeled or categorized. For purposes of this Public License,
the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar
Rights.
+
+ e. Effective Technological Measures means those measures that, in
the absence of proper authority, may not be circumvented under laws fulfilling
obligations under Article 11 of the WIPO Copyright Treaty adopted on December
20, 1996, and/or similar international agreements.
+
+ f. Exceptions and Limitations means fair use, fair dealing, and/or
any other exception or limitation to Copyright and Similar Rights that applies
to Your use of the Licensed Material.
+
+ g. License Elements means the license attributes listed in the
name of a Creative Commons Public License. The License Elements of this Public
License are Attribution and ShareAlike.
+
+ h. Licensed Material means the artistic or literary work,
database, or other material to which the Licensor applied this Public License.
+
+ i. Licensed Rights means the rights granted to You subject to the
terms and conditions of this Public License, which are limited to all Copyright
and Similar Rights that apply to Your use of the Licensed Material and that the
Licensor has authority to license.
+
+ j. Licensor means the individual(s) or entity(ies) granting rights
under this Public License.
+
+ k. Share means to provide material to the public by any means or
process that requires permission under the Licensed Rights, such as
reproduction, public display, public performance, distribution, dissemination,
communication, or importation, and to make material available to the public
including in ways that members of the public may access the material from a
place and at a time individually chosen by them.
+
+ l. Sui Generis Database Rights means rights other than copyright
resulting from Directive 96/9/EC of the European Parliament and of the Council
of 11 March 1996 on the legal protection of databases, as amended and/or
succeeded, as well as other essentially equivalent rights anywhere in the world.
+
+ m. You means the individual or entity exercising the Licensed
Rights under this Public License. Your has a corresponding meaning.
+
+Section 2 – Scope.
+
+ a. License grant.
+
+ 1. Subject to the terms and conditions of this Public License, the
Licensor hereby grants You a worldwide, royalty-free, non-sublicensable,
non-exclusive, irrevocable license to exercise the Licensed Rights in the
Licensed Material to:
+
+ A. reproduce and Share the Licensed Material, in whole or in
part; and
+
+ B. produce, reproduce, and Share Adapted Material.
+
+ 2. Exceptions and Limitations. For the avoidance of doubt, where
Exceptions and Limitations apply to Your use, this Public License does not
apply, and You do not need to comply with its terms and conditions.
+
+ 3. Term. The term of this Public License is specified in Section
6(a).
+
+ 4. Media and formats; technical modifications allowed. The Licensor
authorizes You to exercise the Licensed Rights in all media and formats whether
now known or hereafter created, and to make technical modifications necessary
to do so. The Licensor waives and/or agrees not to assert any right or
authority to forbid You from making technical modifications necessary to
exercise the Licensed Rights, including technical modifications necessary to
circumvent Effective Technological Measures. For purposes of this Public
License, simply making modifications authorized by this Section 2(a)(4) never
produces Adapted Material.
+
+ 5. Downstream recipients.
+
+ A. Offer from the Licensor – Licensed Material. Every recipient
of the Licensed Material automatically receives an offer from the Licensor to
exercise the Licensed Rights under the terms and conditions of this Public
License.
+
+ B. Additional offer from the Licensor – Adapted Material. Every
recipient of Adapted Material from You automatically receives an offer from the
Licensor to exercise the Licensed Rights in the Adapted Material under the
conditions of the Adapter’s License You apply.
+
+ C. No downstream restrictions. You may not offer or impose any
additional or different terms or conditions on, or apply any Effective
Technological Measures to, the Licensed Material if doing so restricts exercise
of the Licensed Rights by any recipient of the Licensed Material.
+
+ 6. No endorsement. Nothing in this Public License constitutes or may
be construed as permission to assert or imply that You are, or that Your use of
the Licensed Material is, connected with, or sponsored, endorsed, or granted
official status by, the Licensor or others designated to receive attribution as
provided in Section 3(a)(1)(A)(i).
+
+ b. Other rights.
+
+ 1. Moral rights, such as the right of integrity, are not licensed
under this Public License, nor are publicity, privacy, and/or other similar
personality rights; however, to the extent possible, the Licensor waives and/or
agrees not to assert any such rights held by the Licensor to the limited extent
necessary to allow You to exercise the Licensed Rights, but not otherwise.
+
+ 2. Patent and trademark rights are not licensed under this Public
License.
+
+ 3. To the extent possible, the Licensor waives any right to collect
royalties from You for the exercise of the Licensed Rights, whether directly or
through a collecting society under any voluntary or waivable statutory or
compulsory licensing scheme. In all other cases the Licensor expressly reserves
any right to collect such royalties.
+
+Section 3 – License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
following conditions.
+
+ a. Attribution.
+
+ 1. If You Share the Licensed Material (including in modified form),
You must:
+
+ A. retain the following if it is supplied by the Licensor with
the Licensed Material:
+
+ i. identification of the creator(s) of the Licensed
Material and any others designated to receive attribution, in any reasonable
manner requested by the Licensor (including by pseudonym if designated);
+
+ ii. a copyright notice;
+
+ iii. a notice that refers to this Public License;
+
+ iv. a notice that refers to the disclaimer of
warranties;
+
+ v. a URI or hyperlink to the Licensed Material to the
extent reasonably practicable;
+
+ B. indicate if You modified the Licensed Material and retain an
indication of any previous modifications; and
+
+ C. indicate the Licensed Material is licensed under this Public
License, and include the text of, or the URI or hyperlink to, this Public
License.
+
+ 2. You may satisfy the conditions in Section 3(a)(1) in any
reasonable manner based on the medium, means, and context in which You Share
the Licensed Material. For example, it may be reasonable to satisfy the
conditions by providing a URI or hyperlink to a resource that includes the
required information.
+
+ 3. If requested by the Licensor, You must remove any of the
information required by Section 3(a)(1)(A) to the extent reasonably practicable.
+
+ b. ShareAlike.In addition to the conditions in Section 3(a), if
You Share Adapted Material You produce, the following conditions also apply.
+
+ 1. The Adapter’s License You apply must be a Creative Commons
license with the same License Elements, this version or later, or a BY-SA
Compatible License.
+
+ 2. You must include the text of, or the URI or hyperlink to, the
Adapter's License You apply. You may satisfy this condition in any reasonable
manner based on the medium, means, and context in which You Share Adapted
Material.
+
+ 3. You may not offer or impose any additional or different terms or
conditions on, or apply any Effective Technological Measures to, Adapted
Material that restrict exercise of the rights granted under the Adapter's
License You apply.
+
+Section 4 – Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that apply to
Your use of the Licensed Material:
+
+ a. for the avoidance of doubt, Section 2(a)(1) grants You the
right to extract, reuse, reproduce, and Share all or a substantial portion of
the contents of the database;
+
+ b. if You include all or a substantial portion of the database
contents in a database in which You have Sui Generis Database Rights, then the
database in which You have Sui Generis Database Rights (but not its individual
contents) is Adapted Material, including for purposes of Section 3(b); and
+
+ c. You must comply with the conditions in Section 3(a) if You
Share all or a substantial portion of the contents of the database.
+For the avoidance of doubt, this Section 4 supplements and does not replace
Your obligations under this Public License where the Licensed Rights include
other Copyright and Similar Rights.
+
+Section 5 – Disclaimer of Warranties and Limitation of Liability.
+
+ a. Unless otherwise separately undertaken by the Licensor, to the
extent possible, the Licensor offers the Licensed Material as-is and
as-available, and makes no representations or warranties of any kind concerning
the Licensed Material, whether express, implied, statutory, or other. This
includes, without limitation, warranties of title, merchantability, fitness for
a particular purpose, non-infringement, absence of latent or other defects,
accuracy, or the presence or absence of errors, whether or not known or
discoverable. Where disclaimers of warranties are not allowed in full or in
part, this disclaimer may not apply to You.
+
+ b. To the extent possible, in no event will the Licensor be liable
to You on any legal theory (including, without limitation, negligence) or
otherwise for any direct, special, indirect, incidental, consequential,
punitive, exemplary, or other losses, costs, expenses, or damages arising out
of this Public License or use of the Licensed Material, even if the Licensor
has been advised of the possibility of such losses, costs, expenses, or
damages. Where a limitation of liability is not allowed in full or in part,
this limitation may not apply to You.
+
+ c. The disclaimer of warranties and limitation of liability
provided above shall be interpreted in a manner that, to the extent possible,
most closely approximates an absolute disclaimer and waiver of all liability.
+
+Section 6 – Term and Termination.
+
+ a. This Public License applies for the term of the Copyright and
Similar Rights licensed here. However, if You fail to comply with this Public
License, then Your rights under this Public License terminate automatically.
+
+ b. Where Your right to use the Licensed Material has terminated
under Section 6(a), it reinstates:
+
+ 1. automatically as of the date the violation is cured, provided it
is cured within 30 days of Your discovery of the violation; or
+
+ 2. upon express reinstatement by the Licensor.
+
+ c. For the avoidance of doubt, this Section 6(b) does not affect
any right the Licensor may have to seek remedies for Your violations of this
Public License.
+
+ d. For the avoidance of doubt, the Licensor may also offer the
Licensed Material under separate terms or conditions or stop distributing the
Licensed Material at any time; however, doing so will not terminate this Public
License.
+
+ e. Sections 1, 5, 6, 7, and 8 survive termination of this Public
License.
+
+Section 7 – Other Terms and Conditions.
+
+ a. The Licensor shall not be bound by any additional or different
terms or conditions communicated by You unless expressly agreed.
+
+ b. Any arrangements, understandings, or agreements regarding the
Licensed Material not stated herein are separate from and independent of the
terms and conditions of this Public License.
+
+Section 8 – Interpretation.
+
+ a. For the avoidance of doubt, this Public License does not, and
shall not be interpreted to, reduce, limit, restrict, or impose conditions on
any use of the Licensed Material that could lawfully be made without permission
under this Public License.
+
+ b. To the extent possible, if any provision of this Public License
is deemed unenforceable, it shall be automatically reformed to the minimum
extent necessary to make it enforceable. If the provision cannot be reformed,
it shall be severed from this Public License without affecting the
enforceability of the remaining terms and conditions.
+
+ c. No term or condition of this Public License will be waived and
no failure to comply consented to unless expressly agreed to by the Licensor.
+
+ d. Nothing in this Public License constitutes or may be
interpreted as a limitation upon, or waiver of, any privileges and immunities
that apply to the Licensor or You, including from the legal processes of any
jurisdiction or authority.
+
+Creative Commons is not a party to its public licenses. Notwithstanding,
Creative Commons may elect to apply one of its public licenses to material it
publishes and in those instances will be considered the “Licensor.” Except for
the limited purpose of indicating that material is shared under a Creative
Commons public license or as otherwise permitted by the Creative Commons
policies published at creativecommons.org/policies, Creative Commons does not
authorize the use of the trademark “Creative Commons” or any other trademark or
logo of Creative Commons without its prior written consent including, without
limitation, in connection with any unauthorized modifications to any of its
public licenses or any other arrangements, understandings, or agreements
concerning use of licensed material. For the avoidance of doubt, this paragraph
does not form part of the public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/docs/Doxyfile.local
new/kcolorscheme-6.15.0/docs/Doxyfile.local
--- old/kcolorscheme-6.14.0/docs/Doxyfile.local 2025-05-02 16:15:47.000000000
+0200
+++ new/kcolorscheme-6.15.0/docs/Doxyfile.local 1970-01-01 01:00:00.000000000
+0100
@@ -1,11 +0,0 @@
-# SPDX-FileCopyrightText: Volker Krause <vkra...@kde.org>
-# SPDX-License-Identifier: BSD-2-Clause
-
-# define so that deprecated API is not skipped
-PREDEFINED += \
- "KCOLORSCHEME_ENABLE_DEPRECATED_SINCE(x, y)=1" \
- "KCOLORSCHEME_BUILD_DEPRECATED_SINCE(x, y)=1" \
- "KCOLORSCHEME_DEPRECATED_VERSION(x, y, t)=" \
- "KCOLORSCHEME_ENUMERATOR_DEPRECATED_VERSION(x, y, t)=" \
- "KCOLORSCHEME_ENUMERATOR_DEPRECATED_VERSION_BELATED(x, y, xt, yt, t)=" \
- KCOLORSCHEME_EXPORT=
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/CMakeLists.txt
new/kcolorscheme-6.15.0/src/CMakeLists.txt
--- old/kcolorscheme-6.14.0/src/CMakeLists.txt 2025-05-02 16:15:47.000000000
+0200
+++ new/kcolorscheme-6.15.0/src/CMakeLists.txt 2025-06-06 15:29:19.000000000
+0200
@@ -81,36 +81,4 @@
DESTINATION ${KDE_INSTALL_LOGGINGCATEGORIESDIR}
)
-
-if(BUILD_QCH)
- ecm_add_qch(
- KF6ColorScheme_QCH
- NAME KColorScheme
- BASE_NAME KF6ColorScheme
- VERSION ${KF_VERSION}
- ORG_DOMAIN org.kde
- SOURCES # using only public headers, to cover only public API
- ${KColorScheme_HEADERS}
- MD_MAINPAGE "${CMAKE_SOURCE_DIR}/README.md"
- IMAGE_DIRS "${CMAKE_SOURCE_DIR}/docs/pics"
- LINK_QCHS
- KF6GuiAddons_QCH
- INCLUDE_DIRS
- ${CMAKE_CURRENT_BINARY_DIR}
- BLANK_MACROS
- KCOLORSCHEME_EXPORT
- KCOLORSCHEME_DEPRECATED
- KCOLORSCHEME_DEPRECATED_EXPORT
- "KCOLORSCHEME_DEPRECATED_VERSION(x, y, t)"
- "KCOLORSCHEME_DEPRECATED_VERSION_BELATED(x, y, xt, yt, t)"
- "KCOLORSCHEME_ENUMERATOR_DEPRECATED_VERSION(x, y, t)"
- "KCOLORSCHEME_ENUMERATOR_DEPRECATED_VERSION_BELATED(x, y, xt, yt,
t)"
- PREDEFINED_MACROS
- "KCOLORSCHEME_ENABLE_DEPRECATED_SINCE(x, y)=1"
- "KCOLORSCHEME_BUILD_DEPRECATED_SINCE(x, y)=1"
- TAGFILE_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
- QCH_INSTALL_DESTINATION ${KDE_INSTALL_QTQCHDIR}
- COMPONENT Devel
- )
-endif()
-
+ecm_generate_qdoc(KF6ColorScheme kcolorscheme.qdocconf)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorscheme-index.qdoc
new/kcolorscheme-6.15.0/src/kcolorscheme-index.qdoc
--- old/kcolorscheme-6.14.0/src/kcolorscheme-index.qdoc 1970-01-01
01:00:00.000000000 +0100
+++ new/kcolorscheme-6.15.0/src/kcolorscheme-index.qdoc 2025-06-06
15:29:19.000000000 +0200
@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: CC-BY-SA-4.0
+// SPDX-FileCopyrightText: None
+
+/*!
+ \page kcolorscheme-index.html
+ \title KColorScheme
+
+ Classes to interact with KColorScheme.
+
+ \section1 Using the Module
+
+ \include {module-use.qdocinc} {using the c++ api}
+
+ \section2 Building with CMake
+
+ \include {module-use.qdocinc} {building with cmake} {KF6} {ColorScheme}
{KF6::ColorScheme}
+
+ \section1 API Reference
+
+ \list
+ \li \l{KColorScheme C++ Classes}
+ \endlist
+*/
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorscheme.h
new/kcolorscheme-6.15.0/src/kcolorscheme.h
--- old/kcolorscheme-6.14.0/src/kcolorscheme.h 2025-05-02 16:15:47.000000000
+0200
+++ new/kcolorscheme-6.15.0/src/kcolorscheme.h 2025-06-06 15:29:19.000000000
+0200
@@ -20,10 +20,10 @@
class KColorSchemePrivate;
-/**
- * @class KColorScheme kcolorscheme.h KColorScheme
- *
- * A set of methods used to work with colors.
+/*!
+ * \class KColorScheme
+ * \inmodule KColorScheme
+ * \brief A set of methods used to work with colors.
*
* KColorScheme currently provides access to the system color palette that the
* user has selected (in the future, it is expected to do more). It greatly
@@ -38,7 +38,7 @@
* foreground for any other set. Individual colors may be quickly referenced by
* creating an anonymous instance and invoking a lookup member.
*
- * @note
+ * \note
* The color palettes for the various states of a widget (active, inactive,
* disabled) may be wildly different. Therefore, it is important to take the
* state into account. This is why the KColorScheme constructor requires a
@@ -46,84 +46,63 @@
*
* To facilitate working with potentially-varying states, two convenience API's
* are provided. These are KColorScheme::adjustBackground and its sister
- * KColorScheme::adjustForeground, and the helper class ::KStatefulBrush.
+ * KColorScheme::adjustForeground, and the helper class KStatefulBrush.
*
- * @see KColorScheme::ColorSet, KColorScheme::ForegroundRole,
+ * \sa KColorScheme::ColorSet, KColorScheme::ForegroundRole,
* KColorScheme::BackgroundRole, KColorScheme::DecorationRole,
* KColorScheme::ShadeRole
*/
class KCOLORSCHEME_EXPORT KColorScheme
{
public:
- /**
+ /*!
+ * \enum KColorScheme::ColorSet
+ *
* This enumeration describes the color set for which a color is being
* selected.
*
* Color sets define a color "environment", suitable for drawing all parts
* of a given region. Colors from different sets should not be combined.
+ *
+ * \value View Views; for example, frames, input fields, etc.\br\br
+ * If it contains things that can be selected, it is probably
a \c View.
+ * \value Window Non-editable window elements; for example, menus.\br\br
+ * If it isn't a \c Button, \c View, or \c Tooltip, it is
probably a \c Window.
+ * \value Button Buttons and button-like controls.\br\br
+ * In addition to buttons, "button-like" controls such as
non-editable
+ * dropdowns, scrollbar sliders, slider handles, etc. should
also use
+ * this role.
+ * \value Selection Selected items in views.\br\br
+ * Note that unfocused or disabled selections should use
the \c Window
+ * role. This makes it more obvious to the user that the
view
+ * containing the selection does not have input focus.
+ * \value Tooltip Tooltips.\br\br
+ * The tooltip set can often be substituted for the view
+ * set when editing is not possible, but the Window set is
deemed
+ * inappropriate. "What's This" help is an excellent
example, another
+ * might be pop-up notifications (depending on taste).
+ * \value [since KColorScheme 5.19] Complementary Complementary
areas.\br\br
+ * Some applications want some areas to
have a different color scheme.
+ * Usually dark areas over a light theme.
For instance the fullscreen UI
+ * of a picture viewer, or the
logout/lock screen of the plasma workspace
+ * ask for a dark color scheme even on
light themes.
+ * \value Header
+ * \omitvalue NColorSets
*/
enum ColorSet {
- /**
- * Views; for example, frames, input fields, etc.
- *
- * If it contains things that can be selected, it is probably a View.
- */
View,
- /**
- * Non-editable window elements; for example, menus.
- *
- * If it isn't a Button, View, or Tooltip, it is probably a Window.
- */
Window,
- /**
- * Buttons and button-like controls.
- *
- * In addition to buttons, "button-like" controls such as non-editable
- * dropdowns, scrollbar sliders, slider handles, etc. should also use
- * this role.
- */
Button,
- /**
- * Selected items in views.
- *
- * Note that unfocused or disabled selections should use the Window
- * role. This makes it more obvious to the user that the view
- * containing the selection does not have input focus.
- */
Selection,
- /**
- * Tooltips.
- *
- * The tooltip set can often be substituted for the view
- * set when editing is not possible, but the Window set is deemed
- * inappropriate. "What's This" help is an excellent example, another
- * might be pop-up notifications (depending on taste).
- */
Tooltip,
- /**
- * Complementary areas.
- *
- * Some applications want some areas to have a different color scheme.
- * Usually dark areas over a light theme. For instance the fullscreen
UI
- * of a picture viewer, or the logout/lock screen of the plasma
workspace
- * ask for a dark color scheme even on light themes.
- * @since 5.19
- */
Complementary,
- /**
- * Colors for header areas that should be used both by the top toolbar
and the titlebar.
- * @since 5.69
- */
Header,
- /**
- * Number of color sets.
- * Note: don't use this
- * @since 5.65
- */
NColorSets,
};
- /**
+ /*!
+ * \enum KColorScheme::BackgroundRole
+ *
* This enumeration describes the background color being selected from the
* given set.
*
@@ -131,66 +110,46 @@
* be used to draw text. In combination with one of the overloads of
* KColorScheme::shade, they may be used to generate colors for drawing
* frames, bevels, and similar decorations.
+ *
+ * \value NormalBackground Normal background.
+ * \value AlternateBackground Alternate background; for example, for use
in lists.
+ * This color may be the same as \c
BackgroundNormal, especially in sets
+ * other than \c View and \c Window.
+ * \value ActiveBackground Third color; for example, items which are new,
active, requesting
+ * attention, etc.\br\br
+ * Alerting the user that a certain field must be
filled out would be a
+ * good usage (although NegativeBackground could
be used to the same
+ * effect, depending on what you are trying to
achieve). Unlike
+ * \c ActiveText, this should not be used for
mouseover effects.
+ * \value LinkBackground Fourth color; corresponds to (unvisited)
links.\br\br
+ * Exactly what this might be used for is somewhat
harder to qualify;
+ * it might be used for bookmarks, as a 'you can
click here' indicator,
+ * or to highlight recent content (i.e. in a
most-recently-accessed
+ * list).
+ * \value VisitedBackground Fifth color; corresponds to visited
links.\br\br
+ * This can also be used to indicate "not recent"
content, especially
+ * when a color is needed to denote content which
is "old" or
+ * "archival".
+ * \value NegativeBackground Sixth color; for example, errors, untrusted
content, etc.
+ * \value NeutralBackground Seventh color; for example, warnings,
secure/encrypted content.
+ * \value PositiveBackground Eighth color; for example, success messages,
trusted content.
+ * \omitvalue NBackgroundRoles
*/
enum BackgroundRole {
- /**
- * Normal background.
- */
NormalBackground,
- /**
- * Alternate background; for example, for use in lists.
- *
- * This color may be the same as BackgroundNormal, especially in sets
- * other than View and Window.
- */
AlternateBackground,
- /**
- * Third color; for example, items which are new, active, requesting
- * attention, etc.
- *
- * Alerting the user that a certain field must be filled out would be a
- * good usage (although NegativeBackground could be used to the same
- * effect, depending on what you are trying to achieve). Unlike
- * ActiveText, this should not be used for mouseover effects.
- */
ActiveBackground,
- /**
- * Fourth color; corresponds to (unvisited) links.
- *
- * Exactly what this might be used for is somewhat harder to qualify;
- * it might be used for bookmarks, as a 'you can click here' indicator,
- * or to highlight recent content (i.e. in a most-recently-accessed
- * list).
- */
LinkBackground,
- /**
- * Fifth color; corresponds to visited links.
- *
- * This can also be used to indicate "not recent" content, especially
- * when a color is needed to denote content which is "old" or
- * "archival".
- */
VisitedBackground,
- /**
- * Sixth color; for example, errors, untrusted content, etc.
- */
NegativeBackground,
- /**
- * Seventh color; for example, warnings, secure/encrypted content.
- */
NeutralBackground,
- /**
- * Eighth color; for example, success messages, trusted content.
- */
PositiveBackground,
- /**
- * Number of background roles.
- * @since 5.65
- */
NBackgroundRoles,
};
- /**
+ /*!
+ * \enum KColorScheme::ForegroundRole
+ *
* This enumeration describes the foreground color being selected from the
* given set.
*
@@ -200,65 +159,55 @@
*
* For window decorations, the following is suggested, but not set in
* stone:
- * @li Maximize - PositiveText
- * @li Minimize - NeutralText
- * @li Close - NegativeText
- * @li WhatsThis - LinkText
- * @li Sticky - ActiveText
+ * \list
+ * \li Maximize - \c PositiveText
+ * \li Minimize - \c NeutralText
+ * \li Close - \c NegativeText
+ * \li WhatsThis - \c LinkText
+ * \li Sticky - \c ActiveText
+ * \endlist
+ *
+ * \value NormalText Normal foreground.
+ * \value InactiveText Second color; for example, comments, items which
are old, inactive
+ * or disabled.\br\br
+ * Generally used for things that are meant to be "less
+ * important". \c InactiveText is not the same role as
NormalText in the
+ * inactive state.
+ * \value ActiveText Third color; for example items which are new, active,
requesting
+ * attention, etc.\br\br
+ * May be used as a hover color for clickable items.
+ * \value LinkText Fourth color; use for (unvisited) links.\br\br
+ * May also be used for other
+ * clickable items or content that indicates
relationships, items that
+ * indicate somewhere the user can visit, etc.
+ * \value VisitedText Fifth color; used for (visited) links.\br\br
+ * As with \c LinkText, may be used
+ * for items that have already been "visited" or
accessed. May also be
+ * used to indicate "historical" (i.e. "old") items or
information,
+ * especially if \c InactiveText is being used in the
same context to
+ * express something different.
+ * \value NegativeText Sixth color; for example, errors, untrusted
content, deletions,
+ * etc.
+ * \value NeutralText Seventh color; for example, warnings,
secure/encrypted content.
+ * \value PositiveText Eighth color; for example, additions, success
messages, trusted
+ * content.
+ * \omitvalue NForegroundRoles
*/
enum ForegroundRole {
- /**
- * Normal foreground.
- */
NormalText,
- /**
- * Second color; for example, comments, items which are old, inactive
- * or disabled. Generally used for things that are meant to be "less
- * important". InactiveText is not the same role as NormalText in the
- * inactive state.
- */
InactiveText,
- /**
- * Third color; for example items which are new, active, requesting
- * attention, etc. May be used as a hover color for clickable items.
- */
ActiveText,
- /**
- * Fourth color; use for (unvisited) links. May also be used for other
- * clickable items or content that indicates relationships, items that
- * indicate somewhere the user can visit, etc.
- */
LinkText,
- /**
- * Fifth color; used for (visited) links. As with LinkText, may be used
- * for items that have already been "visited" or accessed. May also be
- * used to indicate "historical" (i.e. "old") items or information,
- * especially if InactiveText is being used in the same context to
- * express something different.
- */
VisitedText,
- /**
- * Sixth color; for example, errors, untrusted content, deletions,
- * etc.
- */
NegativeText,
- /**
- * Seventh color; for example, warnings, secure/encrypted content.
- */
NeutralText,
- /**
- * Eighth color; for example, additions, success messages, trusted
- * content.
- */
PositiveText,
- /**
- * Number of foreground roles.
- * @since 5.65
- */
NForegroundRoles,
};
- /**
+ /*!
+ * \enum KColorScheme::DecorationRole
+ *
* This enumeration describes the decoration color being selected from the
* given set.
*
@@ -266,63 +215,47 @@
* special purposes. Like color shades, they are neither foreground nor
* background colors. Text should not be painted over a decoration color,
* and decoration colors should not be used to draw text.
+ *
+ * \value FocusColor Color used to draw decorations for items which have
input focus.
+ * \value HoverColor Color used to draw decorations for items which will
be activated by
+ * clicking.
+ * \omitvalue NDecorationRoles
*/
enum DecorationRole {
- /**
- * Color used to draw decorations for items which have input focus.
- */
FocusColor,
- /**
- * Color used to draw decorations for items which will be activated by
- * clicking.
- */
HoverColor,
- /**
- * Number of decoration roles.
- * @since 5.65
- */
NDecorationRoles,
};
- /**
+ /*!
+ * \enum KColorScheme::ShadeRole
+ *
* This enumeration describes the color shade being selected from the given
* set.
*
* Color shades are used to draw "3d" elements, such as frames and bevels.
* They are neither foreground nor background colors. Text should not be
* painted over a shade, and shades should not be used to draw text.
+ *
+ * \value LightShade The light color is lighter than QPalette::dark() or
QPalette::shadow() and contrasts
+ * with the base color.
+ * \value MidlightShade The midlight color is in between base() and
QPalette::light().
+ * \value MidShade The mid color is in between QPalette::base() and
QPalette::dark().
+ * \value DarkShade The dark color is in between QPalette::mid() and
QPalette::shadow().
+ * \value ShadowShade The shadow color is darker than QPalette::light() or
QPalette::midlight() and contrasts
+ * the base color.
+ * \omitvalue NShadeRoles
*/
enum ShadeRole {
- /**
- * The light color is lighter than dark() or shadow() and contrasts
- * with the base color.
- */
LightShade,
- /**
- * The midlight color is in between base() and light().
- */
MidlightShade,
- /**
- * The mid color is in between base() and dark().
- */
MidShade,
- /**
- * The dark color is in between mid() and shadow().
- */
DarkShade,
- /**
- * The shadow color is darker than light() or midlight() and contrasts
- * the base color.
- */
ShadowShade,
- /**
- * Number of shade roles.
- * @since 5.65
- */
NShadeRoles,
};
- /** Destructor */
+ /*! Destructor */
virtual ~KColorScheme(); // TODO KF6: remove virtual
KColorScheme(const KColorScheme &);
@@ -330,97 +263,100 @@
KColorScheme(KColorScheme &&);
KColorScheme &operator=(KColorScheme &&);
- /**
+ /*!
* Construct a palette from given color set and state. Colors are taken
* from the given KConfig. If null, the application's color scheme is used
* (either the system default or one set by KColorSchemeManager).
*
- * @note KColorScheme provides direct access to the color scheme for users
+ * \note KColorScheme provides direct access to the color scheme for users
* that deal directly with widget states. Unless you are a low-level user
* or have a legitimate reason to only care about a fixed, limited number
* of states (e.g. windows that cannot be inactive), consider using a
- * ::KStatefulBrush instead.
+ * KStatefulBrush instead.
*/
explicit KColorScheme(QPalette::ColorGroup = QPalette::Normal, ColorSet =
View, KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Retrieve the requested background brush.
*/
QBrush background(BackgroundRole = NormalBackground) const;
- /**
+ /*!
* Retrieve the requested foreground brush.
*/
QBrush foreground(ForegroundRole = NormalText) const;
- /**
+ /*!
* Retrieve the requested decoration brush.
*/
QBrush decoration(DecorationRole) const;
- /**
+ /*!
* Retrieve the requested shade color, using
* KColorScheme::background(KColorScheme::NormalBackground)
* as the base color and the contrast setting from the KConfig used to
* create this KColorScheme instance.
*
- * @note Shades are chosen such that all shades would contrast with the
+ * \note Shades are chosen such that all shades would contrast with the
* base color. This means that if base is very dark, the 'dark' shades will
- * be lighter than the base color, with midlight() == shadow().
+ * be lighter than the base color, with QPalette::midlight() ==
QPalette::shadow().
* Conversely, if the base color is very light, the 'light' shades will be
- * darker than the base color, with light() == mid().
+ * darker than the base color, with QPalette::light() == QPalette::mid().
*/
QColor shade(ShadeRole) const;
- /**
+ /*!
* Returns the contrast for borders as a floating point value.
- * @param config pointer to the config from which to read the contrast
+ *
+ * \a config pointer to the config from which to read the contrast
* setting. If null, the application's color scheme will be used
* (either the system default or one set by KColorSchemeManager).
- * @return the contrast (between 0.0 for minimum and 1.0 for maximum
+ *
+ * Returns the contrast (between 0.0 for minimum and 1.0 for maximum
* contrast)
*/
static qreal contrastF(const KSharedConfigPtr &config =
KSharedConfigPtr());
- /**
+ /*!
* Retrieve the requested shade color, using the specified color as the
* base color and the application's contrast setting.
*
- * @note Shades are chosen such that all shades would contrast with the
+ * \note Shades are chosen such that all shades would contrast with the
* base color. This means that if base is very dark, the 'dark' shades will
- * be lighter than the base color, with midlight() == shadow().
+ * be lighter than the base color, with QPalette::midlight() ==
QPalette::shadow().
* Conversely, if the base color is very light, the 'light' shades will be
- * darker than the base color, with light() == mid().
+ * darker than the base color, with QPalette::light() == QPalette::mid().
*/
static QColor shade(const QColor &, ShadeRole);
- /**
+ /*!
* Retrieve the requested shade color, using the specified color as the
* base color and the specified contrast.
*
- * @param contrast Amount roughly specifying the contrast by which to
+ * \a contrast Amount roughly specifying the contrast by which to
* adjust the base color, between -1.0 and 1.0 (values between 0.0 and 1.0
* correspond to the value from KColorScheme::contrastF)
- * @param chromaAdjust (optional) Amount by which to adjust the chroma of
+ *
+ * \a chromaAdjust (optional) Amount by which to adjust the chroma of
* the shade (1.0 means no adjustment)
*
- * @note Shades are chosen such that all shades would contrast with the
+ * \note Shades are chosen such that all shades would contrast with the
* base color. This means that if base is very dark, the 'dark' shades will
- * be lighter than the base color, with midlight() == shadow().
+ * be lighter than the base color, with QPalette::midlight() ==
QPalette::shadow().
* Conversely, if the base color is very light, the 'light' shades will be
- * darker than the base color, with light() == mid().
+ * darker than the base color, with QPalette::light() == QPalette::mid().
*
- * @see KColorUtils::shade
+ * \sa KColorUtils::shade
*/
static QColor shade(const QColor &, ShadeRole, qreal contrast, qreal
chromaAdjust = 0.0);
- /**
+ /*!
* Adjust a QPalette by replacing the specified QPalette::ColorRole with
* the requested background color for all states. Using this method is
* safer than replacing individual states, as it insulates you against
* changes in QPalette::ColorGroup.
*
- * @note Although it is possible to replace a foreground color using this
+ * \note Although it is possible to replace a foreground color using this
* method, it's bad usability to do so. Just say "no".
*/
static void adjustBackground(QPalette &,
@@ -429,13 +365,13 @@
ColorSet set = View,
KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Adjust a QPalette by replacing the specified QPalette::ColorRole with
* the requested foreground color for all states. Using this method is
* safer than replacing individual states, as it insulates you against
* changes in QPalette::ColorGroup.
*
- * @note Although it is possible to replace a background color using this
+ * \note Although it is possible to replace a background color using this
* method, it's bad usability to do so. Just say "no".
*/
static void adjustForeground(QPalette &,
@@ -444,33 +380,33 @@
ColorSet set = View,
KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Used to obtain the QPalette that will be used to set the application
* palette from KDE Platform theme.
*
- * @param config KConfig from which to load the colors
+ * \a config KConfig from which to load the colors
*
- * @returns the QPalette
+ * Returns the QPalette
*
- * @since 5.0
+ * \since 5.0
*/
static QPalette createApplicationPalette(const KSharedConfigPtr &config);
- /**
+ /*!
* Used to check if the color scheme has a given set.
*
- * @param config KConfig from which to load the colors
+ * \a config KConfig from which to load the colors
*
- * @param set The color set to check for.
+ * \a set The color set to check for.
*
- * @returns whether the color scheme has a given color set
+ * Returns whether the color scheme has a given color set
*
- * @since 5.75
+ * \since 5.75
*/
static bool isColorSetSupported(const KSharedConfigPtr &config,
KColorScheme::ColorSet set);
- /**
- * @since 5.92
+ /*!
+ * \since 5.92
*/
bool operator==(const KColorScheme &other) const;
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorscheme.qdoc
new/kcolorscheme-6.15.0/src/kcolorscheme.qdoc
--- old/kcolorscheme-6.14.0/src/kcolorscheme.qdoc 1970-01-01
01:00:00.000000000 +0100
+++ new/kcolorscheme-6.15.0/src/kcolorscheme.qdoc 2025-06-06
15:29:19.000000000 +0200
@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: CC-BY-SA-4.0
+// SPDX-FileCopyrightText: None
+
+/*!
+ \module KColorScheme
+ \title KColorScheme C++ Classes
+ \ingroup modules
+ \cmakepackage KF6
+ \cmakecomponent ColorScheme
+
+ \brief Classes to interact with KColorScheme.
+*/
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorscheme.qdocconf
new/kcolorscheme-6.15.0/src/kcolorscheme.qdocconf
--- old/kcolorscheme-6.14.0/src/kcolorscheme.qdocconf 1970-01-01
01:00:00.000000000 +0100
+++ new/kcolorscheme-6.15.0/src/kcolorscheme.qdocconf 2025-06-06
15:29:19.000000000 +0200
@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: CC-BY-SA-4.0
+# SPDX-FileCopyrightText: None
+
+include($KDE_DOCS/global/qt-module-defaults.qdocconf)
+
+project = KColorScheme
+description = Classes to interact with KColorScheme.
+
+documentationinheaders = true
+
+headerdirs += .
+sourcedirs += .
+
+navigation.landingpage = "KColorScheme"
+
+outputformats = HTML
+
+depends += \
+ kde \
+ qtcore \
+ qtgui \
+ qtwidgets \
+ kconfigcore \
+ kguiaddons \
+ kconfigwidgets
+
+qhp.projects = KColorScheme
+
+qhp.KColorScheme.file = kcolorscheme.qhp
+qhp.KColorScheme.namespace = org.kde.kcolorscheme.$QT_VERSION_TAG
+qhp.KColorScheme.virtualFolder = kcolorscheme
+qhp.KColorScheme.indexTitle = KColorScheme
+qhp.KColorScheme.indexRoot =
+
+qhp.KColorScheme.subprojects = classes
+qhp.KColorScheme.subprojects.classes.title = C++ Classes
+qhp.KColorScheme.subprojects.classes.indexTitle = KColorScheme C++ Classes
+qhp.KColorScheme.subprojects.classes.selectors = class fake:headerfile
+qhp.KColorScheme.subprojects.classes.sortPages = true
+
+tagfile = kcolorscheme.tags
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorschememanager.h
new/kcolorscheme-6.15.0/src/kcolorschememanager.h
--- old/kcolorscheme-6.14.0/src/kcolorschememanager.h 2025-05-02
16:15:47.000000000 +0200
+++ new/kcolorscheme-6.15.0/src/kcolorschememanager.h 2025-06-06
15:29:19.000000000 +0200
@@ -21,11 +21,14 @@
class KActionMenu;
class KColorSchemeManagerPrivate;
-/**
- * @class KColorSchemeManager kcolorschememanager.h KColorSchemeManager
+/*!
+ * \class KColorSchemeManager
+ * \inmodule KColorScheme
*
- * A small helper to get access to all available color schemes and activating
a scheme in the
- * QApplication. This is useful for applications which want to provide a
selection of custom color
+ * \brief A small helper to get access to all available color schemes and
activating a scheme in the
+ * QApplication.
+ *
+ * This is useful for applications which want to provide a selection of custom
color
* schemes to their user. For example it is very common for photo and painting
applications to use
* a dark color scheme even if the default is a light scheme. Since version
5.67 it also allows
* going back to following the system color scheme.
@@ -33,12 +36,12 @@
* The model() member function provides access to the KColorSchemeModel that
the KColorSchemeManager uses
* which holds all the available color schemes. A possible usage looks like
the following:
*
- * @code
+ * \code
* KColorSchemeManager *schemes = new KColorSchemeManager(this);
* QListView *view = new QListView(this);
* view->setModel(schemes->model());
* connect(view, &QListView::activated, schemes,
&KColorSchemeManager::activateScheme);
- * @endcode
+ * \endcode
*
* A convenience function that creates a KActionMenu that contains and
activates color schemes exists
* in KColorSchemeMenu::createMenu
@@ -46,9 +49,9 @@
* By default KColorSchemeManager remembers the activated color scheme and
restores it on the next
* start of the application. Use setAutosaveChanges() to change this behavior.
*
- * @see KColorSchemeMenu::createMenu, KColorSchemeModel
+ * \sa KColorSchemeMenu::createMenu, KColorSchemeModel
*
- * @since 5.0
+ * \since 5.0
*/
class KCOLORSCHEME_EXPORT KColorSchemeManager : public QObject
{
@@ -61,91 +64,91 @@
~KColorSchemeManager() override;
- /**
+ /*!
* A QAbstractItemModel of all available color schemes.
*
* The model provides the name of the scheme in Qt::DisplayRole, a preview
* in Qt::DelegateRole and the full path to the scheme file in
Qt::UserRole. The system theme
* has an empty Qt::UserRole.
*
- * @return Model of all available color schemes.
- * @see KColorSchemeModel
+ * Returns Model of all available color schemes.
+ * \sa KColorSchemeModel
*/
QAbstractItemModel *model() const;
- /**
- * Returns the model index for the scheme with the given @p id. If no such
+ /*!
+ * Returns the model index for the scheme with the given \param id. If no
such
* scheme exists an invalid index is returned. If you pass an empty string
the index
* returned is equivalent to going back to following the system scheme.
- * @see model
+ * \sa model
*
- * @since 6.6
+ * \since 6.6
*/
QModelIndex indexForSchemeId(const QString &id) const;
- /**
- * Returns the model index for the scheme with the given @p name. If no
such
+ /*!
+ * Returns the model index for the scheme with the given \param name. If
no such
* scheme exists an invalid index is returned. If you pass an empty
* string the index that is equivalent to going back to following the
system scheme is returned
* for versions 5.67 and newer.
- * @see model
+ * \sa model
*/
QModelIndex indexForScheme(const QString &name) const;
- /**
+ /*!
* Saves the color scheme to config file. The scheme is saved by default
whenever it's changed.
* Use this method when autosaving is turned off, see setAutosaveChanges().
*
- * @since 5.89
+ * \since 5.89
*/
void saveSchemeToConfigFile(const QString &schemeName) const;
- /**
- * Sets color scheme autosaving. Default value is @c true.
- * If this is set to @c false, the scheme is not going to be remembered
when the
+ /*!
+ * Sets color scheme autosaving. Default value is \c true.
+ * If this is set to \c false, the scheme is not going to be remembered
when the
* application is restarted.
*
- * @param autosaveChanges Enables/Disables autosaving of the color scheme.
- * @since 5.89
+ * \param autosaveChanges Enables/Disables autosaving of the color scheme.
+ * \since 5.89
*/
void setAutosaveChanges(bool autosaveChanges);
- /**
+ /*!
* Returns the id of the currently active scheme or an empty string if the
default
* scheme is active.
*
- * @since 5.107
+ * \since 5.107
*/
QString activeSchemeId() const;
- /**
+ /*!
* Returns the name of the currently active scheme or an empty string if
the default
* scheme is active.
*
- * @since 6.6
+ * \since 6.6
*/
QString activeSchemeName() const;
- /**
+ /*!
* Returns the manager for the current application instance.
* If no instance is existing, it will be constructed.
* Must be called after construction of the gui application instance.
*
- * @return color scheme manager for the current application instance
+ * Returns color scheme manager for the current application instance
*
- * @since 6.6
+ * \since 6.6
*/
static KColorSchemeManager *instance();
public Q_SLOTS:
- /**
- * @brief Activates the KColorScheme identified by the provided @p index.
+ /*!
+ * \brief Activates the KColorScheme identified by the provided \param
index.
*
* Installs the KColorScheme as the QApplication's QPalette.
*
- * @param index The index for the KColorScheme to activate.
- * The index must reference the QAbstractItemModel provided by @link model
@endlink. Since
+ * \param index The index for the KColorScheme to activate.
+ * The index must reference the QAbstractItemModel provided by model().
Since
* version 5.67 passing an invalid index activates the system scheme.
- * @see model()
+ * \sa model()
*/
void activateScheme(const QModelIndex &index);
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kcolorschememodel.h
new/kcolorscheme-6.15.0/src/kcolorschememodel.h
--- old/kcolorscheme-6.14.0/src/kcolorschememodel.h 2025-05-02
16:15:47.000000000 +0200
+++ new/kcolorscheme-6.15.0/src/kcolorschememodel.h 2025-06-06
15:29:19.000000000 +0200
@@ -18,15 +18,24 @@
struct KColorSchemeModelPrivate;
-/**
- * A model listing the KColorSchemes available in the system.
+/*!
+ * \class KColorSchemeModel
+ * \inmodule KColorScheme
*
- * @since 5.84
+ * \brief A model listing the KColorSchemes available in the system.
+ *
+ * \since 5.84
*/
class KColorSchemeModel : public QAbstractListModel
{
Q_OBJECT
public:
+ /*!
+ * \value NameRole
+ * \value IconRole
+ * \value PathRole
+ * \value IdRole
+ */
enum Roles {
NameRole = Qt::DisplayRole,
IconRole = Qt::DecorationRole,
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/kcolorscheme-6.14.0/src/kstatefulbrush.h
new/kcolorscheme-6.15.0/src/kstatefulbrush.h
--- old/kcolorscheme-6.14.0/src/kstatefulbrush.h 2025-05-02
16:15:47.000000000 +0200
+++ new/kcolorscheme-6.15.0/src/kstatefulbrush.h 2025-06-06
15:29:19.000000000 +0200
@@ -13,9 +13,11 @@
class KStatefulBrushPrivate;
-/**
- * @class KStatefulBrush kstatefulbrush.h KStatefulBrush
- * A container for a "state-aware" brush.
+/*!
+ * \class KStatefulBrush
+ * \inmodule KColorScheme
+ *
+ * \brief A container for a "state-aware" brush.
*
* KStatefulBrush provides an easy and safe way to store a color for use in a
* user interface. It is "safe" both in that it will make it easy to deal with
@@ -31,7 +33,7 @@
* brushes, for example when working with a application specific user-defined
* color palette.
*
- * @note As of Qt 4.3, QPalette::ColorGroup is missing a state for disabled
+ * \note As of Qt 4.3, QPalette::ColorGroup is missing a state for disabled
* widgets in an inactive window. Hopefully Trolltech will fix this bug, at
* which point KColorScheme and KStatefulBrush will be updated to recognize the
* new state. Using KStatefulBrush will allow your application to inherit these
@@ -40,14 +42,14 @@
class KCOLORSCHEME_EXPORT KStatefulBrush
{
public:
- /**
+ /*!
* Construct a "default" stateful brush. For such an instance, all
* overloads of KStatefulBrush::brush will return a default brush (i.e.
- * <tt>QBrush()</tt>).
+ * QBrush()).
*/
explicit KStatefulBrush();
- /**
+ /*!
* Construct a stateful brush from given color set and foreground role,
* using the colors from the given KConfig.
* If null, the application's color scheme is used (either the system
@@ -55,21 +57,21 @@
*/
explicit KStatefulBrush(KColorScheme::ColorSet,
KColorScheme::ForegroundRole, KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Construct a stateful brush from given color set and background role,
* using the colors from the given KConfig (if null, the application's
* colors are used).
*/
explicit KStatefulBrush(KColorScheme::ColorSet,
KColorScheme::BackgroundRole, KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Construct a stateful brush from given color set and decoration role,
* using the colors from the given KConfig (if null, the application's
* colors are used).
*/
explicit KStatefulBrush(KColorScheme::ColorSet,
KColorScheme::DecorationRole, KSharedConfigPtr = KSharedConfigPtr());
- /**
+ /*!
* Construct a stateful background brush from a specified QBrush (or
* QColor, via QBrush's implicit constructor). The various states are
* determined from the base QBrush (which fills in the Active state)
@@ -79,7 +81,7 @@
*/
explicit KStatefulBrush(const QBrush &, KSharedConfigPtr =
KSharedConfigPtr());
- /**
+ /*!
* Construct a stateful foreground/decoration brush from a specified
* QBrush (or QColor, via QBrush's implicit constructor). The various
* states are determined from the base QBrush (which fills in the Active
@@ -87,33 +89,32 @@
* from the system color scheme. The state effects from the given KConfig
* are used (if null, the application's state effects are used).
*
- * @param background The background brush (or color) corresponding to the
+ * \param background The background brush (or color) corresponding to the
* KColorScheme::NormalBackground role and QPalette::Active state for this
* foreground/decoration color.
*/
explicit KStatefulBrush(const QBrush &, const QBrush &background,
KSharedConfigPtr = KSharedConfigPtr());
- /** Construct a copy of another KStatefulBrush. */
+ /*! Construct a copy of another KStatefulBrush. */
KStatefulBrush(const KStatefulBrush &);
- /** Destructor */
~KStatefulBrush();
- /** Standard assignment operator */
+ /*! Standard assignment operator */
KStatefulBrush &operator=(const KStatefulBrush &);
- /**
+ /*!
* Retrieve the brush for the specified widget state. This is used when you
* know explicitly what state is wanted. Otherwise one of overloads is
* often more convenient.
*/
QBrush brush(QPalette::ColorGroup) const;
- /**
+ /*!
* Retrieve the brush, using a QPalette reference to determine the correct
* state. Use when your painting code has easy access to the QPalette that
* it is supposed to be using. The state used in this instance is the
- * currentColorGroup of the palette.
+ * QPalette::currentColorGroup().
*/
QBrush brush(const QPalette &) const;
