You are viewing a plain text version of this content. The canonical link for it is here.
Posted to kato-commits@incubator.apache.org by sp...@apache.org on 2009/07/24 09:43:06 UTC

svn commit: r797392 - in /incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics: image/ImageRegister.java java/JavaRuntime.java

Author: spoole
Date: Fri Jul 24 09:43:05 2009
New Revision: 797392

URL: http://svn.apache.org/viewvc?rev=797392&view=rev
Log:
api spec updates

Modified:
    incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/image/ImageRegister.java
    incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/java/JavaRuntime.java

Modified: incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/image/ImageRegister.java
URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/image/ImageRegister.java?rev=797392&r1=797391&r2=797392&view=diff
==============================================================================
--- incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/image/ImageRegister.java (original)
+++ incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/image/ImageRegister.java Fri Jul 24 09:43:05 2009
@@ -22,185 +22,8 @@
      * Fetch the name of a register.
      * 
      * On some CPUs registers may have more than one conventional name. Recommended 
-     * names for some CPUs are provided below. Implementations may provide more
-     * registers than those named here.
-     * 
-     * <table cellspacing="10"><tr valign="top">
-     * 
-     * <td><table frame="border">
-     * <tr><th colspan=2>IA32</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>EDI</td><td>Integer</td></tr>
-     * <tr><td>ESI</td><td>Integer</td></tr>
-     * <tr><td>EAX</td><td>Integer</td></tr>
-     * <tr><td>EBX</td><td>Integer</td></tr>
-     * <tr><td>ECX</td><td>Integer</td></tr>
-     * <tr><td>EDX</td><td>Integer</td></tr>
-     * <tr><td>EIP</td><td>Integer</td></tr>
-     * <tr><td>ESP</td><td>Integer</td></tr>
-     * <tr><td>EBP</td><td>Integer</td></tr>
-     * </table></td>
-     * 
-     * <td><table frame="border">
-     * <tr><th colspan=2>AMD64</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>RDI</td><td>Long</td></tr>
-     * <tr><td>RSI</td><td>Long</td></tr>
-     * <tr><td>RAX</td><td>Long</td></tr>
-     * <tr><td>RBX</td><td>Long</td></tr>
-     * <tr><td>RCX</td><td>Long</td></tr>
-     * <tr><td>RDX</td><td>Long</td></tr>
-     * <tr><td>R8</td><td>Long</td></tr>
-     * <tr><td>R9</td><td>Long</td></tr>
-     * <tr><td>R10</td><td>Long</td></tr>
-     * <tr><td>R11</td><td>Long</td></tr>
-     * <tr><td>R12</td><td>Long</td></tr>
-     * <tr><td>R13</td><td>Long</td></tr>
-     * <tr><td>R14</td><td>Long</td></tr>
-     * <tr><td>R15</td><td>Long</td></tr>
-     * <tr><td>RIP</td><td>Long</td></tr>
-     * <tr><td>RSP</td><td>Long</td></tr>
-     * <tr><td>RBP</td><td>Long</td></tr>
-     * </table></td>
-     * 
-     * <td><table frame="border">
-     * <tr><th colspan=2>PowerPC 32</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>R0</td><td>Integer</td></tr>
-     * <tr><td>R1</td><td>Integer</td></tr>
-     * <tr><td>R2</td><td>Integer</td></tr>
-     * <tr><td>R3</td><td>Integer</td></tr>
-     * <tr><td>R4</td><td>Integer</td></tr>
-     * <tr><td>R5</td><td>Integer</td></tr>
-     * <tr><td>R6</td><td>Integer</td></tr>
-     * <tr><td>R7</td><td>Integer</td></tr>
-     * <tr><td>R8</td><td>Integer</td></tr>
-     * <tr><td>R9</td><td>Integer</td></tr>
-     * <tr><td>R10</td><td>Integer</td></tr>
-     * <tr><td>R11</td><td>Integer</td></tr>
-     * <tr><td>R12</td><td>Integer</td></tr>
-     * <tr><td>R13</td><td>Integer</td></tr>
-     * <tr><td>R14</td><td>Integer</td></tr>
-     * <tr><td>R15</td><td>Integer</td></tr>
-     * <tr><td>R16</td><td>Integer</td></tr>
-     * <tr><td>R17</td><td>Integer</td></tr>
-     * <tr><td>R18</td><td>Integer</td></tr>
-     * <tr><td>R19</td><td>Integer</td></tr>
-     * <tr><td>R20</td><td>Integer</td></tr>
-     * <tr><td>R21</td><td>Integer</td></tr>
-     * <tr><td>R22</td><td>Integer</td></tr>
-     * <tr><td>R23</td><td>Integer</td></tr>
-     * <tr><td>R24</td><td>Integer</td></tr>
-     * <tr><td>R25</td><td>Integer</td></tr>
-     * <tr><td>R26</td><td>Integer</td></tr>
-     * <tr><td>R27</td><td>Integer</td></tr>
-     * <tr><td>R28</td><td>Integer</td></tr>
-     * <tr><td>R29</td><td>Integer</td></tr>
-     * <tr><td>R30</td><td>Integer</td></tr>
-     * <tr><td>R31</td><td>Integer</td></tr>
-     * <tr><td>IAR</td><td>Integer</td></tr>
-     * <tr><td>LR</td><td>Integer</td></tr>
-     * <tr><td>MSR</td><td>Integer</td></tr>
-     * <tr><td>CTR</td><td>Integer</td></tr>
-     * <tr><td>CR</td><td>Integer</td></tr>
-     * <tr><td>FPSCR</td><td>Integer</td></tr>
-     * <tr><td>XER</td><td>Integer</td></tr>
-     * <tr><td>TID</td><td>Integer</td></tr>
-     * <tr><td>MQ</td><td>Integer</td></tr>
-     * </table></td>
-     * 
-     * <td><table frame="border">
-     * <tr><th colspan=2>PowerPC 64</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>R0</td><td>Long</td></tr>
-     * <tr><td>R1</td><td>Long</td></tr>
-     * <tr><td>R2</td><td>Long</td></tr>
-     * <tr><td>R3</td><td>Long</td></tr>
-     * <tr><td>R4</td><td>Long</td></tr>
-     * <tr><td>R5</td><td>Long</td></tr>
-     * <tr><td>R6</td><td>Long</td></tr>
-     * <tr><td>R7</td><td>Long</td></tr>
-     * <tr><td>R8</td><td>Long</td></tr>
-     * <tr><td>R9</td><td>Long</td></tr>
-     * <tr><td>R10</td><td>Long</td></tr>
-     * <tr><td>R11</td><td>Long</td></tr>
-     * <tr><td>R12</td><td>Long</td></tr>
-     * <tr><td>R13</td><td>Long</td></tr>
-     * <tr><td>R14</td><td>Long</td></tr>
-     * <tr><td>R15</td><td>Long</td></tr>
-     * <tr><td>R16</td><td>Long</td></tr>
-     * <tr><td>R17</td><td>Long</td></tr>
-     * <tr><td>R18</td><td>Long</td></tr>
-     * <tr><td>R19</td><td>Long</td></tr>
-     * <tr><td>R20</td><td>Long</td></tr>
-     * <tr><td>R21</td><td>Long</td></tr>
-     * <tr><td>R22</td><td>Long</td></tr>
-     * <tr><td>R23</td><td>Long</td></tr>
-     * <tr><td>R24</td><td>Long</td></tr>
-     * <tr><td>R25</td><td>Long</td></tr>
-     * <tr><td>R26</td><td>Long</td></tr>
-     * <tr><td>R27</td><td>Long</td></tr>
-     * <tr><td>R28</td><td>Long</td></tr>
-     * <tr><td>R29</td><td>Long</td></tr>
-     * <tr><td>R30</td><td>Long</td></tr>
-     * <tr><td>R31</td><td>Long</td></tr>
-     * <tr><td>IAR</td><td>Long</td></tr>
-     * <tr><td>LR</td><td>Long</td></tr>
-     * <tr><td>MSR</td><td>Long</td></tr>
-     * <tr><td>CTR</td><td>Long</td></tr>
-     * <tr><td>CR</td><td>Long</td></tr>
-     * <tr><td>FPSCR</td><td>Long</td></tr>
-     * <tr><td>XER</td><td>Long</td></tr>
-     * </table></td>
-     *
-     * <td><table frame="border">
-     * <tr><th colspan=2>z/Series 31</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>gpr0</td><td>Integer</td></tr>
-     * <tr><td>gpr1</td><td>Integer</td></tr>
-     * <tr><td>gpr2</td><td>Integer</td></tr>
-     * <tr><td>gpr3</td><td>Integer</td></tr>
-     * <tr><td>gpr4</td><td>Integer</td></tr>
-     * <tr><td>gpr5</td><td>Integer</td></tr>
-     * <tr><td>gpr6</td><td>Integer</td></tr>
-     * <tr><td>gpr7</td><td>Integer</td></tr>
-     * <tr><td>gpr8</td><td>Integer</td></tr>
-     * <tr><td>gpr9</td><td>Integer</td></tr>
-     * <tr><td>gpr10</td><td>Integer</td></tr>
-     * <tr><td>gpr11</td><td>Integer</td></tr>
-     * <tr><td>gpr12</td><td>Integer</td></tr>
-     * <tr><td>gpr13</td><td>Integer</td></tr>
-     * <tr><td>gpr14</td><td>Integer</td></tr>
-     * <tr><td>gpr15</td><td>Integer</td></tr>
-     * <tr><td>psw0</td><td>Integer</td></tr>
-     * <tr><td>psw1</td><td>Integer</td></tr>
-     * </table></td>
-     *
-     * <td><table frame="border">
-     * <tr><th colspan=2>z/Series 64</th></tr>
-     * <tr><th>Register</th><th>Type</th></tr>
-     * <tr><td>gpr0</td><td>Long</td></tr>
-     * <tr><td>gpr1</td><td>Long</td></tr>
-     * <tr><td>gpr2</td><td>Long</td></tr>
-     * <tr><td>gpr3</td><td>Long</td></tr>
-     * <tr><td>gpr4</td><td>Long</td></tr>
-     * <tr><td>gpr5</td><td>Long</td></tr>
-     * <tr><td>gpr6</td><td>Long</td></tr>
-     * <tr><td>gpr7</td><td>Long</td></tr>
-     * <tr><td>gpr8</td><td>Long</td></tr>
-     * <tr><td>gpr9</td><td>Long</td></tr>
-     * <tr><td>gpr10</td><td>Long</td></tr>
-     * <tr><td>gpr11</td><td>Long</td></tr>
-     * <tr><td>gpr12</td><td>Long</td></tr>
-     * <tr><td>gpr13</td><td>Long</td></tr>
-     * <tr><td>gpr14</td><td>Long</td></tr>
-     * <tr><td>gpr15</td><td>Long</td></tr>
-     * <tr><td>psw0</td><td>Long</td></tr>
-     * <tr><td>psw1</td><td>Long</td></tr>
-     * </table></td>
-     * 
-     * </tr></table>
-     * 
+     * names for some CPUs are provided in the user guide. 
+     *  
      * @return the conventional name of the register
      */
     String getName();

Modified: incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/java/JavaRuntime.java
URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/java/JavaRuntime.java?rev=797392&r1=797391&r2=797392&view=diff
==============================================================================
--- incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/java/JavaRuntime.java (original)
+++ incubator/kato/trunk/org.apache.kato/kato.api/src/main/java/javax/tools/diagnostics/java/JavaRuntime.java Fri Jul 24 09:43:05 2009
@@ -133,9 +133,9 @@
      * There may be multiple heaps	within a Java Virtual Machine, for instance a generational heap and a class heap. 
      * Heaps may be specific to this Java Virtual Machine instance, or may be shared between multiple
      * Java Virtual Machine instances. 
-     *
+     *<p>
      * The returned list follows the standard semantics for javax.tools.diagnostics collections.
-     * 
+     * <p>
      * The returned list is never null and will always contain at least one JavaHeap object
      * 
   	 * @return a list for all of the Java heaps within this runtime.