improve documentation of GT_DEPRECATED