updated javadoc comments

git-svn-id: http://anonsvn.jboss.org/repos/javassist/trunk@204 30ef5769-5b8d-40dd-aea6-55b5d6557bb3

3 files changed, 58 insertions, 6 deletions

diff --git a/src/main/javassist/CtBehavior.java b/src/main/javassist/CtBehavior.java
index a8baaf8c..6069f5fd 100644
--- a/src/main/javassist/CtBehavior.java
+++ b/src/main/javassist/CtBehavior.java
@@ -51,7 +51,23 @@ public abstract class CtBehavior extends CtMember {
     }
 
     /**
-     * Undocumented method.  Do not use; internal-use only.
+     * Returns the MethodInfo representing the method/constructor in the
+     * class file (read only).
+     * Normal applications do not need calling this method.  Use
+     * <code>getMethodInfo()</code>.
+     *
+     * <p>The <code>MethodInfo</code> object obtained by this method
+     * is read only.  Changes to this object might not be reflected
+     * on a class file generated by <code>toBytecode()</code>,
+     * <code>toClass()</code>, etc in <code>CtClass</code>.
+     *
+     * <p>This method is available even if the <code>CtClass</code>
+     * containing this method is frozen.  However, if the class is
+     * frozen, the <code>MethodInfo</code> might be also pruned.
+     *
+     * @see #getMethodInfo()
+     * @see CtClass#isFrozen()
+     * @see CtClass#prune()
      */
     public MethodInfo getMethodInfo2() { return methodInfo; }
 
diff --git a/src/main/javassist/CtClass.java b/src/main/javassist/CtClass.java
index 1b3b588b..9e407962 100644
--- a/src/main/javassist/CtClass.java
+++ b/src/main/javassist/CtClass.java
@@ -51,7 +51,7 @@ public abstract class CtClass {
     /**
      * The version number of this release.
      */
-    public static final String version = "3.1RC1";
+    public static final String version = "3.1RC2";
 
     /**
      * Prints the version number and the copyright notice.
@@ -215,7 +215,22 @@ public abstract class CtClass {
     }
 
     /**
-     * Undocumented method.  Do not use; internal-use only.
+     * Returns a class file for this class (read only).
+     * Normal applications do not need calling this method.  Use
+     * <code>getClassFile()</code>.
+     *
+     * <p>The <code>ClassFile</code> object obtained by this method
+     * is read only.  Changes to this object might not be reflected
+     * on a class file generated by <code>toBytecode()</code>,
+     * <code>toClass()</code>, etc.
+     *
+     * <p>This method is available even if <code>isFrozen()</code>
+     * is true.  However, if the class is frozen, it might be also
+     * pruned.
+     *
+     * @see CtClass#getClassFile()
+     * @see CtClass#isFrozen()
+     * @see CtClass#prune()
      */
     public ClassFile getClassFile2() { return null; }
 
@@ -1029,8 +1044,8 @@ public abstract class CtClass {
     public void stopPruning(boolean stop) {}
 
     /**
-     * Discards unnecessary data, in particuar, <code>CodeAttribute</code>s
-     * (method bodies) of the class,
+     * Discards unnecessary attributes, in particuar,
+     * <code>CodeAttribute</code>s (method bodies) of the class,
      * to minimize the memory footprint.
      * After calling this method, the class is read only.
      * It cannot be modified any more.
@@ -1040,9 +1055,14 @@ public abstract class CtClass {
      * However, the method names and signatures in the class etc.
      * are still accessible.
      *
+     * <p><code>toBytecode()</code>, <code>writeFile()</code>, and
+     * <code>toClass()</code> internally call this method. 
+     *
      * @see #toBytecode()
      * @see #toClass()
      * @see #writeFile()
+     * @see #instrument(CodeConverter)
+     * @see #instrument(ExprEditor)
      *
      * @see #stopPruning(boolean)
      */
diff --git a/src/main/javassist/CtField.java b/src/main/javassist/CtField.java
index f4f2986a..fa446f4d 100644
--- a/src/main/javassist/CtField.java
+++ b/src/main/javassist/CtField.java
@@ -171,7 +171,23 @@ public class CtField extends CtMember {
     }
 
     /**
-     * Undocumented method.  Do not use; internal-use only.
+     * Returns the FieldInfo representing the field in the class
+     * file (read only).
+     * Normal applications do not need calling this method.  Use
+     * <code>getFieldInfo()</code>.
+     *
+     * <p>The <code>FieldInfo</code> object obtained by this method
+     * is read only.  Changes to this object might not be reflected
+     * on a class file generated by <code>toBytecode()</code>,
+     * <code>toClass()</code>, etc in <code>CtClass</code>.
+     *
+     * <p>This method is available even if the <code>CtClass</code>
+     * containing this field is frozen.  However, if the class is
+     * frozen, the <code>FieldInfo</code> might be also pruned.
+     *
+     * @see #getFieldInfo()
+     * @see CtClass#isFrozen()
+     * @see CtClass#prune()
      */
     public FieldInfo getFieldInfo2() { return fieldInfo; }