Bug 19756 - [ExternalTools] Confusing variable terminology
Summary: [ExternalTools] Confusing variable terminology
Status: RESOLVED WONTFIX
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Ant (show other bugs)
Version: 2.0   Edit
Hardware: PC Windows 2000
: P3 minor (vote)
Target Milestone: ---   Edit
Assignee: Platform-Ant-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords: ui
: 20588 (view as bug list)
Depends on:
Blocks:
 
Reported: 2002-06-10 00:01 EDT by Chris McLaren CLA
Modified: 2009-08-30 02:21 EDT (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Chris McLaren CLA 2002-06-10 00:01:26 EDT
External Tools provides variables for a resources' location and full path, 
which eventually resolves to the accessors of the same names in IResource.

To a user, "full path" intuitively means an absolute path on a file system, 
while "location" is a more abstract notion - more useful a term to describe a 
relative position within a domain-specific semantic construct like 'workspace'. 

Perhaps "full path" and "location" should be swapped. Please note for version 
3.0, if a renaming of this nature could be more than a remote possibility.
Comment 1 John Arthorne CLA 2002-07-26 14:59:05 EDT
To me, "location" suggests the physical place where the file is stored on the 
disk, while a path is just a means of finding that resource in the logical 
structure of the workspace.

Regardless of semantic interpretation, I don't think it's worth the API upheaval 
and confusion to existing developers to swap the meaning of these terms.  
"Location" and "path" are used consistently throughout the core API with those 
meanings.  It's called "full path" to contrast with project-relative paths that 
are also part of the API.

I think both terms are abstract when presented to the user outside the context 
of the workspace API.  If these terms aren't clear enough when presented in the 
UI, then it might be appropriate to explain them more clearly within the UI.
Comment 2 Nick Edgar CLA 2002-07-26 16:26:22 EDT
Reopening for UI consideration.
Comment 3 Nick Edgar CLA 2002-07-26 16:27:27 EDT
Should come up with more intuitive variable names, that aren't so bound to Core 
API terminology.
Comment 4 Simon Arsenault CLA 2002-09-06 15:15:31 EDT
Address in the new external tool rework

Note: new external tool work is not yet released to the head stream and won't 
for a while yet.
Comment 5 Jared Burns CLA 2002-09-27 15:20:13 EDT
This bug has not been fixed and should not have been closed.
Comment 6 Darin Wright CLA 2002-11-15 11:06:57 EST
Nothing more planned for 2.1. When selecting a varible as a tool argument, the 
variables appear with a meaninful description.
Comment 7 Darin Wright CLA 2002-11-15 11:57:19 EST
*** Bug 20588 has been marked as a duplicate of this bug. ***
Comment 8 Denis Roy CLA 2009-08-30 02:21:37 EDT
As of now 'LATER' and 'REMIND' resolutions are no longer supported.
Please reopen this bug if it is still valid for you.