diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/css2/CSS2FontPropertiesHelpers.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/css2/CSS2FontPropertiesHelpers.java index 53dd79eec8f..068e848223f 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/css2/CSS2FontPropertiesHelpers.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/css2/CSS2FontPropertiesHelpers.java @@ -127,7 +127,6 @@ public static void updateCSSPropertyFontComposite(CSS2FontProperties font, CSSVa * * @param font * @param value - * @throws Exception */ public static void updateCSSPropertyFontFamily(CSS2FontProperties font, CSSValue value) { if (value.getCssValueType() == CSSValue.CSS_PRIMITIVE_VALUE) { @@ -140,7 +139,6 @@ public static void updateCSSPropertyFontFamily(CSS2FontProperties font, CSSValue * * @param font * @param value - * @throws Exception */ public static void updateCSSPropertyFontSize(CSS2FontProperties font, CSSValue value) { if (value.getCssValueType() == CSSValue.CSS_PRIMITIVE_VALUE) { @@ -153,7 +151,6 @@ public static void updateCSSPropertyFontSize(CSS2FontProperties font, CSSValue v * * @param font * @param value - * @throws Exception */ public static void updateCSSPropertyFontStyle(CSS2FontProperties font, CSSValue value) { if (value.getCssValueType() == CSSValue.CSS_PRIMITIVE_VALUE) { @@ -166,7 +163,6 @@ public static void updateCSSPropertyFontStyle(CSS2FontProperties font, CSSValue * * @param font * @param value - * @throws Exception */ public static void updateCSSPropertyFontWeight(CSS2FontProperties font, CSSValue value) { if (value.getCssValueType() == CSSValue.CSS_PRIMITIVE_VALUE) { diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/dom/properties/converters/ICSSValueConverter.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/dom/properties/converters/ICSSValueConverter.java index 11c80b9b635..2a30af753ef 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/dom/properties/converters/ICSSValueConverter.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/dom/properties/converters/ICSSValueConverter.java @@ -42,12 +42,11 @@ public interface ICSSValueConverter { * Returns the result of the conversion of the given CSSValue * value. * - * @param value - * the CSSValue to convert, of type {@link #getFromType()} + * @param value the CSSValue to convert * @param engine * @param context * - * @return the converted object, of type {@link #getToType()} + * @return the converted object */ public Object convert(CSSValue value, CSSEngine engine, Object context) throws Exception; diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/engine/CSSEngine.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/engine/CSSEngine.java index 76450e133c7..e05adf0f292 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/engine/CSSEngine.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/engine/CSSEngine.java @@ -367,7 +367,6 @@ ICSSPropertyHandler applyCSSProperty(Object node, String property, CSSValue valu * * @param node * @param applyStylesToChildNodes - * @throws IOException */ void applyDefaultStyleDeclaration(Object node, boolean applyStylesToChildNodes); diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/dom/Measure.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/dom/Measure.java index 1cb4a68370d..64af2ae6f12 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/dom/Measure.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/dom/Measure.java @@ -16,6 +16,7 @@ import org.w3c.css.sac.LexicalUnit; import org.w3c.dom.DOMException; +import org.w3c.dom.css.CSSValue; public class Measure extends CSSValueImpl { @@ -35,8 +36,9 @@ public float getFloatValue(short valueType) throws DOMException { //If it's actually a SAC_INTEGER return the integer value, callers tend to expect and cast //There is no getIntegerFloat(short) //TODO Not sure the purpose of arg valyeType, its not referenced in this method - if(value.getLexicalUnitType() == LexicalUnit.SAC_INTEGER) + if(value.getLexicalUnitType() == LexicalUnit.SAC_INTEGER) { return value.getIntegerValue(); + } //TODO not sure what to do if it's not one of the lexical unit types that are specified in LexicalUnit#getFloatValue() //ie. SAC_DEGREE, SAC_GRADIAN, SAC_RADIAN, SAC_MILLISECOND, SAC_SECOND, SAC_HERTZ or SAC_KILOHERTZ return value.getFloatValue(); @@ -55,8 +57,9 @@ public String getStringValue() throws DOMException { short lexicalUnit = value.getLexicalUnitType(); if((lexicalUnit == LexicalUnit.SAC_IDENT) || (lexicalUnit == LexicalUnit.SAC_STRING_VALUE) - || (lexicalUnit == LexicalUnit.SAC_URI)) + || (lexicalUnit == LexicalUnit.SAC_URI)) { return value.getStringValue(); + } // TODO There are more cases to catch of getLexicalUnitType() throw new UnsupportedOperationException("NOT YET IMPLEMENTED"); } diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/sac/CSSDocumentHandlerImpl.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/sac/CSSDocumentHandlerImpl.java index 8496d851642..9a7dfe40eb1 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/sac/CSSDocumentHandlerImpl.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/impl/sac/CSSDocumentHandlerImpl.java @@ -35,8 +35,8 @@ import org.w3c.dom.css.CSSStyleSheet; /** - * This class provides an implementation for the - * {@link org.eclipse.ui.css.core.sac.ExtendedDocumentHandler} interface. + * This class provides an implementation for the {@link ExtendedDocumentHandler} + * interface. */ public class CSSDocumentHandlerImpl implements ExtendedDocumentHandler { diff --git a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/utils/StringUtils.java b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/utils/StringUtils.java index 7b4a4a58c9f..bb358a6f578 100644 --- a/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/utils/StringUtils.java +++ b/bundles/org.eclipse.e4.ui.css.core/src/org/eclipse/e4/ui/css/core/utils/StringUtils.java @@ -64,16 +64,14 @@ public static boolean isEmpty(String value) { // ----------------------------------------------------------------------- /** *

- * Capitalizes all the whitespace separated words in a String. Only the - * first letter of each word is changed. To convert the rest of each word to - * lowercase at the same time, use {@link #capitalizeFully(String)}. + * Capitalizes all the whitespace separated words in a String. Only the first + * letter of each word is changed. *

* *

* Whitespace is defined by {@link Character#isWhitespace(char)}. A - * null input String returns null. - * Capitalization uses the unicode title case, normally equivalent to upper - * case. + * null input String returns null. Capitalization uses + * the unicode title case, normally equivalent to upper case. *

* * 
@@ -82,11 +80,8 @@ public static boolean isEmpty(String value) {
 	 * WordUtils.capitalize("i am FINE") = "I Am FINE"
 	 *
* - * @param str - * the String to capitalize, may be null + * @param str the String to capitalize, may be null * @return capitalized String, null if null String input - * @see #uncapitalize(String) - * @see #capitalizeFully(String) */ public static String capitalize(String str) { return capitalize(str, null); @@ -95,20 +90,18 @@ public static String capitalize(String str) { /** *

* Capitalizes all the delimiter separated words in a String. Only the first - * letter of each word is changed. To convert the rest of each word to - * lowercase at the same time, use {@link #capitalizeFully(String, char[])}. + * letter of each word is changed. *

* *

- * The delimiters represent a set of characters understood to separate - * words. The first string character and the first non-delimiter character - * after a delimiter will be capitalized. + * The delimiters represent a set of characters understood to separate words. + * The first string character and the first non-delimiter character after a + * delimiter will be capitalized. *

* *

- * A null input String returns null. - * Capitalization uses the unicode title case, normally equivalent to upper - * case. + * A null input String returns null. Capitalization + * uses the unicode title case, normally equivalent to upper case. *

* * 
@@ -119,14 +112,10 @@ public static String capitalize(String str) {
 	 * WordUtils.capitalize("i aM.fine", {'.'}) = "I aM.Fine"
 	 *
* - * @param str - * the String to capitalize, may be null - * @param delimiters - * set of characters to determine capitalization, null means - * whitespace + * @param str the String to capitalize, may be null + * @param delimiters set of characters to determine capitalization, null means + * whitespace * @return capitalized String, null if null String input - * @see #uncapitalize(String) - * @see #capitalizeFully(String) * @since 2.1 */ public static String capitalize(String str, char[] delimiters) { diff --git a/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/dom/SWTElementProvider.java b/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/dom/SWTElementProvider.java index 94c9d100781..2c304f3273c 100644 --- a/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/dom/SWTElementProvider.java +++ b/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/dom/SWTElementProvider.java @@ -44,7 +44,7 @@ * * * {@link IElementProvider} SWT implementation to retrieve w3c Element - * {@link SWTElement} linked to SWT widget. + * {@link Element} linked to SWT widget. * */ public class SWTElementProvider implements IElementProvider { diff --git a/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/helpers/CSSSWTCursorHelper.java b/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/helpers/CSSSWTCursorHelper.java index 35c486d1a5c..eb3beb4574b 100644 --- a/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/helpers/CSSSWTCursorHelper.java +++ b/bundles/org.eclipse.e4.ui.css.swt/src/org/eclipse/e4/ui/css/swt/helpers/CSSSWTCursorHelper.java @@ -25,7 +25,8 @@ public class CSSSWTCursorHelper { private static final String DEFAULT_CURSOR = "defaultCursor"; /** - * @see http://www.w3schools.com/css/pr_class_cursor.asp + * @see http://www.w3schools.com/css/pr_class_cursor.asp */ public static Cursor getSWTCursor(CSSValue value, Display display) { if (!(value.getCssValueType() == CSSValue.CSS_PRIMITIVE_VALUE)) { diff --git a/bundles/org.eclipse.e4.ui.workbench3/src/org/eclipse/ui/testing/IWorkbenchPartTestable.java b/bundles/org.eclipse.e4.ui.workbench3/src/org/eclipse/ui/testing/IWorkbenchPartTestable.java index 08653b20e03..c0363ff4156 100644 --- a/bundles/org.eclipse.e4.ui.workbench3/src/org/eclipse/ui/testing/IWorkbenchPartTestable.java +++ b/bundles/org.eclipse.e4.ui.workbench3/src/org/eclipse/ui/testing/IWorkbenchPartTestable.java @@ -19,7 +19,7 @@ * This interface provides methods that allow introspection of workbench parts. * Instances may be obtained by calling * {@link org.eclipse.core.runtime.IAdaptable#getAdapter(Class)} on - * {@link org.eclipse.ui.IWorkbenchPartSite}. + * org.eclipse.ui.IWorkbenchPartSite. * *

* This interface is not intended to be implemented or extended by clients. @@ -31,8 +31,7 @@ public interface IWorkbenchPartTestable { /** * Get the {@link org.eclipse.swt.widgets.Composite} provided to the parts - * {@link org.eclipse.ui.IWorkbenchPart#createPartControl(Composite)} - * method. + * org.eclipse.ui.IWorkbenchPart.createPartControl(Composite) method. * * @return the composite */ diff --git a/bundles/org.eclipse.jface/src/org/eclipse/jface/widgets/AbstractControlFactory.java b/bundles/org.eclipse.jface/src/org/eclipse/jface/widgets/AbstractControlFactory.java index 6f85790a3ee..1798e37f201 100644 --- a/bundles/org.eclipse.jface/src/org/eclipse/jface/widgets/AbstractControlFactory.java +++ b/bundles/org.eclipse.jface/src/org/eclipse/jface/widgets/AbstractControlFactory.java @@ -52,9 +52,9 @@ public abstract class AbstractControlFactory - *

  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • - *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • - * - * @see List#deselectAll() - * @see List#select(int) + * @exception SWTException + * + * @see org.eclipse.swt.widgets.List#deselectAll() + * @see org.eclipse.swt.widgets.List#select(int) */ public void setSelection (int index) { if (index < 0 || index > buttons.length - 1) { diff --git a/examples/org.eclipse.jface.examples.databinding/src/org/eclipse/jface/examples/databinding/snippets/Snippet040SideEffectRunOnce.java b/examples/org.eclipse.jface.examples.databinding/src/org/eclipse/jface/examples/databinding/snippets/Snippet040SideEffectRunOnce.java index ec8930c7607..90ea805b410 100644 --- a/examples/org.eclipse.jface.examples.databinding/src/org/eclipse/jface/examples/databinding/snippets/Snippet040SideEffectRunOnce.java +++ b/examples/org.eclipse.jface.examples.databinding/src/org/eclipse/jface/examples/databinding/snippets/Snippet040SideEffectRunOnce.java @@ -31,7 +31,7 @@ /** * This snippet shows how to use the - * {@link ISideEffect#runOnce(java.util.function.Supplier, java.util.function.Consumer)} + * {@link ISideEffect#create(java.util.function.Supplier, java.util.function.Consumer)} * method to react properly, when an observable is changed inside an async * action, e.g., a Job. */