### Eclipse Workspace Patch 1.0 #P org.eclipse.jdt.core Index: model/org/eclipse/jdt/core/ISourceReference.java =================================================================== RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/model/org/eclipse/jdt/core/ISourceReference.java,v retrieving revision 1.23 diff -u -r1.23 ISourceReference.java --- model/org/eclipse/jdt/core/ISourceReference.java 27 Jun 2008 16:04:01 -0000 1.23 +++ model/org/eclipse/jdt/core/ISourceReference.java 6 Nov 2009 17:08:49 -0000 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2008 IBM Corporation and others. + * Copyright (c) 2000, 2009 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 @@ -61,13 +61,15 @@ * associated with the class file (if there is one). *
*
- * If this element has no associated source code null
is either returned,
- * or a source range with a -1 offset and a 0 length.
+ * If this element has no associated source code, either null
is returned,
+ * or a source range with a -1 offset and a 0 length. {@link SourceRange#isAvailable(ISourceRange)}
+ * can be used to detect that case.
*
null
or [-1, 0] if this element has no
* associated source code
* @exception JavaModelException if an exception occurs while accessing its corresponding resource
+ * @see SourceRange#isAvailable(ISourceRange)
*/
ISourceRange getSourceRange() throws JavaModelException;
}