Index: IJavaElement.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.core/model/org/eclipse/jdt/core/IJavaElement.java,v
retrieving revision 1.27
diff -u -r1.27 IJavaElement.java
--- IJavaElement.java	23 Feb 2005 02:47:28 -0000	1.27
+++ IJavaElement.java	29 Sep 2005 21:33:25 -0000
@@ -196,6 +196,20 @@
 	int getElementType();
 
 	/**
+	 * Returns the Javadoc in HTML format if found, null otherwise.
+	 * 
+	 * <p>If this element is from source, then the javadoc is 
+	 * extracted from the corresponding source.</p>
+	 * <p>If this element is from a binary, the the javadoc is extracted from either the 
+	 * attached source if present or the IClasspathAttribute#JAVADOC_LOCATION_ATTRIBUTE_NAME
+	 * attribute of the corresponding classpath entry if set.
+	 *
+	 * @return a string with the Javadoc in HTML format.
+	 * @since 3.2
+	 */
+	String getJavadoc();
+
+	/**
 	 * Returns a string representation of this element handle. The format of
 	 * the string is not specified; however, the identifier is stable across
 	 * workspace sessions, and can be used to recreate this handle via the