deprecated old methods that have been re-written better. deprecated warning instructs what method to use instead
added overview to depreacted header
Fully documented deprecated header