This javadoc block looks good, but I think adding the 2 (3?) lines of code that demonstrate how to use this would be helpful (thinking from the gist). WDYT?