Skip to content

Commit

Permalink
[Releng] Fix all javadoc broken link warnings.
Browse files Browse the repository at this point in the history
  • Loading branch information
merks committed Oct 21, 2017
1 parent 9fb6595 commit 7878024
Show file tree
Hide file tree
Showing 77 changed files with 140 additions and 223 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<feature
id="org.eclipse.emf.ecore.xcore.lib"
label="%featureName"
version="1.2.100.qualifier"
version="1.3.0.qualifier"
provider-name="%providerName"
license-feature="org.eclipse.emf.license"
license-feature-version="2.8.0.qualifier">
Expand Down
2 changes: 1 addition & 1 deletion features/org.eclipse.emf.gwt.common-feature/feature.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<feature
id="org.eclipse.emf.gwt.common"
label="%featureName"
version="2.10.0.qualifier"
version="2.11.0.qualifier"
provider-name="%providerName"
license-feature="org.eclipse.emf.license"
license-feature-version="2.8.0.qualifier">
Expand Down
2 changes: 1 addition & 1 deletion features/org.eclipse.emf.gwt.edit-feature/feature.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<feature
id="org.eclipse.emf.gwt.edit"
label="%featureName"
version="2.8.0.qualifier"
version="2.9.0.qualifier"
provider-name="%providerName"
license-feature="org.eclipse.emf.license"
license-feature-version="2.8.0.qualifier">
Expand Down
2 changes: 1 addition & 1 deletion features/org.eclipse.emf.rap.common.ui-feature/feature.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<feature
id="org.eclipse.emf.rap.common.ui"
label="%featureName"
version="2.9.0.qualifier"
version="2.10.0.qualifier"
provider-name="%providerName"
license-feature="org.eclipse.emf.license"
license-feature-version="2.8.0.qualifier">
Expand Down
2 changes: 1 addition & 1 deletion features/org.eclipse.emf.rap.edit.ui-feature/feature.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<feature
id="org.eclipse.emf.rap.edit.ui"
label="%featureName"
version="2.9.0.qualifier"
version="2.10.0.qualifier"
provider-name="%providerName"
license-feature="org.eclipse.emf.license"
license-feature-version="2.8.0.qualifier">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1863,7 +1863,7 @@ protected void generateProperties(String targetPathName, JETEmitter jetEmitter,
}

/**
* Whether {@link #generateJava(String, String, String, JETEmitter, Object[], Monitor) generateJava) or
* Whether {@link #generateJava(String, String, String, JETEmitter, Object[], Monitor) generateJava} or
* {@link #generateProperties(String, JETEmitter, Object[], Monitor) generateProperties}
* should merge the newly generated contents with the existing contents
* or should simply overwrite the old contents.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ public class CodeGen
{
/**
* This is a progress monitor that prints the progress information to a stream.
* @deprecated As of EMF 2.1.0, moved to {@link CodeGenUtil.StreamProgressMonitor CodeGenUtil}.
* @deprecated As of EMF 2.1.0, moved to {@link org.eclipse.emf.codegen.util.CodeGenUtil.StreamProgressMonitor CodeGenUtil}.
*/
@Deprecated
public static class StreamProgressMonitor extends CodeGenUtil.EclipseUtil.StreamProgressMonitor
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -511,7 +511,7 @@ public String getCompilerCompliance()

