doxy tidying in rt_raven

redoing some of the tidying that was done in the code review meeting
spelling fix

huge commit.