Description Remy Suen 2008-11-16 08:30:23 EST

IDragAndDropService's class level javadoc states the following:

"Authors should access this service using the PartSite's getService method, passing this interface as the argument."

It is implied that the scope of this service is only available at the part site level (similar to IWorkbenchSiteProgressService) but this is not made explicit. This should be corrected. It should be noted that it is only for editors and not for views (which is somewhat implied in its methods' javadocs).

Its addMergedDropTarget(Control, int, Transfer[], DropTargetListener) method states the following:

"NOTE: Site authors must use this method to add drop behaviour; directly adding drop targets using SWT onto a site will cause the standard site behaviour (i.e. dragging files / markers into the EditorSite...) to not work when that editor is active."

It is not clear what "authors" means in this context (or is this a general Eclipse "word")? The word "author" seems to imply that it's for people that are creating/implementing part sites. However, this interpretation appears to contradict IWorkbenchSite and all its subinterfaces' specification as they are all spec'ed with @noimplement.