tweaked docs and added bug-report