proper documentation of deprecated functions