fixed LOTS of perl warnings generated by doxygen.  in basically every case the error was the same - a regular expression was matched with (something)? and then used with  without checking that there was actually a match
removed a fragment left from previous documentation
let doxygen update the doxyfile.  quiets final warnings on my mac