--- a/src/main/java/org/mpi/openmind/cache/WrapperService.java	Wed Oct 12 20:51:35 2016 +0200
+++ b/src/main/java/org/mpi/openmind/cache/WrapperService.java	Thu Oct 13 19:02:24 2016 +0200
@@ -988,6 +988,8 @@
 	}
 
 	/**
+	 * Return an entity with the given id from the cache.
+	 * 
 	 * The entity returned could be LW or not, it depends on the cache.
 	 * additionally, it will be always a clone of the version in cache,
 	 * therefore it method is thought for editing's issues.
@@ -1000,6 +1002,14 @@
 		return ent;
 	}
 
+	/**
+	 * Return an entity with the given id from the cache.
+	 * 
+	 * Do not modify the entity!
+	 * 
+	 * @param id
+	 * @return
+	 */
 	public Entity getEntityByIdReadOnly(Long id) {
 		Entity ent = this.cache.getEntityByIdReadOnly(id);
 		return ent;