If this is deprecated, should we keep it documented?

Also, it helps, when deprecating something, to write in a comment the date at which it was deprecated. This way, later, we can remove it for good.