AUI-1550

Hey Rob, I added the documentation and the tests.  I also made a couple other minor revisions while I was at it.  Let me know if you have any questions.