clarifications to the documentation

git-svn-id: svn://svn.r-forge.r-project.org/svnroot/jbtools@24 edb9625f-4e0d-4859-8d74-9fd3b1da38cb