Doc: fix doxygen comments.

Some existing doxygen comments resulted in bad or bad looking
documentation. These were fixed.

Change-Id: I20ab5a81c54d3bdc0e056965ad7de293d472cdf9
Signed-off-by: Gyorgy Szing <Gyorgy.Szing@arm.com>
28 files changed