/**
* Specify the required Java {@link JavaCore#COMPILER_COMPLIANCE compiler compliance} level.
* @param complierCompliance the required Java compiler compliance level.
* @param compilerCompliance the required Java compiler compliance level.
* @since 2.8
*/
public void setCompilerCompliance(String compilerCompliance)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -376,7 +376,6 @@ else if (j + 4 < end && "super".equals(qualifiedName.substring(j, j + 5)))
* In fact, a parameterized type expression is also allowed, in which case the expression will be parsed to obtain the
* individual imported names within it. Then the full expression, with the appropriate substitutions, is returned.
* @param qualifiedName the qualified name or parameterized type expression.
* @param autoImport whether to try to automatically import types as needed.
* @return the equivalent type or type expression, using short names wherever possible.
*/
public String getImportedName(String qualifiedName)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -274,7 +274,6 @@ public E set(int index, E object)
* Sets the object at the index
* and returns the old object at the index;
* it does no ranging checking or uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didSet didSet}, and {@link #didChange didChange}.
* @param index the position in question.
* @param object the object to set.
* @return the old object at the index.
Expand Down Expand Up @@ -310,8 +309,6 @@ public boolean add(E object)
/**
* Adds the object at the end of the list;
* it does no uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* after uniqueness checking.
* @param object the object to be added.
* @see #add(Object)
*/
Expand Down Expand Up @@ -346,7 +343,6 @@ public void add(int index, E object)
/**
* Adds the object at the given index in the list;
* it does no ranging checking or uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* @param object the object to be added.
* @see #add(int, Object)
*/
Expand Down Expand Up @@ -375,7 +371,6 @@ public boolean addAll(Collection<? extends E> collection)
/**
* Adds each object of the collection to the end of the list;
* it does no uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* @param collection the collection of objects to be added.
* @see #addAll(Collection)
*/
Expand Down Expand Up @@ -412,7 +407,6 @@ public boolean addAll(int index, Collection<? extends E> collection)
* Adds each object of the collection at each successive index in the list
* and returns whether any objects were added;
* it does no ranging checking or uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* @param index the index at which to add.
* @param collection the collection of objects to be added.
* @return whether any objects were added.
Expand All @@ -424,7 +418,6 @@ public boolean addAll(int index, Collection<? extends E> collection)
* Adds each object from start to end of the array at the index of list
* and returns whether any objects were added;
* it does no ranging checking or uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* @param objects the objects to be added.
* @param start the index of first object to be added.
* @param end the index past the last object to be added.
Expand All @@ -437,7 +430,6 @@ public boolean addAll(int index, Collection<? extends E> collection)
* Adds each object from start to end of the array at each successive index in the list
* and returns whether any objects were added;
* it does no ranging checking or uniqueness checking.
* This implementation delegates to {@link #assign assign}, {@link #didAdd didAdd}, and {@link #didChange didChange}.
* @param index the index at which to add.
* @param objects the objects to be added.
* @param start the index of first object to be added.
Expand Down Expand Up @@ -540,7 +532,6 @@ public void move(int index, E object)
/**
* Moves the object at the source index of the list to the target index of the list
* and returns the moved object.
* This implementation delegates to {@link #assign assign}, {@link #didMove didMove}, and {@link #didChange didChange}.
* @param targetIndex the new position for the object in the list.
* @param sourceIndex the old position of the object in the list.
* @return the moved object.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -666,7 +666,7 @@ protected SubstringAccessUnit(Queue queue)
}

/**
* Sets the {@link #characters}, {@link #offset}, {@link #count}, and {@link #hashCode()} of the value being {@link StringPool#intern(char[], int, int, int) accessed}.
* Sets the {@link #string}, {@link #offset}, {@link #count}, and {@link #hashCode()} of the value being {@link StringPool#intern(char[], int, int, int) accessed}.
*/
public void setValue(String string, int offset, int count, int hashCode)
{
Expand All @@ -677,7 +677,7 @@ public void setValue(String string, int offset, int count, int hashCode)
}

/**
* Sets the {@link #characters}, {@link #offset}, and {@link #count} and computes the {@link #hashCode()} of the value being {@link StringPool#intern(char[], int, int) accessed}.
* Sets the {@link #string}, {@link #offset}, and {@link #count} and computes the {@link #hashCode()} of the value being {@link StringPool#intern(char[], int, int) accessed}.
*/
public void setValue(String string, int offset, int count)
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1352,8 +1352,8 @@ public static <T> EList<T> unmodifiableEList(List<? extends T> list)
}

/**
* Creates an empty mutable {@link BasicEList>}.
* @return an empty mutable {@link BasicEList>}.
* Creates an empty mutable {@link BasicEList}.
* @return an empty mutable {@link BasicEList}.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEList()
Expand All @@ -1362,8 +1362,8 @@ public static <T> BasicEList<T> newBasicEList()
}

/**
* Creates an empty mutable {@link BasicEList>} with the given capacity.
* @return an empty mutable {@link BasicEList>}.
* Creates an empty mutable {@link BasicEList} with the given capacity.
* @return an empty mutable {@link BasicEList}.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEListWithCapacity(int capacity)
Expand All @@ -1372,9 +1372,9 @@ public static <T> BasicEList<T> newBasicEListWithCapacity(int capacity)
}

/**
* Creates an empty mutable {@link BasicEList>} with a capacity large enough to hold a bit more than the estimated number of elements.
* Creates an empty mutable {@link BasicEList} with a capacity large enough to hold a bit more than the estimated number of elements.
* If you know the exact size, use {@link #newBasicEListWithCapacity(int)} instead.
* @return an empty mutable {@link BasicEList>}.
* @return an empty mutable {@link BasicEList}.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEListWithExpectedSize(int estimatedSize)
Expand All @@ -1385,8 +1385,8 @@ public static <T> BasicEList<T> newBasicEListWithExpectedSize(int estimatedSize)
}

/**
* Creates a mutable {@link BasicEList>} containing the given elements.
* @return a mutable {@link BasicEList>} containing the given elements.
* Creates a mutable {@link BasicEList} containing the given elements.
* @return a mutable {@link BasicEList} containing the given elements.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEList(T... elements)
Expand All @@ -1400,8 +1400,8 @@ public static <T> BasicEList<T> newBasicEList(T... elements)
}

/**
* Creates a mutable {@link BasicEList>} containing the given elements.
* @return a mutable {@link BasicEList>} containing the given elements.
* Creates a mutable {@link BasicEList} containing the given elements.
* @return a mutable {@link BasicEList} containing the given elements.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEList(Iterator<? extends T> iterator)
Expand All @@ -1415,8 +1415,8 @@ public static <T> BasicEList<T> newBasicEList(Iterator<? extends T> iterator)
}

/**
* Creates a mutable {@link BasicEList>} containing the given elements.
* @return a mutable {@link BasicEList>} containing the given elements.
* Creates a mutable {@link BasicEList} containing the given elements.
* @return a mutable {@link BasicEList} containing the given elements.
* @since 2.9
*/
public static <T> BasicEList<T> newBasicEList(Iterable<? extends T> iterable)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ public void push(AccessUnit<E> accessUnit, boolean isExclusive)
protected final Queue<E> queue;

/**
* Access units are chained in {@link Pool#accessUnits} via this link.
* Access units are chained via this link.
*/
protected AccessUnit<E> next;

Expand Down Expand Up @@ -298,7 +298,7 @@ public void add(E value, Entry<E> entry)

/**
* Prepare the access unit for reuse.
* In particular remove the hard references to each element in both the {@link #getValues()} and {@link #getEntries()}
* In particular remove the hard references to each element in both the {@link #values} and {@link #entries}
* and then reset the {@link #valuesLength} to 0
*/
public void reset(boolean isExclusive)
Expand Down Expand Up @@ -394,7 +394,7 @@ public void reset(boolean isExclusive)
protected int accessCount;

/**
* The number of {@link #access(AccessUnit, int) access} between each attempt to {@link #cleanup() clean up} garbage collected entries.
* The number of {@link #access(boolean, AccessUnit) accesses} between each attempt to {@link #cleanup() clean up} garbage collected entries.
* Garbage collecting entries requires the exclusive {@link #getWriteLock()} to be held, so it's best to do this infrequently.
*/
protected int cleanupPeriod = 1000;
Expand Down Expand Up @@ -663,7 +663,7 @@ public Lock getWriteLock()

/**
* Gets the first entry with the matching hash code.
* Use {@link Entry#getNextEntry()} to navigate to the next entry with the same hash code.
* Use {@link org.eclipse.emf.common.util.WeakInterningHashSet.Entry#getNextEntry()} to navigate to the next entry with the same hash code.
* This method does no locking so it may fail to find matches if the pool is rehashing or another thread is adding the entry.
*/
@Override
Expand Down Expand Up @@ -728,8 +728,8 @@ protected final void access(boolean isReadLocked, AccessUnit<E> accessUnit)
/**
* Adds an entry to the pool,
* but first checks if the entry has been added by another thread
* since the time when the pool was {@link #access(AccessUnit, int) accessed} while without holding any locks.
* The access unit is used to {@link AccessUnit#isEntryCreated record} whether an entry was really added.
* since the time when the pool was {@link #access(boolean, AccessUnit) accessed} without holding any locks.
* The access unit is used to {@link AccessUnit#rematches(Object, Entry) determine} whether an entry was already added.
* This returns either the value added, or the value that was already added by another thread.
* The <code>isExlusive</code> argument controls whether the write lock needs to be acquired (<code>false</code>) or is already acquired (<code>true</code>).
*/
Expand Down Expand Up @@ -910,7 +910,7 @@ public E intern(E value)

/**
* Returns the interned version of the value accessed by this access unit
* and {@link #setAccessUnit(AccessUnit) frees} the access unit for reuse.
* and {@link AccessUnit#reset(boolean) frees} the access unit for reuse.
*/
protected E doIntern(boolean isExclusive, AccessUnit<E> accessUnit)
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
*/
package org.eclipse.emf.common.util;

import java.lang.reflect.Array;
import java.util.HashMap;
import java.util.Map;

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -350,7 +350,7 @@ protected boolean ensureCapacity()
}

