update intro comment to doxygen
added peeters reference where necessary
fixed <br>
forgot a <br>
file for generating doxygen documentation