documentation amended to indicate what is mandatory arguments