complete with comments and examples of use.