Support a "Deprecated" Direction

[reid-spencer]

It should be possible to put:

#deprecated("Reason for deprecation", "alternative")

before any definition and have it reflected in the documentation, and generate a warning if it is used