adding documentation in response to Bug #22.