document new -D flag