Fix typos & reinstate comment about deprecation