I had formatted the description with indenting on the examples but all the leading spaces were stripped when I posted it here. Sorry if it turns out to be a bit difficult to read.
EDIT* I will be updating this function tonight with additional functionality.
I plan to implement a markdown parser for these descriptions to add more flexibility.