Added output parameter documentation

Added output parameter documentation and fixed some formatting consistency issues in highlight blocks (some were tabbed, some were not; tabs are not necessary).

I did some markdown previews, but couldn't find a way to preview it as it is rendered at http://cpputest.github.io/, so be wary.  If there's a good way to preview it, please let me know.