From 93bedd7abae33f5d5eb909d3d216ee415ad2f8b2 Mon Sep 17 00:00:00 2001 From: Chris Plummer Date: Thu, 11 Jan 2024 18:13:11 +0000 Subject: [PATCH] 8323213: Fix some javadoc broken links in ObjectReference, and other misc javadoc cleanups Reviewed-by: sspitsyn, amenkov --- .../classes/com/sun/jdi/ObjectReference.java | 18 +++++++++--------- .../classes/com/sun/jdi/VirtualMachine.java | 9 +++++---- 2 files changed, 14 insertions(+), 13 deletions(-) diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/ObjectReference.java b/src/jdk.jdi/share/classes/com/sun/jdi/ObjectReference.java index dcada00d99b..dbcf77d3e39 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/ObjectReference.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/ObjectReference.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2023, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -306,7 +306,7 @@ public interface ObjectReference extends Value { * consequently, may result in application behavior under the * debugger that differs from its non-debugged behavior. * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - * -see {@link VirtualMachine#canBeModified()}. + * - see {@link VirtualMachine#canBeModified()}. */ void disableCollection(); @@ -317,7 +317,7 @@ public interface ObjectReference extends Value { * is necessary only if garbage collection was previously disabled * with {@link #disableCollection}. * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - * -see {@link VirtualMachine#canBeModified()}. + * - see {@link VirtualMachine#canBeModified()}. */ void enableCollection(); @@ -328,7 +328,7 @@ public interface ObjectReference extends Value { * @return true if this {@link ObjectReference} has been collected; * false otherwise. * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - * -see {@link VirtualMachine#canBeModified()}. + * - see {@link VirtualMachine#canBeModified()}. */ boolean isCollected(); @@ -351,7 +351,7 @@ public interface ObjectReference extends Value { * for a monitor. *

* Not all target VMs support this operation. See - * VirtualMachine#canGetMonitorInfo to determine if the + * {@link VirtualMachine#canGetMonitorInfo} to determine if the * operation is supported. * * @return a List of {@link ThreadReference} objects. The list @@ -372,7 +372,7 @@ public interface ObjectReference extends Value { * of ownership. *

* Not all target VMs support this operation. See - * VirtualMachine#canGetMonitorInfo to determine if the + * {@link VirtualMachine#canGetMonitorInfo} to determine if the * operation is supported. * * @return the {@link ThreadReference} which currently owns the @@ -392,7 +392,7 @@ public interface ObjectReference extends Value { * of ownership. *

* Not all target VMs support this operation. See - * VirtualMachine#canGetMonitorInfo to determine if the + * {@link VirtualMachine#canGetMonitorInfo} to determine if the * operation is supported. * * @see #owningThread @@ -422,12 +422,12 @@ public interface ObjectReference extends Value { * @param maxReferrers The maximum number of referring objects to return. * Must be non-negative. If zero, all referring * objects are returned. - * @return a of List of {@link ObjectReference} objects. If there are + * @return a List of {@link ObjectReference} objects. If there are * no objects that reference this object, a zero-length list is returned.. * @throws java.lang.UnsupportedOperationException if * the target virtual machine does not support this * operation - see - * {@link VirtualMachine#canGetInstanceInfo() canGetInstanceInfo()} + * {@link VirtualMachine#canGetInstanceInfo()} * @throws java.lang.IllegalArgumentException if maxReferrers is less * than zero. * @since 1.6 diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java b/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java index 0c7d0644229..0c4e833b613 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/VirtualMachine.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -427,7 +427,7 @@ public interface VirtualMachine extends Mirror { * @return a {@link StringReference} that mirrors the newly created * string in the target VM. * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - * -see {@link VirtualMachine#canBeModified()}. + * - see {@link VirtualMachine#canBeModified()}. */ StringReference mirrorOf(String value); @@ -448,7 +448,7 @@ public interface VirtualMachine extends Mirror { * @return the {@link java.lang.Process} object for this virtual * machine, or null if it was not launched by a {@link LaunchingConnector}. * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - * -see {@link VirtualMachine#canBeModified()}. + * - see {@link VirtualMachine#canBeModified()}. */ Process process(); @@ -678,7 +678,8 @@ public interface VirtualMachine extends Mirror { * Determines if the target VM supports the filtering of * class prepare events by source name. * - * see {@link ClassPrepareRequest#addSourceNameFilter}. + * @see ClassPrepareRequest#addSourceNameFilter + * * @return true if the feature is supported, * false otherwise. *