Problem finding klipper docs (locally)

[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?
>> 
>>> 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.

  Jack
-------------- next part --------------
A non-text attachment was scrubbed...
Name: update-docnotfound.patch
Type: text/x-patch
Size: 1917 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20200908/6fa70042/attachment.bin>