Rather than duplicating the method description within this example, it's better to give an explanation of what each of the arguments do. Check out the examples in [TomDoc](http://tomdoc.org), and reach out if you're ever confused about documentation formatting.