WICKET-4904 improved javadoc and marked as deprecated