Name: dmR10075 Date: 02/12/2004


I found that several important methods of DropTargetDropEvent,
DropTargetDragEvent, which have key importance during usual DnD
operations, are not well documented and their behavior is not obvious.

For example,
DropTargetDropEvent.rejectDrop has the following documentation:

public void rejectDrop()

        reject the Drop.
        
*** I don't know what does it do really, and for me it seems that
rejecting drop might cause some other consequences worth mentioning.

DropTargetDragEvent.rejectDrag:
public void rejectDrag()

        Rejects the drag as a result of examining either the dropAction
        or the available DataFlavor types.
*** It is known however that this method also informs DragSource about
this decision, and this reject DOESN'T actually reject drop(which can be
the idea coming to the developer's mind) and as the result DragSource
might perform some action like updating cursor.

I think the documentation for the whole package should be revisited and
more details, implementation independent of course, should be
documented.
======================================================================