diff options
9 files changed, 105 insertions, 76 deletions
diff --git a/org.eclipse.jface.text/src/org/eclipse/jface/text/TextAttribute.java b/org.eclipse.jface.text/src/org/eclipse/jface/text/TextAttribute.java index c11c93beebf..bff933aaed1 100644 --- a/org.eclipse.jface.text/src/org/eclipse/jface/text/TextAttribute.java +++ b/org.eclipse.jface.text/src/org/eclipse/jface/text/TextAttribute.java @@ -28,15 +28,15 @@ import org.eclipse.swt.graphics.Font; public class TextAttribute { /** - * Text attribute for strikethrough style. - * (value <code>1 << 29</code>). + * Text attribute for strikethrough style. (value <code>1 << 29</code>). + * * @since 3.1 */ public static final int STRIKETHROUGH= 1 << 29; /** - * Text attribute for underline style. - * (value <code>1 << 30</code>) + * Text attribute for underline style. (value <code>1 << 30</code>) + * * @since 3.1 */ public static final int UNDERLINE= 1 << 30; diff --git a/org.eclipse.jface.text/src/org/eclipse/jface/text/TextViewer.java b/org.eclipse.jface.text/src/org/eclipse/jface/text/TextViewer.java index b72276c23af..75feb94457f 100644 --- a/org.eclipse.jface.text/src/org/eclipse/jface/text/TextViewer.java +++ b/org.eclipse.jface.text/src/org/eclipse/jface/text/TextViewer.java @@ -1558,7 +1558,8 @@ public class TextViewer extends Viewer implements protected Map<String, List<IAutoEditStrategy>> fAutoIndentStrategies; /** The text viewer's text hovers */ protected Map<TextHoverKey, ITextHover> fTextHovers; - /** All registered view port listeners> */ + + /** All registered view port listeners */ protected List<IViewportListener> fViewportListeners; /** The last visible vertical position of the top line */ protected int fLastTopPixel; @@ -3224,14 +3225,13 @@ public class TextViewer extends Viewer implements } /** - * Returns the region covered by the given start and end offset. - * The result is relative to the upper left corner of the widget - * client area. + * Returns the region covered by the given start and end offset. The result is relative to the + * upper left corner of the widget client area. * - * @param start offset relative to the start of this viewer's view port - * 0 <= offset <= getCharCount() - * @param end offset relative to the start of this viewer's view port - * 0 <= offset <= getCharCount() + * @param start offset relative to the start of this viewer's view port 0 <= offset <= + * getCharCount() + * @param end offset relative to the start of this viewer's view port 0 <= offset <= + * getCharCount() * @return the region covered by start and end offset */ final protected IRegion getExtent(int start, int end) { diff --git a/org.eclipse.jface.text/src/org/eclipse/jface/text/source/ICharacterPairMatcherExtension.java b/org.eclipse.jface.text/src/org/eclipse/jface/text/source/ICharacterPairMatcherExtension.java index 34a8abe868b..b60649848a9 100644 --- a/org.eclipse.jface.text/src/org/eclipse/jface/text/source/ICharacterPairMatcherExtension.java +++ b/org.eclipse.jface.text/src/org/eclipse/jface/text/source/ICharacterPairMatcherExtension.java @@ -67,7 +67,8 @@ public interface ICharacterPairMatcherExtension { * * <p> * Clients can use this method to handle characters which may have special meaning in some - * situations. E.g. in Java, '<' is used as an angular bracket and as well as less-than operator. + * situations. E.g. in Java, '<' is used as an angular bracket and as well as less-than + * operator. * </p> * * @param ch the character diff --git a/org.eclipse.jface.text/src/org/eclipse/jface/text/source/LineChangeHover.java b/org.eclipse.jface.text/src/org/eclipse/jface/text/source/LineChangeHover.java index 7108f06a05d..780929a4492 100644 --- a/org.eclipse.jface.text/src/org/eclipse/jface/text/source/LineChangeHover.java +++ b/org.eclipse.jface.text/src/org/eclipse/jface/text/source/LineChangeHover.java @@ -101,15 +101,16 @@ public class LineChangeHover implements IAnnotationHover, IAnnotationHoverExtens } /** - * Takes a list of <code>ILineDiffInfo</code>s and computes a hover of at most <code>maxLines</code>. - * Added lines are prefixed with a <code>'+'</code>, changed lines with <code>'>'</code> and - * deleted lines with <code>'-'</code>. - * <p>Deleted and added lines can even each other out, so that a number of deleted lines get + * Takes a list of <code>ILineDiffInfo</code>s and computes a hover of at most + * <code>maxLines</code>. Added lines are prefixed with a <code>'+'</code>, changed lines with + * <code>'>'</code> and deleted lines with <code>'-'</code>. + * <p> + * Deleted and added lines can even each other out, so that a number of deleted lines get * displayed where - in the current document - the added lines are. * * @param diffInfos a <code>List</code> of <code>ILineDiffInfo</code> * @param maxLines the maximum number of lines. Note that adding up all annotations might give - * more than that due to deleted lines. + * more than that due to deleted lines. * @return a <code>String</code> suitable for hover display */ protected String decorateText(List<? extends ILineDiffInfo> diffInfos, int maxLines) { diff --git a/org.eclipse.jface.text/src/org/eclipse/jface/text/templates/persistence/package.html b/org.eclipse.jface.text/src/org/eclipse/jface/text/templates/persistence/package.html index 79efa958651..7f5e717732e 100644 --- a/org.eclipse.jface.text/src/org/eclipse/jface/text/templates/persistence/package.html +++ b/org.eclipse.jface.text/src/org/eclipse/jface/text/templates/persistence/package.html @@ -12,7 +12,7 @@ Provides persistence support for templates. <h3>Packages</h3> <ul> - <li><code>org.eclipse.jface.text.templates<</code></li> + <li><code>org.eclipse.jface.text.templates</code></li> <li><code>org.eclipse.ui.workbench.texteditor.templates</code></li> <li><code>org.eclipse.ui.editors.templates</code></li> </ul> diff --git a/org.eclipse.search/search/org/eclipse/search/ui/ISearchResultView.java b/org.eclipse.search/search/org/eclipse/search/ui/ISearchResultView.java index 09ed5fad8eb..19696cbc6d0 100644 --- a/org.eclipse.search/search/org/eclipse/search/ui/ISearchResultView.java +++ b/org.eclipse.search/search/org/eclipse/search/ui/ISearchResultView.java @@ -94,25 +94,34 @@ public interface ISearchResultView extends IViewPart { public ISelection getSelection(); /** - * Informs the view that a search has started. - * Provides all necessary information to create an entry in the search result - * view. - * If every match should show up in the search result view then the match - * itself can be used as key. + * Informs the view that a search has started. Provides all necessary + * information to create an entry in the search result view. If every match + * should show up in the search result view then the match itself can be + * used as key. * - * @param pageId the id of the search page which started the search - * @param label the label to be used for this search occurrence - * @param imageDescriptor the image descriptor to be used for this search occurrence, - * or <code>null</code> if this search should not have an image - * @param contributor the context menu contributor - * or <code>null</code> if no context menu is contributed - * @param labelProvider the label provider used by this search result view - * or <code>null</code> if the default provider should be used. - * The default label provider shows the resource name and the corresponding image. - * @param gotoAction the action used by the view to go to a marker - * @param groupByKeyComputer the computer used by the view to compute the key for a marker - * @param operation the runnable used by the view to repeat the search - * @deprecated As of build > 20011107, replaced by the new version with additional parameter + * @param pageId + * the id of the search page which started the search + * @param label + * the label to be used for this search occurrence + * @param imageDescriptor + * the image descriptor to be used for this search occurrence, or + * <code>null</code> if this search should not have an image + * @param contributor + * the context menu contributor or <code>null</code> if no + * context menu is contributed + * @param labelProvider + * the label provider used by this search result view or + * <code>null</code> if the default provider should be used. The + * default label provider shows the resource name and the + * corresponding image. + * @param gotoAction + * the action used by the view to go to a marker + * @param groupByKeyComputer + * the computer used by the view to compute the key for a marker + * @param operation + * the runnable used by the view to repeat the search + * @deprecated As of build > 20011107, replaced by the new version with + * additional parameter */ @Deprecated public void searchStarted( @@ -126,31 +135,41 @@ public interface ISearchResultView extends IViewPart { IRunnableWithProgress operation); /** - * Informs the view that a search has started. - * Provides all necessary information to create an entry in the search result - * view. - * If every match should show up in the search result view then the match - * itself can be used as key. + * Informs the view that a search has started. Provides all necessary + * information to create an entry in the search result view. If every match + * should show up in the search result view then the match itself can be + * used as key. * - * @param pageId the id of the search page which started the search - * @param singularLabel the label to be used for this search occurrence - * if there is one match - * or <code>null</code> if the pluralLabelPattern should be used - * @param pluralLabelPattern the label pattern to be used for this search occurrence - * if there are more than one matches or none. - * This string may contain {0} which will be replace by the match count - * @param imageDescriptor the image descriptor to be used for this search occurrence, - * or <code>null</code> if this search should not have an image - * @param contributor the context menu contributor - * or <code>null</code> if no context menu is contributed - * @param labelProvider the label provider used by this search result view - * or <code>null</code> if the default provider should be used. - * The default label provider shows the resource name and the corresponding image. - * @param gotoAction the action used by the view to go to a marker - * @param groupByKeyComputer the computer used by the view to compute the key for a marker - * @param operation the runnable used by the view to repeat the search - * @since 2.0 - * @deprecated As of build > 20020514, replaced by the new version which provides an action group factory + * @param pageId + * the id of the search page which started the search + * @param singularLabel + * the label to be used for this search occurrence if there is + * one match or <code>null</code> if the pluralLabelPattern + * should be used + * @param pluralLabelPattern + * the label pattern to be used for this search occurrence if + * there are more than one matches or none. This string may + * contain {0} which will be replace by the match count + * @param imageDescriptor + * the image descriptor to be used for this search occurrence, or + * <code>null</code> if this search should not have an image + * @param contributor + * the context menu contributor or <code>null</code> if no + * context menu is contributed + * @param labelProvider + * the label provider used by this search result view or + * <code>null</code> if the default provider should be used. The + * default label provider shows the resource name and the + * corresponding image. + * @param gotoAction + * the action used by the view to go to a marker + * @param groupByKeyComputer + * the computer used by the view to compute the key for a marker + * @param operation + * the runnable used by the view to repeat the search + * @since 2.0 + * @deprecated As of build > 20020514, replaced by the new version which + * provides an action group factory */ @Deprecated public void searchStarted( diff --git a/org.eclipse.text/src/org/eclipse/jface/text/Position.java b/org.eclipse.text/src/org/eclipse/jface/text/Position.java index 064f8fdb40a..1239d9eb77d 100644 --- a/org.eclipse.text/src/org/eclipse/jface/text/Position.java +++ b/org.eclipse.text/src/org/eclipse/jface/text/Position.java @@ -49,7 +49,7 @@ public class Position { /** * Creates a new position with the given offset and length 0. * - * @param offset the position offset, must be >= 0 + * @param offset the position offset, must be >= 0 */ public Position(int offset) { this(offset, 0); @@ -58,8 +58,8 @@ public class Position { /** * Creates a new position with the given offset and length. * - * @param offset the position offset, must be >= 0 - * @param length the position length, must be >= 0 + * @param offset the position offset, must be >= 0 + * @param length the position length, must be >= 0 */ public Position(int offset, int length) { Assert.isTrue(offset >= 0); diff --git a/org.eclipse.text/src/org/eclipse/jface/text/source/IAnnotationModelExtension2.java b/org.eclipse.text/src/org/eclipse/jface/text/source/IAnnotationModelExtension2.java index 1367cbe628c..9011e83e2f5 100644 --- a/org.eclipse.text/src/org/eclipse/jface/text/source/IAnnotationModelExtension2.java +++ b/org.eclipse.text/src/org/eclipse/jface/text/source/IAnnotationModelExtension2.java @@ -28,8 +28,8 @@ public interface IAnnotationModelExtension2 { * Returns an iterator over all annotations managed by this model that are * inside the given region. * - * @param offset the start position of the region, must be >= 0 - * @param length the length of the region, must be >= 0 + * @param offset the start position of the region, must be >= 0 + * @param length the length of the region, must be >= 0 * @param canStartBefore if <code>true</code> then annotations are included * which start before the region if they end at or after the region's start * @param canEndAfter if <code>true</code> then annotations are included diff --git a/org.eclipse.ui.workbench.texteditor/src/org/eclipse/ui/texteditor/ITextEditorActionDefinitionIds.java b/org.eclipse.ui.workbench.texteditor/src/org/eclipse/ui/texteditor/ITextEditorActionDefinitionIds.java index 566ee0523c1..8ee59776c76 100644 --- a/org.eclipse.ui.workbench.texteditor/src/org/eclipse/ui/texteditor/ITextEditorActionDefinitionIds.java +++ b/org.eclipse.ui.workbench.texteditor/src/org/eclipse/ui/texteditor/ITextEditorActionDefinitionIds.java @@ -456,35 +456,42 @@ public interface ITextEditorActionDefinitionIds extends IWorkbenchActionDefiniti String GOTO_PREVIOUS_ANNOTATION= "org.eclipse.ui.edit.text.gotoPreviousAnnotation"; //$NON-NLS-1$ /** - * Action definition ID of the edit -> content assist proposal action + * Action definition ID of the edit -> content assist proposal action * Value: <code>"org.eclipse.ui.edit.text.contentAssist.proposals"</code>). * <p> * Note: Since 3.2 the command is defined in <code>org.eclipse.ui</code> and - * its ID can also be accessed using {@link org.eclipse.ui.fieldassist.ContentAssistCommandAdapter#CONTENT_PROPOSAL_COMMAND}. + * its ID can also be accessed using + * {@link org.eclipse.ui.fieldassist.ContentAssistCommandAdapter#CONTENT_PROPOSAL_COMMAND}. * </p> + * * @since 2.1 */ String CONTENT_ASSIST_PROPOSALS= "org.eclipse.ui.edit.text.contentAssist.proposals"; //$NON-NLS-1$ /** - * Action definition ID of the edit -> content assist context information action - * Value: <code>"org.eclipse.ui.edit.text.contentAssist.contextInformation"</code>). + * Action definition ID of the edit -> content assist context information + * action Value: + * <code>"org.eclipse.ui.edit.text.contentAssist.contextInformation"</code>). + * * @since 2.1 */ String CONTENT_ASSIST_CONTEXT_INFORMATION= "org.eclipse.ui.edit.text.contentAssist.contextInformation"; //$NON-NLS-1$ /** - * Action definition ID of the edit -> quick assist proposal action + * Action definition ID of the edit -> quick assist proposal action * <p> - * Note: The constant contains 'jdt' for historical and compatibility reasons. + * Note: The constant contains 'jdt' for historical and compatibility + * reasons. * </p> - * (value <code>"org.eclipse.jdt.ui.edit.text.java.correction.assist.proposals"</code>). + * (value + * <code>"org.eclipse.jdt.ui.edit.text.java.correction.assist.proposals"</code>). + * * @since 3.2 */ String QUICK_ASSIST= "org.eclipse.jdt.ui.edit.text.java.correction.assist.proposals"; //$NON-NLS-1$ /** - * Action definition ID of the edit -> smart insert mode action + * Action definition ID of the edit -> smart insert mode action * Value: <code>"org.eclipse.ui.edit.text.toggleInsertMode"</code>). * @since 3.0 */ @@ -526,8 +533,9 @@ public interface ITextEditorActionDefinitionIds extends IWorkbenchActionDefiniti String LINENUMBER_TOGGLE= "org.eclipse.ui.editors.lineNumberToggle"; //$NON-NLS-1$ /** - * Action definition ID of the edit -> text complete action - * Value: <code>"org.eclipse.ui.edit.text.hippieCompletion"</code>). + * Action definition ID of the edit -> text complete action Value: + * <code>"org.eclipse.ui.edit.text.hippieCompletion"</code>). + * * @since 3.1 */ String HIPPIE_COMPLETION= "org.eclipse.ui.edit.text.hippieCompletion"; //$NON-NLS-1$ |