add some method use clarifaction docs.

git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/trunk@538 f203690c-595d-4dc9-a70b-905162fa7fd2

diff --git a/src/java/com/healthmarketscience/jackcess/Table.java b/src/java/com/healthmarketscience/jackcess/Table.java
index 2d107afd8291dbdde665d47a4889dfba5bdfd8ef..aaeb30613c0f7c211dc2c48572ba60f104e8aa27 100644 (file)
--- a/src/java/com/healthmarketscience/jackcess/Table.java
+++ b/src/java/com/healthmarketscience/jackcess/Table.java
@@ -1361,6 +1361,11 @@ public class Table
   
   /**
    * Update the row on which the given rowState is currently positioned.
+   * <p>
+   * Note, this method is not generally meant to be used directly.  You should
+   * use the {@link #updateCurrentRow} method or use the Cursor class, which
+   * allows for more complex table interactions, e.g.
+   * {@link Cursor#setCurrentRowValue} and {@link Cursor#updateCurrentRow}.
    */
   public void updateRow(RowState rowState, RowId rowId, Object... row) 
     throws IOException