I feel like this needs documented somewhere. Can you see if there's a logical place in the massive Javadoc up above?