import org.eclipse.jdt.core.compiler.IScanner;

import org.eclipse.jdt.core.compiler.ITerminalSymbols;

import org.eclipse.jdt.core.compiler.InvalidInputException;

public ISourceRange getJavadocRange() throws JavaModelException {

	ISourceRange range= this.getSourceRange();

	if (range == null) return null;

	IBuffer buf= this.isBinary() ? this.getClassFile().getBuffer() : this.getCompilationUnit().getBuffer();

	final int start= range.getOffset();

	final int length= range.getLength();

	if (length > 0 && buf.getChar(start) == '/') {

		IScanner scanner= ToolFactory.createScanner(true, false, false, false);

		scanner.setSource(buf.getText(start, length).toCharArray());

		try {

			int docOffset= -1;

			int docEnd= -1;

			int terminal= scanner.getNextToken();

			loop: while (true) {

				switch(terminal) {

					case ITerminalSymbols.TokenNameCOMMENT_JAVADOC :

						docOffset= scanner.getCurrentTokenStartPosition();

						docEnd= scanner.getCurrentTokenEndPosition() + 1;

						terminal= scanner.getNextToken();

						break;

					case ITerminalSymbols.TokenNameCOMMENT_LINE :

					case ITerminalSymbols.TokenNameCOMMENT_BLOCK :

						terminal= scanner.getNextToken();

						continue loop;

					default :

						break loop;

				}

			}

			if (docOffset != -1) {

				return new SourceRange(docOffset + start, docEnd - docOffset + 1);

			}

		} catch (InvalidInputException ex) {

			// try if there is inherited Javadoc

		}

	}

	return null;

}

 * Returns the Javadoc range if this element is from source or if this element

 * is a binary element with an attached source, null otherwise.

 * 

 * <p>If this element is from source, the javadoc range is 

 * extracted from the corresponding source.</p>

 * <p>If this element is from a binary, the javadoc is extracted from the

 * attached source if present.</p>

 *

 * @exception JavaModelException if this element does not exist or if an

 *      exception occurs while accessing its corresponding resource.

 * @return a source range corresponding to the javadoc source or <code>null</code>

 * if no source is available or the element has no javadoc comment.

 * @since 3.2

 */

ISourceRange getJavadocRange() throws JavaModelException;

/**