середа, 9 вересня 2020 р. 01:03:27 EEST Jack написано: > On 2020.09.08 16:25, Jack wrote: > > Yuri - thanks for the quick response. > > > > On 2020.09.08 14:09, Yuri Chornoivan wrote: > >> вівторок, 8 вересня 2020 р. 20:46:37 EEST Jack написано: > >>> If I launch the clipboard widget (klipper), click "Configure > >>> Clipboard," and then click the "Help" button, I get the dreaded > >>> "Documentation not Found" page I wrote in 2014. (I just discovered > >>> this because someone sent me a message because my email address is > >>> on that page as the author.) He's on Suse Tumbleweed, and I'm on > >>> Gentoo, so I don't think it's a packaging problem. > >>> > >>> However, if I open khelpcenter and search for klipper (how is > >>> someone to know that "klipper" is the name of the "clipboard" > >>> widget?) the documentation is present. > >>> > >>> So, I'm wondering if Klipper is actually calling KHelpCenter with > >>> the wrong name for the doc it is looking for. > >> > >> Sure. The KConfigDialog window is for KCMs, so the "Help" button > >> tries to load help:/kcontrol(5)/klipper, but the docs are stored for > >> help:/klipper. > > > > That makes sense. How easily can that be fixed, and does it need a > > bug filed, and if so, against which component?
No need to: https://bugs.kde.org/show_bug.cgi?id=421589 It might be hard and right (I'm afraid) or easy and _wrong_: https://invent.kde.org/plasma/plasma-workspace/-/merge_requests/252 > > > >>> Separately, when that happens, there is no way to know what page > >>> KHelpCenter was asked to find. Would that be a useful enhancement > >>> to request? (Showing the name of the doc requested when it can't > >>> be found.) > >> > >> I think so. > > > > Bug 426311 filed. > > > >>> I'll also probably try to update the "Documentation not Found" page > >>> to add a note not to contact the author of the page for help, as he > >>> will just tell you to follow the instructions on the page. > > > > I finally found the source of that page, buried under kio, but > > several changes (such as adding a <tip>) are rejected by checkXML5 as > > not following the DTD. It's using kdedbx45.dtd, so I'm not sure why > > a <tip> wouldn't be allowed. > > My bad - I was misreading the error message. I missed that <para> is > needed within <tag>. I've attached a proposed diff to that page. I > also added the suggestion to search in KHelpCenter before checking the > online docs. If there are any suggestions, I"ll be glad to update. Thanks. Pushed. > Jack Best regards, Yuri
