Attachment 178084 Details for Bug 322596 – Proposed fix

[patch] Proposed fix

patch_322596.txt (text/plain), 161.52 KB, created by Olivier Thomann

on 2010-09-02 14:43:09 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Olivier Thomann

Created: 2010-09-02 14:43:09 EDT

Size: 161.52 KB

patch

obsolete

>### Eclipse Workspace Patch 1.0
>#P org.eclipse.jdt.core
>Index: dom/org/eclipse/jdt/core/dom/ASTMatcher.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ASTMatcher.java,v
>retrieving revision 1.47
>diff -u -r1.47 ASTMatcher.java
>--- dom/org/eclipse/jdt/core/dom/ASTMatcher.java	7 Mar 2009 01:08:09 -0000	1.47
>+++ dom/org/eclipse/jdt/core/dom/ASTMatcher.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -85,11 +85,11 @@
> 	 * 
> 	 *
> 	 * @param list1 the first list of AST nodes
>-	 * (element type: <code>ASTNode</code>)
>+	 * (element type: {@link ASTNode})
> 	 * @param list2 the second list of AST nodes
>-	 * (element type: <code>ASTNode</code>)
>+	 * (element type: {@link ASTNode})
> 	 * @return <code>true</code> if the lists have the same number of elements
>-	 * and match pair-wise according to <code>ASTNode.subtreeMatch</code>
>+	 * and match pair-wise according to {@link ASTNode#subtreeMatch(ASTMatcher, Object) ASTNode.subtreeMatch}
> 	 * @see ASTNode#subtreeMatch(ASTMatcher matcher, Object other)
> 	 */
> 	public final boolean safeSubtreeListMatch(List list1, List list2) {
>Index: dom/org/eclipse/jdt/core/dom/ASTNode.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ASTNode.java,v
>retrieving revision 1.80
>diff -u -r1.80 ASTNode.java
>--- dom/org/eclipse/jdt/core/dom/ASTNode.java	7 Mar 2009 00:59:01 -0000	1.80
>+++ dom/org/eclipse/jdt/core/dom/ASTNode.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -1099,7 +1099,7 @@
> 
> 		/**
> 		 * The underlying list in which the nodes of this list are
>-		 * stored (element type: <code>ASTNode</code>).
>+		 * stored (element type: {@link ASTNode}).
> 		 * 
> 		 * Be stingy on storage - assume that list will be empty.
> 		 * 
>@@ -1171,7 +1171,7 @@
> 
> 		/**
> 		 * A list of currently active cursors (element type:
>-		 * <code>Cursor</code>), or <code>null</code> if there are no
>+		 * {@link Cursor}), or <code>null</code> if there are no
> 		 * active cursors.
> 		 * 
> 		 * It is important for storage considerations to maintain the
>@@ -1753,7 +1753,7 @@
> 	 * @param propertyList list beginning with the AST node class
> 	 * followed by accumulated structural property descriptors
> 	 * @return unmodifiable list of structural property descriptors
>-	 * (element type: <code>StructuralPropertyDescriptor</code>)
>+	 * (element type: {@link StructuralPropertyDescriptor})
> 	 */
> 	static List reapPropertyList(List propertyList) {
> 		propertyList.remove(0); // remove nodeClass
>@@ -2406,9 +2406,9 @@
> 	 *
> 	 * @param target the AST that is to own the nodes in the result
> 	 * @param nodes the list of nodes to copy
>-	 * (element type: <code>ASTNode</code>)
>+	 * (element type: {@link ASTNode})
> 	 * @return the list of copied subtrees
>-	 * (element type: <code>ASTNode</code>)
>+	 * (element type: {@link ASTNode})
> 	 */
> 	public static List copySubtrees(AST target, List nodes) {
> 		List result = new ArrayList(nodes.size());
>Index: dom/org/eclipse/jdt/core/dom/AbstractTypeDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/AbstractTypeDeclaration.java,v
>retrieving revision 1.19
>diff -u -r1.19 AbstractTypeDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/AbstractTypeDeclaration.java	7 Mar 2009 01:08:09 -0000	1.19
>+++ dom/org/eclipse/jdt/core/dom/AbstractTypeDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2009 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -29,14 +29,14 @@
> 	/**
> 	 * The type name; lazily initialized; defaults to a unspecified,
> 	 * legal Java class identifier.
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	SimpleName typeName = null;
> 
> 	/**
>-	 * The body declarations (element type: <code>BodyDeclaration</code>).
>+	 * The body declarations (element type: {@link BodyDeclaration}).
> 	 * Defaults to an empty list.
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	ASTNode.NodeList bodyDeclarations;
> 
>@@ -80,7 +80,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "bodyDeclaration" property declared on the given concrete node type.
>+	 * "bodyDeclaration" property declared on the given concrete node type (element type: {@link BodyDeclaration}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>@@ -90,7 +90,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "name" property declared on the given concrete node type.
>+	 * "name" property declared on the given concrete node type (child type: {@link SimpleName}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>@@ -118,7 +118,7 @@
> 	 * Returns the name of the type declared in this type declaration.
> 	 *
> 	 * @return the type name node
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	public SimpleName getName() {
> 		if (this.typeName == null) {
>@@ -144,7 +144,7 @@
> 	 * <li>the node belongs to a different AST</li>
> 	 * <li>the node already has a parent</li>
> 	 * </ul>
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	public void setName(SimpleName typeName) {
> 		if (typeName == null) {
>@@ -162,8 +162,8 @@
> 	 * declaration.
> 	 *
> 	 * @return the live list of body declarations
>-	 * (element type: <code>BodyDeclaration</code>)
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * (element type: {@link BodyDeclaration})
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	public List bodyDeclarations() {
> 		return this.bodyDeclarations;
>@@ -179,7 +179,7 @@
> 	 *
> 	 * @return <code>true</code> if this type declaration is a child of
> 	 * a compilation unit node, and <code>false</code> otherwise
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	public boolean isPackageMemberTypeDeclaration() {
> 		ASTNode parent = getParent();
>@@ -197,7 +197,7 @@
> 	 * @return <code>true</code> if this type declaration is a child of
> 	 * a type declaration node or an anonymous class declaration node,
> 	 * and <code>false</code> otherwise
>-	 * @since 2.0 (originally declared on <code>TypeDeclaration</code>)
>+	 * @since 2.0 (originally declared on {@link TypeDeclaration})
> 	 */
> 	public boolean isMemberTypeDeclaration() {
> 		ASTNode parent = getParent();
>Index: dom/org/eclipse/jdt/core/dom/Annotation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Annotation.java,v
>retrieving revision 1.17
>diff -u -r1.17 Annotation.java
>--- dom/org/eclipse/jdt/core/dom/Annotation.java	7 Mar 2009 01:08:09 -0000	1.17
>+++ dom/org/eclipse/jdt/core/dom/Annotation.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2009 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -44,7 +44,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "typeName" property declared on the given concrete node type.
>+	 * "typeName" property declared on the given concrete node type (child type: {@link Name}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>Index: dom/org/eclipse/jdt/core/dom/AnnotationTypeMemberDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/AnnotationTypeMemberDeclaration.java,v
>retrieving revision 1.22
>diff -u -r1.22 AnnotationTypeMemberDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/AnnotationTypeMemberDeclaration.java	27 Jun 2008 16:03:49 -0000	1.22
>+++ dom/org/eclipse/jdt/core/dom/AnnotationTypeMemberDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -52,19 +52,19 @@
> 		internalModifiers2PropertyFactory(AnnotationTypeMemberDeclaration.class);
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(AnnotationTypeMemberDeclaration.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(AnnotationTypeMemberDeclaration.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "default" structural property of this node type.
>+	 * The "default" structural property of this node type (child type: {@link Expression}).
> 	 */
> 	public static final ChildPropertyDescriptor DEFAULT_PROPERTY =
> 		new ChildPropertyDescriptor(AnnotationTypeMemberDeclaration.class, "default", Expression.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
>Index: dom/org/eclipse/jdt/core/dom/AnonymousClassDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/AnonymousClassDeclaration.java,v
>retrieving revision 1.21
>diff -u -r1.21 AnonymousClassDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/AnonymousClassDeclaration.java	27 Jun 2008 16:03:45 -0000	1.21
>+++ dom/org/eclipse/jdt/core/dom/AnonymousClassDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -32,7 +32,7 @@
> public class AnonymousClassDeclaration extends ASTNode {
> 
> 	/**
>-	 * The "bodyDeclarations" structural property of this node type.
>+	 * The "bodyDeclarations" structural property of this node type (element type: {@link BodyDeclaration}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor BODY_DECLARATIONS_PROPERTY =
>@@ -68,7 +68,7 @@
> 	}
> 
> 	/**
>-	 * The body declarations (element type: <code>BodyDeclaration</code>).
>+	 * The body declarations (element type: {@link BodyDeclaration}).
> 	 * Defaults to none.
> 	 */
> 	private ASTNode.NodeList bodyDeclarations =
>@@ -150,7 +150,7 @@
> 	 * anonymous class declaration.
> 	 *
> 	 * @return the live list of body declarations
>-	 * (element type: <code>BodyDeclaration</code>)
>+	 * (element type: {@link BodyDeclaration})
> 	 */
> 	public List bodyDeclarations() {
> 		return this.bodyDeclarations;
>Index: dom/org/eclipse/jdt/core/dom/ArrayAccess.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ArrayAccess.java,v
>retrieving revision 1.27
>diff -u -r1.27 ArrayAccess.java
>--- dom/org/eclipse/jdt/core/dom/ArrayAccess.java	27 Jun 2008 16:03:48 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/ArrayAccess.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class ArrayAccess extends Expression {
> 
> 	/**
>-	 * The "array" structural property of this node type.
>+	 * The "array" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor ARRAY_PROPERTY =
> 		new ChildPropertyDescriptor(ArrayAccess.class, "array", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "index" structural property of this node type.
>+	 * The "index" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor INDEX_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/ArrayCreation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ArrayCreation.java,v
>retrieving revision 1.32
>diff -u -r1.32 ArrayCreation.java
>--- dom/org/eclipse/jdt/core/dom/ArrayCreation.java	27 Jun 2008 16:03:45 -0000	1.32
>+++ dom/org/eclipse/jdt/core/dom/ArrayCreation.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -49,21 +49,21 @@
> public class ArrayCreation extends Expression {
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link ArrayType}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(ArrayCreation.class, "type", ArrayType.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "dimensions" structural property of this node type.
>+	 * The "dimensions" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor DIMENSIONS_PROPERTY =
> 		new ChildListPropertyDescriptor(ArrayCreation.class, "dimensions", Expression.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "initializer" structural property of this node type.
>+	 * The "initializer" structural property of this node type (child type: {@link ArrayInitializer}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor INITIALIZER_PROPERTY =
>@@ -108,7 +108,7 @@
> 
> 	/**
> 	 * The list of dimension expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList dimensions =
> 		new ASTNode.NodeList(DIMENSIONS_PROPERTY);
>@@ -261,7 +261,7 @@
> 	 * initializer.
> 	 *
> 	 * @return the live list of dimension expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List dimensions() {
> 		return this.dimensions;
>Index: dom/org/eclipse/jdt/core/dom/ArrayInitializer.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ArrayInitializer.java,v
>retrieving revision 1.21
>diff -u -r1.21 ArrayInitializer.java
>--- dom/org/eclipse/jdt/core/dom/ArrayInitializer.java	27 Jun 2008 16:03:47 -0000	1.21
>+++ dom/org/eclipse/jdt/core/dom/ArrayInitializer.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class ArrayInitializer extends Expression {
> 
> 	/**
>-	 * The "expressions" structural property of this node type.
>+	 * The "expressions" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor EXPRESSIONS_PROPERTY =
>@@ -65,7 +65,7 @@
> 
> 	/**
> 	 * The list of expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList expressions =
> 		new ASTNode.NodeList(EXPRESSIONS_PROPERTY);
>@@ -138,7 +138,7 @@
> 	 * Returns the live ordered list of expressions in this array initializer.
> 	 *
> 	 * @return the live list of expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List expressions() {
> 		return this.expressions;
>Index: dom/org/eclipse/jdt/core/dom/ArrayType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ArrayType.java,v
>retrieving revision 1.30
>diff -u -r1.30 ArrayType.java
>--- dom/org/eclipse/jdt/core/dom/ArrayType.java	27 Jun 2008 16:03:46 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/ArrayType.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -30,7 +30,7 @@
> public class ArrayType extends Type {
> 
> 	/**
>-	 * The "componentType" structural property of this node type.
>+	 * The "componentType" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor COMPONENT_TYPE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/AssertStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/AssertStatement.java,v
>retrieving revision 1.29
>diff -u -r1.29 AssertStatement.java
>--- dom/org/eclipse/jdt/core/dom/AssertStatement.java	27 Jun 2008 16:03:47 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/AssertStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class AssertStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(AssertStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "message" structural property of this node type.
>+	 * The "message" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor MESSAGE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/Assignment.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Assignment.java,v
>retrieving revision 1.30
>diff -u -r1.30 Assignment.java
>--- dom/org/eclipse/jdt/core/dom/Assignment.java	27 Jun 2008 16:03:46 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/Assignment.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -148,21 +148,21 @@
> 	}
> 
> 	/**
>-	 * The "leftHandSide" structural property of this node type.
>+	 * The "leftHandSide" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LEFT_HAND_SIDE_PROPERTY =
> 		new ChildPropertyDescriptor(Assignment.class, "leftHandSide", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "operator" structural property of this node type.
>+	 * The "operator" structural property of this node type (type: {@link Assignment.Operator}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor OPERATOR_PROPERTY =
> 		new SimplePropertyDescriptor(Assignment.class, "operator", Assignment.Operator.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "rightHandSide" structural property of this node type.
>+	 * The "rightHandSide" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor RIGHT_HAND_SIDE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/Block.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Block.java,v
>retrieving revision 1.23
>diff -u -r1.23 Block.java
>--- dom/org/eclipse/jdt/core/dom/Block.java	27 Jun 2008 16:03:47 -0000	1.23
>+++ dom/org/eclipse/jdt/core/dom/Block.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class Block extends Statement {
> 
> 	/**
>-	 * The "statements" structural property of this node type.
>+	 * The "statements" structural property of this node type (element type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor STATEMENTS_PROPERTY =
>@@ -63,7 +63,7 @@
> 	}
> 
> 	/**
>-	 * The list of statements (element type: <code>Statement</code>).
>+	 * The list of statements (element type: {@link Statement}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList statements =
>@@ -146,7 +146,7 @@
> 	 * exception.
> 	 *
> 	 * @return the live list of statements in this block
>-	 * (element type: <code>Statement</code>)
>+	 * (element type: {@link Statement})
> 	 */
> 	public List statements() {
> 		return this.statements;
>Index: dom/org/eclipse/jdt/core/dom/BodyDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/BodyDeclaration.java,v
>retrieving revision 1.25
>diff -u -r1.25 BodyDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/BodyDeclaration.java	7 Mar 2009 01:08:09 -0000	1.25
>+++ dom/org/eclipse/jdt/core/dom/BodyDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -70,7 +70,7 @@
> 	private int modifierFlags = Modifier.NONE;
> 
> 	/**
>-	 * The extended modifiers (element type: <code>IExtendedModifier</code>).
>+	 * The extended modifiers (element type: {@link IExtendedModifier}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 *
>@@ -127,7 +127,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "javadoc" property declared on the given concrete node type.
>+	 * "javadoc" property declared on the given concrete node type (child type: {@link Javadoc}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>@@ -137,7 +137,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "modifiers" property declared on the given concrete node type.
>+	 * "modifiers" property declared on the given concrete node type (type: {@link Integer}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>@@ -147,7 +147,7 @@
> 
> 	/**
> 	 * Creates and returns a structural property descriptor for the
>-	 * "modifiers" property declared on the given concrete node type.
>+	 * "modifiers" property declared on the given concrete node type (element type: {@link IExtendedModifier}).
> 	 *
> 	 * @return the property descriptor
> 	 */
>@@ -259,7 +259,7 @@
> 	 * of this declaration (added in JLS3 API).
> 	 *
> 	 * @return the live list of modifiers and annotations
>-	 * (element type: <code>IExtendedModifier</code>)
>+	 * (element type: {@link IExtendedModifier})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>Index: dom/org/eclipse/jdt/core/dom/BooleanLiteral.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/BooleanLiteral.java,v
>retrieving revision 1.22
>diff -u -r1.22 BooleanLiteral.java
>--- dom/org/eclipse/jdt/core/dom/BooleanLiteral.java	27 Jun 2008 16:03:46 -0000	1.22
>+++ dom/org/eclipse/jdt/core/dom/BooleanLiteral.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -29,7 +29,7 @@
> public class BooleanLiteral extends Expression {
> 
> 	/**
>-	 * The "booleanValue" structural property of this node type.
>+	 * The "booleanValue" structural property of this node type (type: {@link Boolean}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor BOOLEAN_VALUE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/BreakStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/BreakStatement.java,v
>retrieving revision 1.26
>diff -u -r1.26 BreakStatement.java
>--- dom/org/eclipse/jdt/core/dom/BreakStatement.java	27 Jun 2008 16:03:48 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/BreakStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class BreakStatement extends Statement {
> 
> 	/**
>-	 * The "label" structural property of this node type.
>+	 * The "label" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LABEL_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/CastExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/CastExpression.java,v
>retrieving revision 1.27
>diff -u -r1.27 CastExpression.java
>--- dom/org/eclipse/jdt/core/dom/CastExpression.java	27 Jun 2008 16:03:47 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/CastExpression.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class CastExpression extends Expression {
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(CastExpression.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/CatchClause.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/CatchClause.java,v
>retrieving revision 1.29
>diff -u -r1.29 CatchClause.java
>--- dom/org/eclipse/jdt/core/dom/CatchClause.java	5 Mar 2010 15:07:52 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/CatchClause.java	2 Sep 2010 18:40:35 -0000
>@@ -29,14 +29,14 @@
> public class CatchClause extends ASTNode {
> 
> 	/**
>-	 * The "exception" structural property of this node type.
>+	 * The "exception" structural property of this node type (child type: {@link SingleVariableDeclaration}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXCEPTION_PROPERTY =
> 		new ChildPropertyDescriptor(CatchClause.class, "exception", SingleVariableDeclaration.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/CharacterLiteral.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/CharacterLiteral.java,v
>retrieving revision 1.40
>diff -u -r1.40 CharacterLiteral.java
>--- dom/org/eclipse/jdt/core/dom/CharacterLiteral.java	23 Sep 2008 18:11:52 -0000	1.40
>+++ dom/org/eclipse/jdt/core/dom/CharacterLiteral.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class CharacterLiteral extends Expression {
> 
> 	/**
>-	 * The "escapedValue" structural property of this node type.
>+	 * The "escapedValue" structural property of this node type (type: {@link String}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor ESCAPED_VALUE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/ClassInstanceCreation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ClassInstanceCreation.java,v
>retrieving revision 1.44
>diff -u -r1.44 ClassInstanceCreation.java
>--- dom/org/eclipse/jdt/core/dom/ClassInstanceCreation.java	27 Jun 2008 16:03:46 -0000	1.44
>+++ dom/org/eclipse/jdt/core/dom/ClassInstanceCreation.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -63,42 +63,42 @@
> public class ClassInstanceCreation extends Expression {
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type (added in JLS3 API).
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(ClassInstanceCreation.class, "typeArguments", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(ClassInstanceCreation.class, "expression", Expression.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type (JLS2 API only).
>+	 * The "name" structural property of this node type (child type: {@link Name}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(ClassInstanceCreation.class, "name", Name.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "type" structural property of this node type (added in JLS3 API).
>+	 * The "type" structural property of this node type (child type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(ClassInstanceCreation.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "arguments" structural property of this node type.
>+	 * The "arguments" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(ClassInstanceCreation.class, "arguments", Expression.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "anonymousClassDeclaration" structural property of this node type.
>+	 * The "anonymousClassDeclaration" structural property of this node type (child type: {@link AnonymousClassDeclaration}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor ANONYMOUS_CLASS_DECLARATION_PROPERTY =
>@@ -164,7 +164,7 @@
> 	private Expression optionalExpression = null;
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -185,7 +185,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -373,7 +373,7 @@
> 	 * instance creation (added in JLS3 API).
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -511,7 +511,7 @@
> 	 * instance creation expression.
> 	 *
> 	 * @return the live list of argument expressions (possibly empty)
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/CompilationUnit.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/CompilationUnit.java,v
>retrieving revision 1.93
>diff -u -r1.93 CompilationUnit.java
>--- dom/org/eclipse/jdt/core/dom/CompilationUnit.java	25 Jun 2010 14:58:37 -0000	1.93
>+++ dom/org/eclipse/jdt/core/dom/CompilationUnit.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -63,7 +63,7 @@
> 	private static final IProblem[] EMPTY_PROBLEMS = new IProblem[0];
> 
> 	/**
>-	 * The "imports" structural property of this node type.
>+	 * The "imports" structural property of this node type (element type: {@link ImportDeclaration}).
> 	 *
> 	 * @since 3.0
> 	 */
>@@ -71,7 +71,7 @@
> 		new ChildListPropertyDescriptor(CompilationUnit.class, "imports", ImportDeclaration.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "package" structural property of this node type.
>+	 * The "package" structural property of this node type (child type: {@link PackageDeclaration}).
> 	 *
> 	 * @since 3.0
> 	 */
>@@ -87,7 +87,7 @@
> 	private static final List PROPERTY_DESCRIPTORS;
> 
> 	/**
>-	 * The "types" structural property of this node type.
>+	 * The "types" structural property of this node type (element type: {@link AbstractTypeDeclaration}).
> 	 *
> 	 * @since 3.0
> 	 */
>@@ -154,7 +154,7 @@
> 	private Message[] messages;
> 
> 	/**
>-	 * The comment list (element type: <code>Comment</code>,
>+	 * The comment list (element type: {@link Comment},
> 	 * or <code>null</code> if none; initially <code>null</code>.
> 	 * @since 3.0
> 	 */
>Index: dom/org/eclipse/jdt/core/dom/ConditionalExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ConditionalExpression.java,v
>retrieving revision 1.27
>diff -u -r1.27 ConditionalExpression.java
>--- dom/org/eclipse/jdt/core/dom/ConditionalExpression.java	27 Jun 2008 16:03:49 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/ConditionalExpression.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,21 +28,21 @@
> public class ConditionalExpression extends Expression {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(ConditionalExpression.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "thenExpression" structural property of this node type.
>+	 * The "thenExpression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor THEN_EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(ConditionalExpression.class, "thenExpression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "elseExpression" structural property of this node type.
>+	 * The "elseExpression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor ELSE_EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/ConstructorInvocation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ConstructorInvocation.java,v
>retrieving revision 1.27
>diff -u -r1.27 ConstructorInvocation.java
>--- dom/org/eclipse/jdt/core/dom/ConstructorInvocation.java	27 Jun 2008 16:03:48 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/ConstructorInvocation.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -34,14 +34,14 @@
> public class ConstructorInvocation extends Statement {
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type (added in JLS3 API).
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(ConstructorInvocation.class, "typeArguments", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "arguments" structural property of this node type.
>+	 * The "arguments" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor ARGUMENTS_PROPERTY =
>@@ -96,7 +96,7 @@
> 	}
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -105,7 +105,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -192,7 +192,7 @@
> 	 * invocation (added in JLS3 API).
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -210,7 +210,7 @@
> 	 * constructor invocation statement.
> 	 *
> 	 * @return the live list of argument expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/ContinueStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ContinueStatement.java,v
>retrieving revision 1.26
>diff -u -r1.26 ContinueStatement.java
>--- dom/org/eclipse/jdt/core/dom/ContinueStatement.java	27 Jun 2008 16:03:49 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/ContinueStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class ContinueStatement extends Statement {
> 
> 	/**
>-	 * The "label" structural property of this node type.
>+	 * The "label" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LABEL_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/DoStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/DoStatement.java,v
>retrieving revision 1.31
>diff -u -r1.31 DoStatement.java
>--- dom/org/eclipse/jdt/core/dom/DoStatement.java	27 Jun 2008 16:03:48 -0000	1.31
>+++ dom/org/eclipse/jdt/core/dom/DoStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class DoStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(DoStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/EnhancedForStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/EnhancedForStatement.java,v
>retrieving revision 1.24
>diff -u -r1.24 EnhancedForStatement.java
>--- dom/org/eclipse/jdt/core/dom/EnhancedForStatement.java	5 Mar 2010 15:07:52 -0000	1.24
>+++ dom/org/eclipse/jdt/core/dom/EnhancedForStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -32,19 +32,19 @@
> public class EnhancedForStatement extends Statement {
> 
> 	/**
>-	 * The "parameter" structural property of this node type.
>+	 * The "parameter" structural property of this node type (child type: {@link SingleVariableDeclaration}).
> 	 */
> 	public static final ChildPropertyDescriptor PARAMETER_PROPERTY =
> 		new ChildPropertyDescriptor(EnhancedForStatement.class, "parameter", SingleVariableDeclaration.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(EnhancedForStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Statement}).
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
> 		new ChildPropertyDescriptor(EnhancedForStatement.class, "body", Statement.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
>Index: dom/org/eclipse/jdt/core/dom/EnumConstantDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/EnumConstantDeclaration.java,v
>retrieving revision 1.26
>diff -u -r1.26 EnumConstantDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/EnumConstantDeclaration.java	27 Jun 2008 16:03:48 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/EnumConstantDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -54,19 +54,19 @@
> 		internalModifiers2PropertyFactory(EnumConstantDeclaration.class);
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(EnumConstantDeclaration.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "arguments" structural property of this node type.
>+	 * The "arguments" structural property of this node type (element type: {@link Expression}).
> 	 */
> 	public static final ChildListPropertyDescriptor ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(EnumConstantDeclaration.class, "arguments", Expression.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "anonymousClassDeclaration" structural property of this node type.
>+	 * The "anonymousClassDeclaration" structural property of this node type (child type: {@link AnonymousClassDeclaration}).
> 	 */
> 	public static final ChildPropertyDescriptor ANONYMOUS_CLASS_DECLARATION_PROPERTY =
> 		new ChildPropertyDescriptor(EnumConstantDeclaration.class, "anonymousClassDeclaration", AnonymousClassDeclaration.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
>@@ -111,7 +111,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -308,7 +308,7 @@
> 	 * to not explicitly specifying arguments.
> 	 *
> 	 * @return the live list of argument expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/EnumDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/EnumDeclaration.java,v
>retrieving revision 1.23
>diff -u -r1.23 EnumDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/EnumDeclaration.java	27 Jun 2008 16:03:47 -0000	1.23
>+++ dom/org/eclipse/jdt/core/dom/EnumDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -62,13 +62,13 @@
> 		internalNamePropertyFactory(EnumDeclaration.class);
> 
> 	/**
>-	 * The "superInterfaceTypes" structural property of this node type.
>+	 * The "superInterfaceTypes" structural property of this node type (element type: {@link Type}).
> 	 */
> 	public static final ChildListPropertyDescriptor SUPER_INTERFACE_TYPES_PROPERTY =
> 		new ChildListPropertyDescriptor(EnumDeclaration.class, "superInterfaceTypes", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "enumConstants" structural property of this node type.
>+	 * The "enumConstants" structural property of this node type (element type: {@link EnumConstantDeclaration}).
> 	 */
> 	public static final ChildListPropertyDescriptor ENUM_CONSTANTS_PROPERTY =
> 		new ChildListPropertyDescriptor(EnumDeclaration.class, "enumConstants", EnumConstantDeclaration.class, CYCLE_RISK); //$NON-NLS-1$
>@@ -113,7 +113,7 @@
> 	}
> 
> 	/**
>-	 * The superinterface types (element type: <code>Type</code>).
>+	 * The superinterface types (element type: {@link Type}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList superInterfaceTypes =
>@@ -121,7 +121,7 @@
> 
> 	/**
> 	 * The enum constant declarations
>-	 * (element type: <code>EnumConstantDeclaration</code>).
>+	 * (element type: {@link EnumConstantDeclaration}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList enumConstants =
>@@ -288,7 +288,7 @@
> 	 * declaration.
> 	 *
> 	 * @return the live list of super interface types
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 */
> 	public List superInterfaceTypes() {
> 		return this.superInterfaceTypes;
>Index: dom/org/eclipse/jdt/core/dom/ExpressionStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ExpressionStatement.java,v
>retrieving revision 1.29
>diff -u -r1.29 ExpressionStatement.java
>--- dom/org/eclipse/jdt/core/dom/ExpressionStatement.java	27 Jun 2008 16:03:48 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/ExpressionStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -31,7 +31,7 @@
> public class ExpressionStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/FieldAccess.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/FieldAccess.java,v
>retrieving revision 1.32
>diff -u -r1.32 FieldAccess.java
>--- dom/org/eclipse/jdt/core/dom/FieldAccess.java	27 Jun 2008 16:03:46 -0000	1.32
>+++ dom/org/eclipse/jdt/core/dom/FieldAccess.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -58,14 +58,14 @@
> public class FieldAccess extends Expression {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(FieldAccess.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/FieldDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/FieldDeclaration.java,v
>retrieving revision 1.43
>diff -u -r1.43 FieldDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/FieldDeclaration.java	7 Mar 2009 00:59:01 -0000	1.43
>+++ dom/org/eclipse/jdt/core/dom/FieldDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -60,14 +60,14 @@
> 		internalModifiers2PropertyFactory(FieldDeclaration.class);
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(FieldDeclaration.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "fragments" structural property of this node type).
>+	 * The "fragments" structural property of this node type (element type: {@link VariableDeclarationFragment}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor FRAGMENTS_PROPERTY =
>@@ -341,7 +341,7 @@
> 	 * type of node will trigger an exception.
> 	 *
> 	 * @return the live list of variable declaration fragments in this
>-	 * statement (element type: <code>VariableDeclarationFragment</code>)
>+	 * statement (element type: {@link VariableDeclarationFragment})
> 	 */
> 	public List fragments() {
> 		return this.variableDeclarationFragments;
>Index: dom/org/eclipse/jdt/core/dom/ForStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ForStatement.java,v
>retrieving revision 1.33
>diff -u -r1.33 ForStatement.java
>--- dom/org/eclipse/jdt/core/dom/ForStatement.java	27 Jun 2008 16:03:46 -0000	1.33
>+++ dom/org/eclipse/jdt/core/dom/ForStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -44,28 +44,28 @@
> public class ForStatement extends Statement {
> 
> 	/**
>-	 * The "initializers" structural property of this node type.
>+	 * The "initializers" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor INITIALIZERS_PROPERTY =
> 		new ChildListPropertyDescriptor(ForStatement.class, "initializers", Expression.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(ForStatement.class, "expression", Expression.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "updaters" structural property of this node type.
>+	 * The "updaters" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor UPDATERS_PROPERTY =
> 		new ChildListPropertyDescriptor(ForStatement.class, "updaters", Expression.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>@@ -105,7 +105,7 @@
> 
> 	/**
> 	 * The list of initializer expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList initializers =
> 		new ASTNode.NodeList(INITIALIZERS_PROPERTY);
>@@ -117,7 +117,7 @@
> 
> 	/**
> 	 * The list of update expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList updaters =
> 		new ASTNode.NodeList(UPDATERS_PROPERTY);
>@@ -241,7 +241,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of initializer expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List initializers() {
> 		return this.initializers;
>@@ -286,7 +286,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of update expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List updaters() {
> 		return this.updaters;
>Index: dom/org/eclipse/jdt/core/dom/IfStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/IfStatement.java,v
>retrieving revision 1.31
>diff -u -r1.31 IfStatement.java
>--- dom/org/eclipse/jdt/core/dom/IfStatement.java	27 Jun 2008 16:03:47 -0000	1.31
>+++ dom/org/eclipse/jdt/core/dom/IfStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -27,21 +27,21 @@
> public class IfStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(IfStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "thenStatement" structural property of this node type.
>+	 * The "thenStatement" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor THEN_STATEMENT_PROPERTY =
> 		new ChildPropertyDescriptor(IfStatement.class, "thenStatement", Statement.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "elseStatement" structural property of this node type.
>+	 * The "elseStatement" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor ELSE_STATEMENT_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/ImportDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ImportDeclaration.java,v
>retrieving revision 1.32
>diff -u -r1.32 ImportDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/ImportDeclaration.java	27 Jun 2008 16:03:45 -0000	1.32
>+++ dom/org/eclipse/jdt/core/dom/ImportDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -33,21 +33,21 @@
> public class ImportDeclaration extends ASTNode {
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(ImportDeclaration.class, "name", Name.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "onDemand" structural property of this node type.
>+	 * The "onDemand" structural property of this node type (type: {@link Boolean}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor ON_DEMAND_PROPERTY =
> 		new SimplePropertyDescriptor(ImportDeclaration.class, "onDemand", boolean.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "static" structural property of this node type (added in JLS3 API).
>+	 * The "static" structural property of this node type (type: {@link Boolean}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final SimplePropertyDescriptor STATIC_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/InfixExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/InfixExpression.java,v
>retrieving revision 1.33
>diff -u -r1.33 InfixExpression.java
>--- dom/org/eclipse/jdt/core/dom/InfixExpression.java	27 Jun 2008 16:03:46 -0000	1.33
>+++ dom/org/eclipse/jdt/core/dom/InfixExpression.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -174,28 +174,28 @@
> 	}
> 
> 	/**
>-	 * The "leftOperand" structural property of this node type.
>+	 * The "leftOperand" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LEFT_OPERAND_PROPERTY =
> 		new ChildPropertyDescriptor(InfixExpression.class, "leftOperand", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "operator" structural property of this node type.
>+	 * The "operator" structural property of this node type (type: {@link InfixExpression.Operator}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor OPERATOR_PROPERTY =
> 		new SimplePropertyDescriptor(InfixExpression.class, "operator", InfixExpression.Operator.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "rightOperand" structural property of this node type.
>+	 * The "rightOperand" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor RIGHT_OPERAND_PROPERTY =
> 		new ChildPropertyDescriptor(InfixExpression.class, "rightOperand", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "extendedOperands" structural property of this node type.
>+	 * The "extendedOperands" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor EXTENDED_OPERANDS_PROPERTY =
>@@ -252,7 +252,7 @@
> 
> 	/**
> 	 * The list of extended operand expressions (element type:
>-	 * <code>Expression</code>). Lazily initialized; defaults to an empty list.
>+	 * {@link Expression}). Lazily initialized; defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList extendedOperands = null;
> 
>@@ -507,7 +507,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of extended operands
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List extendedOperands() {
> 		if (this.extendedOperands == null) {
>Index: dom/org/eclipse/jdt/core/dom/Initializer.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Initializer.java,v
>retrieving revision 1.35
>diff -u -r1.35 Initializer.java
>--- dom/org/eclipse/jdt/core/dom/Initializer.java	27 Jun 2008 16:03:46 -0000	1.35
>+++ dom/org/eclipse/jdt/core/dom/Initializer.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -48,7 +48,7 @@
> 		internalModifiers2PropertyFactory(Initializer.class);
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/InstanceofExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/InstanceofExpression.java,v
>retrieving revision 1.26
>diff -u -r1.26 InstanceofExpression.java
>--- dom/org/eclipse/jdt/core/dom/InstanceofExpression.java	27 Jun 2008 16:03:47 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/InstanceofExpression.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -27,14 +27,14 @@
> public class InstanceofExpression extends Expression {
> 
> 	/**
>-	 * The "leftOperand" structural property of this node type.
>+	 * The "leftOperand" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LEFT_OPERAND_PROPERTY =
> 		new ChildPropertyDescriptor(InstanceofExpression.class, "leftOperand", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "rightOperand" structural property of this node type.
>+	 * The "rightOperand" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor RIGHT_OPERAND_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/Javadoc.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Javadoc.java,v
>retrieving revision 1.37
>diff -u -r1.37 Javadoc.java
>--- dom/org/eclipse/jdt/core/dom/Javadoc.java	27 Jun 2008 16:03:47 -0000	1.37
>+++ dom/org/eclipse/jdt/core/dom/Javadoc.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -31,7 +31,7 @@
> public class Javadoc extends Comment {
> 
> 	/**
>-	 * The "comment" structural property of this node type (JLS2 API only).
>+	 * The "comment" structural property of this node type (type: {@link String}) (JLS2 API only).
> 	 * @since 3.0
> 	 * @deprecated Replaced by {@link #TAGS_PROPERTY} in the JLS3 API.
> 	 */
>@@ -39,7 +39,7 @@
> 		new SimplePropertyDescriptor(Javadoc.class, "comment", String.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "tags" structural property of this node type.
>+	 * The "tags" structural property of this node type (element type: {@link TagElement}).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TAGS_PROPERTY =
>@@ -109,7 +109,7 @@
> 	private String comment = MINIMAL_DOC_COMMENT;
> 
> 	/**
>-	 * The list of tag elements (element type: <code>TagElement</code>).
>+	 * The list of tag elements (element type: {@link TagElement}).
> 	 * Defaults to an empty list.
> 	 * @since 3.0
> 	 */
>@@ -292,7 +292,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of tag elements in this doc comment
>-	 * (element type: <code>TagElement</code>)
>+	 * (element type: {@link TagElement})
> 	 * @since 3.0
> 	 */
> 	public List tags() {
>Index: dom/org/eclipse/jdt/core/dom/LabeledStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/LabeledStatement.java,v
>retrieving revision 1.28
>diff -u -r1.28 LabeledStatement.java
>--- dom/org/eclipse/jdt/core/dom/LabeledStatement.java	27 Jun 2008 16:03:46 -0000	1.28
>+++ dom/org/eclipse/jdt/core/dom/LabeledStatement.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class LabeledStatement extends Statement {
> 
> 	/**
>-	 * The "label" structural property of this node type.
>+	 * The "label" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor LABEL_PROPERTY =
> 		new ChildPropertyDescriptor(LabeledStatement.class, "label", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/MemberRef.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MemberRef.java,v
>retrieving revision 1.17
>diff -u -r1.17 MemberRef.java
>--- dom/org/eclipse/jdt/core/dom/MemberRef.java	27 Jun 2008 16:03:45 -0000	1.17
>+++ dom/org/eclipse/jdt/core/dom/MemberRef.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -31,14 +31,14 @@
> public class MemberRef extends ASTNode implements IDocElement {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(MemberRef.class, "qualifier", Name.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/MemberValuePair.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MemberValuePair.java,v
>retrieving revision 1.21
>diff -u -r1.21 MemberValuePair.java
>--- dom/org/eclipse/jdt/core/dom/MemberValuePair.java	27 Jun 2008 16:03:47 -0000	1.21
>+++ dom/org/eclipse/jdt/core/dom/MemberValuePair.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -32,13 +32,13 @@
> public class MemberValuePair extends ASTNode {
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(MemberValuePair.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "value" structural property of this node type.
>+	 * The "value" structural property of this node type (child type: {@link Expression}).
> 	 */
> 	public static final ChildPropertyDescriptor VALUE_PROPERTY =
> 		new ChildPropertyDescriptor(MemberValuePair.class, "value", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
>Index: dom/org/eclipse/jdt/core/dom/MethodDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MethodDeclaration.java,v
>retrieving revision 1.54
>diff -u -r1.54 MethodDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/MethodDeclaration.java	5 Mar 2010 15:07:52 -0000	1.54
>+++ dom/org/eclipse/jdt/core/dom/MethodDeclaration.java	2 Sep 2010 18:40:35 -0000
>@@ -68,7 +68,7 @@
> public class MethodDeclaration extends BodyDeclaration {
> 
> 	/**
>-	 * The "javadoc" structural property of this node type.
>+	 * The "javadoc" structural property of this node type (child type: {@link Javadoc}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor JAVADOC_PROPERTY =
>@@ -89,63 +89,63 @@
> 		internalModifiers2PropertyFactory(MethodDeclaration.class);
> 
> 	/**
>-	 * The "constructor" structural property of this node type.
>+	 * The "constructor" structural property of this node type (type: {@link Boolean}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor CONSTRUCTOR_PROPERTY =
> 		new SimplePropertyDescriptor(MethodDeclaration.class, "constructor", boolean.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(MethodDeclaration.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "returnType" structural property of this node type (JLS2 API only).
>+	 * The "returnType" structural property of this node type (child type: {@link Type}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor RETURN_TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(MethodDeclaration.class, "returnType", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "returnType2" structural property of this node type (added in JLS3 API).
>+	 * The "returnType2" structural property of this node type (child type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildPropertyDescriptor RETURN_TYPE2_PROPERTY =
> 		new ChildPropertyDescriptor(MethodDeclaration.class, "returnType2", Type.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "extraDimensions" structural property of this node type.
>+	 * The "extraDimensions" structural property of this node type (type: {@link Integer}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor EXTRA_DIMENSIONS_PROPERTY =
> 		new SimplePropertyDescriptor(MethodDeclaration.class, "extraDimensions", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeParameters" structural property of this node type (added in JLS3 API).
>+	 * The "typeParameters" structural property of this node type (element type: {@link TypeParameter}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_PARAMETERS_PROPERTY =
> 		new ChildListPropertyDescriptor(MethodDeclaration.class, "typeParameters", TypeParameter.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "parameters" structural property of this node type).
>+	 * The "parameters" structural property of this node type (element type: {@link SingleVariableDeclaration}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor PARAMETERS_PROPERTY =
> 		new ChildListPropertyDescriptor(MethodDeclaration.class, "parameters", SingleVariableDeclaration.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "thrownExceptions" structural property of this node type).
>+	 * The "thrownExceptions" structural property of this node type (element type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor THROWN_EXCEPTIONS_PROPERTY =
> 		new ChildListPropertyDescriptor(MethodDeclaration.class, "thrownExceptions", Name.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>@@ -227,7 +227,7 @@
> 
> 	/**
> 	 * The parameter declarations
>-	 * (element type: <code>SingleVariableDeclaration</code>).
>+	 * (element type: {@link SingleVariableDeclaration}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList parameters =
>@@ -248,7 +248,7 @@
> 	private boolean returnType2Initialized = false;
> 
> 	/**
>-	 * The type paramters (element type: <code>TypeParameter</code>).
>+	 * The type paramters (element type: {@link TypeParameter}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -264,7 +264,7 @@
> 	private int extraArrayDimensions = 0;
> 
> 	/**
>-	 * The list of thrown exception names (element type: <code>Name</code>).
>+	 * The list of thrown exception names (element type: {@link Name}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList thrownExceptions =
>@@ -533,7 +533,7 @@
> 	 * declaration (added in JLS3 API). This list is non-empty for parameterized methods.
> 	 *
> 	 * @return the live list of type parameters
>-	 * (element type: <code>TypeParameter</code>)
>+	 * (element type: {@link TypeParameter})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -594,7 +594,7 @@
> 	 * method declaration.
> 	 *
> 	 * @return the live list of method parameter declarations
>-	 * (element type: <code>SingleVariableDeclaration</code>)
>+	 * (element type: {@link SingleVariableDeclaration})
> 	 */
> 	public List parameters() {
> 		return this.parameters;
>@@ -630,7 +630,7 @@
> 	 * declaration.
> 	 *
> 	 * @return the live list of exception names
>-	 * (element type: <code>Name</code>)
>+	 * (element type: {@link Name})
> 	 */
> 	public List thrownExceptions() {
> 		return this.thrownExceptions;
>Index: dom/org/eclipse/jdt/core/dom/MethodInvocation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MethodInvocation.java,v
>retrieving revision 1.35
>diff -u -r1.35 MethodInvocation.java
>--- dom/org/eclipse/jdt/core/dom/MethodInvocation.java	27 Jun 2008 16:03:46 -0000	1.35
>+++ dom/org/eclipse/jdt/core/dom/MethodInvocation.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -35,28 +35,28 @@
> public class MethodInvocation extends Expression {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(MethodInvocation.class, "expression", Expression.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type (added in JLS3 API).
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(MethodInvocation.class, "typeArguments", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(MethodInvocation.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "arguments" structural property of this node type.
>+	 * The "arguments" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor ARGUMENTS_PROPERTY =
>@@ -120,7 +120,7 @@
> 	private Expression optionalExpression = null;
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -135,7 +135,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -296,7 +296,7 @@
> 	 * invocation (added in JLS3 API).
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -354,7 +354,7 @@
> 	 * invocation expression.
> 	 *
> 	 * @return the live list of argument expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/MethodRef.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MethodRef.java,v
>retrieving revision 1.17
>diff -u -r1.17 MethodRef.java
>--- dom/org/eclipse/jdt/core/dom/MethodRef.java	27 Jun 2008 16:03:45 -0000	1.17
>+++ dom/org/eclipse/jdt/core/dom/MethodRef.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -31,21 +31,21 @@
> public class MethodRef extends ASTNode implements IDocElement {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(MethodRef.class, "qualifier", Name.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(MethodRef.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "parameters" structural property of this node type.
>+	 * The "parameters" structural property of this node type (element type: {@link MethodRefParameter}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor PARAMETERS_PROPERTY =
>@@ -93,7 +93,7 @@
> 
> 	/**
> 	 * The parameter declarations
>-	 * (element type: <code>MethodRefParameter</code>).
>+	 * (element type: {@link MethodRefParameter}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList parameters =
>@@ -275,7 +275,7 @@
> 	 * method reference.
> 	 *
> 	 * @return the live list of method parameter references
>-	 * (element type: <code>MethodRefParameter</code>)
>+	 * (element type: {@link MethodRefParameter})
> 	 */
> 	public List parameters() {
> 		return this.parameters;
>Index: dom/org/eclipse/jdt/core/dom/MethodRefParameter.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/MethodRefParameter.java,v
>retrieving revision 1.17
>diff -u -r1.17 MethodRefParameter.java
>--- dom/org/eclipse/jdt/core/dom/MethodRefParameter.java	27 Jun 2008 16:03:47 -0000	1.17
>+++ dom/org/eclipse/jdt/core/dom/MethodRefParameter.java	2 Sep 2010 18:40:35 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -42,21 +42,21 @@
> public class MethodRefParameter extends ASTNode {
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(MethodRefParameter.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "varargs" structural property of this node type (added in JLS3 API).
>+	 * The "varargs" structural property of this node type (type: {@link Boolean}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final SimplePropertyDescriptor VARARGS_PROPERTY =
> 		new SimplePropertyDescriptor(MethodRefParameter.class, "varargs", boolean.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/Modifier.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/Modifier.java,v
>retrieving revision 1.27
>diff -u -r1.27 Modifier.java
>--- dom/org/eclipse/jdt/core/dom/Modifier.java	27 Jun 2008 16:03:49 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/Modifier.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -210,7 +210,7 @@
> 	public static final int FINAL = 0x0010;
> 
> 	/**
>-	 * The "keyword" structural property of this node type.
>+	 * The "keyword" structural property of this node type (type: {@link Modifier.ModifierKeyword}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor KEYWORD_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/NormalAnnotation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/NormalAnnotation.java,v
>retrieving revision 1.17
>diff -u -r1.17 NormalAnnotation.java
>--- dom/org/eclipse/jdt/core/dom/NormalAnnotation.java	7 Mar 2009 00:59:01 -0000	1.17
>+++ dom/org/eclipse/jdt/core/dom/NormalAnnotation.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2009 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -34,7 +34,7 @@
> 		internalTypeNamePropertyFactory(NormalAnnotation.class);
> 
> 	/**
>-	 * The "values" structural property of this node type.
>+	 * The "values" structural property of this node type (element type: {@link MemberValuePair}).
> 	 */
> 	public static final ChildListPropertyDescriptor VALUES_PROPERTY =
> 		new ChildListPropertyDescriptor(NormalAnnotation.class, "values", MemberValuePair.class, CYCLE_RISK); //$NON-NLS-1$
>@@ -177,7 +177,7 @@
> 	 * type of node will trigger an exception.
> 	 *
> 	 * @return the live list of member value pairs in this
>-	 * annotation (element type: <code>MemberValuePair</code>)
>+	 * annotation (element type: {@link MemberValuePair})
> 	 */
> 	public List values() {
> 		return this.values;
>Index: dom/org/eclipse/jdt/core/dom/NumberLiteral.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/NumberLiteral.java,v
>retrieving revision 1.35
>diff -u -r1.35 NumberLiteral.java
>--- dom/org/eclipse/jdt/core/dom/NumberLiteral.java	27 Jun 2008 16:03:48 -0000	1.35
>+++ dom/org/eclipse/jdt/core/dom/NumberLiteral.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -27,7 +27,7 @@
> public class NumberLiteral extends Expression {
> 
> 	/**
>-	 * The "token" structural property of this node type.
>+	 * The "token" structural property of this node type (type: {@link String}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor TOKEN_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/PackageDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/PackageDeclaration.java,v
>retrieving revision 1.33
>diff -u -r1.33 PackageDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/PackageDeclaration.java	27 Jun 2008 16:03:49 -0000	1.33
>+++ dom/org/eclipse/jdt/core/dom/PackageDeclaration.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -38,21 +38,21 @@
> public class PackageDeclaration extends ASTNode {
> 
> 	/**
>-	 * The "javadoc" structural property of this node type.
>+	 * The "javadoc" structural property of this node type (child type: {@link Javadoc}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor JAVADOC_PROPERTY =
> 		new ChildPropertyDescriptor(PackageDeclaration.class, "javadoc", Javadoc.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "annotations" structural property of this node type (added in JLS3 API).
>+	 * The "annotations" structural property of this node type (element type: {@link Annotation}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor ANNOTATIONS_PROPERTY =
> 		new ChildListPropertyDescriptor(PackageDeclaration.class, "annotations", Annotation.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>@@ -115,7 +115,7 @@
> 	Javadoc optionalDocComment = null;
> 
> 	/**
>-	 * The annotations (element type: <code>Annotation</code>).
>+	 * The annotations (element type: {@link Annotation}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -238,7 +238,7 @@
> 	 * package declaration (added in JLS3 API).
> 	 *
> 	 * @return the live list of annotations
>-	 * (element type: <code>Annotation</code>)
>+	 * (element type: {@link Annotation})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>Index: dom/org/eclipse/jdt/core/dom/ParameterizedType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ParameterizedType.java,v
>retrieving revision 1.26
>diff -u -r1.26 ParameterizedType.java
>--- dom/org/eclipse/jdt/core/dom/ParameterizedType.java	27 Jun 2008 16:03:47 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/ParameterizedType.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2003, 2008 IBM Corporation and others.
>+ * Copyright (c) 2003, 2010 IBM Corporation and others.
> * 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
>@@ -35,13 +35,13 @@
> int index;
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(ParameterizedType.class, "type", Type.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type.
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}).
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(ParameterizedType.class, "typeArguments", Type.class, CYCLE_RISK); //$NON-NLS-1$
>@@ -82,7 +82,7 @@
> 	private Type type = null;
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList typeArguments =
>@@ -222,7 +222,7 @@
> 	 * at least one element and not contain primitive types.
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 */
> 	public List typeArguments() {
> 		return this.typeArguments;
>Index: dom/org/eclipse/jdt/core/dom/ParenthesizedExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ParenthesizedExpression.java,v
>retrieving revision 1.27
>diff -u -r1.27 ParenthesizedExpression.java
>--- dom/org/eclipse/jdt/core/dom/ParenthesizedExpression.java	27 Jun 2008 16:03:46 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/ParenthesizedExpression.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class ParenthesizedExpression extends Expression {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/PostfixExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/PostfixExpression.java,v
>retrieving revision 1.28
>diff -u -r1.28 PostfixExpression.java
>--- dom/org/eclipse/jdt/core/dom/PostfixExpression.java	27 Jun 2008 16:03:49 -0000	1.28
>+++ dom/org/eclipse/jdt/core/dom/PostfixExpression.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -105,14 +105,14 @@
> 	}
> 
> 	/**
>-	 * The "operator" structural property of this node type.
>+	 * The "operator" structural property of this node type (type: {@link PostfixExpression.Operator}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor OPERATOR_PROPERTY =
> 		new SimplePropertyDescriptor(PostfixExpression.class, "operator", PostfixExpression.Operator.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "operand" structural property of this node type.
>+	 * The "operand" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor OPERAND_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/PrefixExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/PrefixExpression.java,v
>retrieving revision 1.29
>diff -u -r1.29 PrefixExpression.java
>--- dom/org/eclipse/jdt/core/dom/PrefixExpression.java	27 Jun 2008 16:03:46 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/PrefixExpression.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -121,14 +121,14 @@
> 	}
> 
> 	/**
>-	 * The "operator" structural property of this node type.
>+	 * The "operator" structural property of this node type (type: {@link PrefixExpression.Operator}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor OPERATOR_PROPERTY =
> 		new SimplePropertyDescriptor(PrefixExpression.class, "operator", PrefixExpression.Operator.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "operand" structural property of this node type.
>+	 * The "operand" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor OPERAND_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/PrimitiveType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/PrimitiveType.java,v
>retrieving revision 1.27
>diff -u -r1.27 PrimitiveType.java
>--- dom/org/eclipse/jdt/core/dom/PrimitiveType.java	27 Jun 2008 16:03:48 -0000	1.27
>+++ dom/org/eclipse/jdt/core/dom/PrimitiveType.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -155,7 +155,7 @@
> 	}
> 
> 	/**
>-	 * The "primitiveTypeCode" structural property of this node type.
>+	 * The "primitiveTypeCode" structural property of this node type (type: {@link PrimitiveType.Code}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor PRIMITIVE_TYPE_CODE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/QualifiedName.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/QualifiedName.java,v
>retrieving revision 1.39
>diff -u -r1.39 QualifiedName.java
>--- dom/org/eclipse/jdt/core/dom/QualifiedName.java	27 Jun 2008 16:03:46 -0000	1.39
>+++ dom/org/eclipse/jdt/core/dom/QualifiedName.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -35,14 +35,14 @@
> public class QualifiedName extends Name {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(QualifiedName.class, "qualifier", Name.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/QualifiedType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/QualifiedType.java,v
>retrieving revision 1.23
>diff -u -r1.23 QualifiedType.java
>--- dom/org/eclipse/jdt/core/dom/QualifiedType.java	27 Jun 2008 16:03:46 -0000	1.23
>+++ dom/org/eclipse/jdt/core/dom/QualifiedType.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2003, 2008 IBM Corporation and others.
>+ * Copyright (c) 2003, 2010 IBM Corporation and others.
> * 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
>@@ -51,13 +51,13 @@
> int index;
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Type}).
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(QualifiedType.class, "qualifier", Type.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(QualifiedType.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
>Index: dom/org/eclipse/jdt/core/dom/ReturnStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ReturnStatement.java,v
>retrieving revision 1.26
>diff -u -r1.26 ReturnStatement.java
>--- dom/org/eclipse/jdt/core/dom/ReturnStatement.java	27 Jun 2008 16:03:49 -0000	1.26
>+++ dom/org/eclipse/jdt/core/dom/ReturnStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class ReturnStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/SimpleName.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SimpleName.java,v
>retrieving revision 1.46
>diff -u -r1.46 SimpleName.java
>--- dom/org/eclipse/jdt/core/dom/SimpleName.java	27 Jun 2008 16:03:46 -0000	1.46
>+++ dom/org/eclipse/jdt/core/dom/SimpleName.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -32,7 +32,7 @@
> public class SimpleName extends Name {
> 
> 	/**
>-	 * The "identifier" structural property of this node type.
>+	 * The "identifier" structural property of this node type (type: {@link String}).
> 	 *
> 	 * @since 3.0
> 	 */
>Index: dom/org/eclipse/jdt/core/dom/SimpleType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SimpleType.java,v
>retrieving revision 1.32
>diff -u -r1.32 SimpleType.java
>--- dom/org/eclipse/jdt/core/dom/SimpleType.java	27 Jun 2008 16:03:49 -0000	1.32
>+++ dom/org/eclipse/jdt/core/dom/SimpleType.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -27,7 +27,7 @@
> public class SimpleType extends Type {
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/SingleMemberAnnotation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SingleMemberAnnotation.java,v
>retrieving revision 1.19
>diff -u -r1.19 SingleMemberAnnotation.java
>--- dom/org/eclipse/jdt/core/dom/SingleMemberAnnotation.java	27 Jun 2008 16:03:47 -0000	1.19
>+++ dom/org/eclipse/jdt/core/dom/SingleMemberAnnotation.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -37,7 +37,7 @@
> 		internalTypeNamePropertyFactory(SingleMemberAnnotation.class);
> 
> 	/**
>-	 * The "value" structural property of this node type.
>+	 * The "value" structural property of this node type (child type: {@link Expression}).
> 	 */
> 	public static final ChildPropertyDescriptor VALUE_PROPERTY =
> 		new ChildPropertyDescriptor(SingleMemberAnnotation.class, "value", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
>Index: dom/org/eclipse/jdt/core/dom/SingleVariableDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SingleVariableDeclaration.java,v
>retrieving revision 1.46
>diff -u -r1.46 SingleVariableDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/SingleVariableDeclaration.java	27 Jun 2008 16:03:49 -0000	1.46
>+++ dom/org/eclipse/jdt/core/dom/SingleVariableDeclaration.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -39,49 +39,49 @@
> public class SingleVariableDeclaration extends VariableDeclaration {
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (JLS2 API only).
>+	 * The "modifiers" structural property of this node type (type: {@link Integer}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor MODIFIERS_PROPERTY =
> 		new SimplePropertyDescriptor(SingleVariableDeclaration.class, "modifiers", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (added in JLS3 API).
>+	 * The "modifiers" structural property of this node type (element type: {@link IExtendedModifier}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor MODIFIERS2_PROPERTY =
> 		new ChildListPropertyDescriptor(SingleVariableDeclaration.class, "modifiers", IExtendedModifier.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(SingleVariableDeclaration.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(SingleVariableDeclaration.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "varargs" structural property of this node type (added in JLS3 API).
>+	 * The "varargs" structural property of this node type (type: {@link Boolean}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final SimplePropertyDescriptor VARARGS_PROPERTY =
> 		new SimplePropertyDescriptor(SingleVariableDeclaration.class, "varargs", boolean.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "extraDimensions" structural property of this node type.
>+	 * The "extraDimensions" structural property of this node type (type: {@link Integer}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor EXTRA_DIMENSIONS_PROPERTY =
> 		new SimplePropertyDescriptor(SingleVariableDeclaration.class, "extraDimensions", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "initializer" structural property of this node type.
>+	 * The "initializer" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor INITIALIZER_PROPERTY =
>@@ -143,7 +143,7 @@
> 	}
> 
> 	/**
>-	 * The extended modifiers (element type: <code>IExtendedModifier</code>).
>+	 * The extended modifiers (element type: {@link IExtendedModifier}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 *
>@@ -384,7 +384,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of modifiers and annotations
>-	 * (element type: <code>IExtendedModifier</code>)
>+	 * (element type: {@link IExtendedModifier})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>Index: dom/org/eclipse/jdt/core/dom/StringLiteral.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/StringLiteral.java,v
>retrieving revision 1.42
>diff -u -r1.42 StringLiteral.java
>--- dom/org/eclipse/jdt/core/dom/StringLiteral.java	15 Jul 2010 14:52:30 -0000	1.42
>+++ dom/org/eclipse/jdt/core/dom/StringLiteral.java	2 Sep 2010 18:40:36 -0000
>@@ -27,7 +27,7 @@
> public class StringLiteral extends Expression {
> 
> 	/**
>-	 * The "escapedValue" structural property of this node type.
>+	 * The "escapedValue" structural property of this node type (type: {@link String}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor ESCAPED_VALUE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/SuperConstructorInvocation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SuperConstructorInvocation.java,v
>retrieving revision 1.30
>diff -u -r1.30 SuperConstructorInvocation.java
>--- dom/org/eclipse/jdt/core/dom/SuperConstructorInvocation.java	27 Jun 2008 16:03:48 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/SuperConstructorInvocation.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -35,14 +35,14 @@
> public class SuperConstructorInvocation extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(SuperConstructorInvocation.class, "expression", Expression.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type (added in JLS3 API).
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
>@@ -111,7 +111,7 @@
> 	private Expression optionalExpression = null;
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -120,7 +120,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -258,7 +258,7 @@
> 	 * invocation (added in JLS3 API).
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -276,7 +276,7 @@
> 	 * constructor invocation statement.
> 	 *
> 	 * @return the live list of argument expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/SuperFieldAccess.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SuperFieldAccess.java,v
>retrieving revision 1.30
>diff -u -r1.30 SuperFieldAccess.java
>--- dom/org/eclipse/jdt/core/dom/SuperFieldAccess.java	27 Jun 2008 16:03:49 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/SuperFieldAccess.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -34,14 +34,14 @@
> public class SuperFieldAccess extends Expression {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(SuperFieldAccess.class, "qualifier", Name.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/SuperMethodInvocation.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SuperMethodInvocation.java,v
>retrieving revision 1.34
>diff -u -r1.34 SuperMethodInvocation.java
>--- dom/org/eclipse/jdt/core/dom/SuperMethodInvocation.java	27 Jun 2008 16:03:47 -0000	1.34
>+++ dom/org/eclipse/jdt/core/dom/SuperMethodInvocation.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -36,28 +36,28 @@
> public class SuperMethodInvocation extends Expression {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
> 		new ChildPropertyDescriptor(SuperMethodInvocation.class, "qualifier", Name.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeArguments" structural property of this node type (added in JLS3 API).
>+	 * The "typeArguments" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_ARGUMENTS_PROPERTY =
> 		new ChildListPropertyDescriptor(SuperMethodInvocation.class, "typeArguments", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(SuperMethodInvocation.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "arguments" structural property of this node type.
>+	 * The "arguments" structural property of this node type (element type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor ARGUMENTS_PROPERTY =
>@@ -121,7 +121,7 @@
> 	private Name optionalQualifier = null;
> 
> 	/**
>-	 * The type arguments (element type: <code>Type</code>).
>+	 * The type arguments (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -136,7 +136,7 @@
> 
> 	/**
> 	 * The list of argument expressions (element type:
>-	 * <code>Expression</code>). Defaults to an empty list.
>+	 * {@link Expression}). Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList arguments =
> 		new ASTNode.NodeList(ARGUMENTS_PROPERTY);
>@@ -294,7 +294,7 @@
> 	 * invocation (added in JLS3 API).
> 	 *
> 	 * @return the live list of type arguments
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -352,7 +352,7 @@
> 	 * "super" method invocation expression.
> 	 *
> 	 * @return the live list of argument expressions
>-	 * (element type: <code>Expression</code>)
>+	 * (element type: {@link Expression})
> 	 */
> 	public List arguments() {
> 		return this.arguments;
>Index: dom/org/eclipse/jdt/core/dom/SwitchCase.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SwitchCase.java,v
>retrieving revision 1.31
>diff -u -r1.31 SwitchCase.java
>--- dom/org/eclipse/jdt/core/dom/SwitchCase.java	27 Jun 2008 16:03:47 -0000	1.31
>+++ dom/org/eclipse/jdt/core/dom/SwitchCase.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -31,7 +31,7 @@
> public class SwitchCase extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/SwitchStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SwitchStatement.java,v
>retrieving revision 1.30
>diff -u -r1.30 SwitchStatement.java
>--- dom/org/eclipse/jdt/core/dom/SwitchStatement.java	27 Jun 2008 16:03:47 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/SwitchStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -35,14 +35,14 @@
> public class SwitchStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(SwitchStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "statements" structural property of this node type.
>+	 * The "statements" structural property of this node type (element type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor STATEMENTS_PROPERTY =
>@@ -85,7 +85,7 @@
> 
> 	/**
> 	 * The statements and SwitchCase nodes
>-	 * (element type: <code>Statement</code>).
>+	 * (element type: {@link Statement}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList statements =
>@@ -225,7 +225,7 @@
> 	 * the switch groups.
> 	 *
> 	 * @return the live list of statement nodes
>-	 * (element type: <code>Statement</code>)
>+	 * (element type: {@link Statement})
> 	 */
> 	public List statements() {
> 		return this.statements;
>Index: dom/org/eclipse/jdt/core/dom/SynchronizedStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/SynchronizedStatement.java,v
>retrieving revision 1.29
>diff -u -r1.29 SynchronizedStatement.java
>--- dom/org/eclipse/jdt/core/dom/SynchronizedStatement.java	27 Jun 2008 16:03:45 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/SynchronizedStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class SynchronizedStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(SynchronizedStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/TagElement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TagElement.java,v
>retrieving revision 1.22
>diff -u -r1.22 TagElement.java
>--- dom/org/eclipse/jdt/core/dom/TagElement.java	27 Jun 2008 16:03:46 -0000	1.22
>+++ dom/org/eclipse/jdt/core/dom/TagElement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -36,7 +36,7 @@
> public final class TagElement extends ASTNode implements IDocElement {
> 
> 	/**
>-	 * The "tagName" structural property of this node type.
>+	 * The "tagName" structural property of this node type (type: {@link String}).
> 	 *
> 	 * @since 3.0
> 	 */
>@@ -44,7 +44,7 @@
> 		new SimplePropertyDescriptor(TagElement.class, "tagName", String.class, OPTIONAL); //$NON-NLS-1$
> 
> 	/**
>-	 * The "fragments" structural property of this node type.
>+	 * The "fragments" structural property of this node type (element type: {@link IDocElement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor FRAGMENTS_PROPERTY =
>@@ -189,7 +189,7 @@
> 	private String optionalTagName = null;
> 
> 	/**
>-	 * The list of doc elements (element type: <code>IDocElement</code>).
>+	 * The list of doc elements (element type: {@link IDocElement}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList fragments =
>@@ -356,7 +356,7 @@
> 	 * of node will trigger an exception.
> 	 *
> 	 * @return the live list of doc elements in this tag element
>-	 * (element type: <code>ASTNode</code>)
>+	 * (element type: {@link ASTNode})
> 	 */
> 	public List fragments() {
> 		return this.fragments;
>Index: dom/org/eclipse/jdt/core/dom/TextElement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TextElement.java,v
>retrieving revision 1.18
>diff -u -r1.18 TextElement.java
>--- dom/org/eclipse/jdt/core/dom/TextElement.java	27 Jun 2008 16:03:46 -0000	1.18
>+++ dom/org/eclipse/jdt/core/dom/TextElement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2004, 2008 IBM Corporation and others.
>+ * Copyright (c) 2004, 2010 IBM Corporation and others.
> * 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
>@@ -30,7 +30,7 @@
> public final class TextElement extends ASTNode implements IDocElement {
> 
> 	/**
>-	 * The "text" structural property of this node type.
>+	 * The "text" structural property of this node type (type: {@link String}).
> 	 *
> 	 * @since 3.0
> 	 */
>Index: dom/org/eclipse/jdt/core/dom/ThisExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ThisExpression.java,v
>retrieving revision 1.28
>diff -u -r1.28 ThisExpression.java
>--- dom/org/eclipse/jdt/core/dom/ThisExpression.java	27 Jun 2008 16:03:49 -0000	1.28
>+++ dom/org/eclipse/jdt/core/dom/ThisExpression.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -33,7 +33,7 @@
> public class ThisExpression extends Expression {
> 
> 	/**
>-	 * The "qualifier" structural property of this node type.
>+	 * The "qualifier" structural property of this node type (child type: {@link Name}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor QUALIFIER_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/ThrowStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/ThrowStatement.java,v
>retrieving revision 1.29
>diff -u -r1.29 ThrowStatement.java
>--- dom/org/eclipse/jdt/core/dom/ThrowStatement.java	27 Jun 2008 16:03:49 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/ThrowStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class ThrowStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/TryStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TryStatement.java,v
>retrieving revision 1.29
>diff -u -r1.29 TryStatement.java
>--- dom/org/eclipse/jdt/core/dom/TryStatement.java	27 Jun 2008 16:03:48 -0000	1.29
>+++ dom/org/eclipse/jdt/core/dom/TryStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -30,21 +30,21 @@
> public class TryStatement extends Statement {
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
> 		new ChildPropertyDescriptor(TryStatement.class, "body", Block.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "catchClauses" structural property of this node type.
>+	 * The "catchClauses" structural property of this node type (element type: {@link CatchClause}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor CATCH_CLAUSES_PROPERTY =
> 		new ChildListPropertyDescriptor(TryStatement.class, "catchClauses", CatchClause.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "finally" structural property of this node type.
>+	 * The "finally" structural property of this node type (child type: {@link Block}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor FINALLY_PROPERTY =
>@@ -86,7 +86,7 @@
> 	private Block body = null;
> 
> 	/**
>-	 * The catch clauses (element type: <code>CatchClause</code>).
>+	 * The catch clauses (element type: {@link CatchClause}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList catchClauses =
>@@ -243,7 +243,7 @@
> 	 * Returns the live ordered list of catch clauses for this try statement.
> 	 *
> 	 * @return the live list of catch clauses
>-	 * (element type: <code>CatchClause</code>)
>+	 * (element type: {@link CatchClause})
> 	 */
> 	public List catchClauses() {
> 		return this.catchClauses;
>Index: dom/org/eclipse/jdt/core/dom/TypeDeclaration.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TypeDeclaration.java,v
>retrieving revision 1.49
>diff -u -r1.49 TypeDeclaration.java
>--- dom/org/eclipse/jdt/core/dom/TypeDeclaration.java	27 Jun 2008 16:03:47 -0000	1.49
>+++ dom/org/eclipse/jdt/core/dom/TypeDeclaration.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -90,7 +90,7 @@
> 		internalModifiers2PropertyFactory(TypeDeclaration.class);
> 
> 	/**
>-	 * The "interface" structural property of this node type.
>+	 * The "interface" structural property of this node type (type: {@link Boolean}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor INTERFACE_PROPERTY =
>@@ -104,35 +104,35 @@
> 		internalNamePropertyFactory(TypeDeclaration.class);
> 
> 	/**
>-	 * The "superclass" structural property of this node type (JLS2 API only).
>+	 * The "superclass" structural property of this node type (child type: {@link Name}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor SUPERCLASS_PROPERTY =
> 		new ChildPropertyDescriptor(TypeDeclaration.class, "superclass", Name.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "superInterfaces" structural property of this node type (JLS2 API only).
>+	 * The "superInterfaces" structural property of this node type (element type: {@link Name}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor SUPER_INTERFACES_PROPERTY =
> 		new ChildListPropertyDescriptor(TypeDeclaration.class, "superInterfaces", Name.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "superclassType" structural property of this node type (added in JLS3 API).
>+	 * The "superclassType" structural property of this node type (child type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildPropertyDescriptor SUPERCLASS_TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(TypeDeclaration.class, "superclassType", Type.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "superInterfaceTypes" structural property of this node type (added in JLS3 API).
>+	 * The "superInterfaceTypes" structural property of this node type (element type: {@link Type}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor SUPER_INTERFACE_TYPES_PROPERTY =
> 		new ChildListPropertyDescriptor(TypeDeclaration.class, "superInterfaceTypes", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeParameters" structural property of this node type (added in JLS3 API).
>+	 * The "typeParameters" structural property of this node type (element type: {@link TypeParameter}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_PARAMETERS_PROPERTY =
>@@ -212,7 +212,7 @@
> 	private boolean isInterface = false;
> 
> 	/**
>-	 * The type paramters (element type: <code>TypeParameter</code>).
>+	 * The type paramters (element type: {@link TypeParameter}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -227,7 +227,7 @@
> 	private Name optionalSuperclassName = null;
> 
> 	/**
>-	 * The superinterface names (element type: <code>Name</code>).
>+	 * The superinterface names (element type: {@link Name}).
> 	 * JLS2 only; defaults to an empty list. Not used in JLS3.
> 	 * (see constructor).
> 	 *
>@@ -243,7 +243,7 @@
> 	private Type optionalSuperclassType = null;
> 
> 	/**
>-	 * The superinterface types (element type: <code>Type</code>).
>+	 * The superinterface types (element type: {@link Type}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -517,7 +517,7 @@
> 	 * declaration (added in JLS3 API). This list is non-empty for parameterized types.
> 	 *
> 	 * @return the live list of type parameters
>-	 * (element type: <code>TypeParameter</code>)
>+	 * (element type: {@link TypeParameter})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -655,7 +655,7 @@
> 	 * extends.
> 	 *
> 	 * @return the live list of interface names
>-	 * (element type: <code>Name</code>)
>+	 * (element type: {@link Name})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * an AST later than JLS2
> 	 * @deprecated In the JLS3 API, this method is replaced by
>@@ -685,7 +685,7 @@
> 	 * these are the interfaces that this interface extends.
> 	 *
> 	 * @return the live list of interface types
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>Index: dom/org/eclipse/jdt/core/dom/TypeDeclarationStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TypeDeclarationStatement.java,v
>retrieving revision 1.36
>diff -u -r1.36 TypeDeclarationStatement.java
>--- dom/org/eclipse/jdt/core/dom/TypeDeclarationStatement.java	27 Jun 2008 16:03:45 -0000	1.36
>+++ dom/org/eclipse/jdt/core/dom/TypeDeclarationStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -41,14 +41,14 @@
> public class TypeDeclarationStatement extends Statement {
> 
> 	/**
>-	 * The "typeDeclaration" structural property of this node type (JLS2 API only).
>+	 * The "typeDeclaration" structural property of this node type (child type: {@link TypeDeclaration}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_DECLARATION_PROPERTY =
> 		new ChildPropertyDescriptor(TypeDeclarationStatement.class, "typeDeclaration", TypeDeclaration.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "declaration" structural property of this node type (added in JLS3 API).
>+	 * The "declaration" structural property of this node type (child type: {@link AbstractTypeDeclaration}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildPropertyDescriptor DECLARATION_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/TypeLiteral.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TypeLiteral.java,v
>retrieving revision 1.28
>diff -u -r1.28 TypeLiteral.java
>--- dom/org/eclipse/jdt/core/dom/TypeLiteral.java	27 Jun 2008 16:03:45 -0000	1.28
>+++ dom/org/eclipse/jdt/core/dom/TypeLiteral.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,7 +28,7 @@
> public class TypeLiteral extends Expression {
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/TypeParameter.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/TypeParameter.java,v
>retrieving revision 1.24
>diff -u -r1.24 TypeParameter.java
>--- dom/org/eclipse/jdt/core/dom/TypeParameter.java	27 Jun 2008 16:03:46 -0000	1.24
>+++ dom/org/eclipse/jdt/core/dom/TypeParameter.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2003, 2008 IBM Corporation and others.
>+ * Copyright (c) 2003, 2010 IBM Corporation and others.
> * 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
>@@ -27,13 +27,13 @@
> public class TypeParameter extends ASTNode {
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(TypeParameter.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "typeBounds" structural property of this node type.
>+	 * The "typeBounds" structural property of this node type (element type: {@link Type}).
> 	 */
> 	public static final ChildListPropertyDescriptor TYPE_BOUNDS_PROPERTY =
> 		new ChildListPropertyDescriptor(TypeParameter.class, "typeBounds", Type.class, NO_CYCLE_RISK); //$NON-NLS-1$
>@@ -74,7 +74,7 @@
> 	private SimpleName typeVariableName = null;
> 
> 	/**
>-	 * The type bounds (element type: <code>Type</code>).
>+	 * The type bounds (element type: {@link Type}).
> 	 * Defaults to an empty list.
> 	 */
> 	private ASTNode.NodeList typeBounds =
>@@ -231,7 +231,7 @@
> 	 * and parameterized types are allowed).
> 	 *
> 	 * @return the live list of type bounds
>-	 * (element type: <code>Type</code>)
>+	 * (element type: {@link Type})
> 	 */
> 	public List typeBounds() {
> 		return this.typeBounds;
>Index: dom/org/eclipse/jdt/core/dom/VariableDeclarationExpression.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/VariableDeclarationExpression.java,v
>retrieving revision 1.39
>diff -u -r1.39 VariableDeclarationExpression.java
>--- dom/org/eclipse/jdt/core/dom/VariableDeclarationExpression.java	7 Mar 2009 00:59:00 -0000	1.39
>+++ dom/org/eclipse/jdt/core/dom/VariableDeclarationExpression.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -45,28 +45,28 @@
> public class VariableDeclarationExpression extends Expression {
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (JLS2 API only).
>+	 * The "modifiers" structural property of this node type (type: {@link Integer}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor MODIFIERS_PROPERTY =
> 		new SimplePropertyDescriptor(VariableDeclarationExpression.class, "modifiers", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (added in JLS3 API).
>+	 * The "modifiers" structural property of this node type (element type: {@link IExtendedModifier}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor MODIFIERS2_PROPERTY =
> 		new ChildListPropertyDescriptor(VariableDeclarationExpression.class, "modifiers", IExtendedModifier.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(VariableDeclarationExpression.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "fragments" structural property of this node type).
>+	 * The "fragments" structural property of this node type (element type: {@link VariableDeclarationFragment}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor FRAGMENTS_PROPERTY =
>@@ -124,7 +124,7 @@
> 	}
> 
> 	/**
>-	 * The extended modifiers (element type: <code>IExtendedModifier</code>).
>+	 * The extended modifiers (element type: {@link IExtendedModifier}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.0
>@@ -281,7 +281,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of modifiers and annotations
>-	 * (element type: <code>IExtendedModifier</code>)
>+	 * (element type: {@link IExtendedModifier})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -407,7 +407,7 @@
> 	 * type of node will trigger an exception.
> 	 *
> 	 * @return the live list of variable declaration fragments in this
>-	 * expression (element type: <code>VariableDeclarationFragment</code>)
>+	 * expression (element type: {@link VariableDeclarationFragment})
> 	 */
> 	public List fragments() {
> 		return this.variableDeclarationFragments;
>Index: dom/org/eclipse/jdt/core/dom/VariableDeclarationFragment.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/VariableDeclarationFragment.java,v
>retrieving revision 1.32
>diff -u -r1.32 VariableDeclarationFragment.java
>--- dom/org/eclipse/jdt/core/dom/VariableDeclarationFragment.java	27 Jun 2008 16:03:46 -0000	1.32
>+++ dom/org/eclipse/jdt/core/dom/VariableDeclarationFragment.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -32,21 +32,21 @@
> public class VariableDeclarationFragment extends VariableDeclaration {
> 
> 	/**
>-	 * The "name" structural property of this node type.
>+	 * The "name" structural property of this node type (child type: {@link SimpleName}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor NAME_PROPERTY =
> 		new ChildPropertyDescriptor(VariableDeclarationFragment.class, "name", SimpleName.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "extraDimensions" structural property of this node type.
>+	 * The "extraDimensions" structural property of this node type (type: {@link Integer}).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor EXTRA_DIMENSIONS_PROPERTY =
> 		new SimplePropertyDescriptor(VariableDeclarationFragment.class, "extraDimensions", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "initializer" structural property of this node type.
>+	 * The "initializer" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor INITIALIZER_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/VariableDeclarationStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/VariableDeclarationStatement.java,v
>retrieving revision 1.41
>diff -u -r1.41 VariableDeclarationStatement.java
>--- dom/org/eclipse/jdt/core/dom/VariableDeclarationStatement.java	7 Mar 2009 00:59:01 -0000	1.41
>+++ dom/org/eclipse/jdt/core/dom/VariableDeclarationStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2009 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -48,28 +48,28 @@
> public class VariableDeclarationStatement extends Statement {
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (JLS2 API only).
>+	 * The "modifiers" structural property of this node type (type: {@link Integer}) (JLS2 API only).
> 	 * @since 3.0
> 	 */
> 	public static final SimplePropertyDescriptor MODIFIERS_PROPERTY =
> 		new SimplePropertyDescriptor(VariableDeclarationStatement.class, "modifiers", int.class, MANDATORY); //$NON-NLS-1$
> 
> 	/**
>-	 * The "modifiers" structural property of this node type (added in JLS3 API).
>+	 * The "modifiers" structural property of this node type (element type: {@link IExtendedModifier}) (added in JLS3 API).
> 	 * @since 3.1
> 	 */
> 	public static final ChildListPropertyDescriptor MODIFIERS2_PROPERTY =
> 		new ChildListPropertyDescriptor(VariableDeclarationStatement.class, "modifiers", IExtendedModifier.class, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "type" structural property of this node type.
>+	 * The "type" structural property of this node type (child type: {@link Type}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor TYPE_PROPERTY =
> 		new ChildPropertyDescriptor(VariableDeclarationStatement.class, "type", Type.class, MANDATORY, NO_CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "fragments" structural property of this node type).
>+	 * The "fragments" structural property of this node type (element type: {@link VariableDeclarationFragment}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildListPropertyDescriptor FRAGMENTS_PROPERTY =
>@@ -127,7 +127,7 @@
> 	}
> 
> 	/**
>-	 * The extended modifiers (element type: <code>IExtendedModifier</code>).
>+	 * The extended modifiers (element type: {@link IExtendedModifier}).
> 	 * Null in JLS2. Added in JLS3; defaults to an empty list
> 	 * (see constructor).
> 	 * @since 3.1
>@@ -284,7 +284,7 @@
> 	 * 
> 	 *
> 	 * @return the live list of modifiers and annotations
>-	 * (element type: <code>IExtendedModifier</code>)
>+	 * (element type: {@link IExtendedModifier})
> 	 * @exception UnsupportedOperationException if this operation is used in
> 	 * a JLS2 AST
> 	 * @since 3.1
>@@ -410,7 +410,7 @@
> 	 * exception.
> 	 *
> 	 * @return the live list of variable declaration fragments in this
>-	 * statement (element type: <code>VariableDeclarationFragment</code>)
>+	 * statement (element type: {@link VariableDeclarationFragment})
> 	 */
> 	public List fragments() {
> 		return this.variableDeclarationFragments;
>Index: dom/org/eclipse/jdt/core/dom/WhileStatement.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/WhileStatement.java,v
>retrieving revision 1.30
>diff -u -r1.30 WhileStatement.java
>--- dom/org/eclipse/jdt/core/dom/WhileStatement.java	27 Jun 2008 16:03:47 -0000	1.30
>+++ dom/org/eclipse/jdt/core/dom/WhileStatement.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2000, 2008 IBM Corporation and others.
>+ * Copyright (c) 2000, 2010 IBM Corporation and others.
> * 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
>@@ -28,14 +28,14 @@
> public class WhileStatement extends Statement {
> 
> 	/**
>-	 * The "expression" structural property of this node type.
>+	 * The "expression" structural property of this node type (child type: {@link Expression}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor EXPRESSION_PROPERTY =
> 		new ChildPropertyDescriptor(WhileStatement.class, "expression", Expression.class, MANDATORY, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "body" structural property of this node type.
>+	 * The "body" structural property of this node type (child type: {@link Statement}).
> 	 * @since 3.0
> 	 */
> 	public static final ChildPropertyDescriptor BODY_PROPERTY =
>Index: dom/org/eclipse/jdt/core/dom/WildcardType.java
>===================================================================
>RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/dom/org/eclipse/jdt/core/dom/WildcardType.java,v
>retrieving revision 1.19
>diff -u -r1.19 WildcardType.java
>--- dom/org/eclipse/jdt/core/dom/WildcardType.java	27 Jun 2008 16:03:46 -0000	1.19
>+++ dom/org/eclipse/jdt/core/dom/WildcardType.java	2 Sep 2010 18:40:36 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2003, 2008 IBM Corporation and others.
>+ * Copyright (c) 2003, 2010 IBM Corporation and others.
> * 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
>@@ -32,13 +32,13 @@
> public class WildcardType extends Type {
> 
> 	/**
>-	 * The "bound" structural property of this node type.
>+	 * The "bound" structural property of this node type (child type: {@link Type}).
> 	 */
> 	public static final ChildPropertyDescriptor BOUND_PROPERTY =
> 		new ChildPropertyDescriptor(WildcardType.class, "bound", Type.class, OPTIONAL, CYCLE_RISK); //$NON-NLS-1$
> 
> 	/**
>-	 * The "upperBound" structural property of this node type.
>+	 * The "upperBound" structural property of this node type (type: {@link Boolean}).
> 	 */
> 	public static final SimplePropertyDescriptor UPPER_BOUND_PROPERTY =
> 		new SimplePropertyDescriptor(WildcardType.class, "upperBound", boolean.class, MANDATORY); //$NON-NLS-1$

Actions: View | Diff

Attachments on bug 322596: 178084