document new flags