forgotten documentation for deprecated methods, refs #526