Review and update SWT API javadoc (fixes # #689)