updated javadoc comments

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

1 files changed, 17 insertions, 1 deletions

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; }