javadoc fixed

Author: thurka

visualvm/caching.api/src/org/graalvm/visualvm/api/caching/Cache.java

@@ -34,8 +34,8 @@
  */
 abstract public class Cache<K,V> {
     /**
-     * Retrieves an object from the cache by the given key<br/>
-     * If there is no cached version of the object {@linkplain #cacheMiss(java.lang.Object) } is invoked
+     * Retrieves an object from the cache by the given key<br>
+     * If there is no cached version of the object {@linkplain EntryFactory#createEntry(Object)}  is invoked
      * <p>
      * To obtain a cache one needs to call one of {@linkplain CacheFactory} methods
      * </p>

visualvm/libs.profiler/lib.profiler.charts/src/org/graalvm/visualvm/lib/charts/canvas/BufferedCanvasComponent.java

@@ -230,7 +230,7 @@ protected final void invalidateImage() {
      * Marks part of the offscreen image as invalid. Invalid area of the image
      * will be updated on next paintComponent(Graphics) invocation.
      * 
-     * @param dirtyRect the part of the offscreen image to be marked as invalid.
+     * @param invalidArea the part of the offscreen image to be marked as invalid.
      */
     protected final void invalidateImage(Rectangle invalidArea) {
         if (invalidArea.isEmpty()) return;

visualvm/libs.profiler/lib.profiler.common/src/org/graalvm/visualvm/lib/common/Profiler.java

@@ -116,12 +116,12 @@ public static synchronized Profiler getDefault() {
      * @param port Port number to be used to communicate with the agent
      * @param agentId Expected agent Id
      * @return the state of the agent
-     * @see CommonConstants.AGENT_STATE_CONNECTED
-     * @see CommonConstants.AGENT_STATE_DIFFERENT_ID
-     * @see CommonConstants.AGENT_STATE_NOT_RUNNING
-     * @see CommonConstants.AGENT_STATE_OTHER_SESSION_IN_PROGRESS
-     * @see CommonConstants.AGENT_STATE_READY_DIRECT
-     * @see CommonConstants.AGENT_STATE_READY_DYNAMIC
+     * @see CommonConstants#AGENT_STATE_CONNECTED
+     * @see CommonConstants#AGENT_STATE_DIFFERENT_ID
+     * @see CommonConstants#AGENT_STATE_NOT_RUNNING
+     * @see CommonConstants#AGENT_STATE_OTHER_SESSION_IN_PROGRESS
+     * @see CommonConstants#AGENT_STATE_READY_DIRECT
+     * @see CommonConstants#AGENT_STATE_READY_DYNAMIC
      */
     public abstract int getAgentState(String host, int port, int agentId);
 

visualvm/libs.profiler/lib.profiler.common/src/org/graalvm/visualvm/lib/common/ProfilingSettings.java

@@ -239,9 +239,9 @@ public int getAllocTrackEvery() {
     }
 
     /** @param cpuProfilingType Type of CPU instrumentation.
-     * @see CommonConstants.CPU_INSTR_FULL
-     * @see CommonConstants.CPU_INSTR_SAMPLED
-     * @see CommonConstants.CPU_SAMPLED
+     * @see CommonConstants#CPU_INSTR_FULL
+     * @see CommonConstants#CPU_INSTR_SAMPLED
+     * @see CommonConstants#CPU_SAMPLED
      */
     public void setCPUProfilingType(final int cpuProfilingType) {
         this.cpuProfilingType = cpuProfilingType;
@@ -250,9 +250,9 @@ public void setCPUProfilingType(final int cpuProfilingType) {
     // -- General CPU Profiling settings ---------------------------------------------------------------------------------
 
     /** @return Type of CPU instrumentation
-     * @see CommonConstants.CPU_INSTR_FULL
-     * @see CommonConstants.CPU_INSTR_SAMPLED
-     * @see CommonConstants.CPU_SAMPLED
+     * @see CommonConstants#CPU_INSTR_FULL
+     * @see CommonConstants#CPU_INSTR_SAMPLED
+     * @see CommonConstants#CPU_SAMPLED
      */
     public int getCPUProfilingType() {
         return cpuProfilingType;

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/UIUtils.java

@@ -152,7 +152,7 @@ public void paint(Graphics g) {
         return separator;
     }
 
-    /** Determines if current L&F is AquaLookAndFeel */
+    /** Determines if current L&F is AquaLookAndFeel */
     public static boolean isAquaLookAndFeel() {
         // is current L&F some kind of AquaLookAndFeel?
         return UIManager.getLookAndFeel().getID().equals("Aqua"); //NOI18N
@@ -197,31 +197,31 @@ public static int getDefaultRowHeight() {
         return new JLabel("X").getPreferredSize().height + 2; //NOI18N
     }
 
-    /** Determines if current L&F is GTKLookAndFeel */
+    /** Determines if current L&F is GTKLookAndFeel */
     public static boolean isGTKLookAndFeel() {
         // is current L&F some kind of GTKLookAndFeel?
         return UIManager.getLookAndFeel().getID().equals("GTK"); //NOI18N
     }
 
-    /** Determines if current L&F is Nimbus */
+    /** Determines if current L&F is Nimbus */
     public static boolean isNimbusLookAndFeel() {
         // is current L&F Nimbus?
         return UIManager.getLookAndFeel().getID().equals("Nimbus"); //NOI18N
     }
 
-    /** Determines if current L&F is GTK using Nimbus theme */
+    /** Determines if current L&F is GTK using Nimbus theme */
     public static boolean isNimbusGTKTheme() {
         // is current L&F GTK using Nimbus theme?
         return isGTKLookAndFeel() && "nimbus".equals(Toolkit.getDefaultToolkit().getDesktopProperty("gnome.Net/ThemeName")); //NOI18N
     }
 
-    /** Determines if current L&F is Nimbus or GTK with Nimbus theme*/
+    /** Determines if current L&F is Nimbus or GTK with Nimbus theme*/
     public static boolean isNimbus() {
         // is current L&F Nimbus or GTK with Nimbus theme?
         return isNimbusLookAndFeel() || isNimbusGTKTheme();
     }
 
-    /** Determines if current L&F is MetalLookAndFeel */
+    /** Determines if current L&F is MetalLookAndFeel */
     public static boolean isMetalLookAndFeel() {
         // is current L&F some kind of MetalLookAndFeel?
         return UIManager.getLookAndFeel().getID().equals("Metal"); //NOI18N
@@ -421,7 +421,7 @@ public static boolean isDarkResultsBackground() {
         return darkResultsBackground;
     }
 
-    /** Determines if current L&F is Windows Classic LookAndFeel */
+    /** Determines if current L&F is Windows Classic LookAndFeel */
     public static boolean isWindowsClassicLookAndFeel() {
         if ("Windows Classic".equals(UIManager.getLookAndFeel().getName())) return true; //NOI18N
 
@@ -432,13 +432,13 @@ public static boolean isWindowsClassicLookAndFeel() {
         return (!isWindowsXPLookAndFeel());
     }
 
-    /** Determines if current L&F is WindowsLookAndFeel */
+    /** Determines if current L&F is WindowsLookAndFeel */
     public static boolean isWindowsLookAndFeel() {
         // is current L&F some kind of WindowsLookAndFeel?
         return UIManager.getLookAndFeel().getID().equals("Windows"); //NOI18N
     }
 
-    /** Determines if current L&F is Windows XP LookAndFeel */
+    /** Determines if current L&F is Windows XP LookAndFeel */
     public static boolean isWindowsXPLookAndFeel() {
         if (!isWindowsLookAndFeel()) {
             return false;
@@ -467,7 +467,7 @@ public static boolean isOracleLookAndFeel() {
     /** Checks give TreePath for the last node, and if it ends with a node with just one child,
      * it keeps expanding further.
      * Current implementation expands through the first child that is not leaf. To more correctly
-     * fulfil expected semantics in case maxChildToExpand is > 1, it should expand all paths through
+     * fulfill expected semantics in case maxChildToExpand is > 1, it should expand all paths through
      * all children.
      *
      * @param tree
@@ -600,7 +600,7 @@ public void componentResized(ComponentEvent e) {
     // Also fixes buttons size in JToolbar.
 
     /** Ensures that focus will be really painted if button is focused
-     * and fixes using custom border for JDK 1.5 & XP LaF
+     * and fixes using custom border for JDK 1.5 & XP L&F
      */
     public static void fixButtonUI(AbstractButton button) {
         // Doesn't seem to be necessary any more, conflicts with Jigsaw

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/components/FlatToolBar.java

@@ -189,8 +189,8 @@ public FlatToolBar() {
     /**
      * Creates a toolbar with specified orientation and horizontal button style (i.e. icon left to text)
      *
-     * @see JToolBar.HORIZONTAL
-     * @see JToolBar.VERTICAL
+     * @see JToolBar#HORIZONTAL
+     * @see JToolBar#VERTICAL
      * @param orientation
      */
     public FlatToolBar(int orientation) {
@@ -200,8 +200,8 @@ public FlatToolBar(int orientation) {
     /**
      * Creates a toolbar with specified orientation and button style
      *
-     * @see JToolBar.HORIZONTAL
-     * @see JToolBar.VERTICAL
+     * @see JToolBar#HORIZONTAL
+     * @see JToolBar#VERTICAL
      *
      * @param orientation
      * @param buttonStyle

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/components/JExtendedTable.java

@@ -37,7 +37,7 @@
 
 /**
  * This class implements JTable with extended CellTip support.
- * Added support for handling Home & End keys.
+ * Added support for handling Home & End keys.
  *
  * @author Tomas Hurka
  * @author Jiri Sedlacek

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/components/treetable/AbstractTreeTableModel.java

@@ -68,7 +68,7 @@ public AbstractTreeTableModel(CCTNode root, boolean supportsSorting, int sorting
 
     /**
      * Returns the child at index 'num' of the given node.
-     * <p/>
+     * <p>
      * Although the method expects an Object because of the TreeModel contract,
      * in reality it assumes the given node is a 'TreeTableNode'.
      *
@@ -80,7 +80,7 @@ public Object getChild(Object node, int num) {
 
     /**
      * Returns the number of children a given node has.
-     * <p/>
+     * <p>
      * Although the method expects an Object because of the TreeModel contract,
      * in reality it assumes the given node is a 'TreeTableNode'.
      *
@@ -112,7 +112,7 @@ public String getColumnToolTipText(int column) {
 
     /**
      * Returns the index of the child node in the parent node.
-     * <p/>
+     * <p>
      * Although the method expects Objects because of the TreeModel contract,
      * it assumes both parent and child are TreeTableNodes.
      */
@@ -144,7 +144,7 @@ public boolean getInitialSortingOrder() {
 
     /**
      * Returns true when the given node is a 'leaf'.
-     * <p/>
+     * <p>
      * Although the method expects an Object because of the TreeModel contract,
      * in reality it assumes the given node is a 'TreeTableNode'.
      *
@@ -336,7 +336,7 @@ public boolean supportsSorting() {
 
     /**
      * Overwrite if you are going to user editors in the JTree.
-     * <p/>
+     * <p>
      * The default implementation does nothing (dummy method).
      *
      * @see javax.swing.tree.DefaultTreeModel#valueForPathChanged(javax.swing.tree.TreePath, java.lang.Object)

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/cpu/CPUResultsPanel.java

@@ -117,9 +117,9 @@ public Boolean isSampling() {
      *
      * @param view one of CPUResultsSnapshot.METHOD_LEVEL_VIEW, CPUResultsSnapshot.CLASS_LEVEL_VIEW, CPUResultsSnapshot.PACKAGE_LEVEL_VIEW
      *
-     * @see CPUResultsSnapshot.METHOD_LEVEL_VIEW
-     * @see CPUResultsSnapshot.CLASS_LEVEL_VIEW
-     * @see CPUResultsSnapshot.PACKAGE_LEVEL_VIEW
+     * @see CPUResultsSnapshot#METHOD_LEVEL_VIEW
+     * @see CPUResultsSnapshot#CLASS_LEVEL_VIEW
+     * @see CPUResultsSnapshot#PACKAGE_LEVEL_VIEW
      */
     public void changeView(int view) {
         if (currentView == view) {

visualvm/libs.profiler/lib.profiler.ui/src/org/graalvm/visualvm/lib/ui/cpu/FlatProfilePanel.java

@@ -56,7 +56,7 @@
 
 /**
  * A common abstract superclass for Hotspots display containing a flat profile.
- * <p/>
+ * <p>
  * The subclasses need to implement these methods:
  * obtainResults () to initialize the data either from snapshot or from live data.
  * getTitle () to provide title for the panel