doc update and bugfix

updated documentation and bugfix when entering of message fails