Standard formatting for documentation comments?

[xigoi]

Take a look at the standard library documentation. It's usually just a 
description, there's no need to document parameters if it's clear from their 
names what they do.