extended documentation to describe usage