updated user documentation.
release 1.2