doc: add spec for util.deprecate()

Signed-off-by: Trevor Norris <trev.norris@gmail.com>