more comments, and better mainpage.dox file