Each type must have at least one paragraph of descriptive
text in addition to a \brief. Edited the briefs where necessary.

Change-Id: I0cfaa37b39bab0be8409e4bf6ac8c4b6e5a77bf3
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>