Bug 484244

Summary: Help is not linked from the bluedevil KCM
Product: [Applications] systemsettings Reporter: Emir SARI <emir_sari>
Component: kcm_bluetoothAssignee: Plasma Bugs List <plasma-bugs-null>
Status: RESOLVED FIXED    
Severity: normal CC: luigi.toscano, nate, nowrep
Priority: NOR Keywords: regression
Version First Reported In: 6.0.3   
Target Milestone: ---   
Platform: Other   
OS: Linux   
Latest Commit: Version Fixed/Implemented In: 6.5.4
Sentry Crash Report:

Description Emir SARI 2024-03-22 13:07:51 UTC
There is help content associated with the Bluetooth module, but there is no button to open it from System Settings.

Plasma 6.0.2, KDE neon Unstable
Comment 1 Nate Graham 2025-10-30 21:10:29 UTC
Where is the documentation? I don't see any under https://docs.kde.org/stable5/en/plasma-desktop/kcontrol/
Comment 2 Emir SARI 2025-11-02 20:46:09 UTC
Hmm, I thought the BlueDevil documentation would be available there I think.
Comment 3 Nate Graham 2025-11-03 16:30:54 UTC
Do you know where it is?
Comment 4 Emir SARI 2025-11-03 16:35:08 UTC
It’s here: https://invent.kde.org/plasma/bluedevil/-/tree/master/doc?ref_type=heads

Maybe it’s a naming issue from the l10n side. I’ll ask on the i18n channel.
Comment 5 Luigi Toscano 2025-11-03 16:43:44 UTC
I'm not sure how it works, maybe the new QML-based KCMs don't associate the documentation?
(please don't check the docs.kde.org website, we are talking about help:// links, in this case it would be xdg-open help:/kcontrol/bluedevil
 which xdg-open handles correctly through khelpcenter)
Comment 6 Luigi Toscano 2025-11-03 16:48:49 UTC
Or maybe it's just ./src/kcm/kcm_bluetooth.json which missing an entry like
    "X-DocPath": "kcontrol/bluedevil/index.html",

(check kcm/kcm_powerdevilprofilesconfig.json in powerdevil as a reference)
Comment 7 Nate Graham 2025-12-08 22:55:37 UTC
That is indeed the issue!
Comment 8 Bug Janitor Service 2025-12-08 22:56:43 UTC
A possibly relevant merge request was started @ https://invent.kde.org/plasma/bluedevil/-/merge_requests/230
Comment 9 Nate Graham 2025-12-08 22:59:27 UTC
Git commit feaf1739f32ca45b10deeca2f5858f7713f33d8b by Nate Graham.
Committed on 08/12/2025 at 22:55.
Pushed by ngraham into branch 'master'.

kcm: link the help
FIXED-IN: 6.5.4

M  +1    -0    src/kcm/kcm_bluetooth.json

https://invent.kde.org/plasma/bluedevil/-/commit/feaf1739f32ca45b10deeca2f5858f7713f33d8b
Comment 10 Nate Graham 2025-12-08 22:59:41 UTC
Git commit cc81331ed70846a9e9a6c8fcb0c32d2bdbdb1d7e by Nate Graham.
Committed on 08/12/2025 at 22:59.
Pushed by ngraham into branch 'Plasma/6.5'.

kcm: link the help
FIXED-IN: 6.5.4


(cherry picked from commit feaf1739f32ca45b10deeca2f5858f7713f33d8b)

Co-authored-by: Nate Graham <nate@kde.org>

M  +1    -0    src/kcm/kcm_bluetooth.json

https://invent.kde.org/plasma/bluedevil/-/commit/cc81331ed70846a9e9a6c8fcb0c32d2bdbdb1d7e