clean up some JavaDoc

4 files changed, 24 insertions, 25 deletions

diff --git a/common/tests/org.eclipse.jpt.common.utility.tests/src/org/eclipse/jpt/common/utility/tests/internal/model/value/swing/TreeModelAdapterTests.java b/common/tests/org.eclipse.jpt.common.utility.tests/src/org/eclipse/jpt/common/utility/tests/internal/model/value/swing/TreeModelAdapterTests.java
index 4d83541980..97d635aef9 100644
--- a/common/tests/org.eclipse.jpt.common.utility.tests/src/org/eclipse/jpt/common/utility/tests/internal/model/value/swing/TreeModelAdapterTests.java
+++ b/common/tests/org.eclipse.jpt.common.utility.tests/src/org/eclipse/jpt/common/utility/tests/internal/model/value/swing/TreeModelAdapterTests.java
@@ -211,16 +211,17 @@ public class TreeModelAdapterTests extends TestCase {
 	}
 
 	/**
-	 * test a problem we had where removing a child from a tree would cause
-	 * the JTree to call #equals(Object) on each node removed (actually, it was
-	 * TreePath, but that was because its own #equals(Object) was called by
-	 * JTree); and since we had already removed the last listener from the
-	 * aspect adapter, the aspect adapter would say its value was null; this
-	 * would cause a NPE until we tweaked TreeModelAdapter to remove its
-	 * listeners from a node only *after* the node had been completely
-	 * removed from the JTree
-	 * @see TreeModelAdapter#removeNode(Object[], int, TreeNodeValueModel)
-	 * @see TreeModelAdapter#addNode(Object[], int, TreeNodeValueModel)
+	 * Test a problem we had where removing a child from a tree would cause
+	 * the {@link JTree} to call {@link Object#equals(Object)} on each node removed
+	 * (actually, it was {@link javax.swing.tree.TreePath}, but that was because
+	 * its own {@link javax.swing.tree.TreePath#equals(Object) equals} method was called by
+	 * {@link JTree}); and since we had already removed the last listener from the
+	 * aspect adapter, the aspect adapter would say its value was <code>null</code>;
+	 * this would cause a NPE until we tweaked {@link TreeModelAdapter} to remove its
+	 * listeners from a node only <em>after</em> the node had been completely
+	 * removed from the {@link JTree}
+	 * @see TreeModelAdapter#removeChildren(TreeNodeValueModel[] path, int[] childIndices, TreeNodeValueModel[] children)
+	 * @see TreeModelAdapter#addChildren(TreeNodeValueModel[] path, int[] childIndices, TreeNodeValueModel[] children)
 	 */
 	public void testLazyInitialization() {
 		TreeModel treeModel = this.buildSpecialTreeModel();
diff --git a/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/context/java/JavaPersistentAttribute.java b/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/context/java/JavaPersistentAttribute.java
index dd0ba4563f..eb5ebfa461 100644
--- a/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/context/java/JavaPersistentAttribute.java
+++ b/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/context/java/JavaPersistentAttribute.java
@@ -1,18 +1,17 @@
 /*******************************************************************************

- *  Copyright (c) 2013  Oracle. All rights reserved.

- *  This program and the accompanying materials are made available under the

- *  terms of the Eclipse Public License v1.0, which accompanies this distribution

- *  and is available at http://www.eclipse.org/legal/epl-v10.html

- *  

- *  Contributors: 

- *  	Oracle - initial API and implementation

- *******************************************************************************/

+ * Copyright (c) 2013, 2016 Oracle. All rights reserved.

+ * This program and the accompanying materials are made available under the

+ * terms of the Eclipse Public License v1.0, which accompanies this distribution

+ * and is available at http://www.eclipse.org/legal/epl-v10.html.

+ * 

+ * Contributors:

+ *     Oracle - initial API and implementation

+ ******************************************************************************/

 package org.eclipse.jpt.jaxb.core.context.java;
 
 import org.eclipse.jpt.common.core.resource.java.JavaResourceAttribute;

 import org.eclipse.jpt.common.core.resource.java.JavaResourceField;

 import org.eclipse.jpt.common.core.resource.java.JavaResourceMethod;

-import org.eclipse.jpt.jaxb.core.context.JaxbAttributeMapping;

 import org.eclipse.jpt.jaxb.core.context.JaxbPersistentAttribute;

 

 /**

@@ -48,7 +47,7 @@ public interface JavaPersistentAttribute
 	

 	/**

 	 * Return the key for the attribute's default mapping.

-	 * @see JaxbAttributeMapping#isDefault()

+	 * @see JavaAttributeMapping#isDefault()

 	 */

 	String getDefaultMappingKey();

 }
