Warn about missing description for all standard tags.

4 files changed, 23 insertions, 25 deletions

diff --git a/org.eclipse.text/src/org/eclipse/jface/text/CopyOnWriteTextStore.java b/org.eclipse.text/src/org/eclipse/jface/text/CopyOnWriteTextStore.java
index 375b074c445..fd5f3584000 100644
--- a/org.eclipse.text/src/org/eclipse/jface/text/CopyOnWriteTextStore.java
+++ b/org.eclipse.text/src/org/eclipse/jface/text/CopyOnWriteTextStore.java
@@ -16,22 +16,23 @@ import org.eclipse.core.runtime.Assert;
 /**
  * Copy-on-write <code>ITextStore</code> wrapper.
  * <p>
- * This implementation uses an unmodifiable text store for the initial content.
- * Upon first modification attempt, the unmodifiable store is replaced with
- * a modifiable instance which must be supplied in the constructor.</p>
+ * This implementation uses an unmodifiable text store for the initial content. Upon first
+ * modification attempt, the unmodifiable store is replaced with a modifiable instance which must be
+ * supplied in the constructor.
+ * </p>
  * <p>
  * This class is not intended to be subclassed.
  * </p>
- *
+ * 
  * @since 3.2
  * @noextend This class is not intended to be subclassed by clients.
  */
 public class CopyOnWriteTextStore implements ITextStore {
 
 	/**
-	 * An unmodifiable String based text store. It is not possible to modify the content
-	 * other than using {@link #set}. Trying to {@link #replace} a text range will
-	 * throw an <code>UnsupportedOperationException</code>.
+	 * An unmodifiable String based text store. It is not possible to modify the content other than
+	 * using {@link #set}. Trying to {@link #replace} a text range will throw an
+	 * <code>UnsupportedOperationException</code>.
 	 */
 	private static class StringTextStore implements ITextStore {
 
@@ -47,7 +48,8 @@ public class CopyOnWriteTextStore implements ITextStore {
 
 		/**
 		 * Create a text store with initial content.
-		 * @param text  the initial content
+		 * 
+		 * @param text the initial content
 		 */
 		private StringTextStore(String text) {
 			super();
@@ -99,11 +101,10 @@ public class CopyOnWriteTextStore implements ITextStore {
 	private final ITextStore fModifiableTextStore;
 
 	/**
-	 * Creates an empty text store. The given text store will be used upon first
-	 * modification attempt.
+	 * Creates an empty text store. The given text store will be used upon first modification
+	 * attempt.
 	 * 
-	 * @param modifiableTextStore
-	 *            a modifiable <code>ITextStore</code> instance, may not be
+	 * @param modifiableTextStore a modifiable <code>ITextStore</code> instance, may not be
 	 *            <code>null</code>
 	 */
 	public CopyOnWriteTextStore(ITextStore modifiableTextStore) {
diff --git a/org.eclipse.text/src/org/eclipse/jface/text/TreeLineTracker.java b/org.eclipse.text/src/org/eclipse/jface/text/TreeLineTracker.java
index 7f49ee60d31..73ff0a1b7c7 100755
--- a/org.eclipse.text/src/org/eclipse/jface/text/TreeLineTracker.java
+++ b/org.eclipse.text/src/org/eclipse/jface/text/TreeLineTracker.java
@@ -165,12 +165,12 @@ abstract class TreeLineTracker implements ILineTracker {
 	 */
 	protected TreeLineTracker() {
 	}
-	
+
 	/**
 	 * Package visible constructor for creating a tree tracker from a list tracker.
 	 * 
-     * @param tracker
-     */
+	 * @param tracker the list line tracker
+	 */
     TreeLineTracker(ListLineTracker tracker) {
     	final List lines= tracker.getLines();
     	final int n= lines.size();
diff --git a/org.eclipse.text/src/org/eclipse/jface/text/link/LinkedModeManager.java b/org.eclipse.text/src/org/eclipse/jface/text/link/LinkedModeManager.java
index dc8805c5738..d8a3c9502aa 100644
--- a/org.eclipse.text/src/org/eclipse/jface/text/link/LinkedModeManager.java
+++ b/org.eclipse.text/src/org/eclipse/jface/text/link/LinkedModeManager.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2000, 2006 IBM Corporation and others.
+ * Copyright (c) 2000, 2008 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -143,9 +143,9 @@ class LinkedModeManager {
 
 	/**
 	 * Notify the manager about a leaving model.
-	 *
-	 * @param model
-	 * @param flags
+	 * 
+	 * @param model the model to nest
+	 * @param flags the reason and commands for leaving linked mode
 	 */
 	private void left(LinkedModeModel model, int flags) {
 		if (!fEnvironments.contains(model))
diff --git a/org.eclipse.text/src/org/eclipse/text/undo/DocumentUndoManager.java b/org.eclipse.text/src/org/eclipse/text/undo/DocumentUndoManager.java
index a9594961324..dd14f412a65 100644
--- a/org.eclipse.text/src/org/eclipse/text/undo/DocumentUndoManager.java
+++ b/org.eclipse.text/src/org/eclipse/text/undo/DocumentUndoManager.java
@@ -437,8 +437,7 @@ public class DocumentUndoManager implements IDocumentUndoManager {
 		/**
 		 * Creates a new compound text change.
 		 * 
-		 * @param manager
-		 *            the undo manager for this change
+		 * @param manager the undo manager for this change
 		 */
 		UndoableCompoundTextChange(DocumentUndoManager manager) {
 			super(manager);
@@ -951,11 +950,9 @@ public class DocumentUndoManager implements IDocumentUndoManager {
 	}
 
 	/**
-	 * Adds the given text edit to the operation history if it is not part of a
-	 * compound change.
+	 * Adds the given text edit to the operation history if it is not part of a compound change.
 	 * 
-	 * @param edit
-	 *            the edit to be added
+	 * @param edit the edit to be added
 	 */
 	private void addToOperationHistory(UndoableTextChange edit) {
 		if (!fFoldingIntoCompoundChange