improve documentation of GT_DEPRECATED
Merge pull request #502 from gordon/deprecateddoc

improve documentation of GT_DEPRECATED