more doc for new argument scheme