document package erasure
changed order of parameters for consistency