fixes in the @return section; more markup