add deprecated method; update docs.