doc: add documentation about the LogHolder position manipulation

1 files changed, 14 insertions, 0 deletions

diff --git a/main/src/cgeo/geocaching/CacheDetailActivity.java b/main/src/cgeo/geocaching/CacheDetailActivity.java
index 4d3a0f0..11c4b4f 100644
--- a/main/src/cgeo/geocaching/CacheDetailActivity.java
+++ b/main/src/cgeo/geocaching/CacheDetailActivity.java
@@ -2236,10 +2236,24 @@ public class CacheDetailActivity extends AbstractViewPagerActivity<CacheDetailAc
                 statusMarker = (ImageView) base.findViewById(R.id.log_mark);
             }
 
+            /**
+             * Read the position of the cursor pointed to by this holder.
+             * <br/>
+             * This must be called by the UI thread.
+             *
+             * @return the cursor position
+             */
             public int getPosition() {
                 return position;
             }
 
+            /**
+             * Set the position of the cursor pointed to by this holder.
+             * <br/>
+             * This must be called by the UI thread.
+             *
+             * @param position the cursor position
+             */
             public void setPosition(final int position) {
                 this.position = position;
             }