After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 356137 - Thoughts on tool names and tooltips...
Thoughts on tool names and tooltips...
Status: RESOLVED FIXED
Product: GIMP
Classification: Other
Component: Tools
git master
Other All
: Normal minor
: 2.4
Assigned To: GIMP Bugs
GIMP Bugs
Depends on:
Blocks:
 
 
Reported: 2006-09-15 14:57 UTC by jbaker
Modified: 2006-09-26 23:00 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Edited Source Files... (710.00 KB, patch)
2006-09-16 13:17 UTC, jbaker
none Details | Review
Tools Patch... (33.94 KB, patch)
2006-09-17 19:33 UTC, jbaker
committed Details | Review

Description jbaker 2006-09-15 14:57:01 UTC
I started looking at the tool names and tooltips after seeing someone refer to the new "Rect Select" tool, and also when I noticed that there was a capital "R" in the tool tip... These are just some thoughts that came to mind after looking through them...

Some of the names for the tools are open for differences in reference and common conversation. For example: The "Rect Select" tool will probably be interepted, refered to, and written about in several different ways - The "Rect Select" tool, the "Rectangle Select" tool, the "Rectangle Selection" tool, the "Rectangular Select" or "Selection" tool, etc... 

If the wording for some of the tool names were changed a little it would provide for more consistancy in the way the community refers to the tools. If for example, the text for "Rect Select" was changed to "Rectangular Selection" it would effectively set only one way to refer to the tool. This would filter on down to the documentation team, tutorial writers, book authors, and everyday conversation.

You could also add the tool name in the tooltip for the tool in the toolbox. Basically the format could be Tool Name/Colon/Description... So for the "Rectangular Selection" tool, the tooltip could be "Rectangular Selection: Select rectangular regions" - This would really help those trying to learn the program and those writing/reading a tutorial or documentation... 

Another option is just to use the tool name in the tooltip with no description... Most of the tools can do more things and require more information than what a tooltip can provide anyway.

Anyway - just thought I'd throw it all out here...


The following is a list of possible changes to the tool names in the tools dialog and the matching tooltip for the toolbox. I left the word "tool" off of all names and descriptions. Depending on the tool, most people will add the word automatically when referring to them... 

Suggested Tools Dialog: "Rectangular Selection"
Suggested Toolbox Hint: "Rectangular Selection: Select rectangular regions"
* Note *: If you decide to keep the original - I would change the capitol "R" to lower-case...

Suggested Tools Dialog: "Elliptical Selection"
Suggested Toolbox Hint: "Elliptical Selection: Select elliptical regions"

Suggested Tools Dialog: "Free Selection"
Suggested Toolbox Hint: "Free Selection: Select hand-drawn regions"

Suggested Tools Dialog: "Fuzzy Selection"
Suggested Toolbox Hint: "Fuzzy Selection: Select contiguous regions"

Suggested Tools Dialog: "Color Selection"
Suggested Toolbox Hint: "Color Selection: Select regions by color"

Suggested Tools Dialog: "Scissors Selection"
Suggested Toolbox Hint: "Scissors Selection: Select regions defined by high-contrast edges"

Suggested Tools Dialog: "Foreground Selection"
Suggested Toolbox Hint: "Foreground Selection: Select regions by defining forground criteria"

Tools Dialog: "Paths"
Suggested Toolbox Hint: "Paths: Create and edit paths"

Tools Dialog: "Color Picker"
Suggested Toolbox Hint: "Color Picker: Set foreground color by selecting a color in the active image"

Tools Dialog: "Zoom"
Suggested Toolbox Hint: "Zoom: Adjust the zoom level in the active view"

Tools Dialog: "Measure"
Suggested Toolbox Hint: "Measure: Measure distances and angles"
* Note *: Could use "Measuring" instead of "Measure". Most people will probably say "Measuring Tool"

Tools Dialog: "Move"
Suggested Toolbox Hint: "Move: Move layers, selections, and other objects"

Suggested Tools Dialog: "Alignment"
Suggested Toolbox Hint: "Alignment: Align layers and other objects"

Tools Dialog: "Crop"
Suggested Toolbox Hint: "Crop: Discard areas of active image outside of a user defined region "

Tools Dialog: "Rotate"
Suggested Toolbox Hint: "Rotate: Rotate active layer or selection"