/**
* Rehashes the existing {@#entries} into the new entries.
* Rehashes the existing {@link #entries} into the new entries.
*/
final void rehash(Entry<E> [] newEntries)
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Bundle-Name: %pluginName
Bundle-Vendor: %providerName
Bundle-Localization: plugin
Bundle-SymbolicName: org.eclipse.emf.ecore.xcore.lib;singleton:=true
Bundle-Version: 1.1.100.qualifier
Bundle-Version: 1.2.0.qualifier
Bundle-ClassPath: .
Bundle-RequiredExecutionEnvironment: JavaSE-1.6
Require-Bundle: org.eclipse.emf.ecore;resolution:=optional,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,8 +53,8 @@ public static <T> EList<T> newImmutableEList(T... elements)
/**
* Creates a mutable {@link BasicEList} containing the given elements.
*
* @param initial the initial elements that the list should contain, in order. May not be <code>null</code>.
* @return a new {@link Basic} containing the given elements
* @param elements the initial elements that the list should contain, in order. May not be <code>null</code>.
* @return a new {@link BasicEList} containing the given elements
*/
@Pure
public static <T> BasicEList<T> newBasicEList(T... elements)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
public class XcoreReferenceFinder extends ReferenceFinder
{
/**
* @inheritDoc
* {@inheritDoc}
*
* Xtext 2.10.x
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -538,7 +538,7 @@ interface ElementHandler
String OPTION_PROXY_ATTRIBUTES = org.eclipse.emf.ecore.resource.impl.BinaryResourceImpl.OPTION_STYLE_PROXY_ATTRIBUTES;

/**
* A load option that when set to Boolean.TRUE directs the resource to load the an {@link EPackage.Registry unregistered package} using the {@link EPackage#getNsURI() package's namespace} as its location.
* A load option that when set to Boolean.TRUE directs the resource to load the an {@link org.eclipse.emf.ecore.EPackage.Registry unregistered package} using the {@link EPackage#getNsURI() package's namespace} as its location.
* The default is true.
* @since 2.9
*/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
import org.eclipse.emf.ecore.EClassifier;
import org.eclipse.emf.ecore.EModelElement;
import org.eclipse.emf.ecore.EPackage;
import org.eclipse.emf.ecore.EReference;
import org.eclipse.emf.ecore.EStructuralFeature;
import org.eclipse.emf.ecore.EcorePackage;
import org.eclipse.emf.ecore.util.BasicExtendedMetaData;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@


/**
* This is the basic implementation of the {@link XMLResource.URIHandler URIHandler} interface.
* This is the basic implementation of the {@link org.eclipse.emf.ecore.xmi.XMLResource.URIHandler URIHandler} interface.
* Implementations should extend this class to implement a specialized URI handler.
*/
public class URIHandlerImpl implements XMLResource.URIHandler
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ public Factory getFactory(String uri)

/**
* Sets the specialized delegate for this data type.
* @param settingDelegate the specialized delegate.
* @param conversionDelegate the specialized delegate.
*/
void setConversionDelegate(ConversionDelegate conversionDelegate);
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -465,7 +465,7 @@ public interface EStore

/**
* Does the equivalent of <code>eObject.eInvoke(eObject.eClass().getEOperation(featureID), arguments)</code>.
* @see #eInvoke(EOperation, EList<?>)
* @see #eInvoke(EOperation, EList)
* @since 2.6
*/
Object eInvoke(int operationID, EList<?> arguments) throws InvocationTargetException;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ public class EPackageRegistryImpl extends HashMap<String, Object> implements EPa
private static final long serialVersionUID = 1L;

/**
* Creates the {@link EPackage.Registry#INSTANCE instance} of the global registry.
* Creates the {@link org.eclipse.emf.ecore.EPackage.Registry#INSTANCE instance} of the global registry.
* If a {@link System#getSecurityManager() security manager} is active,
* and <code>"classLoader"</code> {@link RuntimePermission permission} is not granted,
* a secure delegator instance is created,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ protected void eBasicSetContainer(InternalEObject newContainer)
private static final int ADAPTER = 1 << 2;

/**
* The {@link #eFlags bit flag} for indicating that a dynamic {@link BasicNotifierImpl.EObservableAdapterList.Listener adapter list listener} field is allocated.
* The {@link #eFlags bit flag} for indicating that a dynamic {@link org.eclipse.emf.common.notify.impl.BasicNotifierImpl.EObservableAdapterList.Listener adapter list listener} field is allocated.
*/
private static final int ADAPTER_LISTENER = 1 << 3;

Expand Down
Loading

0 comments on commit 7878024

Please sign in to comment.