Tweak deprecation message for symbol descriptions.

Tweak deprecation message for symbol descriptions to indicate it will effect `described_class`, this should fix #1666.

Note I added a spec covering this.
Vim buffer error ;) the amount of time I removed this...