modify by arguments in docs
Merge remote-tracking branch 'origin/chdoig/by_change' into chdoig/by_change