Let's also add an explanation of what these new parameters do to the docblock. 

Also, nitpick here and above: our boolean values are always lower case so true instead of True.