Added commentary to the public API referring to new functionality of