Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 340342

Summary: [Contributions] Tooltips for command
Product: [Eclipse Project] Platform Reporter: David Pérez <david.perez.ingeniero>
Component: UIAssignee: Prakash Rangaraj <prakash>
Status: VERIFIED FIXED QA Contact: Paul Webster <pwebster>
Severity: normal    
Priority: P3 CC: daniel_megert, prakash
Version: 3.7   
Target Milestone: 3.7 M7   
Hardware: PC   
OS: Windows XP   
Whiteboard:
Bug Depends on:    
Bug Blocks: 440095    
Attachments:
Description Flags
Diff respect to the head version of org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/menus
pwebster: iplog+
Patch v02 none

Description David Pérez CLA 2011-03-17 12:06:32 EDT
The tooltip of a command contribution in a toolbar should be description (longer) instead of the name (normally short), if the first one is available.
In this way, the user will have more detailed information.

The name of a command is more useful for menu items, where the space is more limited.

I attach the patched version.
I have modified from version 1.60 in the source repository.

Additional information in this thread:
http://www.eclipse.org/forums/index.php?t=msg&th=205104&start=0&S=ce33b644d22b52255ed013cedf29262d
Comment 1 Paul Webster CLA 2011-03-18 08:15:22 EDT
Hi David,

It looks like the patch didn't  make it.
PW
Comment 2 David Pérez CLA 2011-03-22 08:19:04 EDT
Created attachment 191669 [details]
Diff respect to the head version of org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/menus
Comment 3 David Pérez CLA 2011-03-22 08:19:31 EDT
I hope now my patch (diff file) is ok.
Comment 4 Prakash Rangaraj CLA 2011-03-23 03:36:37 EDT
Created attachment 191728 [details]
Patch v02

A slightly modified version of the actual diff
Comment 5 Prakash Rangaraj CLA 2011-03-23 03:46:52 EDT
Patch v02 released to HEAD
Comment 6 Prakash Rangaraj CLA 2011-04-26 10:24:37 EDT
Verified in I20110425-1800
Comment 7 Dani Megert CLA 2012-08-20 07:30:44 EDT
Tool tips are somewhere in the middle of the name/label and the description. A description can be very long, even consist of multiple sentences. Also, tool tips must be in headline style and not sentence style:
http://wiki.eclipse.org/index.php/User_Interface_Guidelines#Capitalization

Like we introduced a away to specify command images, we should also have a mechanism to show tool tips, and by default show the name. Filed bug 387583 to track that.