fdsn: docstrings/examples/frontpage
fdsn: deprecation warnings in obspy.iris

also fixed @deprecated's kwarg see
http://stackoverflow.com/questions/5929107/python-decorators-with-parameters