Re: [platform-ui-dev] JFace Snippets and (non-Javadoc) @see - Question

[Lars Vogel <lars.vogel@xxxxxxxxx>]

Just for your information: I also ask about the usage of  (non-Javadoc) @see comments via Twitter and Doug Schaefer and Paul Webster indicated that they can probably removed in code which contains @Override.

Best regards, Lars

2013/10/15 Lars Vogel <lars.vogel@xxxxxxxxx>

Hi,

in the JFace snippets (org.eclipse.jface.snippets plug-in) I see frequently (non-Javadoc) @see comments like the following.

v.getTable().addMouseListener(new MouseAdapter() {

/* (non-Javadoc)

* @see org.eclipse.swt.events.MouseAdapter#mouseDown(org.eclipse.swt.events.MouseEvent)

*/

public void mouseDown(MouseEvent e) {

if( v.getTable().getItem(new Point(e.x,e.y)) == null ) {

v.setSelection(new StructuredSelection());

}

}

});

Is my assumption correct that this was created because JFace originally did not require Java 1.5? Should this become @Override instead (except for interfaces which would require Java 1.6)?

Best regards, Lars