help expanded with new examples
descriptions of methods