javadoc cleanup

platform/core-api/src/com/intellij/openapi/command/undo/UndoUtil.java

@@ -44,7 +44,7 @@ public class UndoUtil {
   }
 
   /**
-   * @deprecated please use CommandProcessor.getInstance().addAffectedFiles instead
+   * @deprecated please use {@link CommandProcessor#addAffectedFiles} instead
    */
   public static void markVirtualFileForUndo(@NotNull Project project, @NotNull VirtualFile file) {
     CommandProcessor.getInstance().addAffectedFiles(project, file);

platform/util-rt/src/com/intellij/util/Base64.java

@@ -16,7 +16,7 @@
 package com.intellij.util;
 
 /**
- * DEPRECATED, please use java.util.Base64
+ * DEPRECATED, please use {@link java.util.Base64} instead
  */
 public class Base64 {
   private Base64() { }

platform/util/src/com/intellij/util/containers/UnsafeWeakList.java

@@ -37,7 +37,7 @@ import java.util.*;
  * </ul>
  * Please note that since weak references can be collected at any time, index-based methods (like get(index))
  * or size-based methods (like size()) are dangerous, misleading, error-inducing and are not supported.
- * Instead, please use add(element) and iterator().
+ * Instead, please use {@link #add(T)} and {@link #iterator()}.
  */
 public class UnsafeWeakList<T> extends AbstractCollection<T> {
   protected final List<MyReference<T>> myList;
@@ -243,7 +243,7 @@ public class UnsafeWeakList<T> extends AbstractCollection<T> {
   /**
    * Since weak references can be collected at any time,
    * this method considered dangerous, misleading, error-inducing and are is not supported.
-   * Instead, please use add(element) and iterator()
+   * Instead, please use {@link #add(T)} and {@link #iterator()}.
    */
   @Override
   @Deprecated

platform/util/src/com/intellij/util/containers/WeakList.java

@@ -32,7 +32,7 @@ import java.util.List;
  * </ul>
  * Please note that since weak references can be collected at any time, index-based methods (like get(index))
  * or size-based methods (like size()) are dangerous, misleading, error-inducing and are not supported.
- * Instead, please use add(element) and iterator().
+ * Instead, please use {@link #add(T)} and {@link #iterator()}.
  */
 public class WeakList<T> extends UnsafeWeakList<T> {
   public WeakList() {