added a CHANGES entry and updated the documentation to include a use
example