doc'ing deprecated bin api