doc: more consistent comments about vector types.