completion: improve __git_refs()'s in-code documentation