incubator-kato-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From spo...@apache.org
Subject svn commit: r800564 - /incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java
Date Mon, 03 Aug 2009 21:08:51 GMT
Author: spoole
Date: Mon Aug  3 21:08:51 2009
New Revision: 800564

URL: http://svn.apache.org/viewvc?rev=800564&view=rev
Log:
updated JavaMethod  javadoc

Modified:
    incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java

Modified: incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java
URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java?rev=800564&r1=800563&r2=800564&view=diff
==============================================================================
--- incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java
(original)
+++ incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/runtime/java/JavaMethod.java
Mon Aug  3 21:08:51 2009
@@ -15,17 +15,19 @@
 
 import java.util.List;
 
-import javax.tools.diagnostics.image.DataUnavailable;
+import javax.tools.diagnostics.image.ImageSection;
 
 
 /**
+ * <p>
  * Represents a method or constructor in a class
  */
 public interface JavaMethod extends JavaMember {
 
     /**
+     * <p>
      * Get the set of ImageSections containing the bytecode of this method.
-     * <br>
+     * <p>
      * Each ImageSection contains data (usually bytecodes) used
      * in executing this method in interpreted mode. 
      * <p>
@@ -33,40 +35,46 @@
      * pre-compiled methods.
      * <p>
      * Typically, the collection will contain no more than one
-     * section, but this is not guaranteed. 
-     * 
-     * @return an iterator over a collection of ImageSections.
+     * section, but this is not guaranteed.
+     *  
+     * <p>The returned list follows the standard semantics for javax.tools.diagnostics
collections.</p>
+     * <p>The returned list is never null but could be empty.</p>
+     * @return a list of ImageSections.
      * 
      * 
      * @see javax.tools.diagnostics.image.ImageSection
-     * @see javax.tools.diagnostics.image.CorruptData
      */
-    List getBytecodeSections();
+    List<ImageSection> getBytecodeSections();
 
     /**
+     * <p>
      * Get the set of ImageSections containing the compiled code of this method.
-     * <br>
+     * <p>
      * Each ImageSection contains data (usually executable code) used
      * in executing this method in compiled mode.
+     * <p>The returned list follows the standard semantics for javax.tools.diagnostics
collections.</p>
+     * <p>The returned list is never null but could be empty.</p>
      * 
-     * @return an iterator over a collection of ImageSections.
+     * @return a list of ImageSections.
      * 
      * @see javax.tools.diagnostics.image.ImageSection
-     * @see javax.tools.diagnostics.image.CorruptData
+     * 
      */
-    List getCompiledSections();
+    List<ImageSection> getCompiledSections();
     
     
     /**
-     * An experimental addition to the API
+     * <p>
+     * An experimental addition to the API.
+     * <p>
      * Get the set of {@link JavaVariable} objects
+     * <p>The returned list follows the standard semantics for javax.tools.diagnostics
collections.</p>
+     * <p>The returned list is never null but could be empty.</p>
      * 
      * @return List of JavaVariable objects available
-     * 
-     * @experimental
-     * 
+     *  
      */
-    List<JavaVariable> getVariables() throws DataUnavailable; 
+    List<JavaVariable> getVariables();  
     
 	/**
 	 * @param obj



Mime
View raw message