remove the tabular environment from @return; replace it with item macros
remove redundant describe macro; markup up item names in code macro