closes #1704 : documentation updated.

 -