Skip to content

Commit

Permalink
fix javadoc for JDK11
Browse files Browse the repository at this point in the history
Signed-off-by: Lukas Jungmann <[email protected]>
  • Loading branch information
lukasj committed May 2, 2019
1 parent 691eeed commit 3bf05cb
Show file tree
Hide file tree
Showing 7 changed files with 24 additions and 23 deletions.
7 changes: 4 additions & 3 deletions src/main/java/org/glassfish/gmbal/DescriptorFields.java
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2007, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2007, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand Down Expand Up @@ -52,7 +52,8 @@
* <p>then the resulting {@code Descriptor} will contain the following
* fields:</p>
*
* <table border="2">
* <table>
* <caption>{@code Descriptor} fields</caption>
* <tr><th>Name</th><th>Value</th></tr>
* <tr><td>units</td><td>"bytes"</td></tr>
* <tr><td>since</td><td>"1.5"</td></tr>
Expand Down Expand Up @@ -95,7 +96,7 @@
* immutableInfo}</a> field for an MBean. The fields from the annotations
* must be consistent with these fields provided by the implementation.</p>
*
* <h4>{@literal @DescriptorFields and @DescriptorKey}</h4>
* <h3>{@literal @DescriptorFields and @DescriptorKey}</h3>
*
* <p>The DescriptorKey annotation provides
* another way to use annotations to define Descriptor fields.
Expand Down
8 changes: 5 additions & 3 deletions src/main/java/org/glassfish/gmbal/DescriptorKey.java
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand Down Expand Up @@ -86,7 +86,8 @@
* <p>then the resulting {@code Descriptor} will contain the following
* fields:</p>
*
* <table border="2">
* <table>
* <caption>{@code Descriptor} fields:</caption>
* <tr><th>Name</th><th>Value</th></tr>
* <tr><td>units</td><td>"bytes"</td></tr>
* <tr><td>descriptionResourceKey</td><td>"bytes.key"</td></tr>
Expand Down Expand Up @@ -136,7 +137,8 @@
* or an array of annotations. The value of the field is derived from
* the value of the annotation element as follows:</p>
*
* <table border="2">
* <table>
* <caption>Annotation element to {@code Descriptor} field mappings</caption>
* <tr><th>Annotation element</th><th>Descriptor field</th></tr>
* <tr><td>Primitive value ({@code 5}, {@code false}, etc)</td>
* <td>Wrapped value ({@code Integer.valueOf(5)},
Expand Down
6 changes: 3 additions & 3 deletions src/main/java/org/glassfish/gmbal/InheritedAttribute.java
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2007, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2007, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand All @@ -24,10 +24,10 @@
* it is implemented by the methods inherited by the Managed entity.
* <p>
* An example of a use of this is to handle @ManagedData that inherits from
* Collection<X>, and it is desired to display a read-only attribute containing
* {@code Collection<X>}, and it is desired to display a read-only attribute containing
* the elements of the Collection. Simple add the annotation
* <p>
* @InheritedAttribute( methodName="iterator" )
* {@code @InheritedAttribute( methodName="iterator" )}
* <p>
* to handle this case. Note that this only supports read-only attributes.
*/
Expand Down
11 changes: 5 additions & 6 deletions src/main/java/org/glassfish/gmbal/ManagedObjectManager.java
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2007, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2007, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand Down Expand Up @@ -80,7 +80,7 @@ public interface ManagedObjectManager extends Closeable {
GmbalMBean createRoot() ;

/** Create a root MBean from root, which much have a method with the
* @NameValue annotation.
* {@literal @}NameValue annotation.
* One of the createRoot methods must be called before any of the registration
* methods may be called.
* Only one call to createRoot is permitted after an ManagedObjectManager
Expand Down Expand Up @@ -122,12 +122,11 @@ public interface ManagedObjectManager extends Closeable {
* <p>
* The MBeanInfo for the result is actually ModelMBeanInfo, and may contain
* extra metadata as defined using annotations defined with the
* @DescriptorKey and @DescriptorField meta-annotations.
* {@literal @}DescriptorKey and {@literal @}DescriptorField meta-annotations.
* <p>
* Must be called after a successful createRoot call.
* <p>
* This version of register should not be used to register singletons.
* </ol>
* @param parent The parent object that contains obj.
* @param obj The managed object we are registering.
* @param name The name to use for registering this object.
Expand Down Expand Up @@ -331,8 +330,8 @@ public enum RegistrationDebugLevel { NONE, NORMAL, FINE } ;
* <p>
* May be called at any time.
*
* @param level set to 1 to just see the results of the TypeEvaluator, >1 to
* see lots of details. WARNING: values >1 will result in a large amount
* @param level set to 1 to just see the results of the TypeEvaluator, {@literal >}1 to
* see lots of details. WARNING: values {@literal >}1 will result in a large amount
* of output.
*/
void setTypelibDebug( int level ) ;
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2008, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2008, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand Down Expand Up @@ -116,7 +116,7 @@ void clear() {
}

/** Increment the suspended registration count.
* All registrations with JMX are suspended while suspendCount > 0.
* All registrations with JMX are suspended while suspendCount {@literal >} 0.
*/
public void suspendRegistration() {
synchronized (lock) {
Expand All @@ -126,7 +126,7 @@ public void suspendRegistration() {

/** Decrement the suspended registration count.
* If the count goes to zero. all registrations that occurred while
* suspendCount > 0 are registered with the JMX server, UNLESS
* suspendCount {@literal >} 0 are registered with the JMX server, UNLESS
* isJMXRegistrationEnabled is false, in which case we simply clear the
* deferredRegistrations list, because all MBean will be registered once the
* root is available.
Expand Down Expand Up @@ -181,7 +181,7 @@ public void register( MBeanImpl mb )
* deferredRegistrations list and mark suspended false. In any case,
* we unregister from JMX if JMX registration is enabled.
* Note that we may call unregister on an unregistered object if
* suspendCount > 0, but that's OK, because MBean.unregister does
* suspendCount {@literal >} 0, but that's OK, because MBean.unregister does
* nothing if mb is not registered.
* @param mb The MBean to unregister.
* @throws InstanceNotFoundException
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2007, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2007, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand All @@ -15,7 +15,6 @@
import java.lang.annotation.ElementType ;
import java.lang.annotation.Retention ;
import java.lang.annotation.RetentionPolicy ;
import sun.font.EAttribute;

/** Flag on a method indicating that the
*
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2006, 2018 Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2006, 2019 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
Expand Down Expand Up @@ -37,7 +37,7 @@ public class GenericConstructor<T> {
* Generally cls is a class that has been generated and loaded, so
* no compiled code can depend on the class directly. However, the
* generated class probably implements some interface T, represented
* here by Class<T>.
* here by {@code Class<T>}.
* @param type The expected type of a create call.
* @param className The name of the class to use for a constructor.
* @param signature The signature of the desired constructor.
Expand Down

0 comments on commit 3bf05cb

Please sign in to comment.