marked legacy methods deprecated, updated docs