Tools Dialog: "Scale"
Suggested Toolbox Hint: "Scale: Scale active layer or selection"

Tools Dialog: "Shear"
Suggested Toolbox Hint: "Shear: Shear active layer or selection"

Tools Dialog: "Perspective"
Suggested Toolbox Hint: "Perspective: Change perspective of the active layer or selection"

Tools Dialog: "Flip"
Suggested Toolbox Hint: "Flip: Flip the active layer or selection"

Tools Dialog: "Text"
Suggested Toolbox Hint: "Text: Create a text layer"

Tools Dialog: "Bucket Fill"
Suggested Toolbox Hint: "Bucket Fill: Fill with color or a pattern"
* Note *: Could just use the word "Bucket" instead of "Bucket Fill"... 

Tools Dialog: "Blend"
Suggested Toolbox Hint: "Blend: Fill using active gradient"

Tools Dialog: "Pencil"
Suggested Toolbox Hint: "Pencil: Hard edge painting using active brush"

Tools Dialog: "Paintbrush"
Suggested Toolbox Hint: "Paintbrush: Smooth edge painting using active brush"

Tools Dialog: "Eraser"
Suggested Toolbox Hint: "Eraser: Erase to background or transparency using active brush"

Tools Dialog: "Airbrush"
Suggested Toolbox Hint: "Airbrush: Variable pressure painting using active brush"

Tools Dialog: "Ink"
Suggested Toolbox Hint: "Ink: Liquid style painting"

Tools Dialog: "Clone"
Suggested Toolbox Hint: "Clone: Paint with active brush using image regions or patterns as the source for color"

Suggested Tools Dialog: "Healing"
Suggested Toolbox Hint: "Healing: Repair image irregularities"

Tools Dialog: "Perspective Clone"
Suggested Toolbox Hint: "Perspective Clone: Change perspective of active layer or selection"
* Note *: If you decide to keep the original - check the upper-case/lower-case on the text...

Tools Dialog: "Convolve"
Suggested Toolbox Hint: "Convolve: Selective blurring or sharpening using the active brush"

Tools Dialog: "Smudge"
Suggested Toolbox Hint: "Smudge: Selective smearing/smudging using the active brush"

Tools Dialog: "Dodge-Burn"
Suggested Toolbox Hint: "Dodge-Burn: Selective dodging(lighten) or burning(darken) using the active brush"


* Just an "I wonder" question - Since the following are not visible by default. They don't seem to fall into the tools category. They're now in a separate menu. How would the community react if you removed them out of the tool dialogs and the toolbox... ?

Color Balance
Hue-Saturation
Colorize
Brightness-Contrast
Threshold
Levels
Curves
Posterize:


Other information:
Comment 1 weskaggs 2006-09-15 16:24:28 UTC
I'm mostly in favor of these changes, with some modifications of detail:  I would use "select" instead of "selection", "rectangle" instead of "rectangular", and "ellipse" instead of "elliptical".  Also I would add the word "tool" in the tooltips.  So for example the tooltip for Rectangle Select would read "Rectangle Select tool: select rectangular regions".

Regarding the extra question, please stick to one topic per bug report.
Comment 2 jbaker 2006-09-16 13:16:39 UTC
I'm not a coder(BIG Warning) but I wanted to help out so I made the changes in the source files and added it as an attachment... I don't think I broke anything...

I went with "Rectangle", "Ellipse", and "Select"...
I also added the word "Tools" to all of the tooltips...
The text for the tools were changed in the "Tools Dialogs", Tooltips in the "Toolbox" and in the image menu...

