need the modifying annotation, if only the documentation was better