diff options
author | Alexander Kurtakov | 2019-02-16 10:31:27 +0000 |
---|---|---|
committer | Alexander Kurtakov | 2019-02-16 12:43:51 +0000 |
commit | 63e8925dc77db3b93ef521dc6cf2bd6ded7bab64 (patch) | |
tree | ee4799a68345447fb032562b0321b703276046a8 /bundles | |
parent | bddbd2c4bf069e834c9b05f2d0f79147941a6aef (diff) | |
download | eclipse.platform.swt-63e8925dc77db3b93ef521dc6cf2bd6ded7bab64.tar.gz eclipse.platform.swt-63e8925dc77db3b93ef521dc6cf2bd6ded7bab64.tar.xz eclipse.platform.swt-63e8925dc77db3b93ef521dc6cf2bd6ded7bab64.zip |
Bug 543933 - Build javadocs with Java 11
Fix javadoc warnings catched by Java 11 tool with XDoclint:html.
Change-Id: I629f93157dbd7fed59d6a42b3b793c151f8f4ed0
Signed-off-by: Alexander Kurtakov <akurtako@redhat.com>
Diffstat (limited to 'bundles')
10 files changed, 37 insertions, 44 deletions
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledText.java b/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledText.java index 0752edda55..c26aa9073a 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledText.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledText.java @@ -7980,6 +7980,7 @@ public void replaceStyleRanges(int start, int length, StyleRange[] ranges) { * <p> * <b>NOTE:</b> During the replace operation the current selection is * changed as follows: + * </p> * <ul> * <li>selection before replaced text: selection unchanged * <li>selection after replaced text: adjust the selection so that same text @@ -7987,7 +7988,6 @@ public void replaceStyleRanges(int start, int length, StyleRange[] ranges) { * <li>selection intersects replaced text: selection is cleared and caret * is placed after inserted text * </ul> - * </p> * * @param start offset of first character to replace * @param length number of characters to replace. Use 0 to insert text @@ -8407,7 +8407,7 @@ void setAlignment() { /** * Sets the alignment of the widget. The argument should be one of <code>SWT.LEFT</code>, * <code>SWT.CENTER</code> or <code>SWT.RIGHT</code>. The alignment applies for all lines. - * </p><p> + * <p> * Note that if <code>SWT.MULTI</code> is set, then <code>SWT.WRAP</code> must also be set * in order to stabilize the right edge before setting alignment. * </p> @@ -8605,7 +8605,6 @@ void setBlockSelectionOffset (int anchorOffset, int offset, boolean sendEvent) { /** * Sets the receiver's caret. Set the caret's height and location. * - * </p> * @param caret the new caret for the receiver * * @exception SWTException <ul> @@ -8875,7 +8874,6 @@ public void setCursor (Cursor cursor) { } /** * Sets whether the widget implements double click mouse behavior. - * </p> * * @param enable if true double clicking a word selects the word, if false * double clicks have the same effect as regular mouse clicks. @@ -8895,7 +8893,6 @@ public void setDragDetect (boolean dragDetect) { } /** * Sets whether the widget content can be edited. - * </p> * * @param editable if true content can be edited, if false content can not be * edited @@ -9493,7 +9490,6 @@ public void setLineSpacing(int lineSpacing) { * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> - * </ul> * @see #setLineSpacingProvider(StyledTextLineSpacingProvider) * @since 3.107 */ diff --git a/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledTextContent.java b/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledTextContent.java index cb85dfdbc5..140390c568 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledTextContent.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Custom Widgets/common/org/eclipse/swt/custom/StyledTextContent.java @@ -166,6 +166,7 @@ public void removeTextChangeListener(TextChangeListener listener); * <code>TextChangedEvent</code> is received. * <p> * The <code>TextChangingEvent</code> should be set as follows: + * </p> * <ul> * <li>event.start = start of the replaced text * <li>event.newText = text that is going to be inserted or empty String @@ -185,7 +186,6 @@ public void removeTextChangeListener(TextChangeListener listener); * <li>("a", "\n\n") ==> (0, 2) * <li>("\n", "") ==> (1, 0) * </ul> - * </p> * * @param start start offset of text to replace, none of the offsets include * delimiters of preceding lines, offset 0 is the first character of the diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/Transfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/Transfer.java index a867749dad..6950ec5b69 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/Transfer.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/Transfer.java @@ -79,18 +79,18 @@ abstract protected String[] getTypeNames(); * Converts a java representation of data to a platform specific representation of * the data. * - * <p>On a successful conversion, the transferData.result field will be set as follows: + * <p>On a successful conversion, the transferData.result field will be set as follows:</p> * <ul> * <li>Windows: COM.S_OK * <li>GTK: 1 - * </ul></p> + * </ul> * * <p>If this transfer agent is unable to perform the conversion, the transferData.result - * field will be set to a failure value as follows: + * field will be set to a failure value as follows:</p> * <ul> * <li>Windows: COM.DV_E_TYMED or COM.E_FAIL * <li>GTK: 0 - * </ul></p> + * </ul> * * @param object a java representation of the data to be converted; the type of * Object that is passed in is dependent on the <code>Transfer</code> subclass. diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DragSourceListener.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DragSourceListener.java index f2c744fd51..4d508cb725 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DragSourceListener.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DragSourceListener.java @@ -13,7 +13,7 @@ *******************************************************************************/ package org.eclipse.swt.dnd; -import org.eclipse.swt.internal.SWTEventListener; +import org.eclipse.swt.internal.*; /** * The <code>DragSourceListener</code> class provides event notification to the application for DragSource events. @@ -33,12 +33,12 @@ public interface DragSourceListener extends SWTEventListener { * The user has begun the actions required to drag the widget. This event gives the application * the chance to decide if a drag should be started. * - * <p>The following fields in the DragSourceEvent apply: + * <p>The following fields in the DragSourceEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time * <li>(in,out)doit - * </ul></p> + * </ul> * * @param event the information associated with the drag start event * @@ -49,14 +49,14 @@ public void dragStart(DragSourceEvent event); /** * The data is required from the drag source. * - * <p>The following fields in the DragSourceEvent apply: + * <p>The following fields in the DragSourceEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time * <li>(in)dataType - the type of data requested. * <li>(out)data - the application inserts the actual data here (must match the dataType) * <li>(out)doit - set this to cancel the drag - * </ul></p> + * </ul> * * @param event the information associated with the drag set data event * @@ -68,13 +68,13 @@ public void dragSetData(DragSourceEvent event); * The drop has successfully completed(mouse up over a valid target) or has been terminated (such as hitting * the ESC key). Perform cleanup such as removing data from the source side on a successful move operation. * - * <p>The following fields in the DragSourceEvent apply: + * <p>The following fields in the DragSourceEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time * <li>(in)doit * <li>(in)detail - * </ul></p> + * </ul> * * @param event the information associated with the drag finished event * diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DropTargetListener.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DropTargetListener.java index 15eca46fb5..0e40f22dc1 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DropTargetListener.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/common/org/eclipse/swt/dnd/DropTargetListener.java @@ -13,7 +13,7 @@ *******************************************************************************/ package org.eclipse.swt.dnd; -import org.eclipse.swt.internal.SWTEventListener; +import org.eclipse.swt.internal.*; /** * The <code>DropTargetListener</code> class provides event notification to the application @@ -41,7 +41,7 @@ public interface DropTargetListener extends SWTEventListener { /** * The cursor has entered the drop target boundaries. * - * <p>The following fields in the DropTargetEvent apply: + * <p>The following fields in the DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -52,7 +52,7 @@ public interface DropTargetListener extends SWTEventListener { * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback - * </ul></p> + * </ul> * * <p>The <code>operations</code> value is determined by the modifier keys pressed by the user. * If no keys are pressed the <code>event.detail</code> field is set to DND.DROP_DEFAULT. @@ -84,7 +84,7 @@ public void dragEnter(DropTargetEvent event); * The cursor has left the drop target boundaries OR the drop has been cancelled OR the data * is about to be dropped. * - * <p>The following fields in the DropTargetEvent apply: + * <p>The following fields in the DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -94,7 +94,7 @@ public void dragEnter(DropTargetEvent event); * <li>(in)currentDataType * <li>(in)operations * <li>(in)detail - * </ul></p> + * </ul> * * @param event the information associated with the drag leave event * @@ -106,7 +106,7 @@ public void dragLeave(DropTargetEvent event); * The operation being performed has changed (usually due to the user changing the selected modifier key(s) * while dragging). * - * <p>The following fields in the DropTargetEvent apply: + * <p>The following fields in the DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -117,7 +117,7 @@ public void dragLeave(DropTargetEvent event); * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback - * </ul></p> + * </ul> * * <p>The <code>operations</code> value is determined by the modifier keys pressed by the user. * If no keys are pressed the <code>event.detail</code> field is set to DND.DROP_DEFAULT. @@ -144,7 +144,7 @@ public void dragOperationChanged(DropTargetEvent event); /** * The cursor is moving over the drop target. * - * <p>The following fields in the DropTargetEvent apply: + * <p>The following fields in the DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -155,7 +155,7 @@ public void dragOperationChanged(DropTargetEvent event); * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback - * </ul></p> + * </ul> * * <p>The <code>operations</code> value is determined by the value assigned to * <code>currentDataType</code> in previous dragEnter and dragOver calls.</p> @@ -197,7 +197,7 @@ public void dragOver(DropTargetEvent event); * To determine the type of the data object, refer to the documentation for the Transfer subclass * specified in event.currentDataType. * - * <p>The following fields in DropTargetEvent apply: + * <p>The following fields in DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -206,7 +206,7 @@ public void dragOver(DropTargetEvent event); * <li>(in,out)detail * <li>(in)currentDataType * <li>(in)data - * </ul></p> + * </ul> * * <p>The application can refuse to perform the drop operation by setting the detail * field to DND.DROP_NONE.</p> @@ -221,7 +221,7 @@ public void drop(DropTargetEvent event); * The drop is about to be performed. * The drop target is given a last chance to change the nature of the drop. * - * <p>The following fields in the DropTargetEvent apply: + * <p>The following fields in the DropTargetEvent apply:</p> * <ul> * <li>(in)widget * <li>(in)time @@ -231,7 +231,7 @@ public void drop(DropTargetEvent event); * <li>(in,out)currentDataType * <li>(in)operations * <li>(in,out)detail - * </ul></p> + * </ul> * * <p>The application can veto the drop by setting the <code>event.detail</code> field to * <code>DND.DROP_NONE</code>.</p> @@ -241,8 +241,8 @@ public void drop(DropTargetEvent event); * <code>operations</code> field.</p> * * <p>The application can also change the type of data being requested by modifying the - * <code>currentDataTypes</code> field but the value must be one of the values in the < - * code>dataTypes</code> list.</p> + * <code>currentDataTypes</code> field but the value must be one of the values in the + * <code>dataTypes</code> list.</p> * * @param event the information associated with the drop accept event * diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/Transfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/Transfer.java index 9c07aa958b..f7ff46fddf 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/Transfer.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/Transfer.java @@ -80,18 +80,18 @@ abstract protected int[] getTypeIds(); * Converts a java representation of data to a platform specific representation of * the data. * - * <p>On a successful conversion, the transferData.result field will be set as follows: + * <p>On a successful conversion, the transferData.result field will be set as follows:</p> * <ul> * <li>Windows: COM.S_OK * <li>GTK: 1 - * </ul></p> + * </ul> * * <p>If this transfer agent is unable to perform the conversion, the transferData.result - * field will be set to a failure value as follows: + * field will be set to a failure value as follows:</p> * <ul> * <li>Windows: COM.DV_E_TYMED or COM.E_FAIL * <li>GTK: 0 - * </ul></p> + * </ul> * * @param object a java representation of the data to be converted; the type of * Object that is passed in is dependent on the <code>Transfer</code> subclass. diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/win32/org/eclipse/swt/dnd/Transfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/win32/org/eclipse/swt/dnd/Transfer.java index 576bb29cda..ecba24dd2e 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/win32/org/eclipse/swt/dnd/Transfer.java +++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/win32/org/eclipse/swt/dnd/Transfer.java @@ -103,18 +103,18 @@ abstract protected String[] getTypeNames(); * Converts a java representation of data to a platform specific representation of * the data. * - * <p>On a successful conversion, the transferData.result field will be set as follows: + * <p>On a successful conversion, the transferData.result field will be set as follows:</p> * <ul> * <li>Windows: COM.S_OK * <li>GTK: 1 - * </ul></p> + * </ul> * * <p>If this transfer agent is unable to perform the conversion, the transferData.result - * field will be set to a failure value as follows: + * field will be set to a failure value as follows:</p> * <ul> * <li>Windows: COM.DV_E_TYMED or COM.E_FAIL * <li>GTK: 0 - * </ul></p> + * </ul> * * @param object a java representation of the data to be converted; the type of * Object that is passed in is dependent on the <code>Transfer</code> subclass. diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java index 05a7e705cb..9850949ea3 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java +++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java @@ -2138,7 +2138,6 @@ public void setSelection (Point selection) { * * @param tabs the number of tabs * - * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java index 954907cffe..bab8233166 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java +++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java @@ -2559,7 +2559,6 @@ public void setSelection (Point selection) { * * @param tabs the number of tabs * - * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> diff --git a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java index 121ee675d6..605cb04b3d 100644 --- a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java +++ b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java @@ -2141,7 +2141,6 @@ public void setSelection (Point selection) { * * @param tabs the number of tabs * - * </ul> * @exception SWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> |