Advance Wayland and KDE package bring-up

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
2026-04-14 10:51:06 +01:00
parent 51f3c21121
commit cf12defd28
15214 changed files with 20594243 additions and 269 deletions
@@ -0,0 +1,65 @@
+/*
+    This file is part of the KDE libraries
+    SPDX-FileCopyrightText: 2012 David Faure <faure@kde.org>
+
+    SPDX-License-Identifier: LGPL-2.0-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
+*/
+
+#include "khelpclient.h"
+
+#include <KDesktopFile>
+
+#include <QCoreApplication>
+#include <QDesktopServices>
+#include <QDirIterator>
+#include <QUrl>
+
+void KHelpClient::invokeHelp(const QString &anchor, const QString &_appname)
+{
+    QString appname;
+    if (_appname.isEmpty()) {
+        appname = QCoreApplication::instance()->applicationName();
+    } else {
+        appname = _appname;
+    }
+
+    // Look for the .desktop file of the application
+
+    // was:
+    // KService::Ptr service(KService::serviceByDesktopName(appname));
+    // if (service)
+    //    docPath = service->docPath();
+    // but we don't want to depend on KService here.
+
+    QString docPath;
+    const QStringList desktopDirs = QStandardPaths::standardLocations(QStandardPaths::ApplicationsLocation);
+    for (const QString &dir : desktopDirs) {
+        QDirIterator it(dir, QStringList() << appname + QLatin1String(".desktop"), QDir::NoFilter, QDirIterator::Subdirectories | QDirIterator::FollowSymlinks);
+        while (it.hasNext()) {
+            const QString desktopPath(it.next());
+            KDesktopFile desktopFile(desktopPath);
+            docPath = desktopFile.readDocPath();
+            break;
+        }
+    }
+
+    // docPath could be a path or a full URL, I think.
+
+    QUrl url;
+    if (!docPath.isEmpty()) {
+        url = QUrl(QStringLiteral("help:/")).resolved(QUrl(docPath));
+    } else {
+        if (!anchor.isEmpty()) {
+            if (anchor.contains(QLatin1Char('#'))) {
+                url = QUrl(QStringLiteral("help:/%1/%2").arg(appname, anchor));
+            } else {
+                url = QUrl(QStringLiteral("help:/%1/%2.html").arg(appname, anchor));
+            }
+        } else {
+            url = QUrl(QStringLiteral("help:/%1/index.html").arg(appname));
+        }
+    }
+
+    // launch khelpcenter, or a browser for URIs not handled by khelpcenter
+    QDesktopServices::openUrl(url);
+}