One thing... (I'm submitting another bug) I could not find the new "Alignment" tool in the image menu...

Just review and do what you would like with them....

Comment 3 jbaker 2006-09-16 13:17:33 UTC
Created attachment 72897 [details] [review]
Edited Source Files...
Comment 4 Sven Neumann 2006-09-17 12:45:18 UTC
If you want to help us, please do not attach the edited source files but a unified diff between CVS and the edited version. If you edited the files in a CVS checkout, you would create such a diff using the command "cvs diff -up > patchfile".
Comment 5 jbaker 2006-09-17 19:33:51 UTC
Created attachment 72946 [details] [review]
Tools Patch...

Thanks for your help... Learned something new today...

I think I did it correctly. If not let me know...

just review the text and change/keep/delete whatever you want...
Comment 6 Sven Neumann 2006-09-17 19:43:18 UTC
OK, if we can agree that we like the change of including the tool name in the tooltip, there are probably only two changes here that need discussion:

 Bucket Fill -> Bucket     not sure if this is a change to the better
 Heal        -> Healing    doesn't seem to be consistent with the other tool names
Comment 7 jbaker 2006-09-17 23:52:58 UTC
Sure, I'm just throwing my ideas out... whatever you all like it to be... and if you decide not to put any of it in, thats fine too...

I'll let you all decide and go from here...

thanks for you help...
Comment 8 weskaggs 2006-09-18 18:07:56 UTC
Okay, I have applied these changes, along with a few "improvements".  I rejected "Bucket Fill -> Bucket" but accepted "Heal -> Healing" even though it is inconsistent, because "Heal Tool" just plain sounds bad to a native English speaker.  Not sure why exactly, but it does.

The main thing that needs fixing still is the "convolve" tool.  I changed it to "blur/sharpen" because "convolve" is completely meaningless to the great majority of users.  However, for the moment I left the menu entry as "Con_volve" because the shortcut is "V" -- this state of affairs can't stand, though.

Also -- note to J. Baker -- I added the word "Tool" for the color tools as well, because they are in fact tools, and can be added to the toolbox even though they don't appear there by default.

2006-09-18  Bill Skaggs  <weskaggs@primate.ucdavis.edu>

	* app/tools/gimpairbrushtool.c
	* app/tools/gimpaligntool.c
	* app/tools/gimpblendtool.c
	* app/tools/gimpbrightnesscontrasttool.c
	* app/tools/gimpbucketfilltool.c
	* app/tools/gimpbycolorselecttool.c
	* app/tools/gimpclonetool.c
	* app/tools/gimpcolorbalancetool.c
	* app/tools/gimpcolorizetool.c
	* app/tools/gimpcolorpickertool.c
	* app/tools/gimpconvolvetool.c
	* app/tools/gimpcroptool.c
	* app/tools/gimpcurvestool.c
	* app/tools/gimpdodgeburntool.c
	* app/tools/gimpellipseselecttool.c
	* app/tools/gimperasertool.c
	* app/tools/gimpfliptool.c
	* app/tools/gimpforegroundselecttool.c
	* app/tools/gimpfreeselecttool.c
	* app/tools/gimpfuzzyselecttool.c
	* app/tools/gimphealtool.c
	* app/tools/gimphuesaturationtool.c
	* app/tools/gimpinktool.c
	* app/tools/gimpiscissorstool.c
	* app/tools/gimplevelstool.c
	* app/tools/gimpmagnifytool.c
	* app/tools/gimpmeasuretool.c
	* app/tools/gimpmovetool.c
	* app/tools/gimppaintbrushtool.c
	* app/tools/gimppenciltool.c
	* app/tools/gimpperspectiveclonetool.c
	* app/tools/gimpperspectivetool.c
	* app/tools/gimpposterizetool.c
	* app/tools/gimprectangleselecttool.c
	* app/tools/gimprectangletool.c
	* app/tools/gimprotatetool.c
	* app/tools/gimpscaletool.c
	* app/tools/gimpsheartool.c
	* app/tools/gimpsmudgetool.c
	* app/tools/gimptexttool.c
	* app/tools/gimpthresholdtool.c
	* app/tools/gimpvectortool.c:  Apply patch from J. Baker,
	with some modifications, to improve tooltips and tool
	names.  Almost fixes bug #356137.
Comment 9 Sven Neumann 2006-09-20 06:47:20 UTC
We still need to change Convolve in the menus then. It doesn't matter if we need to change the shortcut for this or even discard the default shortcut.
Comment 10 Michael Natterer 2006-09-26 23:00:57 UTC
Fixed in CVS:

2006-09-27  Michael Natterer  <mitch@gimp.org>

	* app/tools/gimpconvolvetool.c (gimp_convolve_tool_register):
	changed menu label to "Bl_ur / Sharpen" and shortcut to Shift+U.
	Fixes bug #356137. Use "Blur / Sharpen" for all strings.

	* app/tools/gimpdodgeburntool.c (gimp_dodge_burn_tool_register):
	changed strings from "Dodge/Burn" to "Dodge / Burn".