gre: improve .api descriptions