document blacklist (a bit)