added some documentation and tests demonstrating alternate uses