forgotten documentation for deprecated methods, refs #451