Bug 266664 - tool tips over catch words are uninformative
Summary: tool tips over catch words are uninformative
Status: RESOLVED FIXED
Alias: None
Product: docs.kde.org
Classification: Websites
Component: general (show other bugs)
Version: unspecified
Platform: openSUSE Linux
: NOR minor
Target Milestone: ---
Assignee: Documentation Editorial Team
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-02-19 12:42 UTC by Christopher Yeleighton
Modified: 2011-12-13 21:10 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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