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

improve documentation of GT_DEPRECATED