diff --git a/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/internal/AbstractJaxbNode.java b/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/internal/AbstractJaxbNode.java
index 05ff36c0c7..1dc528384e 100644
--- a/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/internal/AbstractJaxbNode.java
+++ b/jaxb/plugins/org.eclipse.jpt.jaxb.core/src/org/eclipse/jpt/jaxb/core/internal/AbstractJaxbNode.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2010, 2015 Oracle. All rights reserved.
+ * Copyright (c) 2010, 2016 Oracle. All rights reserved.
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0, which accompanies this distribution
  * and is available at http://www.eclipse.org/legal/epl-v10.html.
@@ -17,7 +17,6 @@ import java.util.Vector;
 import org.eclipse.core.resources.IFile;
 import org.eclipse.core.resources.IResource;
 import org.eclipse.jpt.common.core.internal.utility.PlatformTools;
-import org.eclipse.jpt.common.core.internal.utility.jdt.JDTModifiedDeclaration.Adapter;
 import org.eclipse.jpt.common.utility.internal.ObjectTools;
 import org.eclipse.jpt.common.utility.internal.collection.CollectionTools;
 import org.eclipse.jpt.common.utility.internal.iterable.IterableTools;
@@ -297,7 +296,7 @@ public abstract class AbstractJaxbNode
 		}
 
 		/**
-		 * @see #synchronizeWithResourceModel(Adapter)
+		 * @see #synchronizeWithResourceModel()
 		 */
 		public void update() {
 			sync(false);  // false = update
diff --git a/jpa/tests/org.eclipse.jpt.jpa.eclipselink.core.tests/src/org/eclipse/jpt/jpa/eclipselink/core/tests/internal/plugin/JptJpaEclipseLinkCoreTestsPlugin.java b/jpa/tests/org.eclipse.jpt.jpa.eclipselink.core.tests/src/org/eclipse/jpt/jpa/eclipselink/core/tests/internal/plugin/JptJpaEclipseLinkCoreTestsPlugin.java
index 06a78e1c53..9d0d877aef 100644
--- a/jpa/tests/org.eclipse.jpt.jpa.eclipselink.core.tests/src/org/eclipse/jpt/jpa/eclipselink/core/tests/internal/plugin/JptJpaEclipseLinkCoreTestsPlugin.java
+++ b/jpa/tests/org.eclipse.jpt.jpa.eclipselink.core.tests/src/org/eclipse/jpt/jpa/eclipselink/core/tests/internal/plugin/JptJpaEclipseLinkCoreTestsPlugin.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2012 Oracle. All rights reserved.
+ * Copyright (c) 2012, 2016 Oracle. All rights reserved.
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0, which accompanies this distribution
  * and is available at http://www.eclipse.org/legal/epl-v10.html.
@@ -25,7 +25,7 @@ import org.osgi.framework.BundleContext;
  * {@link org.eclipse.jpt.jpa.core.tests.internal.plugin.JptJpaCoreTestsPlugin}
  * is not loaded (as it is when executing
  * {@link org.eclipse.jpt.jpa.eclipselink.core.tests.internal.JptJpaEclipseLinkCoreTests}).
- * So we need to stop preference flushes {@link #start_() here} also.
+ * So we need to stop preference flushes {@link #start(BundleContext) here} also.
  */
 public class JptJpaEclipseLinkCoreTestsPlugin
 	extends JptPlugin