Fix multiple links in Javadoc

Author: timfel

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/method/StaticmethodBuiltins.java

@@ -122,7 +122,7 @@ protected PNone init(VirtualFrame frame, PDecoratedMethod self, Object callable,
     @GenerateNodeFactory
     abstract static class GetNode extends DescrGetBuiltinNode {
         /**
-         * @see ClassmethodBuiltins.GetNode#getCached
+         * @see ClassmethodCommonBuiltins.GetNode#getCached
          */
         @Specialization(guards = {"isSingleContext()", "cachedSelf == self", "cachedCallable != null"}, limit = "3")
         static Object getCached(@SuppressWarnings("unused") PDecoratedMethod self, @SuppressWarnings("unused") Object obj, @SuppressWarnings("unused") Object type,

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/object/ObjectBuiltins.java

@@ -90,7 +90,6 @@
 import com.oracle.graal.python.builtins.objects.set.SetBuiltins;
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked0Node;
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked1Node;
-import com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins;
 import com.oracle.graal.python.builtins.objects.type.PythonBuiltinClass;
 import com.oracle.graal.python.builtins.objects.type.PythonManagedClass;
 import com.oracle.graal.python.builtins.objects.type.TpSlots;
@@ -509,9 +508,10 @@ public abstract static class GetAttributeNode extends GetAttrBuiltinNode {
         @Child private ReadAttributeFromObjectNode attrRead;
 
         /**
-         * Keep in sync with {@link TypeBuiltins.GetattributeNode} and
-         * {@link ThreadLocalBuiltins.GetAttributeNode} and
-         * {@link MergedObjectTypeModuleGetAttributeNode}
+         * Keep in sync with
+         * {@link com.oracle.graal.python.builtins.objects.type.TypeBuiltins.GetattributeNode} and
+         * {@link com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins.GetAttributeNode}
+         * and {@link MergedObjectTypeModuleGetAttributeNode}
          */
         @Specialization
         @SuppressWarnings("truffle-static-method")

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/str/StringBuiltins.java

@@ -206,8 +206,7 @@
 
 /**
  * NOTE: self can either be a TruffleString, PString, PythonNativeObject string or a foreign string
- * (isString()). Use {@link CastToTruffleStringCheckedNode} or {@link CastToTruffleStringNode} to
- * convert to TruffleString.
+ * (isString()). Use {@link CastToTruffleStringNode} to convert to TruffleString.
  */
 @CoreFunctions(extendClasses = PythonBuiltinClassType.PString)
 public final class StringBuiltins extends PythonBuiltins {

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/str/StringUtils.java

@@ -586,9 +586,9 @@ public static int getCodePoint(String characterName) {
     }
 
     /**
-     * Like {@link TruffleString.EqualNode} but with the proper {@link InliningCutoff} since
-     * {@link TruffleString.EqualNode} is too big for host inlining, at least when used in node
-     * guards.
+     * Like {@link com.oracle.truffle.api.strings.TruffleString.EqualNode} but with the proper
+     * {@link InliningCutoff} since {@link com.oracle.truffle.api.strings.TruffleString.EqualNode}
+     * is too big for host inlining, at least when used in node guards.
      */
     @GenerateInline
     @GenerateCached(false)

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/thread/ThreadLocalBuiltins.java

@@ -62,7 +62,6 @@
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked1Node;
 import com.oracle.graal.python.builtins.objects.type.TpSlots;
 import com.oracle.graal.python.builtins.objects.type.TpSlots.GetObjectSlotsNode;
-import com.oracle.graal.python.builtins.objects.type.TypeBuiltins;
 import com.oracle.graal.python.builtins.objects.type.TypeNodes;
 import com.oracle.graal.python.builtins.objects.type.slots.TpSlot;
 import com.oracle.graal.python.builtins.objects.type.slots.TpSlotDescrGet.CallSlotDescrGet;
@@ -139,8 +138,10 @@ public abstract static class GetAttributeNode extends GetAttrBuiltinNode {
         @Child private CallSlotDescrGet callGetNode;
 
         /**
-         * Keep in sync with {@link ObjectBuiltins.GetAttributeNode} and
-         * {@link TypeBuiltins.GetattributeNode} and {@link MergedObjectTypeModuleGetAttributeNode}
+         * Keep in sync with
+         * {@link com.oracle.graal.python.builtins.objects.object.ObjectBuiltins.GetAttributeNode}
+         * and {@link com.oracle.graal.python.builtins.objects.type.TypeBuiltins.GetattributeNode}
+         * and {@link MergedObjectTypeModuleGetAttributeNode}
          */
         @Specialization
         Object doIt(VirtualFrame frame, PThreadLocal object, Object keyObj,

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/builtins/objects/type/TypeBuiltins.java

@@ -99,15 +99,13 @@
 import com.oracle.graal.python.builtins.objects.function.PKeyword;
 import com.oracle.graal.python.builtins.objects.getsetdescriptor.DescriptorDeleteMarker;
 import com.oracle.graal.python.builtins.objects.list.PList;
-import com.oracle.graal.python.builtins.objects.object.ObjectBuiltins;
 import com.oracle.graal.python.builtins.objects.object.ObjectNodes;
 import com.oracle.graal.python.builtins.objects.set.PSet;
 import com.oracle.graal.python.builtins.objects.set.SetBuiltins.UpdateSingleNode;
 import com.oracle.graal.python.builtins.objects.str.PString;
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked0Node;
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked1Node;
 import com.oracle.graal.python.builtins.objects.str.StringUtils.SimpleTruffleStringFormatNode;
-import com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins;
 import com.oracle.graal.python.builtins.objects.tuple.PTuple;
 import com.oracle.graal.python.builtins.objects.type.TpSlots.GetCachedTpSlotsNode;
 import com.oracle.graal.python.builtins.objects.type.TpSlots.GetObjectSlotsNode;
@@ -528,9 +526,11 @@ public abstract static class GetattributeNode extends GetAttrBuiltinNode {
         @Child private LookupAttributeInMRONode.Dynamic lookupAsClass;
 
         /**
-         * Keep in sync with {@link ObjectBuiltins.GetAttributeNode} and
-         * {@link ThreadLocalBuiltins.GetAttributeNode} and
-         * {@link MergedObjectTypeModuleGetAttributeNode}
+         * Keep in sync with
+         * {@link com.oracle.graal.python.builtins.objects.object.ObjectBuiltins.GetAttributeNode}
+         * and
+         * {@link com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins.GetAttributeNode}
+         * and {@link MergedObjectTypeModuleGetAttributeNode}
          */
         @Specialization
         protected Object doIt(VirtualFrame frame, Object object, Object keyObj,

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/compiler/bytecode_dsl/RootNodeCompiler.java

@@ -827,8 +827,9 @@ public BytecodeDSLCompilerResult compileFunctionDef(StmtTy node, String name, Ar
 
     /**
      * Creates a code unit that will create the type parameters and invoke "make function" with
-     * given code unit to create the function for the {@link StmtTy.FunctionDef} or
-     * {@link StmtTy.AsyncFunctionDef} that we are processing.
+     * given code unit to create the function for the
+     * {@link com.oracle.graal.python.pegparser.sst.StmtTy.FunctionDef} or
+     * {@link com.oracle.graal.python.pegparser.sst.StmtTy.AsyncFunctionDef} that we are processing.
      * <p/>
      * The resulting code unit will take the values of the default arguments and default keyword
      * arguments of the function we are processing as its own arguments. The values of those

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/nodes/attributes/MergedObjectTypeModuleGetAttributeNode.java

@@ -48,7 +48,6 @@
 import com.oracle.graal.python.builtins.objects.module.PythonModule;
 import com.oracle.graal.python.builtins.objects.object.ObjectBuiltins;
 import com.oracle.graal.python.builtins.objects.str.StringNodes.CastToTruffleStringChecked1Node;
-import com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins;
 import com.oracle.graal.python.builtins.objects.type.TpSlots;
 import com.oracle.graal.python.builtins.objects.type.TpSlots.GetCachedTpSlotsNode;
 import com.oracle.graal.python.builtins.objects.type.TpSlots.GetObjectSlotsNode;
@@ -77,9 +76,11 @@
 import com.oracle.truffle.api.strings.TruffleString;
 
 /**
- * A node merging the logic of {@link ObjectBuiltins.GetAttributeNode},
- * {@link TypeBuiltins.GetattributeNode} and {@link ModuleBuiltins.ModuleGetattributeNode} to reduce
- * code size by about 3x for host inlining
+ * A node merging the logic of
+ * {@link com.oracle.graal.python.builtins.objects.object.ObjectBuiltins.GetAttributeNode},
+ * {@link com.oracle.graal.python.builtins.objects.type.TypeBuiltins.GetattributeNode} and
+ * {@link com.oracle.graal.python.builtins.objects.module.ModuleBuiltins.ModuleGetattributeNode} to
+ * reduce code size by about 3x for host inlining
  */
 @GenerateUncached
 @GenerateInline
@@ -109,9 +110,12 @@ abstract class MergedObjectTypeModuleGetAttributeInnerNode extends PNodeWithCont
     public abstract Object execute(VirtualFrame frame, Node inliningTarget, Object object, TruffleString key, Object type, TpSlots slots);
 
     /**
-     * Keep in sync with {@link ObjectBuiltins.GetAttributeNode} and
-     * {@link TypeBuiltins.GetattributeNode} and {@link ThreadLocalBuiltins.GetAttributeNode} and
-     * {@link ModuleBuiltins.ModuleGetattributeNode}
+     * Keep in sync with
+     * {@link com.oracle.graal.python.builtins.objects.object.ObjectBuiltins.GetAttributeNode} and
+     * {@link com.oracle.graal.python.builtins.objects.type.TypeBuiltins.GetattributeNode} and
+     * {@link com.oracle.graal.python.builtins.objects.thread.ThreadLocalBuiltins.GetAttributeNode}
+     * and
+     * {@link com.oracle.graal.python.builtins.objects.module.ModuleBuiltins.ModuleGetattributeNode}
      */
     @Specialization(guards = {"slots.tp_getattro() == cachedSlot", "isObjectTypeModuleGetAttribute(cachedSlot)"}, limit = "1")
     static Object doIt(VirtualFrame frame, Node inliningTarget, Object object, TruffleString key, Object type, @SuppressWarnings("unused") TpSlots slots,

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/nodes/object/IsNode.java

@@ -47,7 +47,6 @@
 import com.oracle.graal.python.builtins.objects.code.PCode;
 import com.oracle.graal.python.builtins.objects.ints.PInt;
 import com.oracle.graal.python.builtins.objects.str.PString;
-import com.oracle.graal.python.builtins.objects.str.StringNodes;
 import com.oracle.graal.python.builtins.objects.type.PythonBuiltinClass;
 import com.oracle.graal.python.nodes.PGuards;
 import com.oracle.graal.python.nodes.bytecode.PBytecodeGeneratorFunctionRootNode;
@@ -290,7 +289,10 @@ private static boolean doPNoneSlowpath(Object left, Object right, Node inliningT
     }
 
     // pstring (may be interned)
-    /** See {@link StringNodes.InternStringNode} and {@link StringNodes.IsInternedStringNode} */
+    /**
+     * See {@link com.oracle.graal.python.builtins.objects.str.StringNodes.InternStringNode} and
+     * {@link com.oracle.graal.python.builtins.objects.str.StringNodes.IsInternedStringNode}
+     */
     @Specialization
     public static boolean doPString(PString left, PString right) {
         if (left == right) {

graalpython/com.oracle.graal.python/src/com/oracle/graal/python/runtime/ExecutionContext.java

@@ -292,15 +292,17 @@ protected static void prepareCall(VirtualFrame frame, Object[] callArguments, No
      * Execution of a Python function should be wrapped with {@link #enter(VirtualFrame)} and
      * {@link #exit(VirtualFrame, PRootNode)}.
      * <p>
-     * When entering the function we create the {@link PFrame.Reference} that represents the current
-     * (possibly not yet materialized virtual frame). From then on, at any point we can refer to the
-     * current {@link PFrame.Reference} instance if we have the current virtual frame at hand.
+     * When entering the function we create the
+     * {@link com.oracle.graal.python.builtins.objects.frame.PFrame.Reference} that represents the
+     * current (possibly not yet materialized virtual frame). From then on, at any point we can
+     * refer to the current {@link com.oracle.graal.python.builtins.objects.frame.PFrame.Reference}
+     * instance if we have the current virtual frame at hand.
      * <p>
      * When leaving the function, we check if the current frame needs to outlive the function
      * execution, i.e., needs to escape. In such case, the frame is materialized to a {@link PFrame}
      * instance, and we copy local variables and some arguments into a new {@link MaterializedFrame}
      * stored in the {@link PFrame} (see {@link MaterializeFrameNode}). The {@link PFrame} is stored
-     * into {@link PFrame.Reference}.
+     * into {@link com.oracle.graal.python.builtins.objects.frame.PFrame.Reference}.
      * <p>
      * The frame may have been matarialized already during the function execution, in such case we
      * just synchronize the existing {@link PFrame} with the virtual frame when leaving the