added javadoc to showAllowingStateLoss() warning about it's use