improve description of param/ret attrs