Bug 266664

Summary: tool tips over catch words are uninformative
Product: [Websites] docs.kde.org Reporter: Christopher Yeleighton <giecrilj>
Component: generalAssignee: Documentation Editorial Team <kde-doc-english>
Status: RESOLVED FIXED    
Severity: minor CC: tchollingsworth
Priority: NOR    
Version: unspecified   
Target Milestone: ---   
Platform: openSUSE   
OS: Linux   
Latest Commit: Version Fixed In:

Description Christopher Yeleighton 2011-02-19 12:42:56 UTC
Version:           unspecified (using KDE 4.6.0) 
OS:                Linux

Tool tips over catch words in the documentation show the name of the current section, regardless of the word and the referenced document.  This is misleading and uninformative.  Either remove them or make them display a summary of the target.

Reproducible: Always

Steps to Reproduce:
  1. { xdg-open 'help:/kioslave/info/index.html'; }
  2. Hover over "gcc"

Actual Results:  
  1. … of the Info documentation for the gcc compiler
  2. tooltip: "Info"

Expected Results:  
  2. tooltip: "how to use the GNU compilers"

Documents published on the Web do not have tool tips.
Compare: <URL: http://docs.kde.org/stable/en/kdebase-runtime/kioslave/info/index.html >
Comment 1 T.C. Hollingsworth 2011-08-26 01:14:30 UTC
The XSLT templates need to be modified to not set the title attribute of the <div>s enclosing section and chapter elements.

I'm working on a patch for the kdelibs folks.
Comment 2 T.C. Hollingsworth 2011-08-27 22:53:22 UTC
The spurious title attribute is coming from upstream DocBook's XSLT files, not KDE's customizations.  I'm not sure if we should/can override this in KDE's custom XSLT files or get it fixed upstream.
Comment 3 T.C. Hollingsworth 2011-12-13 19:16:08 UTC
Finally figured this one out:
https://git.reviewboard.kde.org/r/103405/
Comment 4 T.C. Hollingsworth 2011-12-13 21:10:02 UTC
Git commit 6f0dfcbfec4d05a1cbff6f16df17ff19bba334a5 by T.C. Hollingsworth.
Committed on 13/12/2011 at 22:08.
Pushed by hollingsworth into branch 'KDE/4.7'.

get rid of 'title' attribute in DocBook generated HTML
fixes annoying tooltips in KDE documentation

BUG:266664
REVIEW:103405

M  +2    -0    kdoctools/customization/kde-include-common.xsl.cmake

http://commits.kde.org/kdelibs/6f0dfcbfec4d05a1cbff6f16df17ff19bba334a5