Expand DeprecatedOpt documentation

It is not a priori obvious how deprecated options are chosen, so
expand the docstring a bit

Change-Id: If10b45fb042b4a4d6063129b693228fd6ca86b82