document new mandatory arg