added cursor feature (including tests) and updated documentation


[SVN r8367]
added the cursor feature


[SVN r8368]